You are viewing a potentially older version of this package. View Latest Version
IncursionTracker
Tracks Incursion mission stats with a compact HUD: mission time, remaining time, floor, abominations killed, levers pulled, and door codes input.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
Via Thunderstore (recommended)
Install with your mod manager (pulls in SparrohUILib automatically).
Manual
- Install SparrohUILib
- Place
IncursionTracker.dllin<Mycopunk>/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