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 and HUD position with config reload support
• Context-aware hotkeys — ignored while chat is focused, any game menu/window is open, or known mod menus are open (ModSettingsMenu, CheatMenu+, ForceModifiers)

Default Hotkeys

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 ConsumableHotkeys.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.consumablehotkeys.cfg. Key options include:

• EnableHotkeys / EnableHUD toggles
• Hotkeys for each consumable
• HUD anchor position (ConsumableHotkeysAnchorX / ConsumableHotkeysAnchorY)

Help

• Mod not loading? Verify BepInEx is installed correctly and check console logs for errors

• Hotkeys not working? Ensure no conflicts with other mods or game settings, that you have the consumable in inventory, and that chat/menus/mod UIs are closed

• HUD missing? Confirm EnableHUD is true and that 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

Changelog

1.0.6

• Switch hotkeys to Unity Input System InputActionMap callbacks (no per-frame key polling)
• Rebind/enable map from config; dispose actions on unload
• Keeps menu/chat/mod-UI blocking inside the press callback only

1.0.5

• Further micro-stutter reductions:
  • Hotkey menu/focus checks only run when a bound key is pressed (idle frames are 4 key reads)
  • HUD rebuilds TMP text only when a state hash changes (flags, counts, colors)
  • Mod menu detector resolves once via known type names (no AppDomain GetTypes scans)
  • Cheaper early-out on the global SetFlag postfix

1.0.4

• Fix micro-stutters:
  • Stop forever AppDomain type scans when no known mod menus are installed
  • Remove leftover debug Harmony postfixes (including a no-op on every PlayerData.GetFlag)
  • Poll HUD state at ~5 Hz with dirty text updates instead of rewriting TMP every frame
• HUD still refreshes immediately on hotkey use and when consumable flags change (expiry / clearance uses)

1.0.3

• Fixed icon transparency

1.0.2

• Refactor

1.0.1

• Hotkeys are 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)

1.0.0

• Initial standalone release (split out from ExpandedHUD)
• Hotkeys for Personal Access Token, Premium Loot License, Bootleg Replicator, and Clearance Certificate
• Status HUD with active/inactive state, Clearance Certificate uses remaining, and inventory counts
• Configurable keybinds, HUD position, and active/inactive colors