Sparroh-Carnometer icon

Carnometer

A damage meter HUD for Mycopunk showing total damage, rolling DPS, kills, and cores destroyed.

Last updated 18 hours ago
Total downloads 7
Total rating 0 
Categories Client-Side
Dependency string Sparroh-Carnometer-2.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack_Mycopunk-5.4.2403 icon
BepInEx-BepInExPack_Mycopunk

BepInEx pack for Mycopunk. Preconfigured and ready to use.

Preferred version: 5.4.2403
Sparroh-SparrohUILib-1.1.1 icon
Sparroh-SparrohUILib

Shared UI library for Sparroh Mycopunk mods. Provides themed widgets, HUD builders, windows, and resolution-aware layout.

Preferred version: 1.1.1

README

Carnometer

A BepInEx mod for Mycopunk that adds a damage meter HUD tracking your combat performance during missions.

Features

  • Total Damage & DPS: Tracks cumulative damage dealt and average damage per second over the mission
  • Rolling Window DPS: Configurable recent-damage window (default 5 seconds) for short-term DPS
  • Targets Killed: Kill count with kills-per-second rate
  • Cores Killed: Separate counter for enemy cores destroyed
  • Auto-Reset: Stats reset automatically when a new mission starts
  • Configurable Position: Anchor the HUD anywhere on screen via config
  • Hot-Reload Config: Config file changes are picked up without restarting the game

Getting Started

Dependencies

  • Mycopunk (base game)
  • BepInEx - Version 5.4.2403 or compatible
  • .NET Framework 4.8
  • HarmonyLib (included via NuGet)

Building/Compiling

  1. Clone this repository
  2. Open the solution file in Visual Studio, Rider, or your preferred C# IDE
  3. Build the project in Release mode to generate the .dll file

Alternatively, use dotnet CLI:

dotnet build --configuration Release

Installing

Via Thunderstore (Recommended):

  1. Download and install via Thunderstore Mod Manager
  2. The mod will be automatically installed to the correct directory

Manual Installation:

  1. Place the built Carnometer.dll in your <Mycopunk Directory>/BepInEx/plugins/ folder

Executing program

The mod loads automatically through BepInEx when the game starts. Check the BepInEx console for loading confirmation messages.

Configuration

Access mod settings through the BepInEx configuration file at <Mycopunk Directory>/BepInEx/config/sparroh.carnometer.cfg. Options include:

Setting Default Description
EnableDamageMeterHUD true Enable or disable the damage meter
DPSWindowSeconds 5 Time window (seconds) for rolling DPS calculation
CarnometerAnchorX 0.15 X anchor position (0–1)
CarnometerAnchorY 0.95 Y anchor position (0–1)

Help

  • Mod not loading? Verify BepInEx is installed correctly and check console logs for errors
  • HUD not appearing? Ensure EnableDamageMeterHUD 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 CarnometerAnchorX / CarnometerAnchorY in the config file

Authors

  • Sparroh

License

This project is licensed under the MIT License - see the LICENSE file for details