Patterns: | |
Since: | 2.9.0 |
Requirements: | Spigot 1.19.4+ |
Examples:
Patterns: |
|
Since: | 2.0 |
Requirements: | Supported regions plugin |
Examples:
description: set the block at your crosshair to a different type
trigger:
player cannot build at the targeted block:
message "You do not have permission to change blocks there!"
stop
set the targeted block to argument
Patterns: |
|
Since: | 1.0 |
Examples:
player has enough space for 64 feathers
Patterns: |
|
Since: | 2.8.0 |
Examples:
send "You can pick up items!" to player
on drop:
if player can't pick up items:
send "Be careful, you won't be able to pick that up!" to player
Patterns: | |
Since: | 2.3 |
Examples:
message "<light red>The player %player-argument% is not online!"
Patterns: |
|
Since: | 1.0 |
Examples:
drop a diamond
chance of {chance}% # {chance} between 0 and 100
chance of {chance} # {chance} between 0 and 1
Patterns: |
|
Since: | 1.0 |
(was|were)
or will be
instead of (is|are)
respectively, which check different time states of the first expression. Examples:
time in the player's world is greater than 8:00
the creature is not an enderman or an ender dragon
Patterns: |
|
Since: | 1.0 |
Examples:
player has 4 flint and 2 iron ingots
{list::*} contains 5
Patterns: |
|
Since: | 2.0 |
Examples:
on damage:
damage was caused by lava, fire or burning
victim is a player
victim has a potion of fire resistance
cancel event
apply fire resistance to the victim for 30 seconds
remove 1 potion of fire resistance from the victim
# prevent mobs from dropping items under certain circumstances
on death:
entity is not a player
damage wasn't caused by a block explosion, an attack, a projectile, a potion, fire, burning, thorns or poison
clear drops
Patterns: |
|
Since: | 2.7 |
Requirements: | Minecraft 1.16+ |
Examples:
Patterns: |
|
Since: | 2.7 |
Usable in events: | Egg Throw |
Examples:
if an entity won't hatch:
send "Better luck next time!" to the player
Patterns: |
|
Since: | 2.8.0 |
Requirements: | MC 1.13+ (cows, sheep & snowmen), Paper 1.19.4+ (all shearable entities) |
Examples:
send "This entity has nothing left to shear!" to player
Patterns: | |
Since: | 2.6.1 |
Requirements: | Minecraft 1.16+ (in water), Paper 1.16+ (in rain, lava and bubble column) |
Examples:
if player is in water:
player is in lava:
player is in bubble column
Patterns: |
|
Since: | 2.2-dev36 |
Examples:
if event is cancelled:
broadcast "no clicks allowed!"
Patterns: | |
Since: | 1.2 |
Examples:
on damage:
projectile exists
broadcast "%attacker% used a %projectile% to attack %victim%!"
Patterns: |
|
Since: | 2.5 |
Examples:
Patterns: | |
Since: | 2.3 |
Examples:
message "Your custom weather is %player's weather%"
Patterns: |
|
Since: | 2.5 |
Requirements: | 1.14+ |
Examples:
Patterns: |
|
Since: | 2.8.0 |
Examples:
Patterns: |
|
Since: | 2.8.0 |
Examples:
send "You can't use this item right now. Wait %item cooldown of player's tool for player%"
Patterns: |
|
Since: | 2.9.0 |
Requirements: | Spigot 1.20.5+ |
Examples:
if additional tooltip of {_item} is hidden:
Patterns: |
|
Since: | 2.8.0 |
Examples:
victim has line of sight to attacker
player has no line of sight to location 100 blocks in front of player
Patterns: |
|
Since: | 2.2-dev36 |
Examples:
Patterns: |
|
Since: | 1.0 |
Examples:
victim has the permission "admin":
send "You're attacking an admin!" to attacker
Patterns: |
|
Since: | 1.4, 2.7 (multiple players) |
Examples:
player hasn't played before
Patterns: |
|
Since: | 2.6.1 |
Examples:
send "You are sonic!"
if all players have potion effects speed and haste:
broadcast "You are ready to MINE!"
Patterns: | |
Since: | 2.4 |
Requirements: | Paper 1.9 or newer |
Examples:
Patterns: | |
Since: | 2.3 |
Examples:
Patterns: |
|
Since: | 2.5 |
Requirements: | Paper 1.13 or newer |
Examples:
loop all players in radius 3 of the last spawned creeper
send "RUN!!!" to the loop-player
Patterns: | |
Since: | 2.0, 2.4-alpha4 (non-living entity support) |
Examples:
on shoot:
while the projectile is alive:
Patterns: |
|
Since: | 1.4 |
Examples:
victim is not IP-banned
"127.0.0.1" is banned
Patterns: |
|
Since: | 2.7 |
Usable in events: | respawn |
Requirements: | Minecraft 1.16+ |
Examples:
the respawn location is a bed
broadcast "%player% is respawning in their bed! So cozy!"
Patterns: |
|
Since: | 2.4 |
Examples:
{list::*} are blocks
Patterns: | |
Since: | 2.5 |
Examples:
send "This block is well-powered by redstone!"
if clicked block is indirectly redstone powered:
send "This block is indirectly redstone powered."
Patterns: | |
Since: | unknown (before 2.1) |
Examples:
victim is blocking
damage attacker by 0.5 hearts
Patterns: | |
Since: | 1.4.4 |
Examples:
victim is burning:
increase damage by 2
Patterns: |
|
Since: | 2.5 |
Examples:
broadcast "A charged creeper is at %location of last spawned creeper%"
Patterns: |
|
Since: | 2.8.0 |
Requirements: | Minecraft 1.17+ |
Examples:
wait a second
if the last spawned spider is climbing:
message"The spider is now climbing!"
Patterns: |
|
Since: | 2.2-dev36 |
Examples:
player's tool is edible
Patterns: |
|
Since: | unknown (before 2.1) |
Examples:
Patterns: |
|
Since: | 1.4.6 |
Examples:
helm, chestplate, leggings or boots are enchanted
Patterns: |
|
Since: | 2.9.0 |
Requirements: | Spigot 1.20.5+ |
Examples:
if {_items::*} aren't resistant to fire:
Patterns: |
|
Since: | 2.2-dev36 |
Examples:
player's tool is flammable
Patterns: |
|
Since: | 2.5.1 |
Requirements: | Minecraft 1.11.2+ |
Examples:
if player's tool is not fuel:
send "Please hold a valid fuel item in your hand"
cancel event
Patterns: |
|
Since: | 2.7 |
Examples:
Patterns: |
|
Since: | 2.8.0 |
Requirements: | Paper |
Examples:
if victim's main hand is raised:
drop player's tool at player
set player's tool to air
Patterns: |
|
Since: | 1.0 |
Examples:
victim isn't holding a sword of sharpness
Patterns: | |
Since: | 2.5 |
Examples:
if the explosion is fiery:
broadcast "A fiery explosive has been ignited!"
Patterns: |
|
Since: | 2.7 |
Examples:
Patterns: |
|
Since: | 2.5.2 |
Requirements: | Minecraft 1.13+ |
Examples:
if event-block is interactable:
cancel event
send "You cannot break interactable blocks!"
Patterns: |
|
Since: | 2.7 |
Examples:
Patterns: |
|
Since: | 2.8.0 |
Requirements: | Paper 1.15+ |
Examples:
while event-entity is not jumping:
wait 5 ticks
push event-entity upwards
Patterns: |
|
Since: | 2.5 |
Examples:
Patterns: | |
Since: | 2.3, 2.5 (revamp with chunk at location/coords) |
Examples:
if chunk 1, 10 in world "world" is loaded:
if world("lobby") is loaded:
Patterns: |
|
Since: | 2.1 |
Requirements: | Supported regions plugin |
Examples:
player is the owner of the region
message "Welcome back to %region%!"
send "%player% just entered %region%!" to all members of the region
Patterns: |
|
Since: | 2.5.1 |
Examples:
Patterns: |
|
Since: | 1.4 |
Requirements: | Paper 1.20+ (Connected) |
Examples:
player-argument is offline
while player is connected:
wait 60 seconds
send "hello!" to player
# The following will act like `{_player} is online`.
# Using variables with `is connected` will not behave the same as with non-variables.
while {_player} is connected:
broadcast "online!"
wait 1 tick
Patterns: |
|
Since: | 2.7 |
Examples:
Patterns: | |
Since: | 2.5.1 |
Requirements: | Minecraft 1.13.2+ |
Examples:
Patterns: |
|
Since: | 2.9.0 |
Requirements: | Paper |
Examples:
while {_entity} is pathfinding
wait a second
launch flickering trailing burst firework colored red at location of {_entity}
subtract 10 from {defence::tower::health}
clear entity within {_entity}
Patterns: | |
Since: | 2.6 |
Examples:
if plugin "WorldGuard" is not enabled:
if plugins "Essentials" and "Vault" are enabled:
if plugin "MyBrokenPlugin" is disabled:
Patterns: |
|
Since: | 1.4.4 |
Examples:
cure the player from poison
message "You have been cured!"
Patterns: |
|
Since: | 2.7 |
Requirements: | 1.16.5+, Paper 1.19.2+ (blockdata) |
Examples:
event-block is set
if player's tool is the preferred tool for event-block:
break event-block naturally using player's tool
else:
cancel event
Patterns: |
|
Since: | 2.0 |
Examples:
Patterns: |
|
Since: | 2.5 |
Examples:
Patterns: | |
Since: | 2.3 |
Examples:
trigger:
if chunk at player is a slime chunk:
send "Yeah, it is!"
else:
send "Nope, it isn't"
Patterns: | |
Since: | 1.4.4 |
Examples:
on target:
target is sneaking
distance of target and the entity is bigger than 4
cancel the event
Patterns: |
|
Since: | 2.2-dev36 |
Examples:
player's tool isn't solid
Patterns: |
|
Since: | 2.7 |
Examples:
birch wood is stackable
torch is stackable
Patterns: |
|
Since: | 2.3 |
Requirements: | 1.13 or newer |
Examples:
Patterns: |
|
Since: | 2.5 |
Examples:
if victim is tameable:
cancel event
Patterns: |
|
Since: | 2.2-dev36 |
Examples:
Patterns: |
|
Since: | 2.5.1, 2.9.0 (breakable) |
Examples:
send "This item is unbreakable!" to player
if tool of {_p} is breakable:
send "Your tool is breakable!" to {_p}
Patterns: | |
Since: | 2.9.0 |
Examples:
on load:
if the script is using "example feature":
broadcast "You're using an experimental feature!"
Patterns: |
|
Since: | 1.0 |
Examples:
player is wearing all diamond armour
Patterns: |
|
Since: | 2.5.2, 2.9.0 (enforce, offline players) |
Requirements: | MC 1.17+ (enforce) |
Examples:
if the server is whitelisted:
if the server whitelist is enforced:
Patterns: | |
Since: | 2.7 |
Requirements: | MC 1.17+ (within block) |
Examples:
send "You are in a PvP zone!" to player
if player is in world("world"):
send "You are in the overworld!" to player
if attacker's location is inside of victim:
cancel event
send "Back up!" to attacker and victim
Patterns: | |
Since: | 2.7 |
Examples:
if attacker's location is within 10 blocks around {_spawn}:
cancel event
send "You can't PVP in spawn."
Patterns: |
|
Since: | 1.4 |
Examples:
victim is of type {villager type}
Patterns: |
|
Since: | 2.8.0 |
Requirements: | Paper 1.17.1+ (entities) |
Examples:
if victim is left handed:
cancel event
Patterns: | |
Since: | 2.5.2 |
Examples:
if message partially matches "\d":
send "Message contains a digit!"
if message doesn't match "[A-Za-z]+":
send "Message doesn't only contain letters!"
Patterns: |
|
Since: | 2.1 |
Requirements: | Supported regions plugin |
Examples:
on region enter:
region contains {flags.%world%.red}
message "The red flag is near!"
Patterns: |
|
Since: | 2.4 |
Usable in events: | resource pack request response |
Examples:
if the resource pack wasn't accepted:
kick the player due to "You have to install the resource pack to play in this server!"
Patterns: |
|
Since: | 2.5 |
Examples:
Patterns: | |
Since: | 2.0 |
Examples:
trigger:
{command::%player's uuid%::last-usage} was less than a minute ago:
message "Please wait a minute between uses of this command."
stop
set {command::%player's uuid%::last-usage} to now
# ... actual command trigger here ...