Rangefinder

A BepInEx mod for Mycopunk that displays the distance to whatever you're aiming at in the center of the HUD.

Features

• Distance readout: Shows range in meters to the surface under your crosshair (one decimal place)
• No-target display: Shows --- m when nothing is hit within range
• Configurable max range: Set how far the rangefinder will measure (default: 500 m)
• Toggleable HUD: Enable or disable the display via config
• Configurable colors: Separate colors for range values and the no-target state
• Hot reload: Config changes are picked up automatically while the game is running
• Menu-safe HUD: Rangefinder UI reloads correctly after exiting to the menu

Dependencies

• Mycopunk (base game)
• BepInEx — BepInExPack_Mycopunk 5.4.2403 or compatible
• SparrohUILib — required for HUD rendering

Building

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

Alternatively, use the .NET CLI:

dotnet build --configuration Release

Output DLL: bin/Release/netstandard2.1/Rangefinder.dll

Installing

Via Thunderstore (recommended)

1. Install with r2modman or the Thunderstore Mod Manager
2. Ensure SparrohUILib is installed as a dependency

Manual installation

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

General

Colors

Colors use hex RRGGBB or #RRGGBB.

Help

• Mod not loading? Verify BepInEx is installed correctly and check the BepInEx log for errors
• Missing dependency errors? Confirm SparrohUILib is installed and up to date
• No distance shown? Confirm the HUD is enabled in the config and that you are in a mission
• UI missing after menu? Update to the latest mod version; 1.0.1+ reloads the HUD after returning from the menu

Authors

• Sparroh

License

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

Changelog

1.0.2

• Refactor

1.0.1

• Reload rangefinder HUD after exiting to the menu

1.0.0

• Initial standalone release (split from ExpandedHUD)
• Display distance to the surface under the crosshair
• Configurable enable toggle, max range, and colors