GrenadeMacros
Configurable hold/toggle activation macros for incendiary, voltaic, and acid grenades.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 (shock), and acid grenades:
- None: Default Mycopunk behavior (automatic activation when charged)
- Hold: Hold the throw button to auto-throw when charged
- Toggle: Press the throw button to toggle auto-throw on/off; throws automatically when charged and enabled
- Live config reload: Settings reload automatically when the config file changes; toggle states reset on reload
Dependencies
- Mycopunk
- BepInExPack_Mycopunk (BepInEx 5.4.2403 or compatible)
Installation
Via Thunderstore (recommended)
- Install with a Thunderstore mod manager (e.g. r2modman or Thunderstore Mod Manager).
- The mod is placed in the correct plugins folder automatically.
Manual installation
- Install BepInEx for Mycopunk if you have not already.
- Copy
GrenadeMacros.dllinto<Mycopunk Directory>/BepInEx/plugins/.
The mod loads automatically with BepInEx. Check the BepInEx log for a GrenadeMacros loaded message.
Building
- Clone this repository.
- Open the solution in Visual Studio, Rider, or another C# IDE and build Release, or run:
dotnet build --configuration Release
Output DLL: bin/Release/netstandard2.1/GrenadeMacros.dll
Configuration
Settings are written to:
<Mycopunk Directory>/BepInEx/config/sparroh.grenademacros.cfg
| Setting | Default | Description |
|---|---|---|
Incendiary Mode |
None |
Activation mode for incendiary grenades (None / Hold / Toggle) |
Shock Mode |
Toggle |
Activation mode for voltaic (shock) grenades (None / Hold / Toggle) |
Acid Mode |
None |
Activation mode for acid grenades (None / Hold / Toggle) |
Changes apply immediately on save (live reload). Toggle states are cleared when the config reloads.
Usage
-
Toggle: Short-press the throw button to turn auto-throw on or off. Hold still throws manually (or triggers vanilla hold-throw abilities when present). While toggle is on, grenades also throw automatically when charged.
-
Hold: Hold the throw button to auto-throw when the grenade is charged.
-
None: Unmodified game behavior (including vanilla hold/tap throw handling).
Compatible with the game’s throw bind using Hold/Tap interactions.
Troubleshooting
- Mod not loading? Confirm BepInEx is installed and check the BepInEx log for errors.
- Settings not applying? Confirm the config path and values above; ensure the game can read/write the config file.
- Conflicts? This is a client-side mod. Do not run it alongside EnhancedCooldowns if both patch the same grenade systems.
Authors
- Sparroh
- funlennysub (BepInEx template)
License
This project is licensed under the MIT License — see the LICENSE file for details.
