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

1. Install SparrohUILib
2. Place IncursionTracker.dll in <Mycopunk>/BepInEx/plugins/

Configuration

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

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

Changelog

1.0.3

• Migrated HUD rendering to SparrohUILib
• Added configurable HUD position (Tracker X / Tracker Y) and optional HudReposition API support
• Added configurable tracker colors (active and frozen)
• Changed Stop Tracking At 30 default from on to off
• Renamed config entries for clearer BepInEx labels
• HUD rebuilds correctly after returning to the menu

1.0.2

• Added UI reload after exiting to the menu

1.0.1

• Mission total time now pauses when the in-game remaining timer is stopped (elevators, inter-floor waits, timer expiry)
• Nudged tracker HUD slightly toward center so it sits fully on-screen
• Fixed door codes being double-counted on host (SendTo.Everyone RPC Send+Execute)
• Fixed tracker HUD not appearing due to patch init failure from RPC stage reflection

1.0.0

• Initial release
• Incursion HUD tracking: mission time, remaining time, floor, abominations, levers, door codes
• Optional freeze-at-floor-30 config toggle
• Compact multi-line HUD