Actions & Inputs
Button actions
| Action | Behavior |
|---|---|
player: <command> | Runs a command as the clicking player. Do not include the leading slash. |
console: <command> | Runs a command as console. |
message: <MiniMessage> | Sends formatted text to the clicking player. |
menu: <menu-id> | Opens another configured CustomMenu dialog. |
close | Closes the current dialog. |
Multiple actions on one button execute from top to bottom.
Action placeholders
| Placeholder | Value |
|---|---|
%player% | Clicking player name. |
%uuid% | Clicking player UUID. |
%input_<key>% | Value submitted by an input with the matching key. |
Player-provided input is validated/sanitized before command substitution and escaped before MiniMessage substitution.
Input types
| Type | Important options |
|---|---|
text | width, max-length, initial; optional multiline settings such as max-lines and height. |
boolean | initial, on-true and on-false. Quote values such as "yes"/"no" in YAML. |
number | min, max, step and initial. |
option | options list containing ids/display labels and initial selection. |
After-action modes
| Value | Behavior |
|---|---|
close | Close after the action. Default. |
none | Keep the dialog open. |
wait_for_response | Show the client waiting state until the server acts. |