IncursionTracker

IncursionTracker

A BepInEx client-side mod for Mycopunk that adds a compact HUD for tracking Incursion mode stats.

Features

Tracks the following during an Incursion run:

• Mission time – elapsed time since the Incursion objective started (pauses when the in-game remaining timer is

stopped, e.g. elevators, inter-floor waits, or timer expiry)

• Remaining time – synced mission countdown
• Floor – current floor number (includes +5 jumps from door codes)
• Abominations killed – boss-room abominations defeated
• Levers pulled – time levers activated
• Door codes input – successful keypad code entries

Floor 30 freeze

Optional config toggle (Stop Tracking At 30, default off) freezes all trackers once you reach floor 30, so your

“run to 30” stats stay locked while you continue deeper.

HUD

• Compact multi-line panel (Mission, Remaining, Floor, Aboms, Levers, Codes)
• Only visible during an active Incursion
• Can be fully disabled via config
• Position and colors are configurable
• Supports drag-to-reposition when a HudReposition API provider is installed

Dependencies

• Mycopunk
• BepInEx – BepInExPack for Mycopunk 5.4.2403 or compatible
• SparrohUILib – required for HUD rendering

Building

dotnet build --configuration Release

Output DLL: bin/Release/netstandard2.1/IncursionTracker.dll

Installing (recommended)

Install with your mod manager (pulls in SparrohUILib automatically).

Manual

• Install SparrohUILib
• Place IncursionTracker.dll in /BepInEx/plugins/

Configuration

Config file: BepInEx/config/sparroh.incursiontracker.cfg

| Setting | Section | Default | Description |

|------------------------|-----------------|-------------|------------------------------------------------------------------|

| Enable Incursion HUD | General | true | Show or hide the tracker HUD |

| Stop Tracking At 30 | General | false | Freeze all trackers once floor 30 is reached |

| Tracker X | HUD Positioning | 0.6512445 | Horizontal anchor (0–1) |

| Tracker Y | HUD Positioning | 0.93617 | Vertical anchor (0–1) |

| Tracker Color | Colors | amber | Value color while tracking (hex RRGGBB or #RRGGBB) |

| Frozen Color | Colors | muted | Value color when trackers are frozen (hex RRGGBB or #RRGGBB) |

Config reloads automatically when the file changes on disk.

Notes

• Client-side only; works as host or client.
• Late joiners only track stats from the moment they join.
• Floor display uses the game’s current floor (including code-skip jumps).

Authors

• Sparroh

License

MIT – see LICENSE