Actions
Actions are executable operations attached anywhere the configuration layer needs to "do something": menu items, menu open/close hooks, dialog buttons, item-pipeline link payloads, collection rewards, chat tag effects, and so on. They are written as strings following the format:
Global optional parameters available on every action:
Parameter | Type | Description |
|---|---|---|
| long (ticks) | Wait this many ticks before executing. 20 ticks = 1 second. |
| boolean | Run the action on an async thread instead of the main thread. Default |
All argument strings support placeholder substitution (%namespace_key%, %outer_{inner}%, $e(...) — see Placeholders) resolved through the caller's placeholder context.
Command Actions
console
Executes a command as the console (server operator).
player
Executes a command as the clicking player.
Player Actions
message
Sends a chat message to the player. Supports MiniMessage formatting.
actionbar
Displays a message in the player's action bar.
sound
Plays a sound to the player. Adventure sound key format: namespace:key (volume/pitch are resolved by the Sound adapter when included in the key string).
teleport
Teleports the player to a network location (cross-server aware).
connect
Transfers the player to another server group (resolved through the network's server registry).
give-item
Gives an item to the executing player. If a MailboxService is registered the item is delivered to the player's mailbox (giveOrAdd); otherwise it is added to their inventory and any overflow is dropped at their feet.
Arg | Type | Description |
|---|---|---|
|
| Required. A placeholder resolving to an |
| int | Optional. Overrides the stack size. Default |
Inventory Actions
close
Closes the player's currently open inventory.
Menu Navigation Actions
open-menu
Opens a menu by its ID. Parameters can be passed with :key=value syntax separated by colons.
Parameters become available as %parameters_<key>% placeholders in the opened menu.
open-dialog
Opens a dialog by its ID. Parameters follow the same :key=value syntax as open-menu.
refresh
Fully recomputes the current menu (re-evaluates all variables, requirements, and items).
refresh-slot
Recomputes a single slot index.
refresh-layout
Recomputes a named layout instance.
refresh-title
Re-evaluates the menu's title blueprint and pushes the new title to every open inventory window for this menu. Useful after a set-variable that the title interpolates, since changing variables alone does not redraw the window chrome.
Only the title is re-sent; item slots are untouched. Combine with [refresh] if you also need to recompute items.
next-page
Advances the named layout to the next page.
previous-page
Returns the named layout to the previous page.
first-page
Resets the named layout to page 0.
go-to-page
Jumps the named layout to an explicit page index.
Item Actions
These actions are visual / packet-level effects targeting the executing player. They take an item-stack as input (any placeholder that resolves to an ItemStack, including the wrapped form used in menus).
toast
Displays a vanilla advancement toast in the top-right corner using packet-level advancement spoofing — no real advancement is granted. Arguments are parsed as a constructor:
Arg | Type | Description |
|---|---|---|
|
| Icon shown in the toast. |
|
|
|
| MiniMessage | Toast title text. |
totem-animation
Plays the totem-of-undying animation for the player using the supplied item as the icon, without consuming anything. Internally the action briefly equips the item to the off-hand, fires entity event 35, then restores the original hand contents.
Arg | Type | Description |
|---|---|---|
|
| Item displayed during the animation. |
Variable Actions
set-variable
Sets or updates a menu variable. The value supports arithmetic ($e(...)) and ternary expressions.
See Variables for the full expression syntax.
Action Summary Table
ID | Argument | Description |
|---|---|---|
| command string | Run command as console |
| command string | Run command as player |
| MiniMessage text | Send chat message |
| MiniMessage text | Send action bar message |
| sound key | Play Adventure sound |
|
| Teleport (network-aware) |
| group name | Send player to a server group |
|
| Give an item to the player (mailbox if available) |
| — | Close inventory |
|
| Open menu with params |
|
| Open dialog with params |
| — | Recompute full menu |
| slot index | Recompute one slot |
| layout id | Recompute one layout |
| — | Re-send the menu title to all viewers |
| layout id | Go to next page |
| layout id | Go to previous page |
| layout id | Jump to first page |
|
| Jump to explicit page |
|
| Set menu variable |
|
| Show advancement toast (icon + title) |
|
| Play totem-of-undying animation with custom item |