Sparroh-GrenadeMacros icon

GrenadeMacros

Configurable hold/toggle activation macros for incendiary, voltaic, and acid grenades.

Last updated 15 hours ago
Total downloads 3
Total rating 0 
Categories Client-Side
Dependency string Sparroh-GrenadeMacros-1.0.0
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

Grenade Macros

A BepInEx mod for Mycopunk that adds configurable hold/toggle activation macros for grenades.

Split from EnhancedCooldowns as a standalone grenade-focused mod.

Features

  • Per-grenade activation modes for incendiary, voltaic, and acid grenades:
    • None: Default Mycopunk behavior (automatic activation when charged)
    • Hold: Requires holding the throw button to activate when charged
    • Toggle: Toggle on/off with a button press; automatically throws when charged and enabled
  • Live config reload: Settings reload automatically when the config file changes

Getting Started

Dependencies

  • Mycopunk (base game)
  • BepInEx - Version 5.4.2403 or compatible
  • .NET Framework 4.8
  • HarmonyLib (included via NuGet)

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

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 GrenadeMacros.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.grenademacros.cfg:

Setting Default Description
IncendiaryGrenadeActivationMode Toggle Activation mode for incendiary grenades (None/Hold/Toggle)
VoltaicGrenadeActivationMode Toggle Activation mode for voltaic grenades (None/Hold/Toggle)
AcidGrenadeActivationMode Toggle Activation mode for acid grenades (None/Hold/Toggle)

Usage

  • Toggle mode: Press the throw button to toggle auto-throw on/off
  • Hold mode: Hold the throw button to auto-throw when charged
  • None mode: Default game behavior

Configuration changes take effect immediately without restarting the game.

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 grenade systems.

Authors

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

License

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