Carnometer
Damage and kill meter HUDs for Mycopunk — total damage, rolling DPS, kills, and cores destroyed, each with independent enable/position/color.Carnometer
A BepInEx mod for Mycopunk that adds damage and kill meter HUDs tracking your combat performance during missions.
Features
- Damage HUD: Total damage & DPS, plus a configurable rolling-window recent damage/DPS
- Kill HUD: Targets killed and cores killed, each with per-second rates
- Independent HUDs: Enable, position, and color damage vs kill trackers separately
- Auto-Reset: Stats reset automatically when a new mission starts
- Configurable Position: Anchor each HUD anywhere on screen via config (parented to the reticle)
- Configurable Color: Customize each HUD's value text color via config
- Optional Drag Reposition: Registers with HudRepositionAPI when available for in-game dragging
- Hot-Reload Config: Config file changes are picked up without restarting the game
Getting Started
Dependencies
- Mycopunk (base game)
- BepInEx — BepInExPack for Mycopunk 5.4.2403 or compatible
- SparrohUILib — required UI library
Building
- Clone this repository
- Open the solution in Visual Studio, Rider, or your preferred C# IDE
- Build in Release mode to generate the DLL
Alternatively, use the .NET CLI:
dotnet build --configuration Release
Output: bin/Release/netstandard2.1/Carnometer.dll
Installing
Via Thunderstore (recommended):
- Install with a Thunderstore mod manager (e.g. r2modman or Thunderstore App)
- Ensure SparrohUILib is also installed (declared as a dependency)
Manual installation:
- Install BepInEx and SparrohUILib for Mycopunk
- Place
Carnometer.dllin<Mycopunk Directory>/BepInEx/plugins/
The mod loads automatically through BepInEx when the game starts. Check the BepInEx log for a successful load message.
Configuration
Settings are in <Mycopunk Directory>/BepInEx/config/sparroh.carnometer.cfg.
| Section | Setting | Default | Description |
|---|---|---|---|
General |
Enable Damage HUD |
true |
Enable or disable the damage meter HUD |
General |
Enable Kill HUD |
true |
Enable or disable the kill tracker HUD |
General |
DPS Window |
5 |
Time window (seconds) for rolling DPS |
HUD Positioning |
DamageHUD X |
0.294803 |
Damage HUD X anchor position (0–1) |
HUD Positioning |
DamageHUD Y |
0.285045 |
Damage HUD Y anchor position (0–1) |
HUD Positioning |
KillHUD X |
0.294803 |
Kill HUD X anchor position (0–1) |
HUD Positioning |
KillHUD Y |
0.225045 |
Kill HUD Y anchor position (0–1) |
Colors |
Damage HUD Color |
Rose | Damage value text color (RRGGBB or #RRGGBB) |
Colors |
Kill HUD Color |
Rose | Kill value text color (RRGGBB or #RRGGBB) |
Changes to the config file are reloaded automatically. Enable/disable and anchor updates apply while the game is running.
Note: Upgrading from 2.0.x renames several config keys (Enable Carnometer → Enable Damage HUD, etc.). Old keys
are ignored; set the new ones if you had custom values.
Help
- Mod not loading? Verify BepInEx and SparrohUILib are installed, then check the BepInEx log for errors
- HUD not appearing? Ensure the relevant enable toggle is
trueand you are in a mission with a local player - Stats not resetting? Stats reset when a new mission HUD spawns; leave and re-enter a mission if needed
- Position wrong? Adjust each HUD's X/Y anchors, or drag if HudRepositionAPI is available
Authors
- Sparroh
License
This project is licensed under the MIT License — see the LICENSE file for details.