Shapez Settings

A mod settings framework for Shapez 2. Adds a Mods tab to the vanilla Settings screen where any mod can register configurable options with native UI controls. Players get toggles, sliders, and dropdowns that look and feel like vanilla settings. Values persist automatically to JSON files. For Mod Authors Quick Start Add ShapezSettings as a dependency in your manifest.json: { "Dependencies": [ { "ModId": "local:ShapezSettings", "ModTitle": "Shapez Settings", "Version": "0. 1.*" } ] } Add a reference to ShapezSettings.dll in your .csproj: $(SPZ2_PERSISTENT)\mods\ShapezSettings\ShapezSettings.dll False Register your settings in your mod's constructor: using ShapezSettings; public class MyMod : IMod { private ModSettingsHandle _settings; public MyMod() { _settings = ShapezSettingsAPI. RegisterMod("my-mod", "My Mod", b => { b. AddBool("debug-logging", "Debug Logging", defaultValue: false); b. AddFloat("speed", "Movement Speed", defaultValue: 5f, min: 1f, max: 20f); b. AddEnum("difficulty", "Difficulty", new[] { "Easy", "Normal", "Hard" }, defaultIndex: 1); }); } public void Dispose() { } } Read setting values anywhere in your code: bool debug = _settings. GetBool("debug-logging"); float speed = _settings. GetFloat("speed"); int difficulty = _settings. GetEnum("difficulty"); // 0=Easy, 1=Normal, 2=Hard React to changes in real-time: _settings. OnChanged(settingId => { Debug. Log($"Setting '{settingId}' changed!"); }); Translation Keys Settings display names come from the game's localization system. Add these keys to your mod's translations.json: { "en-US": { "menu.settings.mod.my-mod": "My Mod", "setting.my-mod.debug-logging": "Debug Logging", "setting.my-mod.debug-logging.description": "Enable verbose debug output", "setting.my-mod.speed": "Movement Speed", "setting.my-mod.speed.description": "How fast things move", "setting.my-mod.difficulty": "Difficulty", "setting.my-mod.difficulty.description": "Game difficulty level" } } API Reference ShapezSettingsAPI. Registe