Actions

This section is used for dialogues and actions. You can use PlaceholderAPI variables on actions.

Action	Description	Example
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
teleport	Teleports the player. Use this format: "teleport: world;x;y;z;yaw;pitch"	teleport: lobby;0;60;0;90;0
give_potion_effect	Gives a potion effect to the player. Use this format: "give_potion_effect: effect;duration_in_ticks;level;particles" You can find a list of potion effects here: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/potion/PotionEffectType.html	give_potion_effect: BLINDNESS;180;1;false
remove_potion_effect	Removes a potion effect from the player.	remove_potion_effect: BLINDNESS
playsound	Plays a sound to the player. Use this format: "playsound: sound;volume;pitch" 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_resource_pack	Plays a resource pack sound to the player. Uses the same format of the playsound action.	playsound_resource_pack: my_custom_sound;10;1
title	Sends a title and subtitle message to the player. Use this format: "title: fadeIn;stay;fadeOut;title;subtitle" 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
actionbar	Sends an actionbar message to the player. Use this format: "actionbar: message;duration" (The duration must be in ticks, 20ticks = 1second)	actionbar: &6Starting conversation...;60
remove_item	Removes X amount of items from the player inventory. You can check the format HERE.	remove_item: DIAMOND;10
firework	Spawns a firework from the player location. You can check the format HERE.	firework: colors:YELLOW,RED type:BALL fade:AQUA power:0
wait	Waits X amount of seconds before executing more actions.	wait: 2
wait_ticks	Waits X amount of ticks before executing more actions. (20ticks = 1 second)	wait_ticks: 10
influence	Sets, adds or removes influence from the current conversation entity for the player.	influence: set;5 influence: add;2 influence: remove;2

Remove Item

This is the format for the remove_item action: 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_,,<...>%

Example 1

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

Example 2

# This will remove x5 Diamonds named 'Unique Diamond' 
# from the player inventory.
remove_item: "DIAMOND;5;name: Unique Diamond"

Example 3

# This will remove x1 Coal Block named "Burst Turret"
# from the player inventory.
remove_item: "%checkitem_remove_mat:COAL_BLOCK,nameequals:&aBurst &6Turret,amt:1%"

Firework

This is the format for the firework action: firework: colors:<color1>,<color2> type:<type> fade:<color1>,<color2> power:<power>

The fade property is optional, the rest are necessary. You can add more than 2 colors.

Firework Colors: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Color.html Firework Types: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/FireworkEffect.Type.html

Example 1

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

Example 2

firework: colors:BLACK,WHITE type:BURST power:1