You are viewing a potentially older version of this package. View all versions.
Sparroh-GrenadeMacros-1.0.2 icon

GrenadeMacros

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

Date uploaded 2 weeks ago
Version 1.0.2
Download link Sparroh-GrenadeMacros-1.0.2.zip
Downloads 27
Dependency string Sparroh-GrenadeMacros-1.0.2

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 (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

Installation

Via Thunderstore (recommended)

  1. Install with a Thunderstore mod manager (e.g. r2modman or Thunderstore Mod Manager).
  2. The mod is placed in the correct plugins folder automatically.

Manual installation

  1. Install BepInEx for Mycopunk if you have not already.
  2. Copy GrenadeMacros.dll into <Mycopunk Directory>/BepInEx/plugins/.

The mod loads automatically with BepInEx. Check the BepInEx log for a GrenadeMacros loaded message.

Building

  1. Clone this repository.
  2. 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.

CHANGELOG

Changelog

1.1.0

  • Fixed Toggle/Hold macros for vanilla throw Hold,Tap input (press no longer reliably hit TryThrow alone)

  • Toggle: short press arms/disarms auto-throw; hold still manual-throws (or runs vanilla OnThrowHeld if set)

  • Hold mode blocks vanilla throw input and keeps auto-throw while the throw bind is held

1.0.1

  • Refactor

1.0.0

Added

  • Initial release (split from EnhancedCooldowns)
  • Configurable activation modes for incendiary, voltaic (shock), and acid grenades:
    • None: default Mycopunk behavior
    • Hold: auto-throw while holding the throw button when charged
    • Toggle: toggle auto-throw on/off; throws automatically when charged and enabled
  • Live config reload with toggle state reset on reload