| 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 ...