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

RadialHub

Adds a new radial menu, accessible by default using the F key, allowing you to assign any keyboard shortcuts to its entries. The mod includes an editor that makes it easy to assign keyboard shortcuts and custom icons to selected slots.

By Akarian
Date uploaded 3 days ago
Version 1.0.2
Download link Akarian-RadialHub-1.0.2.zip
Downloads 19
Dependency string Akarian-RadialHub-1.0.2

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

The mod is very simple to use. It adds a completely new radial menu based on the vanilla one. All you need to do is open the menu by pressing [F], select the entry with the gear icon to launch the editor, and then go to the Entries section, where you can add new entries, assign keyboard shortcuts to them, and optionally set custom icons.

Once you're done, save your changes and reopen the radial menu. You can now trigger your assigned keyboard shortcuts directly from the entries you've created.

Important Notice

The code for this mod was generated by Claude Sonnet 5.5 and icons by Nano Banana 2, while I was responsible for the main concept, planning individual features, designing the editor's UI, and testing the functionality of its various features.

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.

  • You can also link a selected radial menu entry to a mod's corresponding hotkey, allowing the radial menu hotkey to automatically update whenever changes are made to the selected mod's .cfg file.

  • 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.

  • Mouse buttons are not supported as simulated key inputs (VirtualKeyboard.Press rejects them with a warning). Entries bound to mouse buttons use fallback keys (if available).

  • Links to other mods only work with KeyboardShortcut / KeyCode settings in the standard BepInEx configuration. Mods that use their own keybinding systems must be configured manually.

  • 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.

Supported Mods

List of mods for which I've added dedicated presets and icons:

If you have any requests for mods you'd like me to add dedicated icons and presets for, let me know on Discord in the #suggestions channel!

Compatibility

There are currently no known compatibility issues.

Recommended mods

Bindrune Hotkey Helper
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.