PerformanceEnhancedMenu

A BepInEx mod for MycoPunk that optimizes performance for the gear upgrade menu system with caching and computation improvements.

Description

This client-side performance mod addresses significant lag issues in the gear upgrade menus by completely rewriting how upgrade computations are handled. It implements extensive caching systems for expensive operations including upgrade grid lookups, prism connectivity calculations, rarity touching counts, and stat list generation.

The mod specifically optimizes performance for gear with many upgrades (like fully upgraded Globblers and MiniCannons) by caching results of complex calculations that would otherwise be re-computed hundreds of times per frame. This dramatically improves menu responsiveness while maintaining accurate stat calculations.

Getting Started

Dependencies

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

Building/Compiling

1. Clone this repository
2. Open the solution file in Visual Studio, Rider, or your preferred C# IDE
3. Build the project in Release mode

Alternatively, use dotnet CLI:

dotnet build --configuration Release

Installing

Option 1: Via Thunderstore (Recommended)

1. Download and install using the Thunderstore Mod Manager
2. Search for "PerformanceEnhancedMenu" under MycoPunk community
3. Install and enable the mod

Option 2: Manual Installation

1. Ensure BepInEx is installed for MycoPunk
2. Copy PerformanceEnhancedMenu.dll from the build folder
3. Place it in <MycoPunk Game.Directory>/BepInEx/plugins/
4. Launch the game

Executing program

Once installed, the mod works automatically in the gear upgrade menus:

Performance Improvements:

• Faster Menu Navigation: Significantly reduced lag when opening gear details
• Smooth Upgrade Cycling: Instant response when equipping/unequipping upgrades
• Optimized Stat Calculations: Cached results prevent expensive re-computations
• MiniCannon Prisms: Cached prism connectivity avoids repeated graph traversal
• Globbler Upgrades: Cached rarity touching calculations for stat bonuses

System Behavior:

• Automatically detects and caches upgrade grid layouts
• Caches query results for prism connections and rarity counts
• Clears caches when upgrade changes occur to maintain accuracy
• Profiler-friendly with timing information in logs

Help

• Menu still slow? This mod targets specific performance bottlenecks - extremely complex upgrade layouts may still have some latency
• Incompatible with mods? May not be compatible with mods that modify upgrade grid logic or stat calculations
• Wrong stat values? Caching can sometimes get stale - try force-refreshing caches by unequipping/re-equipping upgrades
• Performance worse? Disable the mod if you experience any issues - it caches a lot of data operationally
• Not seeing improvements? This mod primarily affects menus with many upgrades or complex stat calculations
• BepInEx logs? Check logs for detailed timing information and any skipped patches

Authors

• Sparroh
• funlennysub (original mod template)
• @DomPizzie (README template)

License

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