Rangefinder
Displays the distance to whatever you're aiming at in the center of the HUD.
About this mod Author’s original text
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.
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- Most mods rely on the game's mod loader — the usual route is a community mod manager (such as r2modman): pick this game, install, and it handles the loader and dependencies.
- For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
- Launch the game to confirm it loaded; mods with listed dependencies need those installed as well.
Install locations vary a lot between mods — the bundled readme is the most reliable guide.
Install these first, or the mod will not work: