ValheimRadial

ValheimRadial brings the console-style radial menu to PC in a way that actually feels good with keyboard, mouse, and controller.

It hooks into Valheim’s built-in Hud.m_radialMenu and gives you proper Toggle and Hold behavior for opening and closing the radial on PC, while still playing nicely with the vanilla gamepad controls.

I commissioned this mod after relying on EmoteWheel and EquipWheel, which both used custom assets and were increasingly fragile with updates and other UI mods. Eventually leading to the deprecation.

Azumatt not only recreated that functionality, but he replaced it with a clean, vanilla-compatible solution that feels native to the game (because it is!).

Huge thanks to him for taking the time to do this and giving the community a replacement for EmoteWheel and EquipWheel that’s more future-proof and plays nicely with everything else.

Please consider supporting him using his Buy Me A Coffee account

---

Features

• Radial control

  • Open the Hotbar radial with a keybind (default: G).
    • or (JoyRadial) on controller. Default is Left Bumper.
  • Open the Emote radial with a separate keybind (default: Alt + G).
  • Still works with the vanilla controller radial button (JoyRadial). This is default to left bumper.
    • Planned: Add configurations for the controller binds, don't rely on vanilla.

• Two activation modes

  • Toggle – Press to open, press again to close
  • Hold – Wheel stays open while the key is held, closes when you release.

• Smarter close behavior

  • Uses internal debounce (spam protection) so you don’t accidentally flicker the wheel.
  • Escape / close-key always closes the wheel.

• Plays nice with vanilla

  • Uses the existing radial visuals and behavior from the Xbox version of the game.
  • No custom assets to maintain, it's using the game's own hidden UI!

• Inventory row radial (Hotbar replacement / extension)

  • Choose which inventory rows the “Hotbar radial” uses:
    • Only the vanilla hotbar row,
    • A specific row (e.g. 2nd/3rd row),
    • Or multiple rows at once (e.g. top 3 rows).
  • Optionally include empty slots as empty segments in the radial.
  • Filter which items appear via item-type filters:
    • All items
    • Weapons & tools
    • Weapons, tools & shields
    • Armor & utility/trinkets
    • Consumables only
    • Custom name whitelist (see below).
  • Equipped-only mode to show only currently equipped items from the chosen rows.
  • Custom name whitelist:
    • Match by internal/shared name (m_shared.m_name, e.g. $item_sword_iron)
      or by prefab name (m_dropPrefab.name, e.g. SwordIron).
    • Case-insensitive, comma-separated list.

• Visual & layout customization

  • Adjust overall radial scale.
  • Independently scale:
    • Element info, Inventory info panel, Tooltip, Weight display, Armor display.
  • Offset the entire radial using an anchored position override (move it off-center if you want).

---

Controls (Defaults)

All keys are configurable in BepInEx/config/PerspectiveBroad4501.ValheimRadial.cfg. Though it's recommended to use your mod manager's editor or a Configuration Manager mod in-game.

• Open Hotbar Radial

  • Default: G
  • Opens the Hotbar radial wheel (your hotbar items).

• Open Emotes Radial

  • Default: Alt + G
  • Opens the Emote radial wheel. The emotes are arranged in a spiral, rotate clockwise to see them all!

• Close Radial

  • Default: Escape
  • Closes whatever radial is open.
  • Note: Escape will always close the wheel, even if you change this binding.

• Gamepad

  • The mod respects the vanilla JoyRadial button:
    • In Toggle mode, it behaves like “press to open, press again (or Escape/close key) to close”.
    • In Hold mode, holding JoyRadial keeps the wheel open, releasing closes it.

---

Configuration

All options live in:
BepInEx/config/PerspectiveBroad4501.ValheimRadial.cfg

1 – General

Activation Mode (Toggle / Hold)

Controls how the radial opens and closes for keyboard and controller.

• Toggle (default)

  • Press an open key (or the gamepad radial button) once → radial opens.
  • Press it again → radial closes.
  • The Close Radial key and Escape also close the radial.

• Hold

  • Keep the open key (or gamepad radial button) held → radial stays open.
  • Release all open keys → radial closes.
  • Close Radial / Escape still close instantly.

---

2 – Keyboard Hotkeys

Open Hotbar Radial (KeyboardShortcut)

