Speedometer

A BepInEx client mod for Mycopunk that displays your current movement speed on the HUD.

Features

• Live speed display — Shows your current movement speed in m/s
• Toggleable HUD — Enable or disable the speedometer from the config file
• Configurable position — Adjust X/Y anchor position to place the HUD wherever you like
• Configurable color — Customize the speed value color (default: sky blue)
• Hot reload — Config changes are picked up automatically while the game is running
• Optional HUD repositioning — Registers with HudRepositionAPI when available for in-game dragging

Dependencies

• Mycopunk
• BepInEx 5.4.2403 or compatible (BepInExPack_Mycopunk)
• SparrohUILib 1.2.0 or compatible

Installation

Via Thunderstore (recommended)

1. Install with a Thunderstore-compatible mod manager (e.g. r2modman or Thunderstore Mod Manager).
2. Required dependencies are installed automatically.

Manual installation

1. Install BepInEx and SparrohUILib for Mycopunk.
2. Place Speedometer.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.

Building

1. Clone this repository.
2. Open the solution in Visual Studio, Rider, or another C# IDE.
3. Ensure game and dependency assembly paths in the project file match your install.
4. Build in Release mode:

dotnet build --configuration Release

The output DLL is written to bin/Release/netstandard2.1/Speedometer.dll.

Configuration

Settings are stored at:

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

Troubleshooting

• Mod not loading? Confirm BepInEx and SparrohUILib are installed, then check the BepInEx log for errors.
• Speed not updating? Make sure you are in-game with a local player loaded.
• HUD position wrong? Adjust Speedometer X / Speedometer Y in the config, or use a HUD reposition mod if available.
• No speed detected? The mod tries several player velocity sources; if none report motion you will see "No Speed Detected".

Authors

• Sparroh

License

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

Changelog

1.2.2

Changed

• Refactored config into ConfigManager with debounced hot-reload (aligned with other Sparroh HUD mods)
• Extracted player speed reflection into PlayerSpeedReader
• Use SparrohUILib HudAnchors / HudHandle.EnableReposition instead of a local HudRepositionClient
• Raised SparrohUILib dependency to 1.2.0

1.2.1

Fixed

• Reload the speedometer UI after returning to the main menu

1.2.0

Added

• Initial standalone release of Speedometer (split from ExpandedHUD)
• Configurable HUD enable toggle and anchor position
• Configurable speed value color
• Live player speed display in m/s
• Optional integration with HudRepositionAPI for in-game HUD repositioning
• Dependency on SparrohUILib for HUD building

1.1.0

Changed

• Enhanced HUD positioning to avoid overlap with the damage meter
• Improved positioning logic for better UI integration

Added

• Sky blue color for speed display values

1.0.2

Added

• Basic speedometer functionality with velocity detection
• Support for multiple velocity sources (Player velocity, Rigidbody, moveVelocity, currentMoveSpeed)
• F6 toggle for HUD visibility
• Real-time m/s display updates during gameplay

1.0.0

Added

• MinVer
• thunderstore.toml for tcli
• LICENSE and CHANGELOG.md