AmalgamationTracker

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 (recommended)

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

Manual installation

• Install BepInEx and SparrohUILib for Mycopunk.
• Place AmalgamationTracker.dll in /BepInEx/plugins.

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

AmalgamationTracker loaded successfully.

Building

• Clone this repository.
• Restore and build in Release mode:

dotnet build --configuration Release

• 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:

/BepInEx/config/sparroh.amalgamationtracker.cfg

| Section | Option | Default | Description |

|-------------------|-----------------------------|-------------|-----------------------------------------------|

| General | Enable Amalgamation Timer | true | Enables the Amalgamation timer HUD |

| HUD Positioning | Timer X | 0.8229749 | X anchor position (0–1) |

| HUD Positioning | Timer Y | 0.9050629 | Y anchor position (0–1) |

| Colors | Timer Color | Amber | Rich-text value color (RRGGBB or #RRGGBB) |

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

• Start an Amalgamation mission.
• The HUD shows Amalgamation: Waiting... until the boss spawns.
• Timing begins on spawn and updates live.
• Timing stops when the brain is killed and the final time remains on screen.
• 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.