Sparroh-BounceIndicatorPlus icon

BounceIndicatorPlus

Shows ricochet/bounce prediction lines for all weapons with bounces, with configurable colors.

Last updated 2 weeks ago
Total downloads 51
Total rating 0 
Categories Mods Quality Of Life Client-Side
Dependency string Sparroh-BounceIndicatorPlus-1.0.1
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack_Mycopunk-5.4.2403 icon
BepInEx-BepInExPack_Mycopunk

BepInEx pack for Mycopunk. Preconfigured and ready to use.

Preferred version: 5.4.2403

README

Bounce Indicator Plus

A BepInEx mod for Mycopunk that shows ricochet/bounce prediction lines for any weapon with bounces, with fully configurable colors.

Features

  • Universal bounce lines: Displays bounce/ricochet prediction lines for all weapons with bounces ≥ 1 (not just weapons that already show them)
  • Configurable colors: Choose from Orange, White, Green, Blue, Red, Yellow, Purple, Cyan, or a custom hex color
  • Live color updates: Changing the color in config updates active bounce lines immediately
  • Hot-reload config: Saving the .cfg while the game is running applies changes automatically
  • Client-side only: Safe to use without affecting multiplayer hosts or other players

Getting Started

Dependencies

  • Mycopunk (base game)
  • BepInEx - Version 5.4.2403 or compatible (BepInExPack_Mycopunk)

Installing

Via Thunderstore (Recommended):

  1. Download and install via Thunderstore Mod Manager / r2modman
  2. The mod will be automatically installed to the correct directory

Manual Installation:

  1. Place BounceIndicatorPlus.dll in your <Mycopunk Directory>/BepInEx/plugins/ folder

Building/Compiling

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

Alternatively, use dotnet CLI:

dotnet build --configuration Release

Configuration

Access mod settings through the BepInEx configuration file at:

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

Setting Default Description
All Bounce Indicators true Show bounce/ricochet prediction lines for all weapons with bounces ≥ 1
Bounce Indicator Color Orange Preset color for bounce lines
Bounce Indicator Custom Color #FF8000 Hex color used when Color is set to Custom (#RRGGBB or RRGGBB)

Live reload

Config changes apply while the game is running:

  • Editing and saving the .cfg file reloads settings automatically (short debounce after save)
  • Color changes update active bounce lines immediately
  • Disabling All Bounce Indicators hides active lines immediately; re-enabling shows them again on the next weapon update

Help

  • Mod not loading? Verify BepInEx is installed correctly and check the BepInEx console/log for errors
  • No bounce lines? Confirm the weapon has bounces ≥ 1 and that All Bounce Indicators is enabled
  • Wrong color? Set Bounce Indicator Color to a preset, or choose Custom and set a valid hex code

Authors

  • Sparroh

License

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