ConsumableHotkeys
Hotkeys and status HUD for Personal Access Token, Premium Loot License, Bootleg Replicator, and Clearance Certificate. Hotkeys are blocked in chat, menus, and known mod UIs.
About this mod Author’s original text
ConsumableHotkeys
A BepInEx mod for Mycopunk that adds hotkeys and a status HUD for common consumables.
Features
- Hotkeys to activate consumables without opening inventory:
- Personal Access Token
- Premium Loot License
- Bootleg Replicator
- Clearance Certificate
- Status HUD showing active/inactive state (or remaining uses for Clearance Certificate) and inventory counts
- Configurable keybinds, HUD position, and active/inactive colors, with config reload support
- Context-aware hotkeys — ignored while chat or other text input is focused, any vanilla menu/window is open, or
known mod UIs are open (CheatMenu+, ForceModifiers, HUD reposition mode, and similar)
- Optional HUD reposition integration when a compatible HudRepositionAPI mod is present
Default Hotkeys
| Consumable | Default Key |
|-----------------------|-------------|
| Personal Access Token | H |
| Premium Loot License | J |
| Bootleg Replicator | K |
| Clearance Certificate | L |
Dependencies
- Mycopunk (base game)
- BepInEx 5.4.2403 or compatible (e.g. BepInExPack for Mycopunk)
- SparrohUILib (required)
Installation (recommended)
- Install with a mod manager (r2modman, App, etc.).
- Ensure SparrohUILib is installed as a dependency.
Manual installation
- Install BepInEx and SparrohUILib for Mycopunk.
- Place ConsumableHotkeys.dll in /BepInEx/plugins.
The mod loads automatically through BepInEx when the game starts. Check the BepInEx log for a successful load 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
The output DLL is written under bin/Release/netstandard2.1.
Configuration
Settings are stored at:
/BepInEx/config/sparroh.consumablehotkeys.cfg
The config file is watched and reloaded when it changes.
| Section | Option | Description |
|-----------------|--------------------------|--------------------------------------------------|
| Consumables | Enable Hotkeys | Toggle hotkey activation |
| Consumables | Enable HUD | Toggle the status HUD |
| Consumables | PersonalAccessToken Key | Hotkey for Personal Access Token |
| Consumables | PremiumLootLicense Key | Hotkey for Premium Loot License |
| Consumables | BootlegReplicator Key | Hotkey for Bootleg Replicator |
| Consumables | ClearanceCertificate Key | Hotkey for Clearance Certificate |
| HUD Positioning | HUD X | Horizontal anchor (0–1) |
| HUD Positioning | HUD Y | Vertical anchor (0–1) |
| Colors | Active Color | Rich-text color for active status (hex RRGGBB) |
| Colors | Inactive Color | Rich-text color for inactive status (hex RRGGBB) |
Troubleshooting
- Mod not loading? Confirm BepInEx and SparrohUILib are installed, then check the BepInEx log for errors.
- Hotkeys not working? Check for key conflicts, that you have the consumable in inventory, and that chat, menus, and
known mod UIs are closed. Ensure Enable Hotkeys is true.
- HUD missing? Set Enable HUD to true and make sure you are in-game with a local player loaded.
Authors
- Sparroh
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: