Necropolis Mod Config Menu

No more alt-tabbing to Notepad to edit config files. This mod automatically reads your BepInEx configs and displays them in-game with a native UI.

What It Does

• Automatic mod detection - Scans BepInEx/plugins and finds all mods with config files
• In-game configuration - Access from main menu or pause menu via "Mods" button
• Displays plugin info - Shows author, version, and GUID for each mod
• Multiple setting types:
  • Bool (toggles)
  • Int/Float (sliders with adjustable ranges)
  • KeyCode (rebindable keys with duplicate detection)
  • Enums (cycle through values)
• Smart key rebinding:
  • Real-time conflict detection across all mods
  • Protected/Forbidden keys (WASD mouse buttons, menu navigation etc). Can be bypassed using a config option.
  • Gamepad button support (see warning below)
• Reset button - Restore defaults when you inevitably break something
• Live updates - Some settings apply immediately, others save when closing the menu (depends on how each mod implements their config)
• Native UI integration - Uses the game's existing menu system and style

⚠️ Note on Gamepad Rebinding
You can enable gamepad button rebinding via AllowForbiddenKeyRebind in MCM's settings, but this is experimental. The protected keys exist for a reason - turning this off might break menu navigation. Use at your own risk.

Installation

Manual

1. Install BepInExPack Necropolis (5.4.23 or newer)
2. Extract ModConfigMenu.dll to Necropolis/BepInEx/plugins/
3. Launch the game

Mod Manager

Install via Thunderstore mod manager (r2modman recommended)

Usage

Main Menu: "Mods" button below "Restart"
In-Game: Pause → "Mods"

Select any mod to view and edit its settings. Changes save automatically (most of the time - depends on how each mod implements their config). Use the reset button when things go sideways.

Controls
Keyboard: Arrow keys, Enter/Space (confirm), ESC (back)
Gamepad: D-Pad/Stick, A/Cross (confirm), B/Circle (back)

Key Rebinding
Select a key setting → Press any key/button → ESC to cancel
Critical keys are blocked by default (WASD, I/R, mouse, menu navigation). Turn on AllowForbiddenKeyRebind at your own risk.

Configuration

Settings in BepInEx/config/komikoza.necropolis.modconfigmenu.cfg:

• EnableLogging (default: false) - Debug logging for troubleshooting
• ShowUnsupportedTypes (default: false) - Display read-only settings (strings, etc.)
• AllowForbiddenKeyRebind (default: false) - Remove key protection (can break menu navigation)

For Mod Developers

Your mod configs appear automatically. Supported types:

• bool - Toggle
• int - Slider (AcceptableValueRange required)
• float - Slider (AcceptableValueRange required)
• KeyCode - Rebindable key
• enum - Cycle through values

Example:

Config.Bind("General", "ModEnabled", true, "Enable this mod");
Config.Bind("Controls", "DodgeKey", KeyCode.LeftShift, "Key for dodging");
Config.Bind("Gameplay", "Difficulty", DifficultyLevel.Normal, "Game difficulty");
Config.Bind("Gameplay", "DamageMultiplier", 1.0f, 
    new ConfigDescription("Damage multiplier", new AcceptableValueRange<float>(0.5f, 2.0f)));

Configs without AcceptableValueRange for int/float will show as read-only text.

Compatibility

• BepInExPack Necropolis 5.4.23+ required
• Works with any mod using BepInEx ConfigFile
• No conflicts with other mods spotted

Known Issues

• String configs are read-only (no text input UI yet)
• Very long config names may overflow on 16:9 displays

Changelog

1.0.3

• Fixed plugin filename convention.

1.0.2

• Initial Thunderstore release (previous versions were shared around Necropolis Discord)
• Fixed: Game action keys (WASD, QER, etc.) now properly blocked during rebind by default
• Fixed: Color tags in modal dialogs now display correctly
• Added: Try-catch to all Harmony patches for better stability
• Improved: Consistent logging format with [ModConfigMenu] prefix

Credits

Author: KoMiKoZa
Discord: komikoza

Special thanks to the Necropolis modding community for testing and feedback.

Support

• Website: Mod Documentation
• Source Code: GitHub
• Issues: Report bugs on Discord or GitHub Issues