Valheim HotKeys

A Valheim mod to add configurable hotkeys for various actions.

Features

• Toggle HUD: Quickly hide/show the in-game HUD (default F3).
• Repair Hammer: One press equips your hammer with repair already selected (unbound by default). Press again while repairing to put the hammer away. It looks for any tool with a repair option rather than the vanilla hammer by name, so it should also work with modded hammers or tools that have one (untested; tools without a repair option are ignored).
• Hotbar Shortcuts: Use hotbar slots 1-8 with key combinations such as Alt + 1 (unbound by default). Valheim's Controls menu can give each slot an extra key, but not a combination.
• Custom Item Bindings:
  • Bind hotkeys to items by name (e.g., "Healing Mead", "Arrow"). This can be either the localized name or the internal item ID.
  • Partial Matching: "Arrow" will match "Fire Arrow", "Wood Arrow", etc.
  • Item Cycling: Press the hotkey multiple times to cycle through all items in your inventory that match the search name.
  • Bindings fire while you are moving, so you can drink or swap ammo on the run.

Installation

Thunderstore / r2modman (Recommended)

• Install via Thunderstore Mod Manager or r2modman.
  -or-
• Download the mod from Thunderstore, and follow the Manual Installation instructions below.

Nexus Mods / Vortex

• Install via Vortex Mod Manager.
  -or-
• Download the mod from Nexus Mods, and follow the Manual Installation instructions below.

Manual Installation

1. Install BepInExPack Valheim.
2. Download the latest release of ValheimHotKeys from GitHub.
3. Extract the ValheimHotKeys.dll file into your <Valheim Install Folder>\BepInEx\plugins directory.

Compatibility: tested with Valheim 1.0.

Configuration

The com.malafein.valheimhotkeys.cfg file will be generated in your BepInEx/config folder after the first run.
There you can set the HUD toggle key, the repair hammer key, the hotbar shortcuts, and the eight custom item bindings.

Recommendation: Use a configuration manager like shudnal's Configuration Manager to easily edit bindings and settings in-game.

Mouse buttons may be bound, but only Mouse0 through Mouse4, the buttons Valheim's input system supports.

To put a hotbar slot on a single key, use Valheim's own Controls menu, which has a rebindable alternate key for each of Hotbar 1-8. The hotbar shortcuts here are for combinations with Shift, Ctrl, or Alt.

Shortcuts still fire when you hold modifiers they don't include, so they work while you sprint. Valheim's own keys ignore modifiers entirely, though, so a shortcut shares its key with any game binding on the same key: Alt + 1 also uses hotbar slot 1. Left Shift and Left Ctrl are risky modifiers for hotbar shortcuts, because the game uses them to sprint and crouch: a Left Shift + 1 shortcut fires every time you press 1 while sprinting. Alt, Right Shift, and Right Ctrl are free. Left and right modifiers are separate keys, as they are in the game. The BepInEx log warns when a shortcut shares a key with one of the game's.

Changelog

See CHANGELOG.md.

Thank You

Jthorell - For requesting the Repair Hammer hotkey!

Bugs & Known Issues

Feel free to log any issues you encounter while using this mod on GitHub.

Changelog

1.4.0

• Hotbar slot bindings are back, for key combinations with Shift, Ctrl, or Alt, which Valheim's Controls menu can't bind. Settings from before 1.3.0 are picked up again.
• Custom item bindings are now named Item 1-8 instead of Slot 1-8, so they aren't mistaken for hotbar slots. Existing bindings carry over.
• Binding a custom item key while holding the right Shift, Ctrl, or Alt now saves the right one. It used to save the left one, so the binding then only worked with the left key.
• The log warns when a binding shares a key with one of the game's own bindings.

1.3.0

• Removed the hotbar slot bindings. Valheim now has a rebindable alternate key for each hotbar slot in its own Controls menu. Any leftover [Hotbar] settings in your config file are ignored.
• A custom item binding whose item is not in your inventory no longer logs a warning.

1.2.0

• Added a Repair Hammer hotkey (unbound by default): one press equips your hammer with repair selected, a second press puts it away.

1.1.1

• Corrected documentation.

1.1.0

• Updated for the Valheim 1.0 release, which moved the game to Unity 6.
• Mouse bindings are now limited to Mouse0 through Mouse4, the buttons Valheim's input system supports.

1.0.0

• Initial release.
• Configurable hotkeys for HUD toggling and hotbar slots.
• Custom item bindings with partial matching and item cycling.
• Support for localized and internal item IDs in custom bindings.