LoadoutImprovements
Expands gear loadouts to 9 slots with paging, renaming, previews, custom icons, and equipped-slot highlighting.
About this mod Author’s original text
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 (Recommended):
- Download and install Mod Manager / r2modman
- The mod will be installed to the correct plugins directory automatically
Manual Installation:
- Install dependencies (BepInExPack_Mycopunk and SparrohUILib)
- Place LoadoutImprovements.dll in your /BepInEx/plugins/ folder
Building
dotnet build --configuration Release
Configuration
Settings are stored at:
/BepInEx/config/sparroh.loadoutimprovements.cfg
Config changes are hot-reloaded from disk while the game is running.
| Section | Option | Default | Description |
|----------|----------------------|---------|-------------------------------------------|
| Keybinds | Scroll Loadout Left |, | Previous loadout page |
| Keybinds | Scroll Loadout Right |. | Next loadout page |
| Keybinds | Rename Loadout | R | Rename the hovered loadout |
| General | Loadout Preview | true | Show upgrade list when hovering a loadout |
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
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- Most mods rely on the game's mod loader — the usual route is a community mod manager (such as r2modman): pick this game, install, and it handles the loader and dependencies.
- For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
- Launch the game to confirm it loaded; mods with listed dependencies need those installed as well.
Install locations vary a lot between mods — the bundled readme is the most reliable guide.
Install these first, or the mod will not work: