Actio

Actio

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

Actio is a server plugin. Everything runs on the server, so players need nothing installed. On its own it changes nothing for players: the wheel shows up as soon as a mod registers an action in it.

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

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.
• No actions, no change: with no mod registering actions, E stays the game's.

🔴 The indicator next to the heart

• While the wheel has actions, 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.
• The admin can turn the categories off and choose which action goes in each place of the wheel.

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

🛠️ Admin menu and test actions

• /actio menu opens an in-game admin menu with every option: test actions, categories, mod icons, the time to rest the mouse, the size of the wheel and, without categories, the action in each place.
• 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.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. To see the wheel 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 the actions of WheelActions directly, for a server with few mods
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: the action id of each place, from the top, clockwise, one less than Slices. "" leaves a place empty. Up to 14, with no repeats
ExternalIcons	true	Shows the icons each mod gave its actions. false shows every action with Actio's star

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