ModSettingsMenu

A BepInEx mod for MycoPunk that provides an in-game GUI for editing mod configuration files, plus a quality-of-life HUD Reposition Mode for click-and-drag layout of mod HUD elements.

Description

This mod allows players to edit configuration settings for other installed mods directly within the game interface, without needing to manually edit .cfg files. It parses BepInEx configuration files and presents them in an organized GUI.

Adapted from ToeKneeRED's MycoModList.

Features

• In-game GUI for editing mod configuration files
• Default F10 keybind to toggle the config menu (rebindable in-game)
• "Mod Config" button in the main menu when the menu is open
• Support for editing boolean toggles, integer/float inputs, text strings, and dropdown selections
• Configuration entries organized by file sections
• Automatic saving of changes to .cfg files
• Visual indicators for sandbox mods
• Multi-mod support displaying all installed mods with configs
• HUD Reposition Mode (default F9) — click and drag registered HUD elements; positions write back to each mod's AnchorX/AnchorY config

Dependencies

• MycoPunk (base game)
• BepInEx - Version 5.4.2403 or compatible
• .NET Framework 4.8
• HarmonyLib (included via NuGet)

Installation

1. Install BepInEx for MycoPunk
2. Download the mod from Thunderstore or place the .dll file in <MycoPunk Directory>/BepInEx/plugins/
3. Launch the game - the mod loads automatically through BepInEx

Usage

• Press F10 (or your configured key) to open the mod configuration GUI
• Alternatively, open the main menu and click the "Mod Config" button
• Select a mod from the list to view and edit its configuration options
• Changes are saved automatically when modified

HUD Reposition Mode

• Press F9 (or your configured key), or click Reposition HUDs in the main menu / Mod Config title bar
• Drag highlighted HUD elements to the desired position
• Coordinates (0–1 anchors) update live and are saved when you release the mouse
• Press Esc or the toggle key again to exit

Compatible HUD mods register themselves via the API. Unregistered mods that expose *AnchorX / *AnchorY config pairs may still be auto-detected when their HUD objects exist under the reticle.

Configuration

The mod itself has configurable settings:

• ToggleModConfigGUI: Key to open the config menu (default: F10)
• ToggleHudReposition: Key to enter HUD reposition mode (default: F9)

Both can be rebound in-game by clicking the input field in the Mod Config GUI.

For mod authors — HudRepositionAPI

Register your HUD after creating its RectTransform, and unregister on destroy:

// Soft dependency (recommended) — copy HudRepositionClient.cs.example into your project
HudRepositionClient.Register(
    id: "your.mod.guid",
    displayName: "My HUD",
    rect: containerRect,
    anchorX: myAnchorX,   // ConfigEntry<float> 0-1
    anchorY: myAnchorY);

// On destroy / when HUD is destroyed:
HudRepositionClient.Unregister("your.mod.guid");

Or call HudRepositionAPI directly if you reference ModSettingsMenu.dll.

Convention:

• Section: [HUD Positioning]
• Keys: {Name}AnchorX / {Name}AnchorY as floats in 0–1 (anchorMin = anchorMax)
• Parent under the player reticle (or any screen-space canvas)
• Listen to SettingChanged on the config entries to apply anchors live

Help

• Mod not loading? Ensure BepInEx is installed and the .dll is in the correct plugins folder
• Configs not showing? The mod only displays mods that have .cfg files in the BepInEx config directory
• Keybind not working? Check for conflicts with other mods or rebind it in the GUI
• GUI not appearing? Verify the game is running and try toggling with the menu button
• HUD not draggable? Ensure the HUD is visible (in-mission), registered via the API, or has matching AnchorX/Y config keys

Authors

• Sparroh

License

This project is licensed under the MIT License - see the LICENSE file for details

Changelog

Unreleased

Fixes

• Scroll wheel — each wheel notch now advances the config list by one item (was nearly unusable at 0.1 sensitivity)
• Accidental edits — toggles only flip on a clean click (not drag-pan); text fields require an explicit click to start editing and save on end-edit; scrolling or drag-panning clears focus and closes dropdowns

1.2.0 (2026-07-10)

Features

• HUD Reposition Mode — click-and-drag HUD elements instead of typing X/Y anchors
• Default F9 keybind to toggle reposition mode (rebindable in-game)
• "Reposition HUDs" button in the main menu and Mod Config title bar
• Public HudRepositionAPI for other mods to register draggable HUD elements
• Optional auto-detect of *AnchorX / *AnchorY config pairs under the reticle
• Live coordinate labels while dragging; positions saved to BepInEx configs on release

Technical

• Soft-dependency friendly registration API (HudRepositionAPI.Register / Unregister)
• Example soft-dependency client helper: HudRepositionClient.cs.example

1.1.1 (2026-01-09) Changes

Button Adjustments
Lost this update, it never made it to github.

1.1.0 (2025-12-24)

Features

• Support for dropdown selections for configuration entries with predefined acceptable values

1.0.0 (2025-08-19)

Features

• In-game GUI for editing mod configuration files
• Default F10 keybind to toggle config menu (rebindable in-game)
• "Mod Config" button in main menu when menu is open
• Support for editing boolean toggles, integer/float inputs, and text strings
• Organized display by config file sections
• Automatic saving of changes to .cfg files
• Sandbox mod indicators in the GUI
• Multi-mod support showing all installed mods with configs
• Adapted from ToeKneeRED's MycoModList

Technical

• Adapted from ToeKneeRED's MycoModList
• Built with BepInEx framework and HarmonyLib
• Parses standard BepInEx .cfg configuration files
• GUI created as Unity overlay compatible with MycoPunk
• Key rebinding functionality with real-time feedback

Tech

• Initial mod template setup with BepInEx framework
• Add MinVer for version management
• Add thunderstore.toml configuration for mod publishing
• Add LICENSE.md and CHANGELOG.md template files
• Basic plugin structure with HarmonyLib integration
• Placeholder for mod-specific functionality