Back to mods
Actio: Action Wheel project artwork

CurseForge · Hytale mod

Actio: Action Wheel

Quick access: hold E with an empty hand to open an action wheel, where any mod can put its actions.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Actio: Action Wheel release should I use?

Updated yesterday
Latest stable file Actio-1.2.0.jar
Game version 0.7
Mod system Built-in Hytale mod system

Actio: Action Wheel Actio-1.2.0.jar targets 0.7. Do not install it as a separate client mod. Enable it on the world host—the local server in singleplayer or the dedicated server in multiplayer. No required dependencies listed for this file.

Where it goes

Where should Actio: Action Wheel be installed in Hytale?

Do not install it as a separate client mod. Enable it on the world host—the local server in singleplayer or the dedicated server in multiplayer.

Separate client mod Not supported
World host / dedicated server Required
Mod system for this release Built-in Hytale mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

Put Hytale mods on the world host or dedicated server. Singleplayer runs a local server too; Hytale does not use separate client mods.

What else does Actio: Action Wheel Actio-1.2.0.jar need?

Actio-1.2.0.jar. Change the file and its required mods may change too.

No required dependencies listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional project dependencies. Check the creator notes before changing an existing world.

Before you install it

Add Actio: Action Wheel without breaking your instance.

Built for Actio: Action Wheel Actio-1.2.0.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use Actio-1.2.0.jar. It targets 0.7; another release may target a different game build or dependency set.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Enable it on the world host

    Do not install it as a separate client mod. Enable it on the world host—the local server in singleplayer or the dedicated server in multiplayer.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside Actio-1.2.0.jar. It opens that exact file at the source.

About this project

What does Actio: Action Wheel add?

Actio

Quick access for Hytale servers: hold E with an empty hand to open an action wheel, where any mod can put its actions and the admin can put any command.

Actio is a server plugin. Everything runs on the server, so players need nothing installed. Mods put their actions on the wheel through the Actio API, and the admin adds custom actions that run a command, to open the screen of any mod that has one.

Actio is in English, Portuguese, German, Spanish, French, Russian and Chinese. Each player sees it in their game language, with no setup.

🔌 Mod developers: the Actio integration guide shows how to plug your mod into Actio, in seven languages.

Features

🎡 The action wheel on E

  • Hold E with an empty main hand to open a wheel in the middle of the screen, shaped like the game's Z wheel. Release E to pick the action you are looking at.
  • The camera stays still while the wheel is open: moving the mouse marks the slice on that side, and the center shows the icon and the name of what is marked. The X at the bottom just closes it.
  • It also opens with a shield or a torch in the off hand. An item with its own E keeps its E.
  • Taking damage, switching slots, holding an item or changing worlds closes the wheel without picking anything.
  • The wheel is always there: with no actions it opens with empty places, and administrators find a shortcut to the admin menu on it.

🔴 The indicator next to the heart

  • A small wheel with an E shows to the left of the health bar, to remind players of the key.
  • A red dot on it says an action has something new, like mail waiting to be collected. The dot also shows on the action, its category and its subcategory.

🗂️ Categories, "More" and Back

  • Actions are sorted into four categories, Economy, Social, Tools and Other, and inside them into each mod's subcategory.
  • Rest the mouse on a category for a second to open it: an arrow on the icon says it opens, and a bar fills while you wait. The X becomes Back.
  • When a level has more items than slices, the last slice becomes More.
  • A category that only has one subcategory created by the admin gives its place to it.
  • The admin can turn the categories off and build the first level: each place takes an action, a whole category or a subcategory, in any order.

⚡ Custom actions: any command on the wheel

  • In the admin menu, create an action with a name, an image and the command it runs, like /shop. Use it for mods that are not integrated with Actio.
  • The command runs as the player who picked the action, with that player's permissions. Actio never runs a command as the console.
  • Mark an action as only for administrators to hide it from other players (permission merlinz.actio.wheel.admin; OPs have it).
  • Create your own subcategories, each with a name and an image, and pick one on each action.
  • Choose the image from 20 ready-made icons or from the item icons of the game and of your mods, with search by name.
  • Up to 24 custom actions.

📏 The size you choose

  • The wheel has 5 slices by default, like the Z wheel, or 7, 10 or 15, counting the X. More slices fit more actions per level.
  • The wheel's images are light and don't compete for room with the game's or other mods' images.

🔌 A public API for other mods

  • Any mod registers its actions, with the name in the player's language, its own icon, a category and a subcategory, and can turn on the red dot of an action for a player.
  • Actio doesn't depend on any other mod: the mail, the economy or any other mod plugs into it the same way. Without Actio on the server, those mods keep their own commands.
  • Actions from other mods come and go on their own when each mod starts and stops, and the console lists them.
  • The integration guide has the setup, a complete example and the reference.

