UpgradeFiltering
Advanced upgrade filtering and customizable priority sorting for the gear details menu.
About this mod Author’s original text
Upgrade Filtering
A BepInEx mod for Mycopunk that adds advanced filtering and customizable priority sorting to the gear upgrade menu.
Originally split out from Enhanced Upgrade Menu as a focused standalone mod.
Features
Filter Panel
- Toggle a filter panel from the gear action bar (Filter)
- Hide upgrades by rarity (Standard, Rare, Epic, Exotic, Oddity)
- Filter by favorites (Show All, Only Favorite, Hide Favorite)
- Filter by upgrade stats / properties (context-aware for upgrades vs skins)
- Clear all filters with one click
Priority Sort
- Fully customizable multi-criteria sort order
- Open from the gear action bar (Upgr. Sort)
- Drag-and-drop reordering of sort priorities
- Criteria include favorites, locked/unlocked, rarity, trash/turbo status, recently used/acquired, and name
- Save, Cancel, and Reset controls
- Priority order is saved between sessions
Stat Display Formatting
- Optional reformatting of upgrade stats from 50 Damage to Damage: 50
- Does not affect directive window hover information
- Toggleable in config (disabled by default)
Getting Started
Dependencies
- Mycopunk (base game)
- BepInEx 5.4.2403 or compatible (BepInExPack for Mycopunk)
- SparrohUILib 1.2.2 or compatible
Building
- Clone this repository
- Open the solution in Visual Studio, Rider, or your preferred C# IDE
- Build the project in Release mode to generate the.dll
Alternatively, use the.NET CLI:
dotnet build --configuration Release
Installing (recommended)
- Install via a mod manager
- Dependencies (including SparrohUILib) are installed automatically
Manual installation
- Install BepInEx and SparrohUILib
- Place UpgradeFiltering.dll in /BepInEx/plugins/
The mod loads automatically through BepInEx when the game starts. Check the BepInEx console for a load confirmation
message.
Configuration
Settings are in:
/BepInEx/config/sparroh.upgradefiltering.cfg
| Setting | Section | Default | Description |
|-----------------|---------|---------|-------------------------------------------------|
| Enable Reformat | General | false | Force Key: Value stat format on upgrade stats |
Priority sort order is stored via the game's player options (SortPriority.Order).
Usage
- Open a gear details window
- Click Filter on the gear action bar to open the filter panel
- Click Upgr. Sort to open the drag-and-drop priority editor
- Arrange criteria, then click Save to apply (or Reset to restore defaults)
Help
- Mod not loading? Verify BepInEx and SparrohUILib are installed, then check console logs for errors
- Filter panel missing? Open gear details first, then click Filter on the action bar
- Priority sort not applying? Open Upgr. Sort, arrange criteria, then click Save
- UI elements missing? Confirm mod and SparrohUILib version compatibility
Authors
- Sparroh
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: