<aside> ✨

This will cover setting up a new mod locally for official use in Shadows.

</aside>

Mod Configuration

• Navigate to the persistent data folder for Shadows at: \Users\<username>\AppData\LocalLow\ColePowered Games\Shadows of Doubt

• Inside this you should see a folder called ‘Mods’ (if you don’t, you can create one or run the game with the latest update).

• This is the directory where the game will look for local mods (outside of mod.io which is a separate directory with a corresponding name).

• To set up a new mod, create a folder inside this mods folder and name it the same as your mod (although technically the folder name won’t matter).

• Inside this folder, create a new text file and name it ‘ModSettings.txt’. This is the key file the game will look for to configure your mod.

• You can change various parameters within this ModSettings.txt file to set up some details about your mod. A typical example file might look like this:

  {
  	"name": "Example Mod",
  	"version": "1.0",
  	"loadOrderValue": 0,
  	"creator": "ColeJ",
  	"summary": "An example mod for this guide.",
  	"enabled": true,
  	"workshopTags": ["misc"]
  }
  

• You can change the parameters after the ‘:’ to suit your needs.

Uploading to Steam Workshop

• In the steam version of the game you can upload your local mod to the steam workshop for others to easily download.
• To do this, in the mod menu you should see an ‘upload’ button next to the local mod entry. This will initiate the upload.
  • Please note you will not automatically be subscribed to the workshop version of your mod after first upload, but you can do this easily by browsing the workshop and subscribing. The local copy of your mod is separate to the one uploaded to the workshop; that’s why you should see two entries in your mod list if you subscribe; one local and one from steam workshop.
• After your mod has been uploaded, you can continue to update your mod by modifying the local copy you have (you should notice the ‘upload’ button become an ‘update’ button).
• You can also record change logs in the upload/update. To do this, create a text file named ‘ChangeLog.txt’ in the local mod folder (along side the ModSettings.txt). This will be uploaded along with the rest of it.
• You can also upload a preview image of your mod. To do this, name your chosen image ‘Preview.png’ and put it in the local mod folder (along side the ModSettings.txt).

<aside> 💡

If for some reason you want to update your already created mod from another machine, or fresh install of the game etc, but the game doesn’t recognise an existing steam workshop mod, you’ll have to manually add the mod’s ID to the ModSettings.txt file. To do this find the local ModSetting.txt file in the local mod folder, then add or edit the line "workshopID” and add your workshop published item ID after the colon. You can find this by navigating to its workshop page and grabbing the long digit from the URL. After you add this, the game should now recognise this as an existing workshop item, and the button should change from ‘upload’ to ‘update’.

</aside>

Uploading to Mod.io

• The process for uploading to mod.io is done through their web portal. You can upload the local folder containing your mod.
• One difference is that mod.io will not automatically pull meta data from your ModSettings.txt file like steam workshop; you’ll have to enter this manually when you upload using their website.