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.
-
Inventory profiles & quick cycling
- The inventory radial supports profiles based on the filter mode:
- All items
- Weapons & tools / Weapons, tools & shields
- Armor & utility
- Consumables
- Custom list (if configured)
- While the Inventory radial is open:
- Mouse: scroll wheel up/down cycles profiles.
- Controller: D-Pad Left / Right cycles profiles.
- The current profile is shown as a center-screen message, using localized text such as:
- “All items”
- “Weapons & tools”
- “Armor & utility”
- “Consumables”
- The CustomNameWhitelist profile only appears if you’ve actually configured at least one name in the
Custom Name Filter setting.
-
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).
-
Optional audio feedback
- When enabled, selecting elements on the radial plays the same audio feedback as clicking inventory items.
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.
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
- 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 (default)
- 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 & Audio)
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).
Audio Feedback (Toggle)
- Default:
On
- When On, playing with the radial triggers the same “move item” or "button click" sound as using the inventory.
- When Off, the radial is silent.
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.
