SettingsExtenderForked

Settings Extender Forked

A small framework that lets modders add pages to the game's settings menu to edit mod settings in-game.

Updated fork from the original mod made by JSPAPP

Who is this for?

• Players: Mods use this to have their settings appear in‑game.
• Modders: Add in-game settings using the existing settings menu and types found in the base game. Add toggles, sliders, or keybinds — this plugin makes it quick to add them to the Settings menu without building custom menus yourself.

What it does

• Creates a new tab for your mod in the game’s Settings menu.
• Adds your options (sliders, toggles, enums, buttons, keybinds) to that tab.

Features

• Easy setup with an attribute that declares the tab and display name.
• Base classes for common setting types (Bool, Float, Int, String, Enum, Keybind, Button).
• One‑line helper to register settings.
• Built‑in fixes for stability and text handling.

Quick example

using SettingsExtender;
using Zorro.Settings;

[ExtenderSetting(page: "CoolMod", displayName: "Enable Cool Feature")]
internal class CoolFeatureToggle : ExtenderBoolSetting
{
    public CoolFeatureToggle() : base(_ => CoolModPlugin.Instance.ApplySettings()) {}
    protected override bool GetDefaultValue() => true;
}

// Register once (e.g., in Start)
coolFeatureToggle = SettingsHandler.Instance.AddSetting();

This declares a toggle on a new CoolMod tab and registers it in one line. The value is available via coolFeatureToggle.Value, and your callback runs when it changes.

Guides

• See README.md, HOWTOUSE.md, and HelloWorld.cs on the github page.