AmalgamationTracker

A BepInEx client mod for Mycopunk that tracks Amalgamation boss fight time with an on-screen HUD timer.

Features

• Automatic timing: Starts when the Amalgamation spawns and stops when the brain is killed
• On-screen HUD: Shows waiting, live elapsed, and final time near the reticle (MM:SS.mmm)
• Mission reset: Timer resets when a new mission starts
• Configurable: Toggle the HUD, set position anchors, and choose the timer color
• Hot reload: Config changes apply while the game is running
• Optional repositioning: Drag the timer in-game via ModSettingsMenu (F9) through SparrohUILib

Dependencies

• Mycopunk
• BepInExPack_Mycopunk (BepInEx 5.4.2403 or compatible)
• SparrohUILib (1.2.0 or compatible)
• ModSettingsMenu (optional, for F9 drag-reposition)

Installing

Via Thunderstore (recommended)

1. Install with a Thunderstore mod manager (for example r2modman or the Thunderstore App).
2. Ensure SparrohUILib is installed as a dependency.

Manual installation

1. Install BepInEx and SparrohUILib for Mycopunk.
2. Place AmalgamationTracker.dll in <Mycopunk Directory>/BepInEx/plugins/.

The mod loads automatically with BepInEx. Check the BepInEx log for:

AmalgamationTracker loaded successfully.

Building

1. Clone this repository.
2. Restore and build in Release mode:

dotnet build --configuration Release

1. Output DLL:

bin/Release/netstandard2.1/AmalgamationTracker.dll

Game and SparrohUILib assembly paths in the project file may need to match your local install.

Configuration

Config file:

<Mycopunk Directory>/BepInEx/config/sparroh.amalgamationtracker.cfg

Config changes are hot-reloaded while the game is running. With ModSettingsMenu installed, press F9 to drag the timer; anchor values are written back to this config.

Usage

1. Start an Amalgamation mission.
2. The HUD shows Amalgamation: Waiting... until the boss spawns.
3. Timing begins on spawn and updates live.
4. Timing stops when the brain is killed and the final time remains on screen.
5. Starting a new mission resets the timer.

Help

• Mod not loading? Confirm BepInEx and SparrohUILib are installed, then check the BepInEx log for errors.
• Timer not appearing? Set Enable Amalgamation Timer to true and make sure you are in-game with a reticle HUD.
• Timer not starting? Confirm you are on an Amalgamation mission and the boss has spawned.
• Wrong position or color? Adjust Timer X, Timer Y, and Timer Color in the config file, or drag with F9 when ModSettingsMenu is installed.

Authors

• Sparroh

License

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

Changelog

1.0.2

• Refactored config into a dedicated ConfigManager with debounced hot-reload
• Use SparrohUILib HudAnchors / EnableReposition instead of a local HudRepositionClient
• Removed thin BossTimer pass-through layer
• Require SparrohUILib 1.2.0+

1.0.1

• Reload the timer HUD after returning to the menu so it recreates cleanly on the next run
• Improved HUD lifecycle handling when the reticle UI is destroyed
• Renamed config option Enable Amalgam Timer to Enable Amalgamation Timer (existing configs need re-enabling if disabled)

1.0.0

• Initial release
• Tracks Amalgamation boss fight time from spawn to brain kill
• On-screen HUD with waiting, live, and final time display (MM:SS.mmm)
• Resets the timer when a new mission starts
• Configurable HUD toggle, anchor position, and timer color with hot reload
• Built on SparrohUILib, with optional HudRepositionAPI support for in-game repositioning