Actio

Actio 1.0.0: the first release. The action wheel on E, where any mod puts its actions.

Works with Hytale 0.7.x (Update 7). Tested on 0.7.5, in game, on a local server: the wheel in all four sizes, the categories, the indicator, actions from other mods through the API, the test actions and the admin menu.

The first version of Actio brings the action wheel: hold E with an empty hand to open a wheel in the middle of the screen, and release E to pick the action you are looking at. Any mod puts its actions on it, and Actio sorts them into categories; the admin chooses how the wheel looks in an in-game menu, and can turn on test actions to see the wheel without any other mod.

The action wheel on E

With an empty main hand, holding E opens a wheel shaped like the game's Z wheel, in the look of the author's windows: the game's blue, gold lines between the slices and the marked slice in gold. The camera stays still while the wheel is open, and moving the mouse marks the slice on that side; a gold dot shows where you are looking, and the center shows the icon and the name of what is marked. Releasing E on an action picks it; on the X, at the bottom, the wheel just closes. Taking damage, switching slots, an item in the hand and changing worlds close the wheel without picking anything. The wheel also opens with a shield or a torch in the off hand, and a weapon with its own E keeps its E.

With no action on the wheel, nothing changes: E stays the game's.

A wheel of the size the admin chooses

The admin chooses how many slices the wheel has: 5, like the Z wheel, 7, 10 or 15, counting the X, which is always at the bottom. More slices fit more actions per level before "More", with narrower slices and, at 15, slightly smaller icons. The choice is in config.json (Slices) and in the admin menu, and takes effect the next time each player opens the wheel. The wheel's images are light and don't compete for room with the game's and other mods' images.

The indicator next to the heart

While the wheel has actions, a small wheel with the E shows to the left of the heart, to remind players of the key. A red dot on it says some action has something new.

Categories, "More" and Back

Actions are sorted into four categories (Economy, Social, Tools and Other) and, inside them, into each mod's subcategory. Resting the mouse on a category for a second shows what is inside: an arrow on the icon's corner says it opens, and a bar in the center fills while the mouse rests; at the bottom, the X becomes Back. With more items than fit, the last slice becomes "More" and shows the next ones. A category with a single subcategory opens straight to its actions. The red dot of an action also shows on its category and subcategory.

For mods: the API

A mod registers its actions, with the name in the player's language, its own icon, the category and the subcategory, and turns on the red dot of an action for a player. Without Actio on the server, the mod keeps its own commands. The API contract is version 1.

For admins: the menu, the test actions and the commands

/actio menu opens a screen with the options: turn the test actions, the categories and the mods' icons on and off, the time to rest the mouse, the size of the wheel and, without categories, the action in each place of the wheel. On/off options are a switch, with On and Off side by side and the current state lit. Changes stay in a draft until the admin clicks Apply, which writes config.json and takes effect at once; Undo goes back to what is saved, and closing without applying saves nothing. An action chosen in two places shows its name in red in both, without disappearing from either, and Apply saves nothing while there is a repeat: it says in which places it is. The screen has the common look of the author's windows, with the lightning bolt seal.

/actio testactions on puts the test actions on the wheel, which only send a chat message, and off removes them. /actio shows the state of the wheel, and /actio reload reloads the file. If a mod's image causes trouble in the client, ExternalIcons set to false shows every action with Actio's star.

The wheel's E leaves the player when they leave the server, on /stop and when the mod unloads; only a server crash leaves it saved, and the player's next join fixes it. Before uninstalling, stop the server with /stop while Actio is still installed.

Languages

English, Portuguese, German, Spanish, French, Russian and Chinese.