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.

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.

Changelog

2.1.0

• Refactor
• Split into two independent HUDs: Damage HUD and Kill HUD
• Separate enable toggles, positions, and colors for each HUD
• Kill HUD defaults slightly below the damage HUD so both are visible on first load
• Config keys renamed (Enable Carnometer → Enable Damage HUD / Enable Kill HUD, etc.)

2.0.1

• Recreate UI after returning to the main menu so the HUD loads correctly on the next mission

2.0.0

• Initial standalone release (split from ExpandedHUD)
• Damage meter HUD with total damage, rolling DPS, kills, and cores destroyed
• Configurable enable toggle, DPS window, HUD anchor position, and value color
• Auto-reset on mission start
• Integration with SparrohUILib and optional HudRepositionAPI support

1.1.0

• HUD visibility toggle with F5 key
• HUD positioning at reticle location
• Kill-per-second and core-kill-per-second statistics
• Enhanced UI with TextMeshPro text components
• Proper mission-end reset functionality

1.0.1

• 5-second rolling damage window for DPS calculation
• Configurable DPS window duration via BepInEx config

1.0.0

• Initial release packaging (MinVer, thunderstore.toml, LICENSE, CHANGELOG)