Steelhammer Smart Hotbar

A lightweight client-side Valheim mod that lets you switch through hotbar slots 1-8 with the mouse wheel without breaking Valheim's building controls.

Features

• Scroll the mouse wheel to switch between hotbar slots 1-8.
• Automatically stops hotbar scrolling while building.
• The mouse wheel remains available for normal building-piece rotation.
• Hold Left Ctrl to leave the mouse wheel available for Valheim's normal camera zoom.
• Optional wrap-around between slot 1 and slot 8.
• Configurable scroll direction.
• Configurable scroll delay.
• Client-side only.
• No server installation required.
• Other players do not need the mod.

Why?

Normal mouse-wheel hotbar mods can interfere with Valheim's building system because the same wheel is used to rotate building pieces.

Steelhammer Smart Hotbar detects the building context and automatically leaves the mouse wheel to Valheim whenever it is needed for construction.

Default configuration

General

Enabled = true

Enables or disables the mod.

Hotbar

InvertScrollDirection = false

Reverses the hotbar scroll direction.

WrapAround = true

Scrolling past slot 8 returns to slot 1 and vice versa.

ScrollDelay = 0.10

Minimum time between hotbar changes.

Building

DisableWhileBuilding = true

Prevents the mod from using the mouse wheel while building so pieces can be rotated normally.

Controls

ZoomModifier = LeftControl

Holding Left Ctrl leaves the mouse wheel available for Valheim's normal camera zoom.

Installation

Install with r2modman / Thunderstore Mod Manager.

For manual installation, place:

SteelhammerSmartHotbar.dll

inside:

BepInEx/plugins/SteelhammerSmartHotbar/

Multiplayer

This mod is client-side only.

It does not need to be installed on a dedicated server and other players do not need it.

Tested

Initial release tested successfully with Valheim 1.0 and BepInExPack Valheim 5.4.2350.

AI-assisted development

Development and code review were performed with AI assistance. The mod was compiled and manually tested in Valheim before release.