Shattered Codex

Wiki

Modules/SC - Wheel Menu

SC - Wheel Menu

Foundry v13+System AgnosticPremium

SC - Wheel Menu

Overview

SC - Wheel Menu replaces Foundry's default scene controls column with a radial wheel that opens around the cursor.

It can also turn the sidebar tab strip into its own radial wheel, which makes the module feel less like a shortcut overlay and more like a full navigation layer.

What the module focuses on:

  • a radial wheel for scene controls
  • an optional radial wheel for sidebar tabs
  • cursor-centered interaction instead of docked side columns
  • hold-and-release gesture mode for faster selection
  • keyboard navigation for users who want to stay off the mouse
  • a built-in theme customizer with presets and fully custom colors

Installation

This module is premium.

Install access is handled through the Shattered Codex Download Hub.

See How to Download Premium Modules from the Download Hub for the full access and installation flow.

After installing:

  1. Enable SC - Wheel Menu in your world.
  2. Open a scene.
  3. Press Q to open the scene wheel.
  4. Press E to open the sidebar wheel.
  5. Open Configure Settings > Module Settings > SC - Wheel Menu to adjust the behavior.

Both hotkeys can be rebound through Foundry's normal keybinding UI.

Scene Wheel

The scene wheel mirrors the controls normally shown in Foundry's left-side scene controls column.

Scene wheel showing control layers and tools

The inner ring holds the main control layers, while the outer ring shows the tools for the currently active layer.

How it works:

  • the inner ring contains the main control layers
  • the outer ring contains the tools for the selected layer
  • clicking a layer updates the outer ring
  • clicking a tool activates it and closes the wheel
  • the center button goes back when a submenu is open, or closes the wheel if you are already at the top level

If wheel mode is enabled, the module can also hide the default left scene controls column so the radial menu becomes the primary interface instead of just an alternative.

The sidebar wheel mirrors Foundry's sidebar tab strip.

Sidebar wheel replacing the normal sidebar tabs

The sidebar wheel gives the right-side tabs the same radial treatment, including the collapse control and optional hotkey access.

This wheel has its own behavior and settings:

  • it can be enabled or disabled separately from the scene wheel
  • it can hide the default sidebar tabs entirely
  • it has its own hotkey
  • it can show an optional toggle button on the sidebar itself

This is useful if you want both sides of the Foundry UI to follow the same radial interaction pattern instead of mixing wheel navigation with docked tabs.

Interaction and Hotkeys

The defaults are straightforward:

  • Q toggles the scene wheel
  • E toggles the sidebar wheel

The module also supports two optional interaction modes that change how those hotkeys feel.

Hold-and-Release Gesture Mode

When Use hold-and-release gesture mode is enabled:

  1. Hold the hotkey.
  2. Move the cursor toward the segment you want.
  3. Release the key to activate that segment.

This turns the wheel into a quick gesture-based selector instead of a toggle menu.

Keyboard Navigation

If Enable keyboard navigation is on, the open wheel can be driven without the mouse:

  • Arrow Left / A: move counter-clockwise
  • Arrow Right / D: move clockwise
  • Arrow Up / W: move from the inner ring to the outer ring
  • Arrow Down / S: move back toward the inner ring
  • Tab: cycle focus between the rings and the center button
  • Enter / Space: activate the focused segment
  • Esc: close the wheel

That makes the wheel usable both as a gesture-driven UI and as a fully keyboard-navigable menu.

Settings and Theme

The main settings are grouped in Configure Settings > Module Settings > SC - Wheel Menu.

Main module settings for wheel behavior

This is where you decide whether the default columns stay visible, whether hotkeys can open the wheel anytime, and whether players inherit the GM's configuration.

The settings cover:

  • hiding the default left controls column
  • enabling or disabling wheel mode
  • allowing the scene wheel hotkey even when the default controls are still visible
  • enabling the sidebar wheel
  • showing the sidebar wheel toggle button
  • allowing the sidebar wheel hotkey even when the sidebar tabs are still visible
  • gesture mode
  • keyboard navigation
  • using GM settings for players

GM-Controlled Player Settings

If Use GM settings for players is enabled, players inherit the GM-defined wheel behavior and theme instead of keeping their own client preferences.

That synced snapshot includes:

  • scene wheel visibility behavior
  • wheel mode state
  • sidebar wheel behavior
  • gesture mode
  • keyboard navigation
  • theme preset and theme colors

Theme Customizer

The module also includes a dedicated Wheel Theme configurator.

Wheel theme customizer with live preview

The theme editor lets you start from a preset, tweak the wheel colors section by section, and preview the result live before saving.

The theme editor supports:

  • preset palettes
  • per-color customization
  • a live preview of the wheel
  • separate color groups for the inner ring, outer ring, shell, center core, and accents

Theme changes apply without a reload, so it is easy to test the visual direction until it fits your table.

Notes

Some practical details are worth keeping in mind:

  • the module reads the current Foundry UI, so it stays aligned with the active controls and tools
  • if another module heavily changes the scene-controls or sidebar markup, compatibility may depend on that module's DOM structure
  • the scene wheel and sidebar wheel can be used independently, so you do not need to commit to both at once
  • the wheel menu is system agnostic, so it is about interface flow rather than rules or automation