Actions

Wiki

Discord

Search…

👋

Hey

🔌

Resources

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. 👇
Properties
ID
Each action has its own unique identifier. The id is also case-insensitive, meaning that [CONSOLE] is the same as [console].
Default actions
Commands
​[console] <command>​
​[player] <command>​
Economy
​[addexp] <amount>(L)​
​[item] <material>(:damage) <amount> (args...)​
​[voucher] <name> (amount) (args...)​
Message
​[bossbar] <message>​
​[chat] <message>​
​[message] <message>​
Other
​[data] <key> <value>​
​[effect] <effect> <duration> (amplifier)​
​[sound] <sound>​
Actions with dependencies
Crates
​[givecratereloadedkey] <crate> (amount)​
​Vault​
​[addmoney] <amount>​
​[permission] <ADD/REMOVE> <permission.node> (world)​
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

v2.0.0

Properties

Last modified 7mo ago

Copy link

On this page

Format

Properties

Available actions

Default actions

Actions with dependencies

Format

Properties

ID

Default actions

Actions with dependencies

Available actions

Default actions

[console] - execute a command from console​

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

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

[item] - give to the player a custom item

[voucher] - give vouchers to the player

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

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

[message] - send a message to the player

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

[effect] - give a potion effect to the player

[sound] - play a sound to the player

Actions with dependencies

[addmoney] - add money to player's balance

[permission] add or remove a permission to the player

[console] - execute a command from console