• Default: G
• Opens the Hotbar radial (main item wheel).
• Toggle mode:
  • Press once to open, press again to close.
• Hold mode:
  • Wheel stays open while this key is held.

Open Emotes Radial (KeyboardShortcut)

• Default: Alt + G
• Opens the Emote radial.
• Toggle mode:
  • Press once to open, press again to close.
• Hold mode:
  • Wheel stays open while this key combination is held.

Close Radial (KeyboardShortcut)

• Default: Escape
• Dedicated key to close any active radial.
• Escape always closes the radial, even if you bind this setting to something else.
• Helpful if you want to keep your open keys purely for opening / toggling.

---

3 – Inventory Radial

Start Row Index (int)

• Default: 0
• Which inventory row to start from when building the Inventory Row radial.
• 0 = top row (vanilla hotbar), 1 = second row, 2 = third row, etc.
• Values outside the inventory height are clamped.

Row Count (int)

• Default: 1
• How many rows to include starting from Start Row Index.
• Examples:
  • Start Row Index=0, Row Count=1 → vanilla hotbar row only.
  • Start Row Index=1, Row Count=1 → second row only.
  • Start Row Index=0, Row Count=3 → top three rows.
• If the chosen range exceeds inventory height, it is clamped.

Include Empty Slots (Toggle)

• Default: On
• When true, empty inventory slots within the selected rows appear as empty segments in the radial.
• When false, only occupied slots are added; the radial will have fewer segments.

Filter Mode (InventoryRowFilterMode)

Controls which items from the selected rows are eligible to appear.

• AllItems
  No type filtering; every item can appear.
• WeaponsAndTools
  Only weapons and tool-type items.
• WeaponsToolsShields
  Weapons, tools, and shields.
• ArmorAndUtility
  Armor plus utility/trinket items.
• ConsumablesOnly
  Food, meads, and other consumable/ammo types.
• CustomNameWhitelist
  Only items whose name matches the Custom Name Filter list.

Equipped Only (Toggle)

• Default: Off
• When enabled, only items that are currently equipped (m_equipped == true) can appear in the radial.
• Applied after the Filter Mode check.

Custom Name Filter (string)

Used when Filter Mode = CustomNameWhitelist.

• Comma-separated list of item identifiers.

• Each entry may be either:

  • The internal/shared name (m_shared.m_name), e.g. "$item_sword_iron"
  • The prefab name (m_dropPrefab.name), e.g. "SwordIron"

• Example:

  Custom Name Filter = $item_sword_iron,$item_axe_blackmetal,BowFineWood,ShieldBanded
  

• Whitespace around entries is ignored.
• Comparison is case-insensitive.

---

4 – Customizations (Scale & Location)

Radial Scale (Vector3)

• Overall scale of the radial root.
• Default: 1,1,1.

Element Info Scale (Vector3)

• Scale of the radial element info section (the slice visuals).
• Default: 1,1,1.

Inventory Info Scale (Vector3)

• Scale of the inventory info panel (tooltip, weight, armor section).
• Default: 1,1,1.

Tooltip Scale (Vector3)

• Independent scale for the radial’s tooltip text.
• Default: 1,1,1.

Weight Scale (Vector3)

• Independent scale for the weight display in the inventory info panel.
• Default: 1,1,1.

Armor Scale (Vector3)

• Independent scale for the armor display in the inventory info panel.
• Default: 1,1,1.

Radial Location (Vector2)

• Anchored position offset for the entire radial UI.
• Default: 0,0 (center).
• Non-zero values move the radial around the screen (e.g. shift it slightly up, down, or to the side).

---

Compatibility

• Should be compatible with most mods that don’t completely replace the radial system. None are known at the moment.

If you run into a conflict with another radial-related mod, please share:

• BepInEx/LogOutput.log after the bug happens
• Your mod list
• A brief description of what happens

---

Known Issues

• None known at the moment for the core behavior.

Credits

• Author: Azumatt – code implementation, sweat, and time.
• Commissioned by: PerspectiveBroad4501 – concept, funding, and testing.

If you enjoy this mod, consider leaving feedback, bug reports, or suggestions. Since I am not a coder, please direct them all to Azumatt in any of the Valheim Modding related discords or in his own.

List of Discords