Built-in Actions

send

Send a coloured message to the current player.

send "&aGood job!" to player
send "You have $coins coins." to player

broadcast

Send a message to every online player.

broadcast "&6A world boss has spawned!"

title

Show a large title (and optional subtitle) on the player's screen.

title "&6Welcome!"
title "&6Round Start" subtitle "&eGet ready..."

actionbar

Display a message in the action bar — the text above the player's hotbar. Great for HUD-style prompts and non-intrusive notifications.

actionbar "&6Coins: &e$coins"
actionbar "&cLow health!"

give

Add items to the player's inventory. Amount defaults to 1.

give player diamond 5
give player iron_sword 1
give player cooked_beef 64

clear_inventory

clear_inventory player

heal

Fully restore the player's health to their maximum.

heal

feed

Fully restore the player's food level (sets food to 20 and saturation to 20).

feed

give_xp

Give the player a number of experience points.

give_xp 100
give_xp $reward

set_health

Set the player's health to a specific value. Clamped between 0 and the player's max health.

set_health 10
set_health player.max_health

set_food

Set the player's food level. Clamped between 0 and 20.

set_food 6
set_food 20

teleport

teleport player to 100 64 -200

move

Move the player relative to their current position.

move 0 1 0
move $dx $dy $dz

setblock

Place a block at exact world coordinates.

setblock 0 100 0 gold_block
setblock $x $y $z diamond_block

console

Run a command as the server console — bypasses all player permissions.

console eco give player.name 500
console gamemode creative player.name

execute

Run a command as the player — respects their permissions.

execute "warp spawn"
execute "kit starter"

The leading / is optional. Requires a player context.

kick / ban

kick player "You were kicked for idling."
ban player "Cheating detected."

sound

Play a sound at the player's location.

sound ENTITY_PLAYER_LEVELUP
sound BLOCK_NOTE_BLOCK_PLING 1.0 1.5

Arguments: <SoundName> [volume] [pitch]

particle

Spawn particles at the player's location.

particle FLAME 10
particle HEART 5

Arguments: <ParticleType> [count]

potion

Apply a potion effect to the player. Duration is in ticks (20 = 1 second). Amplifier starts at 0 (level I).

potion SPEED 200 1
potion STRENGTH 600 2

cancel_event

Cancel the Bukkit event that triggered your script. Alias cancelevent also works.

on BlockBreak:
    if player.gamemode == "adventure":
        cancel_event
        send "&cYou cannot break blocks in Adventure mode."

log

Write to the server console. See Logging.

store / load

Persist data across restarts. See Persistent Storage.

emit

Fire a custom event. See Custom Events.

gamemode

Set the player's game mode. Accepts survival, creative, adventure, spectator (or short forms s, c, a, sp).

gamemode creative
gamemode survival
gamemode $mode

weather

Set the weather in the player's current world. Accepts clear, rain, or thunder.

weather clear
weather rain
weather thunder

time

Set the time in the player's current world. Accepts named values (day, noon, sunset, night, midnight, sunrise) or a raw tick number.

time day
time night
time 6000
time $custom_ticks

close_inventory

Close the player's currently open inventory GUI.

close_inventory

lightning

Strike lightning at the player's current location, or at specific coordinates.

lightning
lightning 100 64 200
lightning $x $y $z

remove_potion

Remove a specific potion effect from the player.

remove_potion speed
remove_potion poison
remove_potion $effect

spawn_entity

Spawn a mob or entity at the player's current location.

spawn_entity ZOMBIE
spawn_entity SKELETON
spawn_entity $mob_type

set_display_name

Set the player's display name (chat and tab list). Supports & color codes.

set_display_name "&6[VIP] $player"
set_display_name "&c[Admin] $player"

set_walk_speed

Set the player's walk speed. Range: 0.0 – 1.0 (default 0.2).

set_walk_speed 0.4
set_walk_speed $speed

send_bossbar

Display a boss bar to the player. Syntax: send_bossbar <text> [color] [duration_ticks]. Color: PURPLE (default), BLUE, RED, GREEN, YELLOW, WHITE, PINK. Duration in ticks (20 = 1s, default 100).

send_bossbar "&cBoss Fight!" RED 200
send_bossbar "&aQuest Complete!" GREEN 100

equip

Place armor into a player's armor slot. Syntax: equip <slot> <material>. Slots: head, chest, legs, feet.

equip head DIAMOND_HELMET
equip chest IRON_CHESTPLATE

clear_effects

Remove all active potion effects from the player.

clear_effects

set_max_health

Set the player's maximum health attribute (default 20).

set_max_health 40
set_max_health $max_hp

set_fly

Enable or disable flight for the player. Syntax: set_fly <true|false>.

set_fly true
set_fly false

explode

Create a non-damaging, non-block-breaking explosion at the player's location. Syntax: explode [power]. Default power: 3.0.

command /boom:
    explode

command /bigboom:
    explode 6.0
    sound ENTITY_GENERIC_EXPLODE
    send "&cBOOM!" to player