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

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