Actions

When player accomplishes the conditions, you can execute a diverse list of actions. You can also use variables in the actions list.

Some actions can be executed on all living entities if you are using the to_target action tag.

Message

Sends a message to the player.

message: &aGreat %player%! You''ve just received $5000!

# Only if use_minimessage option is enabled in the config
message: <green>Great %player%! You''ve just received $5000!

Centered Message

Sends a centered message to the player.

centered_message: &c&lWELCOME TO THE SERVER

# Only if use_minimessage option is enabled in the config
centered_message: <red><b>WELCOME TO THE SERVER

When use_minimessage is enabled in the config:

This action only supports color MiniMessages tags. (You can't use other tags like <hover> or <click>, if you want to do so, use the message action and center the text manually)

Console Message

Sends a message to the console.

console_message: %player_name% left the server with IP %player_ip%

JSON Message

Sends a JSON message to the player. These messages allows you to add click and hover events. You can generate JSON messages on this link: https://minecraft.tools/en/json_text.php

json_message: {"text":"Welcome to the server","underlined":true,"color":"red"}

Mini Message

Sends a message in the Mini Message format https://docs.advntr.dev/minimessage/index.html

Only works on Paper 1.19.4+.

mini_message: Welcome to the <b><color:#91ff52>SERVER</color></b>!

Ifuse_minimessage is enabled in the config you don't need to use this action, just use the message action instead.

Console Command

Executes a command from the console.

console_command: eco give %player% 5000

Player Command

Executes a command from the player.

player_command: warp survival

Player Command as Op

Executes a command from the player as OP. (Not recommended)

player_command_as_op: help

Player Send Chat

Sends a message in chat from the player. You can even execute a command that is not registered.

player_send_chat: &2Hello
player_send_chat: /rewards

Teleport

Teleports the player/entity. Use this format: "teleport: world;x;y;z;yaw;pitch"

teleport: lobby;0;60;0;90;0

Works with all living entities when using the to_target action tag.

Give Potion Effect

Gives a potion effect to the player/entity. Use this format: "give_potion_effect: effect;duration_in_ticks;level;show_particles;show_icon" You can find a list of potion effects here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html

# Poison effect with no particles
give_potion_effect: POISON;120;1;false

# Speed effect with particles and icon
give_potion_effect: SPEED;120;1;true;true

Works with all living entities when using the to_target action tag.

Remove Potion Effect

Removes a potion effect from the player/entity. Use "all" to remove all potion effects.

remove_potion_effect: POISON
remove_potion_effect: all

Works with all living entities when using the to_target action tag.

Cancel Event

Whether event should be cancelled or not. Use this format: "cancel_event: true/false"

cancel_event: true

Kick

Kicks the players from the server.

kick: &cWhat are you trying to do?

Play Sound

Plays a sound to the player. Use this format: "playsound: sound;volume;pitch;(optional, location)<x>,<y>,<z>,<world>" You can find a list of sounds here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html Use this list instead when using 1.8: https://helpch.at/docs/1.8.8/index.html?org/bukkit/Sound.html

playsound: BLOCK_NOTE_BLOCK_PLING;10;0.1

# Playsound on location
playsound: BLOCK_NOTE_BLOCK_PLING;10;2;100,60,-127,world

Play Sound Resource Pack

Plays a resource pack sound to the player. The format is the same as playsound action.

playsound_resource_pack: my_custom_sound;10;1

# Playsound on location
playsound_resource_pack: my_custom_sound;10;2;100,60,-127,world

Stop Sound

Stops a sound for a player. Use stopsound: <sound> for specific sound. Only works on 1.10+. Use stopsound: all for stopping all sounds. Only works on 1.17+. You can find a list of sounds here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html

stopsound: BLOCK_NOTE_BLOCK_PLING
stopsound: all

Stop Sound Resource Pack

Stops a resource pack sound for a player. Only works on 1.10+.

stopsound_resource_pack: scorpions:custom.test

Gamemode

Sets a gamemode for the player. Possible gamemodes: CREATIVE, SURVIVAL, ADVENTURE, SPECTATOR

gamemode: CREATIVE

Send to Server

Sends the player to a bungee server.

send_to_server: lobby

Actionbar

Sends an actionbar message to the player. Use this format: "actionbar: message;duration" (The duration must be in ticks, 20ticks = 1second) On repetitive events, use a time of 0 for no flickering.

actionbar: &6Welcome to the server;120

Title

Sends a title and subtitle message to the player. Use this format: "title: fadeIn;stay;fadeOut;title;subtitle" (The duration of fadeIn, stay and fadeOut must be in ticks, 20ticks = 1second) If you want just a title, or just subtitle write "none"

title: 20;40;20;&6This is a title;none

Damage

Damages the player/entity a specific amount.

damage: 5

Works with all living entities when using the to_target action tag.

Set On Fire

Sets the player/entity on fire for a certain duration in ticks. (20ticks = 1 second)

set_on_fire: 60

Works with all living entities when using the to_target action tag.

Freeze

Freezes the player/entity for a certain duration in ticks. (20ticks = 1 seconds). Only works on 1.17+.

freeze: 300

Works with all living entities when using the to_target action tag.

Heal

Heals the player/entity a specific amount.

heal: 5

Works with all living entities when using the to_target action tag.

Set Food Level

Sets the current food level of the player with a specific amount. Should be between 0 and 20.

set_food_level: 20

Throw Directional

Will throw players toward the direction they are looking at, with a certain strength (impulse).

Don't use values greater than 6, the impulse will behave weird, this is a Minecraft limitation.

throw_directional: 2

Works with all living entities when using the to_target action tag.

Throw Coordinate

Similar to Throw Directional. In this case, players will be throwed following the strength defined in each coordinate. Use this format: "throw_coordinate: <strength_x>;<strength_y>;<strength_z>"

Don't use values greater than 6, the impulse will behave weird, this is a Minecraft limitation.

# This will impulse the player up.
throw_coordinate: 0;2;0

# This will impulse the player to -X and -Z
throw_coordinate: -1;0;-1

Works with all living entities when using the to_target action tag.

Close Inventory

Closes the player opened inventory.

close_inventory

Clear Inventory

Clears the player inventory.

clear_inventory

Wait

Waits X amount of seconds before executing more actions.

 - 'message: &a3'
 - 'wait: 1'
 - 'message: &a2'
 - 'wait: 1'
 - 'message: &a1'
 - 'wait: 1'
 - 'message: &aGo!'

Wait Ticks

Waits X amount of ticks before executing more actions. (20ticks = 1 second)

 - 'message: &a3'
 - 'wait_ticks: 20'
 - 'message: &a2'

Remove Item

Removes X amount of items from the player inventory. Use this format: remove_item: <type>;<amount>;datavalue: <datavalue>;name: <name>;lorecontains: <lore_line>

Datavalue, name and lorecontains attributes are OPTIONAL. Don't use color formatting.

You can find a list of valid types of items here: For latest versions: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html For 1.8: https://helpch.at/docs/1.8/org/bukkit/Material.html

You can also use the CheckItem expansion of PlaceholderAPI (https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders#checkitem) to remove items, following this format: remove_item: %checkitem_remove_,,<...>%

# This will remove x5 Diamonds from the player inventory.
remove_item: DIAMOND;5

# This will remove x1 Coal Block named "Burst Turret"
# from the player inventory.
# You must download the CheckItem expansion from PlaceholderAPI
# using /papi ecloud download CheckItem
remove_item: %checkitem_remove_mat:COAL_BLOCK,nameequals:&aBurst &6Turret,amt:1%

Remove Item Slot

Removes X amount of items from a certain slot of the player inventory. Use this format: remove_item_slot: <slot>;<amount>

Valid Slots: HAND, OFF_HAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS You can also use numerical values, check all slots here: https://static.wikia.nocookie.net/minecraft_gamepedia/images/b/b2/Items_slot_number.png/revision/latest/scale-to-width-down/352?cb=20170708121246

remove_item_slot: HAND;1
remove_item_slot: 0;1

Firework

Spawns a firework from the player/entity location. Use this format: firework: colors:<color1>,<color2> type:<type> fade:<color1>,<color2> <propertyN>:<valueN>

Mandatory Properties:

colors:<color1>,<color2>,<colorN> (Main colors of the firework. All colors here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Color.html. You can specify the name of the color, or a HEX color code in this format: #<color>)

type:<type> (Type of the firework. All types here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/FireworkEffect.Type.html)

power:<power> (Power of the firework, could be 0,1,2,3)

Optional Properties:

fade:<color1>,<color2>,<colorN> (Fade colors of the firework. All colors here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Color.html. You can specify the name of the color, or a HEX color code in this format: #<color>)

flicker:<true/false> (Whether the firework must have the flicker property or not)

trail:<true/false> (Whether the firework must have the trail property or not)

location:<x>;<y>;<z>;<world> (Location to spawn the firework)

shot_direction:<x_min>,<x_max>;<y_min>,<y_max>;<z_min>,<z_max>;<velocity_min>-<velocity_max> (Direction and velocity of the firework. Use values between -1 and 1 on the x,y,z properties, and values higher than 0 in the velocity property. Only works on 1.15+)

firework: colors:YELLOW,RED type:BALL fade:AQUA power:0

Works with all living entities when using the to_target action tag.

Lightning Strike

Generates a lightning strike effect that does no damage, at certain location. Use this format: lightning_strike: <world>;<x>;<y>;<z>

lightning_strike: %victim_block_world%;%victim_block_x%;%victim_block_y%;%victim_block_z%

Particle

Spawns a particle on the player/entity location. Use this format: particle: effect:<effect_name> offset:<x>;<y>;<z> speed:<speed> amount:<amount> force:<true/false>

Mandatory Properties:

effect:<effect_name> (Name of the particle/effect: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html) amount:<amount> (Amount of particles to spawn) Optional Properties: offset:<x>;<y>;<z> (The distribution of dispersion of the particle to spawn) speed:<speed> (The speed of the particles, defaults to 0) location:<x>;<y>;<z>;<world> (Location to spawn the particle) force:<true/false> (Whether to force show the particles to the player regardless of the client settings) for_player:<true/false> (Whether the particle should be shown only for the player executing the event, defaults to false)

You can spawn a Redstone particle with colors, configuring the effect as:

REDSTONE;<red>;<green>;<blue> (1.9-1.20.4)

DUST;<red>;<green>;<blue> (1.20.5+)Color codes: https://htmlcolorcodes.com/

Only works on 1.9+

particle: effect:EXPLOSION_LARGE offset:0.1;0.1;0.1 speed:1 amount:5 for_player:true

Works with all living entities when using the to_target action tag.

Give Item

Gives an item to the player. Use this format: give_item: id:<id>;<property>:<value>;<propertyN>:<valueN>

General properties:

id:<id> (MANDATORY, all ids here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html) amount:<amount> durability:<durability> custom_model_data:<custom_model_data> name:<name> lore:<lore_line1>|<lore_lineN> enchants:<enchant1>-<level1>|<enchantN>-<levelN> (All enchant names here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/enchantments/Enchantment.html) flags:<flag1>|<flagN> (All flag names here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/inventory/ItemFlag.html)

Player Head properties:

skull_texture:<skull_texture> (Texture value of the head. Can be found here: https://minecraft-heads.com/custom-heads) skull_owner:<skull_owner> (A player name) skull_id:<skull_id> (Skull Id value of the head. Can be found here: https://minecraft-heads.com/custom-heads) Slot properties:

slot:<slot> (If you want to give the item on a certain slot. Valid Slots: HAND, OFF_HAND, HELMET, CHESTPLATE, LEGGINGS, BOOTS. You can also use numerical values, check all slots here: https://mcutils.com/inventory-slots) slot_replace:<true/false> (Whether you want to replace any items on the selected slot) Custom Model Component Data properties (1.21.4+):

More info here: https://minecraft.wiki/w/Data_component_format/custom_model_data custom_model_component_data_strings:<string1>|<stringN> custom_model_component_data_flags:<flag1>|<flagN> custom_model_component_data_floats:<float1>|<floatN> custom_model_component_data_colors:<color1>|<colorN>

Model (1.21.4+):

More info here: https://minecraft.wiki/w/Items_model_definition item_model:<namespace>|<id> Saved item:

saved_item:<name> (If instead you want to give an already saved item using /ce item save command)

give_item: id:IRON_HELMET;amount:1;name:&6Basic Helmet

Drop Item

Drops an item in a certain location. Use this format: drop_item: location:<x>,<y>,<z>,<world>;id:<id>;<property>:<value>;<propertyN>:<valueN>

General properties:

id:<id> (MANDATORY, all ids here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html) location:<x>,<y>,<z>,<world> (MANDATORY)

All give_items action properties apply as well!

drop_item: location:%block_x%,%block_y%,%block_z%,%block_world%;id:DIAMOND;name:&bUnique Diamond

Set Block

Places a block in a certain location. Use this format: set_block: location:<x>,<y>,<z>,<world>;id:<id>;block_data:<block_data>. Only works on 1.13+.

General properties:

id:<id> (MANDATORY, all ids here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html) location:<x>,<y>,<z>,<world> (MANDATORY)

Optional properties:

Block data

The block data attribute is OPTIONAL and represent some states that the block can have. For example a stairs block could be facing north, south, east, west. A crops block has an age property.

This property has the following format: <property1>=<value1>,<propertyN>=<valueN>

You can check all Block Data properties here: https://minecraft.fandom.com/wiki/Java_Edition_data_values#Block_states

Skull data

skull_texture:<skull_texture> (Texture value of the head. Can be found here: https://minecraft-heads.com/custom-heads) skull_owner:<skull_owner> (A player name)

set_block: location:50,50,-256,world;id:DIAMOND_BLOCK

Summon

Spawns an entity at a certain location. Use this format: summon: location:<x>,<y>,<z>,<world>;entity:<entity>;<property>:<value>;<propertyN>:<valueN>

General properties:

entity:<entity> (MANDATORY, all entities here: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/entity/EntityType.html) location:<x>,<y>,<z>,<world> (MANDATORY)

Optional properties:

custom_name:<custom_name> (Custom name to be displayed above the entity) health:<health> (Max health of the entity) amount:<amount> (Amount of entities to spawn) scale:<value> (Scale/Size of the entity) Equipment/Hand Equipment properties: equipment:<helmet>,<chestplate>,<leggings>,<boots>

hand_equipment:<main_hand>,<off_hand>

Equipment of the entity, use a valid material on each slot: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html or 'none' if you don't want an item on the slot.

You can also use a texture value on the <helmet> slot to set a custom head.

You can also use a Saved Item on a slot like this: saved_item:<name>

summon: location:0,68,0,spawn;entity:SHEEP

summon: location:%player_x%,%player_y%,%player_z%,%player_world%;entity:ZOMBIE;custom_name:&4Aberration;equipment:eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZDJhMmFlNzQ5ZDAzYWU1Y2U3MmJjMmEyNmQyZTJhNThjZDVmMmU0MGM4ODMxODRiZjk2YzZhMjcwMDc4MmQyNiJ9fX0=,IRON_CHESTPLATE,none,none;amount:4

Call Event

Executes a "call" event. Use this format: call_event: <event_name>;%variable1%=<value1>;%variableN%=<valueN>

You can pass multiple variables to be used in a "call" event, but they are optional.

You can pass all already stored variables in a certain event adding the already_stored parameter: call_event: <event_name>;already_stored;%variableX%=<valueN>

example:
    type: player_command
    conditions:
    - "%main_command% == /test"
    actions:
      default:
      - "cancel_event: true"
      - "message: This is a test message from event 'example'"
      - "call_event: example2;%example_variable%=Something"

example2:
    type: call
    conditions:
    - "%example_variable% == Something"
    actions:
      default:
      - "message: This message will be sent only when event 'example2' is called"

Execute Action Group

Executes another action group from the event, randomly. Use this format: execute_action_group: <group1>:<prob1>;<groupN>:<probN> where <group> is the name of a created action group of the event, and <probability> is the chance of selecting the event (The probabilities don't need to sum 100%).

If you only want to execute a single action group, not randomly, you can do it by using: execute_action_group: <group1>:100

example:
    type: player_command
    conditions:
    - "%main_command% == /randomfirework"
    actions:
      default:
      - "cancel_event: true"
      - "execute_action_group: firework1:70;firework2:30;firework3:30"
      firework1:
      - "firework: colors:YELLOW,RED type:BALL fade:AQUA power:0"
      firework2:
      - "firework: colors:BLACK,WHITE type:BURST power:1"
      firework3:
      - "firework: colors:GREEN,BLUE type:BURST power:1"

PreviousConditions Next"To" Actions

Last updated 28 days ago

Was this helpful?