How to Configure Mods That Use Cupboard's JSON Config System

Find the right file

Mods built on Cupboard store their settings as JSON files rather than the classic config format. After you've launched the game at least once with such a mod installed, look in your instance's config folder for a JSON file named after that mod (or a folder containing one). If you don't see it, launch once more — many mods only generate their config on first run.

Edit it safely

JSON is strict, so a single stray comma can break the whole file. Follow these habits:

1. Back up the file first. Copy it somewhere outside the instance before touching anything.

2. Edit with a proper text editor, not a word processor, so you don't introduce smart quotes or hidden formatting.

3. Change values, not structure. Adjust numbers, booleans (true/false), and strings, but leave the key names and nesting exactly as they are unless the mod's own documentation says otherwise.

4. Validate before launching. Paste the file into any JSON validator to confirm it parses. This catches missing commas and brackets instantly.

Apply and verify

Save the file, then restart the game (a full restart is safer than a reload for config changes). If the mod offers an in-game config screen, changes made there are written back to the same JSON file, so you can use the GUI and the file interchangeably — just don't edit the file while the game is running, or your changes may be overwritten on exit. If something breaks, restore your backup and change one value at a time to find the culprit.