Overview
Describes how to upload a mod for Pillars of Eternity II: Deadfire to the Steam Workshop.
Introduction
This guide will walk you through the process of uploading your mods for Pillars of Eternity II: Deadfire to the Steam Workshop.
This guide doesn’t cover the process of actually creating a mod. For tutorials and information on creating your own mods, check out this tutorial[forums.obsidian.net] on our official modding forums[forums.obsidian.net].
Uploading a Mod
Mods are stored in the directory <steam-library>steamappscommonPillars of Eternity IIPillarsOfEternityII_Dataoverride. Each mod is stored in its own subdirectory of this directory.
First, you need to indicate that you are developing the mod you want to upload. Create a file called devmode.json in the override folder, if it doesn’t exist already.
Open the file in a text editor and paste the following text into it.
Now add the folder names of the mod or mods you’re working on to the DevMode list. The names should have quotes around them and be separated by commas. For example, if I was developing the modder-background and penguin-sword mods, my devmode.json would look like this:
By default, the thumb.png file in your mod folder will be used as the thumbnail icon in the Workshop. Optionally, if you create an image called steam-thumb.jpg in your mod folder, that image will be used instead. The recommended size for steam-thumb.jpg is 512×512.
Now launch the game. On the main menu, navigate to the Mod Manager (click Options, then click Mod Manager). Each mod you indicated in DevMode should have a Steam button on its entry.
Click the Steam button for the mod you want to upload. Review the text in the message that appears. If you have not accepted the Steam Workshop Terms of Service, follow the link and review and accept the terms.
If you agree with all the terms, click “Accept”. You’ll see a few progress bars. Once the mod is finished uploading, the Steam Workshop page for the newly-created mod will open in your browser. Here, you can write a full description for the mod, upload images, and set up other data.
Once you’re satisfied with the mod’s page, you just need to set it as visible to the public from the Change Visibility dropdown.
Your mod is now available for players to download and play with!
Updating a Mod
If you make changes to your mod after releasing it, you can easily update the Workshop version.
After changing the mod, open the Mod Manager and click the Steam button next to your mod again (your mod will still need to be included in devmode.json). This time, you’ll be presented with a window where you can briefly describe what you changed. Enter your description, then click Accept.
Your update will be uploaded to the workshop and be available to players immediately.
