Alec's Radial Menu

Standalone radial menu framework mod for Hytale.

V1 Scope

• Asset-driven radial menus at Server/RadialMenu/Menus/*.json
• Menu identity is the asset key (file/path key). RadialMenuConfig has no Id field.
• Item interaction entrypoint: Type: "RadialMenuInteraction"
• API entrypoint: RadialMenuApi
• Built-in option action types:
  • ExecuteCommand
  • InvokeRegisteredAction
• Execution modes:
  • SelectAndArm (menu click selects only; execute on ExecuteSelected)
  • SelectAndRun (menu click executes immediately and updates selection)

RadialMenuConfig Fields

• Enabled (true default)
• ItemIds[] (menu can be auto-resolved by held item id)
• ExecutionMode (SelectAndArm default)
• DefaultOptionId (optional)
• Options[] (required, 1..8)
• Visual (optional, defaults to vector mode)

Visual Fields

• RenderMode: Vector (default) or Texture
• Geometry:
  • OuterDiameterPx
  • InnerDiameterPx
  • LabelRadiusPx
  • CenterDiameterPx
• BorderThicknessPx
• Label.FontSize
• States:
  • Default, Hover, Pressed, Selected, Disabled
  • each state supports FillColor, TextColor, BorderColor
• TextureSet:
  • Preset (LegacyDefault)
  • Prefix (custom texture set path using the same naming convention)

Option Types

• ExecuteCommand
  • Id, optional Label/LabelKey, Command, optional VisualOverride
• InvokeRegisteredAction
  • Id, optional Label/LabelKey, ActionId, optional Payload, optional VisualOverride

VisualOverride Fields (Option)

• LabelFontSize (optional)
• States (optional partial state/color overrides)

Interaction Usage

RadialMenuInteraction supports:

• MenuId (optional menu key override)
• CommandId (OpenMenu or ExecuteSelected)
• ExecutionMode (optional per-binding mode override)

Example item is included:

• Server/Item/Items/Commands/Alec_Radial_Menu_Example.json

API Usage

From another mod:

RadialMenuApi api = RadialMenuMod.getApiInstance();
if (api != null) {
    AutoCloseable registration = api.registerActionHandler("Example.Ping", context -> {
        // custom action logic
        return true;
    });

    // Optional direct control:
    // api.openMenu(player, "menus/example");
    // api.executeSelected(player, "menus/example");
}

Build

.\mvnw.cmd test
.\mvnw.cmd package

Maven Profiles

# Build + install jar to Server/mods and UserData/Mods
.\mvnw.cmd -Pinstall-plugin package

# Build + install + launch Hytale server
.\mvnw.cmd -Prun-server package

# Use prerelease install path (can combine with profiles above)
.\mvnw.cmd -Dprerelease=true -Pinstall-plugin package