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
[console] - execute a command from console
<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
<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
[addexp] - give to the player an amount of EXP
<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.
Required
material(:damage): String, name of a Material. To specify its damage, add
:damageafter (INK_SACK:4for lapiz lazuli on < 1.13)amount: Integer, the amount of the item
Optional
name: String, the name of the item, use
_for spacelore: String, the lore of the item, use
_for space and|for a new linecolor: ColorString, the color of the item, used for leather armor
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
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
[bossbar] - display a boss bar on player's screen
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
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
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>$</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?
[data] - store a value that can be reused on the next actions
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
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
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
[addmoney] - add money to player's balance
An economy plugin is required to use this action.
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.
Required:
action: String, the name of the action to perform,
ADDorREMOVEpermission: 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 updated
Was this helpful?