Action List

Reference of all 12 typed actions supported in action: and actions: blocks.

---

Action Summary Table

Action Type (type)	Parameters	Description
command	command, executor	Executes a command as player or console.
player-command	command	Executes a command as the clicking player.
console-command	command	Executes a command with elevated server console privileges.
open-menu	menu	Transitions to the specified menu ID (waits for render).
close-menu	None	Safely closes the original UI session.
message	message	Sends a formatted chat message to the player.
sound	sound, volume, pitch	Plays a sound effect to the player.
title	title, subtitle, fade-in, stay, fade-out	Shows an on-screen title banner.
teleport	world, x, y, z, yaw, pitch, reset-velocity, no-fall-ticks (safe is parsed but has no effect)	Teleports player to world and coordinates.
delay	duration	Asynchronously delays subsequent action execution without thread blocking.
potion-effect	effect, duration, amplifier, ambient, particles	Applies a status effect or buff to the player.
input	prompt, input-type (string / integer / decimal), min, max, timeout-seconds, variable, command, actions	Prompts player for chat input before proceeding.

---

Action Examples

command

type: command
command: "spawn"
executor: player # player (default) or console; anything else is an error

command is required. type: player-command and type: console-command likewise reject an empty command (empty-command).

player-command

type: player-command
command: "warp survival"

console-command

type: console-command
command: "eco give {player} 1000"

open-menu

type: open-menu
menu: "shop"

close-menu

type: close-menu

message

type: message
message: "&aItem purchased successfully!"

sound

type: sound
sound: "ENTITY_PLAYER_LEVELUP"
volume: 1.0 # default: 1.0
pitch: 1.2  # default: 1.0

An unknown sound name logs a warning (unknown-sound) and removes only this action. The menu still opens.

title

type: title
title: "&6&lQUEST COMPLETED"
subtitle: "&aReward granted"
fade-in: 10  # ticks (default: 10)
stay: 70     # (default: 40)
fade-out: 20 # (default: 10)

At least one of title and subtitle is required. Negative tick values are rejected.

teleport

type: teleport
world: "world"
x: 100.5
y: 64.0
z: -200.5
yaw: 0.0
pitch: 0.0
reset-velocity: true # reset momentum (default: true)
no-fall-ticks: 40    # ticks to keep resetting fall distance (default: 0, max 1200)

The safe key is parsed but unused by the current implementation (no safe-spot search is performed).

delay

type: delay
duration: 2s # 500ms, 2s, 1m, 40t, ... Zero or invalid values are errors

potion-effect

type: potion-effect
effect: "SPEED"   # required; a constant such as SPEED or a key such as speed
duration: 30s     # default: 10s
amplifier: 1      # 0 = Lv1, 1 = Lv2 (default: 0)
ambient: true     # default: false
particles: true   # default: true

An unknown effect name fails at click time and stops the remaining actions.

input

type: input
prompt: "&eEnter withdrawal amount:"
input-type: integer  # string (default), integer, decimal
min: 1
max: 50000
timeout-seconds: 30 # default: 60
variable: input      # default: input (the name of `{input}`)
command: "bank withdraw {player} {input}" # must contain {variable-name}

See Advanced Actions for details.