Click actions

Actions are executed when a player clicks on an icon, they are configured through the ACTIONS attribute. There are many different types of actions that can be selected by using different prefixes.

Actions can contain colors, symbols and placeholders.

If an action opens another menu of Chest Commands or a GUI of an external plugin, set KEEP-OPEN: true.

Command as player (default)

If no prefix is specified, makes the player execute the command, as if they typed it in the chat.
Don't add a slash / at the start (WorldEdit commands need a single slash instead of two).

Format: <command>

Example (teleports the player to the spawn):

ACTIONS:
  - 'spawn'

Command as console

Executes a command directly from the console, bypassing permission checks.

Format: console: <command>

Example:

ACTIONS:
  - 'console: say Hello world!'

Command as OP

Executes a command as if the player was an operator (/op), bypassing permission checks.

Format op: <command>

Example:

ACTIONS:
  - 'op: say Hello world!'

Open another menu

Opens another menu. The player needs the menu-specific permission to open it.

Format: open: <file>

Example:

ACTIONS:
  - 'open: example.yml'

Display message

Sends a chat message to the player.

Format: tell: <message>

Example:

ACTIONS:
  - 'tell: &cHello there!'

Broadcast message

Sends a chat message to all online players.

Format: broadcast: <message>

Example:

ACTIONS:
  - 'broadcast: &d{player} is awesome!'

Play sound

Plays a sound to the player.

Format: sound: <sound name>, [pitch], [volume] where only <sound name> is strictly required (list of valid sounds in the latest Spigot version).

Example:

ACTIONS:
  - 'sound: ghast scream, 2.0, 0.5'

Give item

Gives an item to the player. If you need more advanced control, please use the vanilla /give command.

Format: give: <material>:[data value], [amount] where only <material> is stricly required.

Example (10 black wool):

ACTIONS:
  - 'give: wool:15, 10'

Give money

Gives money to the player. Requires a valid economy setup.

Format: give-money: <amount>

Example:

ACTIONS:
  - 'give-money: 100.0'

Send to BungeeCord server

Attempts to send the player to another BungeeCord server.

Format: server: <target>

Example:

ACTIONS:
  - 'server: hub'

Boss bar message (using BarAPI plugin)

Displays a message on the boss bar. You must have installed BarAPI.

Format: dragon-bar: <time in seconds> | <message>

Example:

ACTIONS:
  - 'dragon-bar: 10 | Hello, &a{player}'