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

1. Clone this repository
2. Open the solution in Visual Studio, Rider, or your preferred C# IDE
3. 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):

1. Install with a Thunderstore mod manager (e.g. r2modman or Thunderstore App)
2. Ensure SparrohUILib is also installed (declared as a dependency)

Manual installation:

1. Install BepInEx and SparrohUILib for Mycopunk
2. Place Carnometer.dll in <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 true and 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.