Sparroh-GridSolverPlus icon

GridSolverPlus

Automatically place selected upgrades on the hex grid. Hover and press N to select, then Solve.

Last updated 21 hours ago
Total downloads 11
Total rating 0 
Categories Client-Side
Dependency string Sparroh-GridSolverPlus-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack_Mycopunk-5.4.2403 icon
BepInEx-BepInExPack_Mycopunk

BepInEx pack for Mycopunk. Preconfigured and ready to use.

Preferred version: 5.4.2403
Sparroh-SparrohUILib-1.1.1 icon
Sparroh-SparrohUILib

Shared UI library for Sparroh Mycopunk mods. Provides themed widgets, HUD builders, windows, and resolution-aware layout.

Preferred version: 1.1.1

README

GridSolver+

A BepInEx mod for MycoPunk that automatically finds and places optimal upgrade arrangements on the hex grid.

Originally extracted from EnhancedUpgradeMenu as a standalone solver.

Features

  • Hex Grid Solver: Select upgrades and automatically place them in a valid layout
  • Rotation support: Tries unique rotations when the player can rotate upgrades
  • Boundary Incursion aware: Prioritizes and accounts for grid-expanding upgrades
  • Works in Gear Details and Ouro gear windows
  • Solve / Cancel / Clear controls while the upgrade window is open

How to use

  1. Open a gear upgrade window
  2. Hover an unlocked upgrade and press N to select or deselect it
  3. Click Solve to auto-place the selected upgrades
  4. Use Cancel to stop a running solve, or Clear to deselect everything

Selected upgrades are highlighted. Non-stackable upgrades of the same type replace each other in the selection.

Getting Started

Dependencies

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

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 to generate the .dll file

Alternatively, use dotnet CLI:

dotnet build --configuration Release

Installing

Via Thunderstore (Recommended):

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

Manual Installation:

  1. Place the built GridSolverPlus.dll in your <MycoPunk Directory>/BepInEx/plugins/ folder

Executing program

The mod loads automatically through BepInEx when the game starts. Check the BepInEx console for a GridSolverPlus load message.

Help

  • Mod not loading? Verify BepInEx is installed correctly and check console logs for errors
  • Solve button missing? Open a gear upgrade window (Gear Details or Ouro)
  • Selection not working? Hover an unlocked upgrade and press N
  • No solution found? The selected set may not fit; try fewer upgrades or include Boundary Incursion if needed

Authors

  • Sparroh
  • funlennysub (original Hex Grid Solver)

License

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