Rangefinder

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

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

Alternatively, use the.NET CLI:

dotnet build --configuration Release

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

Installing (recommended)

• Install with r2modman or the Mod Manager
• Ensure SparrohUILib is installed as a dependency

Manual installation

• Install BepInEx and SparrohUILib for Mycopunk
• Place Rangefinder.dll in /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 /BepInEx/config/sparroh.rangefinder.cfg.

General

| Option | Default | Description |

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

| Enable Rangefinder | true | Toggle the rangefinder display on or off |

| Max Range | 500 | Maximum measurement distance in meters |

Colors

Colors use hex RRGGBB or #RRGGBB.

| Option | Description |

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

| Rangefinder Color | Color for measured range values |

| No Target Color | Color when no target is hit |

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.