How to Upload a Mod to the Steam Workshop - EmbersGames/MurkyDiversMod GitHub Wiki

This guide explains how to upload a mod to the Steam Workshop using SteamWorkshopUploader.

1. Download and Prepare

  1. Download the latest version of SteamWorkshopUploader from the Releases page.
  2. Extract the files to a folder of your choice.
  3. Open the file steam_appid.txt and replace its content with only: 2963880

Accept the Steam Workshop Legal Agreement:

Go to this page:
Steam Workshop Legal Agreement
You must read and accept these terms before you can publish any items on the Steam Workshop.

2. Organize Your Mod Files

  1. In the SteamWorkshopUploader folder, locate the folder called WorkshopContent.
  2. You will see a folder named example. Rename this folder to match the name of your mod (for example, MyMod).
  3. Empty its contents (you can delete the existing example files/folders).
  4. Place your actual mod folder inside this newly renamed folder.
  • Your mod folder should have the same name as the folder itself (e.g., MyMod).
  • This folder should contain:
    • Your .pak file
    • Your .umod file

3. Update the Image and JSON

  1. Change example.png to an image that represents your mod. You can rename your image to the mod’s name (e.g., MyMod.png).
  2. Rename Example.workshop.json to <YourModName>.workshop.json (for example, MyMod.workshop.json).

4. Edit the .workshop.json File

Open the .workshop.json file (now renamed to your mod’s name). You will need to:

  • Update file references (e.g., point to your new .pak, .umod, and .png if needed).
  • Modify the title to your mod’s public name.
  • Update the description to a clear and concise summary of what your mod does.
  • Add or update tags (depending on which tags you need to use).

The final folder structure must look like :

  • WorkshopContent
    • MyModNameFolder
      • MyModNameFolder
        • MyModName.pak
        • MyModName.umod
    • MyModName.png
    • MyModName.workshop.json

Tag List :

  • Item
  • Creature
  • System
  • Character
  • Interface
  • Submarine
  • Expedition site
  • Art
  • Environment
  • Accessibility
  • Audio
  • Optimization
  • Language
  • Cheats

5. Launch SteamWorkshopUploader

Note: You must be logged into the Steam client (Steam application) for the upload process to work.

  1. Run SteamWorkshopUploader.exe.
  2. Check the mod information it displays.
  3. Choose the visibility setting you prefer (Public, Friends-Only, Private, etc.).
  4. Optionally, enter a change note to inform your subscribers of what changed in this version.
  5. When you’re ready, click on the “Submit” button to upload your mod to the Steam Workshop.

Note: the steam workshop app can sometime bug and you need to submit multiple time the mod to be actually submitted. If you see your mod being grayed out on steam workshop, that is probably the reason.

6. Verify on Steam Workshop

  • After submission, your mod should appear on the Steam Workshop page for the game.
  • If you need to update your mod later, repeat the process and include any relevant change notes.

Congratulations! You have successfully uploaded your mod using SteamWorkshopUploader.