GridSolverCoru

Fork of Sparroh's GridSolverPlus — automatically places selected upgrades on the hex grid.

Key Features

Hex Grid Solver

Select upgrades and let the solver find a valid arrangement on the upgrade grid.

Smart Grid-Expander Detection

• Multiversal Thievery — placed first for maximum grid space
• Boundary Incursion & Edge Fault — placed after MT, before everything else
• Handheld Pocket Universe — inflates cell counts per rarity (Standard=1, Rare=2, Epic=3, Exotic=4)

Improved Reliability

• Snapshot & Restore — failed solves restore your previous layout exactly
• Unequip All — strip all upgrades from the current gear with one click
• Gear-change detection — auto-clears selection when switching gear in an open window
• Selection preserved on failure — keeps highlights so you can deselect one or two and retry

Controls

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

Usage

1. Open a gear upgrade window (Gear Details or Ouro)
2. Hover over an unlocked upgrade and press N to add it to the selection
3. To select multiple upgrades, hold N and hover over each one
4. Press N on a selected upgrade to remove it
5. Click Solve — the solver finds the best arrangement
6. If the solve fails, you can deselect one or two upgrades and try again

Troubleshooting

• Solver refuses to solve: Try clicking Unequip All to clear the grid, then select only the upgrades you want to place and hit Solve. This gives the solver a completely empty grid to work with.
• Solver moves things it shouldn't: The solver only rearranges the upgrades you selected. Any upgrades you didn't select stay exactly where they are. If unexpected movement happens, use Unequip All and try solving again with a clean grid.
• Missing controls: If the Solve / Cancel / Unequip All buttons aren't visible, make sure a gear upgrade window is open. The buttons only show while you're editing a weapon, character, or ouro gear.

Installation

Thunderstore

1. Install BepInExPack_Mycopunk.
2. Install SparrohUILib by Sparroh.
3. Install this mod through your mod manager.
4. Launch the game.

Manual

1. Install BepInExPack_Mycopunk as above.
2. Install SparrohUILib as above.
3. Extract GridSolverCoru.dll into BepInEx/plugins/ in your Mycopunk directory.
4. Launch the game.

Requirements

• Mycopunk, obviously
• BepInExPack_Mycopunk
• SparrohUILib by Sparroh

Changelog

See CHANGELOG.md.

Credits

• funlennysub — Original UpgradeSolver (GitHub | Thunderstore)
• Sparroh — GridSolverPlus fork with major enhancements (GitHub | Thunderstore)
• Coruscnium — GridSolverCoru fork with MT/HPU/Edge Fault support, gear-change detection, Unequip All, and snapshot/restore

License

GNU General Public License v3.0

Changelog

1.1.0

• Rewrote the auto-placer. The old solver was a naive backtracker with no pruning that ran one placement per frame — on simple repeated shapes (e.g. 5 identical Y-shaped upgrades) it would leave 1-cell gaps and endlessly rotate the smaller pieces, and on tight sets it could appear frozen for minutes. It is now a bitmask packer with area, connected-region, most-constrained-piece, and exact-cover pruning. Typical layouts solve in milliseconds, and genuinely impossible sets are reported quickly instead of hanging.
• Handheld Pocket Universe now moves. HPU is positioned by the solver alongside the other upgrades instead of being forced into the first free slot, so it no longer defaults to the top-left corner.
• Fixed a false "no solution" case. Region pruning could reject layouts that actually fit when they left a small empty pocket; the packer now only rejects sets that are truly impossible.
• Boundary Incursion, Multiversal Thievery, Edge Fault, and Handheld Pocket Universe support is otherwise unchanged.

1.0.0

• Fork of Sparroh's GridSolverPlus with major enhancements
• Handheld Pocket Universe support: Inflates upgrade cell counts per rarity (Standard=1, Rare=2, Epic=3, Exotic=4)
• Multiversal Thievery support: Grid-expander, placed before all other expanders (adds up to 3 columns)
• Edge Fault support: Grid-expander, placed alongside Boundary Incursion (adds column/row)
• Four-tier placement priority: Major expanders (MT) → Minor expanders (BI, EF) → Cell modifiers (HPU) → Everything else
• Unequip All button: Clear all upgrades from the current gear with one click
• Gear-change detection: Auto-clears selection when switching gear inside an open window
• Selection preserved on failure: Failed solves keep your selection so you can deselect one or two and retry
• Snapshot and restore: Failed solves restore your previous upgrade layout exactly
• Robust reflection: Base-type walking for private field access, cross-gear ownership validation