Salvo Macro

A BepInEx mod for Mycopunk that adds configurable auto-fire for the wingsuit rocket salvo, with optional targeting model suppression and lock-release behavior.

Split from EnhancedCooldowns as a standalone salvo-focused mod.

Features

• Salvo activation modes:
  • None: Default behavior (manual firing)
  • Toggle: Press the salvo button to toggle auto-fire on/off; fires automatically when recharged while enabled
  • Always: Auto-fire whenever the salvo is charged
• Lock release options:
  • Use Zero Lock Release (default): Auto-fire uses vanilla zero-lock release (crosshair point + spread)
  • When disabled: Instantly fills target locks via FindSalvoTarget before firing
• Visual options:
  • Optionally always hide the 3D salvo launcher model (including manual aim)
  • Auto-fire never shows the model regardless of that setting
• Live config reload: Settings reload automatically when the config file changes (toggle state resets)

Getting Started

Dependencies

• Mycopunk (base game)
• BepInEx - Version 5.4.2403 or compatible (BepInExPack_Mycopunk)
• HarmonyLib (included via NuGet / BepInEx)

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 the dotnet CLI:

dotnet build --configuration Release

Installing

Via Thunderstore (Recommended):

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

Manual Installation:

1. Place the built SalvoMacro.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.salvomacro.cfg:

Setting	Default	Description
Salvo Activation Mode	Toggle	Activation mode for wingsuit salvo (None / Toggle / Always)
Use Zero Lock Release	true	When true, auto-fire uses vanilla zero-lock release (crosshair point + spread). When false, instantly fills target locks via FindSalvoTarget before firing.
Suppress Salvo Model	false	Always hide the 3D salvo launcher model to save screen space (including manual aim). Auto-fire never shows the model regardless.

Usage

• Toggle mode: Press the salvo button to toggle auto-fire on/off; salvo fires automatically when recharged while enabled
• Always mode: Salvo auto-fires whenever it is charged (no toggle needed)
• None mode: Default game behavior

Configuration changes take effect immediately without restarting the game. Changing activation mode or reloading the config resets the toggle state to off.

Help

• Mod not loading? Verify BepInEx is installed correctly and check console logs for errors
• Settings not applying? Check the config file syntax and ensure the game has write permissions
• Conflicts? This is a client-side mod and should not affect multiplayer. Do not run alongside EnhancedCooldowns if both patch the same salvo systems.

Authors

• Sparroh
• funlennysub (BepInEx template)
• @DomPizzie (README template)

License

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