You are viewing a potentially older version of this package. View all versions.
malafein-ValheimHotKeys-1.3.0 icon

ValheimHotKeys

Configurable hotkeys for various Valheim actions.

Date uploaded 3 weeks ago
Version 1.3.0
Download link malafein-ValheimHotKeys-1.3.0.zip
Downloads 86
Dependency string malafein-ValheimHotKeys-1.3.0

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2350 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2350

README

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).
  • 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, 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 hotbar slots on other keys, use Valheim's own Controls menu, which now has a rebindable alternate key for each of Hotbar 1-8.

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

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.