GrenadeMacros
Configurable hold/toggle activation macros for incendiary, voltaic, and acid grenades.
About this mod Author’s original text
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 (recommended)
- Install with a mod manager (e.g. r2modman or 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.dll into /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:
/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.
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- Most mods rely on the game's mod loader — the usual route is a community mod manager (such as r2modman): pick this game, install, and it handles the loader and dependencies.
- For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
- Launch the game to confirm it loaded; mods with listed dependencies need those installed as well.
Install locations vary a lot between mods — the bundled readme is the most reliable guide.
Install these first, or the mod will not work: