Wiki
Search…
Actions

Format

Starting with v2.0.0 the format for actions was changed to the following {properties} [id] args.

Properties

A set of key=value options separated by space. Read more about properties on their own page. πŸ‘‡

ID

Each action has its own unique identifier. The id is also case-insensitive, meaning that [CONSOLE] is the same as [console].

Default actions

Actions with dependencies

Available actions

Default actions

Commands

[console] - execute a command from console​

Arguments
Examples
<command>: String, the command to execute
[console] kill %player_name - make the console run /kill <name>

[player] - execute a command as the player that is using the voucher

Arguments
Examples
<command>: String, the command to execute (the slash is not required, unless the command has two or more)
[player] kit Daily - make the player run /kit Daily
Economy

[addexp] - give to the player an amount of EXP

Arguments
Examples
<amount>(L): Integer, amount of exp to add. By appending an L after, levels of exp will be given instead of points
[addexp] 100 - give 100 EXP points to the player
[addexp] 100L - give 100 levels of EXP to the player

[item] - give to the player a custom item

A format similar to EssentialsX's is used.
Arguments
Examples
Required
  • material(:damage): String, name of a Material. To specify its damage, add :damage after (INK_SACK:4 for lapiz lazuli on < 1.13)
  • amount: Integer, the amount of the item
Optional
  • name: String, the name of the item, use _ for space
  • lore: String, the lore of the item, use _ for space and | for a new line
  • flags: List, a comma separated list of ItemFlag names
  • unbreakable: make the item unbreakable, this argument doesn't require a value
  • model: Integer, the custom model data of this item (1.14.4+)
  • nbt: String, a JSON string representing item's NBT, some escaping should be done, mostly for quotes. This argument must be the last one since it takes everything that's after nbt: as value
For enchantments simply use Enchantment:level For name and lore , if you want to use _ and | you will have to escape them by adding a \ before.
[item] LEATHER_CHESTPLATE 1 lore:<red>What's</red>_<blue>up?</blue> - a leather chestplate with a lore saying What's up?

[voucher] - give vouchers to the player

Arguments
Examples
Required
  • name: String, the name of a voucher
Optional
  • amount: Integer, the amount of vouchers to give (default: 1)
  • args: String, similar to the give command​
[voucher] MoneyPouch 1 - one 'MoneyPouch' voucher
[voucher] Rank 1 VIP 7d - one 'Rank' voucher
Message

[bossbar] - display a boss bar on player's screen

Arguments
Properties
Examples
message: String, the message that will be displayed
color: String, the name of a Color (default: WHITE)
duration: Ticks, how long the bar will be displayed (default: 200 or 10 seconds)
flags: List, comma separated list of Flag names (default: empty)
overlay: String, the name of an Overlay (default: PROGRESS)
progress: Float, the progress of the bar (default: MAX_PROGRESS)
{color=BLUE progress=0.5 display=200} [bossbar] <green>Hey</green> - a blue bar that will stay on the screen for 10 seconds, with 50% progress and a green text saying Hey

[chat] - make the player send a message in chat

Arguments
Examples
message: String, the message that will be sent
[chat] <yellow>Hello everyone, my name is %player_name%!<yellow> - a yellow message saying Hello everyone, my name is <name>!

[message] - send a message to the player

Arguments
Properties
Examples
message: String, the message that will be sent.
broadcast: see Properties/Broadcast (default: none)
type: String, the type of the message (ACTION_BAR, CHAT, TITLE) (default: CHAT). Properties for TITLE:
  • fadeIn: Ticks, the time the title will fade-in (default: 10 or 0.5 seconds)
  • fadeOut: Ticks, the time the title will fade-out (default: 20 or 1 second)
  • stay: Ticks, the time the title will stay (default: 70 or 3.5 seconds)
For TITLE, use [n] to separate the title from subtitle (This is the title[n]And this is the subtitle)
{type=TITLE stay=100] [message] <blue>You have won</blue>[n]<dark_green>lt;/dark_green><green>50,000</green>- a title that will stay on the screen for 5 seconds saying You have won $50,000
[message] <red>Hey %player_name%, how are you?<red> - a red chat message saying Hey <name>, how are you?
Other

[data] - store a value that can be reused on the next actions

Arguments
Examples
key: String, the key of the value, must not contain spaces
value: Anything, the value
[data] %random% randomL:{100,200} [addmoney] %random% [message] You have received $%amount% Generate a random number and use it to give money and inform the player how much they got.

[effect] - give a potion effect to the player

Arguments
Properties
Examples
Required:
  • effect: String, the name of a PotionEffectType​
  • duration: Ticks, the duration of the effect
Optional:
  • amplifier: Integer, the amplifier of the effect (default: 1)
Universal: (available on all game versions)
  • ambient: Boolean, makes potion effect produce more, translucent, particles (default: true)
  • particles: Boolean, whether the effect has particles (default: true)
1.9 - 1.12.2:
  • color: ColorString, the color of the particles (default: none)
1.13+:
  • icon: Boolean, whether the icon of the effect will be displayed (default: true)
{particles=false} [effect] SPEED 200 1 - Speed II for 10s with no particles

[sound] - play a sound to the player

Arguments
Properties
Examples
sound: NamespacedKey, the key of the sound
broadcast: see Properties/Broadcast (default: none)
pitch: Float, the pitch of the sound (default: 0)
source: String, the name of a Source (default: MASTER)
volume: Float, the volume of the sound (default: 0)
{source=AMBIENT} [sound] minecraft:ambient.cave - play the sound from AMBIENT source
[sound] custom:sound_name - play a custom sound

Actions with dependencies

Vault

[addmoney] - add money to player's balance

An economy plugin is required to use this action.
Arguments
Examples
amount: Double, the amount of money to give
[addmoney] 125.50

[permission] add or remove a permission to the player

A permissions plugin is required to use this action.
Arguments
Examples
Required:
  • action: String, the name of the action to perform, ADD or REMOVE
  • permission: String, the permission node
Optional:
  • world: String, the name of the world where the permission will be added / removed (default: player's world)
[permission] ADD some.permission world_nether - add the permission only on world_nether
[permission] REMOVE some.permission - remove the permission global
Last modified 7mo ago
Copy link
On this page
Format
Properties
ID
Available actions
Default actions
Actions with dependencies