You are viewing a potentially older version of this package. View all versions.
Akarian-RadialHub-1.0.0 icon

RadialHub

Adds a new radial menu that lets you assign any keyboard shortcuts and trigger them directly from the menu. Everything can be easily configured using the built-in editor.

By Akarian
Date uploaded a week ago
Version 1.0.0
Download link Akarian-RadialHub-1.0.0.zip
Downloads 29
Dependency string Akarian-RadialHub-1.0.0

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2360 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.2360

README

RadialHub

Are you tired of running out of available hotkeys because you have 100+ mods installed and have to keep assigning them to increasingly obscure keys? RadialHub helps you take control of the situation by allowing you to assign any keybind to a new, fully customizable radial menu. It can also prove particularly useful for players using gamepads.

Important Notice

The code for this mod was entirely generated using Claude Sonnet 5.5. However, I would like to clarify that the core concept, design of individual features, UI adjustments, and testing of the mod are entirely my own work.

Features

  • Adds a new radial menu that uses the same methods and functionality as Valheim's vanilla radial menu, accessible by pressing [G]. This ensures that it fits seamlessly into the game's visual style.

  • The menu's appearance can be changed in the settings to the original design used during development. However, this alternative design is not actively developed at the moment, so some limitations may occur.

  • The new radial menu is opened by pressing [F] by default.

  • An easy-to-use radial menu editor, which can be opened through the first entry in the aforementioned radial menu or by using a keyboard shortcut that must first be configured in the mod's configuration file.

  • The editor allows you to fully customize every radial menu entry: change its name, assign the keybind it should trigger, choose its icon, and even create entire groups of keybinds.

  • The editor also provides a convenient drag-and-drop feature for rearranging and changing the layout of individual radial menu entries.

  • The mod's configuration file allows you to customize the color, opacity, size, and several other settings affecting both the radial menu and its editor.

  • Preset system allowing users to add ready-made groups of keybinds dedicated to supported mods, as well as create and share their own custom presets.

Images

Radial menu with example entries – [X] (sit by default) with a custom icon bound to the radial menu. Image

Radial menu editor. Image

Vanilla game icons available in the editor. Image

Planned Features

  • Creating custom presets for my favorite mods.

  • Multiple radial menus, each with its own individually configurable keyboard shortcut.

  • Support for mod developers.

  • Translation into other languages.

Known Issues

  • Assigning icons with excessively high resolutions may cause the game to briefly freeze for about a second. Vanilla Valheim icons have a resolution of 72×72. I have personally tested icons up to 128×128, but I would not recommend using anything larger than 256×256.

  • Some of the editor's UI elements need further improvements.

  • The original radial menu, which can be enabled by setting UseNativeWheel = false in the .csg file, is no longer being developed, so some of its features may not work properly.

Compatibility

There are currently no known compatibility issues.

Recommended mods

Bindrune Hotkey Helper
Icon Icon
An extremely useful mod for
managing keyboard shortcuts.
Keyboard shortcut list and
display of configurable key hints.

Installation

  • Automatic: Install r2modman (if you haven't already) → on this mod's page, click[Install with App] → then select [Open r2modman].

  • Manual: Place the mod's folder inside BepInEx/plugins.

Support Me

Logo Discord

License

RadialHub is open-source software licensed under the MIT License.

You are free to use, copy, modify, redistribute, and incorporate the original RadialHub code and other materials covered by this license into your own projects, including commercial projects.

The only requirement is to include the original copyright notice and a copy of the MIT License in any copies or substantial portions of the Software.

See LICENSE for the full license terms.

Third-party components remain subject to their respective licenses.

CHANGELOG

Changelog

1.0.3

  • Added one of the major planned features: Multiple Radial Wheels. This feature allows you to create additional customized radial menus that operate independently of the main wheel. Each wheel can be opened using its own dedicated hotkey, allowing you to organize a large collection of hotkeys across multiple radial menus.

  • Added two new tabs above the "Entries" list:

    • [Entries] – works as before, containing the list of entries used to edit the radial menu tiles.

    • [Wheels] – a new tab containing a list of radial wheels, with a button below it for adding new wheels.

  • Added the ability to drag and drop presets directly onto items in the [Wheels] list.

  • Added support for selecting multiple items in the Presets and Entries lists using [Ctrl] and [Shift], allowing you to move or delete multiple items at once.

  • Added the ability to replace the gear icon on the tile that opens the editor with a different icon shared across all radial wheels. To do this, place an icon named main.png in the BepInEx\config\RadialHub\icons folder. You can also assign a separate icon to each radial wheel in the editor. Icons assigned in the editor take priority over the shared main.png icon.

  • Added a new radial menu closing mode: "HoldOpen". In this mode, the radial menu stays open after selecting a tile, allowing you to quickly activate multiple hotkeys without having to repeatedly close and reopen the menu. Holding down a selected tile has the same effect as pressing and holding a key on the keyboard. For the main radial menu, this mode can only be enabled through the .cfg file.

  • Added a dedicated message area to the editor.

  • The editor now takes priority over the in-game menus. When the mouse cursor is over an editor window (main editor, icon selection, or link selection), clicks will no longer interact with the game menu buttons behind it. When the cursor is outside the editor, the game menus work normally.

  • Added new presets and icons (7 in total) for the following mods:

  • Updated the README.md file.

1.0.2

  • Added a new hotkey linking feature.

  • The new feature reads the plugins loaded by BepInEx, retrieves their configurations, and identifies settings of type KeyboardShortcut and KeyCode. For each mod, it stores the section, name, description (the first line is displayed as an "action" in parentheses), and the current key. None settings are displayed as "not set", while mouse buttons are displayed as "mouse button: not supported yet" (disabled).

  • The small overlay listing mods, previously used to link mods to presets, has been replaced with a new "Mods and Shortcuts" window. The new window features a search field and two tabs: Mods and Shortcuts. It allows users to link mods to presets and those mods' hotkeys to individual entries.

  • Optimization:

    • When a radial menu entry is activated, the mod checks the configuration for the current value if the link is functional and sends that key. If the link is unavailable, it silently falls back to keys (the manually configured hotkey). This applies when the mod is missing, the setting has been changed or removed, the value is set to None, or a mouse button is assigned. Nothing runs in the background, and configurations are not polled during gameplay.

    • Current fallback keys values are refreshed only before saving entries and presets in the editor.

  • Added new presets and icons (31 in total) for the following mods:

  • Updated the README.md file.

  • Updated the GUID and mod version to the correct values.

Important

  • The configuration file has been renamed to akarian.radialhub.cfg. The old yourname.radialhub.cfg file will no longer work!

  • A new .cfg file with the updated name will be generated automatically. The old file can be safely deleted.

  • No new settings have been added to the .cfg file.

  • If you've changed many settings in the old .cfg file and want to transfer them to the new one quickly, simply copy the contents of the old file into the new one, leaving out the first two lines.

1.0.1

  • Updated the README.md file – Antivirus software flagged links to images hosted on files.fm as potential threats, so all images have been moved to github.com.
  • No changes to the mod itself.

1.0.0

  • Initial release.