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 the range (in meters) to the surface under your crosshair
- Configurable Max Range: Set how far the rangefinder will measure
- Toggleable HUD: Enable or disable the display via config
- Hot Reload: Config changes are picked up automatically while the game is running
Getting Started
Dependencies
- MycoPunk (base game)
- BepInEx - Version 5.4.2403 or compatible
- .NET Framework 4.8
- HarmonyLib (included via NuGet)
Building/Compiling
- Clone this repository
- Open the solution file in Visual Studio, Rider, or your preferred C# IDE
- Build the project in Release mode to generate the .dll file
Alternatively, use dotnet CLI:
dotnet build --configuration Release
Installing
Via Thunderstore (Recommended):
- Download and install via Thunderstore Mod Manager
- The mod will be automatically installed to the correct directory
Manual Installation:
- Place the built
Rangefinder.dll in your <MycoPunk Directory>/BepInEx/plugins/ folder
Executing program
The mod loads automatically through BepInEx when the game starts. Check the BepInEx console for loading confirmation messages.
Configuration
Access mod settings through the BepInEx configuration file at <MycoPunk Directory>/BepInEx/config/sparroh.rangefinder.cfg. Options include:
- EnableRangefinderHUD: Toggle the rangefinder display on or off (default: true)
- RangefinderMaxRange: Maximum measurement distance in meters (default: 500)
Help
- Mod not loading? Verify BepInEx is installed correctly and check console logs for errors
- No distance shown? Confirm the HUD is enabled in the config and that you are in a mission
- UI elements missing? Confirm mod version compatibility and verify no other mods are interfering
Authors
License
This project is licensed under the MIT License - see the LICENSE file for details
