ModConfig

ModConfig

Universal mod configuration framework for Slay the Spire 2

ModConfig adds a “Mods” tab to the game’s Settings screen. It provides a universal in-game interface where mod settings can be adjusted without editing config files or restarting the game.

Other mods integrate with ModConfig via API and automatically display their configuration options (toggles, sliders, dropdowns, keybinds, text inputs, etc.) in this tab.

Supported Control Types

• Toggle — On/off switches

• Slider — Numeric range with step control

• Dropdown — Selection from a list of options

• KeyBind — Hotkey binding with clear support

• Text Input — Free text with optional validation

• Color Picker — Visual color selection

• Headers & Separators — Section grouping and visual dividers

For Players

Install ModConfig alongside any mod that supports it. A new “Mods” tab will appear in Settings where you can adjust all mod options in one place. Changes apply immediately — no restart needed.

Currently used by:

• Skada

• SpeedX

• Rewind

• QuickLink

• And growing

For Mod Authors

Integration is zero-dependency — mods call ModConfig via reflection, so they work even if ModConfig isn’t installed. No DLL reference required.

• Register config entries with one method call per control

• UI updates instantly when values change (live refresh)

• Keybinds support clearing (press Delete/Backspace to unbind)

• Text input validators are safely wrapped — third-party errors won’t break saves

• Persistent storage is handled automatically

Integration guide & source code:
Github – xhyrzldf/ModConfig-STS2

Installation

Extract the following files into:

<Game Install>/mods/ModConfig/

• ModConfig.dll

• ModConfig.pck

• ModConfig.json

Compatibility

• Windows / macOS / Linux — cross-platform (AnyCPU build)

• Bilingual: English & 简体中文 (auto-detected)

• Does not conflict with other mods

• Does not affect saves or gameplay