Loadout Improvements

A BepInEx mod for Mycopunk that expands and improves gear loadout management.

Features

• Expanded Loadouts: Up to 9 loadout slots per gear piece, navigated in pages of 3
• Loadout Scrolling: Configurable left/right keys to page through loadout slots
• Rename Loadouts: Hover a loadout and press the rename key to give it a custom name
• Loadout Preview: Optional text preview listing upgrades when hovering a loadout
• Custom Loadout Icons: Loadout icons can use equipped upgrade icons
• Equipped Loadout Highlight: Loadout slots whose contents match your currently equipped upgrades invert colors — the fill uses your UI color and the icon turns black

Getting Started

Dependencies

• Mycopunk (base game)
• BepInEx - Version 5.4.2403 or compatible (BepInExPack_Mycopunk)
• SparrohUILib - Required for UI components (text preview, rename dialog)
• HarmonyLib (included via BepInEx)

Installing

Via Thunderstore (Recommended):

1. Download and install via Thunderstore Mod Manager / r2modman
2. The mod will be installed to the correct plugins directory automatically

Manual Installation:

1. Install dependencies (BepInExPack_Mycopunk and SparrohUILib)
2. Place LoadoutImprovements.dll in your <Mycopunk Directory>/BepInEx/plugins/ folder

Building

dotnet build --configuration Release

Configuration

Settings are stored at:

<Mycopunk Directory>/BepInEx/config/sparroh.loadoutimprovements.cfg

Config changes are hot-reloaded from disk while the game is running.

Help

• Mod not loading? Verify BepInEx and SparrohUILib are installed, then check the BepInEx log for errors
• Keybinds not working? Check for conflicts with other mods or game binds
• Can't see extra loadouts? Use the scroll keys to move between pages (slots 1–3, 4–6, 7–9)
• Rename not working? Hover a loadout button first, then press the rename key

Authors

• Sparroh
• Coloron (Loadout Expander)

License

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

Changelog

1.2.2

• Refactor
• Rename loadout dialog now uses SparrohUILib (themed modal with input field) instead of the legacy hand-rolled box

1.2.1

• Equipped loadout highlight now inverts icon/fill: fill uses your UI color (Global.UIColor), icon turns black
• Replaces the previous gold icon tint

1.2.0

• Highlight loadout slots that match currently equipped upgrades (content match)
• Active slot's loadout icon is tinted gold; updates on equip, save, upgrade changes, and page scroll

1.1.0

• Initial standalone release of Loadout Improvements
• Split loadout features out of Enhanced Upgrade Menu
• Expanded loadouts (9 slots) with page scrolling
• Loadout renaming with configurable keybind
• Optional text loadout preview on hover
• Custom loadout icons from equipped upgrades

1.0.0

• Expanded loadout system with 9 customizable loadout slots
• Loadout icons use equipped upgrade icons instead of generic defaults
• In-game loadout renaming with dialog popup (press rename key while hovering)
• Enhanced loadout button tooltips with custom names and rename instructions
• Automatic loadout array expansion and UI button management
• Save/load/equip functionality patched for expanded slot support
• Add thunderstore.toml for tcli
• Add LICENSE and CHANGELOG.md