🛠️ Admin menu and test actions

  • /actio menu opens an in-game admin menu with two tabs. Options: test actions, categories, mod icons, the menu shortcut on the wheel, the time to rest the mouse, the size of the wheel and, without categories, what each place shows. Custom actions: the actions and subcategories you create.
  • The magnifier of each place opens a screen to browse the wheel, level by level, and choose an action, a category or a subcategory for that place.
  • Administrators get an Actio menu shortcut on the wheel, in Tools. Turn it off in the menu if you don't want it.
  • Changes stay in a draft until you click Apply, which writes config.json and takes effect at once. Undo goes back to what is saved.
  • Test actions, off by default, put sample actions on the wheel that only send a chat message, to see the wheel without any other mod.
  • The menu shares the look of the author's other mods: the game's blue, gold details and a wax seal with a lightning bolt.

Requirements

Hytale server 0.7.x (Update 7). Tested on 0.7.5
Other mods None required. The wheel shows the actions of any mod that uses the Actio API, such as a mail or an economy mod

Each Actio version supports one Hytale update. The Hytale API changes with each update, so don't update your server to a new Hytale update before an Actio version for it is out.

Actio Hytale
1.1.0 0.7.x (Update 7), tested on 0.7.5
1.0.0 0.7.x (Update 7), tested on 0.7.5

Installation

  1. Stop the server.
  2. Put Actio-<version>.jar in the server's mods folder. Keep only one Actio jar there.
  3. Start the server. Actio creates its files in mods/Merlinz_Actio/, and the console shows Actio loaded.
  4. Add the mods whose actions you want on the wheel, and create custom actions for the others in /actio menu. To see the wheel full without any of them, turn on the test actions with /actio testactions on, and turn them off before players join.

Uninstalling. Stop the server with /stop while Actio is still installed: it removes the wheel's E from every online player. Then remove the jar. After a crash, let each player who was online join once with Actio before removing it.

Commands

All commands are for admins. A subcommand also needs the permission of /actio. OPs have all of them. Every command except menu also runs in the console.

Command What it does Permission
/actio Shows how many actions are registered and whether test actions and categories are on merlinz.actio.command.actio
/actio menu Opens the admin menu merlinz.actio.command.actio.menu
/actio reload Reloads config.json with no restart merlinz.actio.command.actio.reload
/actio testactions on · off Turns the test actions on or off, saves config.json and takes effect at once merlinz.actio.command.actio.testactions

Configuration

mods/Merlinz_Actio/config.json, applied with /actio reload or from the admin menu:

Key Default What it does
TestActions false Puts the test actions on the wheel. Keep it false on a real server
Categories true Shows the categories on the wheel. false shows what you chose for each place in WheelActions
Slices 5 How many slices the wheel has, counting the X: 5, 7, 10 or 15
HoverSeconds 1.0 How long to rest the mouse on a category, "More" or Back to open it, from 0.25 to 5 seconds
WheelActions one empty per place Only with Categories off: what each place shows, from the top, clockwise, one less than Slices: an action id, a category (@Economy, @Social, @Tools, @Other), a subcategory (@Economy/<subcategory id>) or "" for an empty place. Up to 14, with no repeats
ExternalIcons true Shows the icons each mod gave its actions. false shows every action with Actio's star
MenuAction true Puts the Actio menu shortcut on the wheel of administrators
CustomSubcategories empty The subcategories you created for custom actions. Use the admin menu
CustomActions empty The custom actions, each with its name, image, category, command, subcategory and whether it is only for administrators. Use the admin menu

A file with an error (bad JSON, an unknown or missing key, a value out of range) is refused whole, with the reason in the console, and Actio keeps the settings it had.

Known limits

  • The translations of German, Spanish, French, Russian and Chinese have not been reviewed by native speakers yet. Server logs and config file errors are always in English.
  • The wheel has 5, 7, 10 or 15 slices: the game client can't rotate images, so each size is drawn in advance.
  • If another mod already binds E on the player, Actio leaves it alone, and the wheel doesn't open for that player.
  • With an empty main hand, E belongs to Actio even when the wheel is empty.
  • A custom action's name is the text the admin wrote, the same in every language.
  • The wheel's E is saved in the player's file while their hand is empty. Only a server crash leaves it there, and the player's next join with Actio fixes it. See "Uninstalling" above.

License

Free to use on any number of servers, including monetized servers. You may not republish, redistribute, sell or distribute modified versions of Actio. See the license on this page for the full text.

Actio is an unofficial mod. It is not made, endorsed or supported by Hypixel.


Support

Actio is free. If it helps your server, you can support its development on Ko-fi. Thank you!

Support Actio on Ko-fi

Project description from CurseForge.

Pick your setup

Actio: Action Wheel releases for each Hytale build.

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Actio: Action Wheel releases and Hytale builds

3 of 3 releases match

Looking for an older file? The official CurseForge project page is in Resources.