Modding add equipment

This page is a work in progress. It will walk through the process of adding a new item, a shield. The focus is on getting something simple which you can see in the game, and adding more details later. The description and screenshots are current as of November 2019, early access version 0.10+98 Ryvio Wartmarch.

Getting started

1. Select "Tools" at the main game screen, then "Open Editor", then "Content and Comics Editor"
2. At the upper left, click "Mods", click "Create New Mod" in the browser, and fill in the form. This will pop up a file browser showing the files the tool just created; note that the directory is steam\steamapps\common\wildermyth\mods\user\<your mod name>. You will use this directory soon.
3. Click the "save" button and then exit. Most of the work for this mod is done outside the in-game editor; the editor doesn't appear to support creating items yet.

Modifying the files

1. Using a file explorer, navigate to the game install directory: steam\steamapps\common\Wildermyth\assets. We need to copy, and then modify three files: data\aspects\items.json, data\items\offHand.json, and text\aspects\aspects.properties. For each of these files, make new folders as required, then copy (don't move!) the files into the corresponding area of your mod. That is, copy file Wildermyth\assets\data\aspects\items.json to Wildermyth\mods\user\<your mod name>\assets\data\aspects\items.json.
2. Create a new effect by editing items.json.

Seeing the effect in game

1. If you haven't already done so, enable the debug panels in the game. (Save and exit before doing this.) In file explorer, create an empty file under steam\steamapps\common\Wildermyth called devmode.txt.
2. Start a new one chapter story. Choose your mod in the mod picklist, and check "enable cheats". You don't need to select any of the sub-options under cheats for this project.
3. When the game starts, click through the initial dialog to get to the first battle.
4. Pick one of your characters, open the detail view, and click the gear tab. You will see a cheat menu that allows you to select any kind of item and equip it. Try out your items!