| Patterns: | |
| Since: | 2.9.0 |
| Requirements: | Spigot 1.19.4+ |
Checks to see if a bell is currently resonating.
A bell will start resonating five game ticks after being rung, and will continue to resonate for 40 game ticks.
A bell will start resonating five game ticks after being rung, and will continue to resonate for 40 game ticks.
Examples:
target block is resonating
| Patterns: |
|
| Since: | 2.10 |
Checks whether or not an entity will be able to age/grow up.
Examples:
on breeding:
entity can't age
broadcast "An immortal has been born!" to player
entity can't age
broadcast "An immortal has been born!" to player
| Patterns: |
|
| Since: | 2.10 |
Checks whether or not a living entity can be bred.
Examples:
on right click on living entity:
event-entity can't breed
send "Turns out %event-entity% is not breedable. Must be a Skript user!" to player
event-entity can't breed
send "Turns out %event-entity% is not breedable. Must be a Skript user!" to player
| Patterns: |
|
| Since: | 2.0 |
| Requirements: | Supported regions plugin |
Tests whether a player is allowed to build at a certain location.
This condition requires a supported regions plugin to be installed.
This condition requires a supported regions plugin to be installed.
Examples:
command /setblock <material>:
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
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 |
Tests whether a player or a chest can hold the given item.
Examples:
block can hold 200 cobblestone
player has enough space for 64 feathers
player has enough space for 64 feathers
| Patterns: |
|
| Since: | 2.8.0 |
Whether living entities are able to pick up items off the ground or not.
Examples:
if player can pick items up:
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
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, 2.10 (entities) |
| Requirements: | Minecraft 1.19+ (entities) |
Checks whether the given players can see the provided entities.
Examples:
if sender can't see the player-argument:
message "who dat?"
if the player can see the last spawned entity:
message "hello there!"
message "who dat?"
if the player can see the last spawned entity:
message "hello there!"
| Patterns: | |
| Since: | 2.10 |
| Requirements: | Paper |
Checks whether a player can see chat colors.
Examples:
if player can see chat colors:
send "Find the red word in <red>this<reset> message."
else:
send "You cannot partake in finding the colored word."
send "Find the red word in <red>this<reset> message."
else:
send "You cannot partake in finding the colored word."
| Patterns: | |
| Since: | 2.10 |
| Requirements: | Paper |
Checks whether a player can see specific message types in chat.
Examples:
if player can see all messages:
send "You can see all messages."
if player can only see commands:
send "This game doesn't work with commands-only chat."
if player can't see any messages:
send action bar "Server shutting down in 5 minutes!"
send "You can see all messages."
if player can only see commands:
send "This game doesn't work with commands-only chat."
if player can't see any messages:
send action bar "Server shutting down in 5 minutes!"
| Patterns: |
|
| Since: | 1.0 |
A condition that randomly succeeds or fails.
Valid values are between 0% and 100%, or if the percent sign is omitted between 0 and 1.
Valid values are between 0% and 100%, or if the percent sign is omitted between 0 and 1.
Examples:
chance of 50%:
drop a diamond
chance of {chance}% # {chance} between 0 and 100
chance of {chance} # {chance} between 0 and 1
drop a diamond
chance of {chance}% # {chance} between 0 and 100
chance of {chance} # {chance} between 0 and 1
| Patterns: |
|
| Since: | 1.0 |
A very general condition, it simply compares two values. Usually you can only compare for equality (e.g. block is/isn't of <type>), but some values can also be compared using greater than/less than. In that case you can also test for whether an object is between two others.
Note: This is the only element where not all patterns are shown. It has actually another two sets of similar patters, but with
Note: This is the only element where not all patterns are shown. It has actually another two sets of similar patters, but with
(was|were) or will be instead of (is|are) respectively, which check different time states of the first expression. Examples:
the clicked block is a stone slab or a double stone slab
time in the player's world is greater than 8:00
the creature is not an enderman or an ender dragon
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 |
Checks whether an inventory contains an item, a text contains another piece of text, a container contains something, or a list (e.g. {list variable::*} or 'drops') contains another object.
Examples:
block contains 20 cobblestone
player has 4 flint and 2 iron ingots
{list::*} contains 5
player has 4 flint and 2 iron ingots
{list::*} contains 5
| Patterns: |
|
| Since: | 2.0 |
Tests what kind of damage caused a damage event. Refer to the Damage Cause type for a list of all possible causes.
Examples:
# make players use their potions of fire resistance whenever they take any kind of fire damage
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
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+ |
Checks whether or not respawn anchors work in a world.
Examples:
respawn anchors work in world "world_nether"
| Patterns: |
|
| Since: | 2.7 |
| Usable in events: | Egg Throw |
Whether the egg will hatch in a Player Egg Throw event.
Examples:
on player egg throw:
if an entity won't hatch:
send "Better luck next time!" to the player
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) |
Checks whether entities are sheared. This condition only works on cows, sheep and snowmen for versions below 1.19.4.
Examples:
if targeted entity of player is sheared:
send "This entity has nothing left to shear!" to player
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) |
Checks whether an entity is in rain, lava, water or a bubble column.
Examples:
if player is in rain:
if player is in water:
player is in lava:
player is in bubble column
if player is in water:
player is in lava:
player is in bubble column
| Patterns: |
|
| Since: | 2.2-dev36 |
Checks whether or not the event is cancelled.
Examples:
on click:
if event is cancelled:
broadcast "no clicks allowed!"
if event is cancelled:
broadcast "no clicks allowed!"
| Patterns: | |
| Since: | 1.2 |
Checks whether a given expression or variable is set.
Examples:
{teams::%player's uuid%::preferred-team} is not set
on damage:
projectile exists
broadcast "%attacker% used a %projectile% to attack %victim%!"
on damage:
projectile exists
broadcast "%attacker% used a %projectile% to attack %victim%!"
| Patterns: |
|
| Since: | 2.10 |
| Usable in events: | Fishing |
Checks if the lure enchantment is applied to the current fishing event.
Examples:
on fishing line cast:
if lure enchantment is applied:
cancel event
if lure enchantment is applied:
cancel event
| Patterns: |
|
| Since: | 2.5 |
Checks whether an entity has AI.
Examples:
target entity has ai
| Patterns: | |
| Since: | 2.10 |
| Requirements: | Paper |
Checks whether a player has chat filtering enabled.
Examples:
if player doesn't have chat filtering enabled:
send "<gray>This server may contain mature chat messages. You have been warned!" to player
send "<gray>This server may contain mature chat messages. You have been warned!" to player
| Patterns: | |
| Since: | 2.3 |
Checks whether the given players have a custom client weather
Examples:
if the player has custom weather:
message "Your custom weather is %player's weather%"
message "Your custom weather is %player's weather%"
| Patterns: |
|
| Since: | 2.5 |
| Requirements: | 1.14+ |
Check if an item has a custom model data tag
Examples:
player's tool has custom model data
| Patterns: |
|
| Since: | 2.8.0 |
Checks whether a sign (either a block or an item) has glowing text
Examples:
if target block has glowing text
| Patterns: |
|
| Since: | 2.8.0 |
Check whether a cooldown is active on the specified material for a specific player.
Examples:
if player has player's tool on cooldown:
send "You can't use this item right now. Wait %item cooldown of player's tool for player%"
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+ |
Whether the entire or additional tooltip of an item is shown or hidden.
The 'entire tooltip' is what shows to the player when they hover an item (i.e. name, lore, etc.).
The 'additional tooltip' hides certain information from certain items (potions, maps, books, fireworks, and banners).
The 'entire tooltip' is what shows to the player when they hover an item (i.e. name, lore, etc.).
The 'additional tooltip' hides certain information from certain items (potions, maps, books, fireworks, and banners).
Examples:
send true if entire tooltip of player's tool is shown
if additional tooltip of {_item} is hidden:
if additional tooltip of {_item} is hidden:
| Patterns: |
|
| Since: | 2.8.0 |
Checks whether living entities have an unobstructed line of sight to other entities or locations.
Examples:
player has direct line of sight to location 5 blocks to the right of player
victim has line of sight to attacker
player has no line of sight to location 100 blocks in front of player
victim has line of sight to attacker
player has no line of sight to location 100 blocks in front of player
| Patterns: | |
| Since: | 2.10 |
Checks whether an entity or block has a loot table. The loot tables of chests will be deleted when the chest is opened or broken.
Examples:
set event-block to chest
if event-block has a loot table:
# this will never happen, because it doesn't have a loot table.
set loot table of event-block to "minecraft:chests/simple_dungeon"
if event-block has a loot table:
# this will happen, because it now has a loot table.
if event-block has a loot table:
# this will never happen, because it doesn't have a loot table.
set loot table of event-block to "minecraft:chests/simple_dungeon"
if event-block has a loot table:
# this will happen, because it now has a loot table.
| Patterns: |
|
| Since: | 2.2-dev36 |
Checks whether a metadata holder has a metadata tag.
Examples:
if player has metadata value "healer":
| Patterns: |
|
| Since: | 1.0 |
Test whether a player has a certain permission.
Examples:
player has permission "skript.tree"
victim has the permission "admin":
send "You're attacking an admin!" to attacker
victim has the permission "admin":
send "You're attacking an admin!" to attacker
| Patterns: |
|
| Since: | 1.4, 2.7 (multiple players) |
Checks whether a player has played on this server before. You can also use on first join if you want to make triggers for new players.
Examples:
player has played on this server before
player hasn't played before
player hasn't played before
| Patterns: |
|
| Since: | 2.6.1 |
Checks whether the given living entities have specific potion effects.
Examples:
if player has potion speed:
send "You are sonic!"
if all players have potion effects speed and haste:
broadcast "You are ready to MINE!"
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 |
Checks whether the given players have a server resource pack loaded. Please note that this can't detect player's own resource pack, only the resource pack that sent by the server.
Examples:
if the player has a resource pack loaded:
| Patterns: | |
| Since: | 2.3 |
Checks whether the given entities has the given scoreboard tags.
Examples:
if the targeted armor stand has the scoreboard tag "test tag":
| Patterns: |
|
| Since: | 2.5 |
| Requirements: | Paper 1.13 or newer |
Checks if a creeper is going to explode.
Examples:
if the last spawned creeper is going to explode:
loop all players in radius 3 of the last spawned creeper
send "RUN!!!" to the loop-player
loop all players in radius 3 of the last spawned creeper
send "RUN!!!" to the loop-player
| Patterns: | |
| Since: | 2.10 |
Checks whether a date is in the past or future.
Note that using the 'now' expression will not be in the past or future when used directly in the condition.
Note that using the 'now' expression will not be in the past or future when used directly in the condition.
Examples:
set {_date} to now
wait 5 seconds
if {_date} is in the past:
# this will be true
if now is in the future:
# this will be false
set {_dates::*} to 1 day from now, 12 days from now, and 1 year from now
if {_dates::*} are in the future:
# this will be true
if {_dates::*} have passed:
# this will be false
wait 5 seconds
if {_date} is in the past:
# this will be true
if now is in the future:
# this will be false
set {_dates::*} to 1 day from now, 12 days from now, and 1 year from now
if {_dates::*} are in the future:
# this will be true
if {_dates::*} have passed:
# this will be false
| Patterns: |
|
| Since: | 2.10 |
Checks whether or not a living entity is an adult.
Examples:
on drink:
event-entity is not an adult
kill event-entity
event-entity is not an adult
kill event-entity
| Patterns: | |
| Since: | 2.0, 2.4-alpha4 (non-living entity support) |
Checks whether an entity is alive. Works for non-living entities too.
Examples:
if {villager-buddy::%player's uuid%} is not dead:
on shoot:
while the projectile is alive:
on shoot:
while the projectile is alive:
| Patterns: |
|
| Since: | 2.10 |
Checks whether or not a living entity is a baby.
Examples:
on drink:
event-entity is a baby
kill event-entity
event-entity is a baby
kill event-entity
| Patterns: |
|
| Since: | 1.4 |
Checks whether a player or IP is banned.
Examples:
player is banned
victim is not IP-banned
"127.0.0.1" is banned
victim is not IP-banned
"127.0.0.1" is banned
| Patterns: |
|
| Since: | 2.7 |
| Usable in events: | respawn |
| Requirements: | Minecraft 1.16+ |
Checks what the respawn location of a player in the respawn event is.
Examples:
on respawn:
the respawn location is a bed
broadcast "%player% is respawning in their bed! So cozy!"
the respawn location is a bed
broadcast "%player% is respawning in their bed! So cozy!"
| Patterns: |
|
| Since: | 2.4 |
Checks whether an item is a block.
Examples:
player's held item is a block
{list::*} are blocks
{list::*} are blocks
| Patterns: | |
| Since: | 2.5 |
Checks if a block is indirectly or directly powered by redstone
Examples:
if clicked block is redstone powered:
send "This block is well-powered by redstone!"
if clicked block is indirectly redstone powered:
send "This block is indirectly redstone powered."
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) |
Checks whether a player is blocking with their shield.
Examples:
on damage of player:
victim is blocking
damage attacker by 0.5 hearts
victim is blocking
damage attacker by 0.5 hearts
| Patterns: | |
| Since: | 1.4.4 |
Checks whether an entity is on fire, e.g. a zombie due to being in sunlight, or any entity after falling into lava.
Examples:
# increased attack against burning targets
victim is burning:
increase damage by 2
victim is burning:
increase damage by 2
| Patterns: | |
| Since: | 2.5, 2.10 (withers, wither skulls) |
Checks if a creeper, wither, or wither skull is charged (powered).
Examples:
if the last spawned creeper is charged:
broadcast "A charged creeper is at %location of last spawned creeper%"
broadcast "A charged creeper is at %location of last spawned creeper%"
| Patterns: |
|
| Since: | 2.8.0 |
| Requirements: | Minecraft 1.17+ |
Whether a living entity is climbing, such as a spider up a wall or a player on a ladder.
Examples:
spawn a spider at location of spawn
wait a second
if the last spawned spider is climbing:
message"The spider is now climbing!"
wait a second
if the last spawned spider is climbing:
message"The spider is now climbing!"
| Patterns: | |
| Since: | 2.10 |
Checks if an entity's custom name is visible.
Examples:
send true if target's custom name is visible
| Patterns: |
|
| Since: | 2.2-dev36 |
Checks whether an item is edible.
Examples:
steak is edible
player's tool is edible
player's tool is edible
| Patterns: |
|
| Since: | unknown (before 2.1) |
Checks whether an inventory, an inventory slot, a queue, or a text is empty.
Examples:
player's inventory is empty
| Patterns: |
|
| Since: | 1.4.6 |
Checks whether an item is enchanted.
Examples:
tool of the player is enchanted with efficiency 2
helm, chestplate, leggings or boots are enchanted
helm, chestplate, leggings or boots are enchanted
| Patterns: | |
| Since: | 2.10 |
Check if a number is evenly divisible by another number.
Examples:
if 5 is evenly divisible by 5:
if 11 cannot be evenly divided by 10:
if 11 cannot be evenly divided by 10:
| Patterns: |
|
| Since: | 2.9.0 |
| Requirements: | Spigot 1.20.5+ |
Checks whether an item is fire resistant.
Examples:
if player's tool is fire resistant:
if {_items::*} aren't resistant to fire:
if {_items::*} aren't resistant to fire:
| Patterns: | |
| Since: | 2.10 |
| Usable in events: | Fishing |
Checks whether the fish hook is in open water.
Open water is defined by a 5x4x5 area of water, air and lily pads. If in open water, treasure items may be caught.
Open water is defined by a 5x4x5 area of water, air and lily pads. If in open water, treasure items may be caught.
Examples:
on fish catch:
if fish hook is in open water:
send "You will catch a shark soon!"
if fish hook is in open water:
send "You will catch a shark soon!"
| Patterns: |
|
| Since: | 2.2-dev36 |
Checks whether an item is flammable.
Examples:
wood is flammable
player's tool is flammable
player's tool is flammable
| Patterns: | |
| Since: | 2.10 |
| Requirements: | PaperMC |
Checks if an entity was spawned from a mob spawner.
Examples:
send whether target is from a mob spawner
| Patterns: |
|
| Since: | 2.5.1 |
| Requirements: | Minecraft 1.11.2+ |
Checks whether an item can be used as fuel in a furnace.
Examples:
on right click on furnace:
if player's tool is not fuel:
send "Please hold a valid fuel item in your hand"
cancel event
if player's tool is not fuel:
send "Please hold a valid fuel item in your hand"
cancel event
| Patterns: |
|
| Since: | 2.7 |
Checks whether a living entity is gliding.
Examples:
if player is gliding
| Patterns: |
|
| Since: | 2.8.0 |
| Requirements: | Paper |
Checks whether an entity has one or both of their hands raised.
Hands are raised when an entity is using an item (eg: blocking, drawing a bow, eating).
Hands are raised when an entity is using an item (eg: blocking, drawing a bow, eating).
Examples:
on damage of player:
if victim's main hand is raised:
drop player's tool at player
set player's tool to air
if victim's main hand is raised:
drop player's tool at player
set player's tool to air
| Patterns: |
|
| Since: | 1.0 |
Checks whether a player is holding a specific item. Cannot be used with endermen, use 'entity is [not] an enderman holding <item type>' instead.
Examples:
player is holding a stick
victim isn't holding a sword of sharpness
victim isn't holding a sword of sharpness
| Patterns: |
|
| Since: | 2.10 |
Checks whether or not a living entity is in love.
Examples:
on spawn of living entity:
if entity is in love:
broadcast "That was quick!"
if entity is in love:
broadcast "That was quick!"
| Patterns: | |
| Since: | 2.5 |
Checks if an entity will create fire when it explodes. This condition is also usable in an explosion prime event.
Examples:
on explosion prime:
if the explosion is fiery:
broadcast "A fiery explosive has been ignited!"
if the explosion is fiery:
broadcast "A fiery explosive has been ignited!"
| Patterns: |
|
| Since: | 2.7 |
Checks whether potion effects are infinite.
Examples:
all of the active potion effects of the player are infinite
| Patterns: |
|
| Since: | 2.5.2 |
| Requirements: | Minecraft 1.13+ |
Checks wether or not a block is interactable.
Examples:
on block break:
if event-block is interactable:
cancel event
send "You cannot break interactable blocks!"
if event-block is interactable:
cancel event
send "You cannot break interactable blocks!"
| Patterns: |
|
| Since: | 2.7 |
Checks whether a living entity is invisible.
Examples:
target entity is invisible
| Patterns: | |
| Since: | 2.5, 2.10 (gamemode) |
| Requirements: | Paper 1.20.6+ (gamemodes) |
Checks whether an entity or a gamemode is invulnerable. For gamemodes, Paper and Minecraft 1.20.6 are required
Examples:
target entity is invulnerable
loop all gamemodes:
if loop-value is not invulnerable:
broadcast "the gamemode %loop-value% is vulnerable!"
loop all gamemodes:
if loop-value is not invulnerable:
broadcast "the gamemode %loop-value% is vulnerable!"
| Patterns: |
|
| Since: | 2.8.0 |
| Requirements: | Paper 1.15+ |
Checks whether a living entity is jumping. This condition does not work on players.
Examples:
on spawn of zombie:
while event-entity is not jumping:
wait 5 ticks
push event-entity upwards
while event-entity is not jumping:
wait 5 ticks
push event-entity upwards
| Patterns: |
|
| Since: | 2.5 |
Checks to see if an entity is currently leashed.
Examples:
target entity is leashed
| Patterns: | |
| Since: | 2.3, 2.5 (revamp with chunk at location/coords), 2.10 (Scripts) |
Checks whether a world, chunk or script is loaded.
'chunk at 1, 1' uses chunk coordinates, which are location coords divided by 16.
'chunk at 1, 1' uses chunk coordinates, which are location coords divided by 16.
Examples:
if chunk at {home::%player's uuid%} is loaded:
if chunk 1, 10 in world "world" is loaded:
if world("lobby") is loaded:
if script named "MyScript.sk" is loaded:
if chunk 1, 10 in world "world" is loaded:
if world("lobby") is loaded:
if script named "MyScript.sk" is loaded:
| Patterns: | |
| Since: | 2.10 |
Checks whether an entity or block is lootable. Lootables are entities or blocks that can have a loot table.
Examples:
spawn a pig at event-location
set {_pig} to last spawned entity
if {_pig} is lootable:
set loot table of {_pig} to "minecraft:entities/cow"
# the pig will now drop the loot of a cow when killed, because it is indeed a lootable entity.
set block at event-location to chest
if block at event-location is lootable:
set loot table of block at event-location to "minecraft:chests/simple_dungeon"
# the chest will now generate the loot of a simple dungeon when opened, because it is indeed a lootable block.
set block at event-location to wool block
if block at event-location is lootable:
# uh oh, nothing will happen because a wool is not a lootable block.
set {_pig} to last spawned entity
if {_pig} is lootable:
set loot table of {_pig} to "minecraft:entities/cow"
# the pig will now drop the loot of a cow when killed, because it is indeed a lootable entity.
set block at event-location to chest
if block at event-location is lootable:
set loot table of block at event-location to "minecraft:chests/simple_dungeon"
# the chest will now generate the loot of a simple dungeon when opened, because it is indeed a lootable block.
set block at event-location to wool block
if block at event-location is lootable:
# uh oh, nothing will happen because a wool is not a lootable block.
| Patterns: |
|
| Since: | 2.1 |
| Requirements: | Supported regions plugin |
Checks whether a player is a member or owner of a particular region.
This condition requires a supported regions plugin to be installed.
This condition requires a supported regions plugin to be installed.
Examples:
on region enter:
player is the owner of the region
message "Welcome back to %region%!"
send "%player% just entered %region%!" to all members of the region
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 |
Checks whether an item is a block and completely blocks vision.
Examples:
player's tool is occluding
| Patterns: |
|
| Since: | 1.4 |
| Requirements: | Paper 1.20+ (Connected) |
Checks whether a player is online. The 'connected' pattern will return false once this player leaves the server, even if they rejoin. Be aware that using the 'connected' pattern with a variable will not have this special behavior. Use the direct event-player or other non-variable expression for best results.
Examples:
player is online
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
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 |
Checks whether a player is a server operator.
Examples:
player is an operator
| Patterns: | |
| Since: | 2.5.1 |
| Requirements: | Minecraft 1.13.2+ |
Checks whether a block is passable.
A block is passable if it has no colliding parts that would prevent players from moving through it.
Blocks like tall grass, flowers, signs, etc. are passable, but open doors, fence gates, trap doors, etc. are not because they still have parts that can be collided with.
A block is passable if it has no colliding parts that would prevent players from moving through it.
Blocks like tall grass, flowers, signs, etc. are passable, but open doors, fence gates, trap doors, etc. are not because they still have parts that can be collided with.
Examples:
if player's targeted block is passable
| Patterns: |
|
| Since: | 2.9.0 |
| Requirements: | Paper |
Checks whether living entities are pathfinding.
Can only be a living entity that is a Mob.
Can only be a living entity that is a Mob.
Examples:
make {_entity} pathfind to {_location} at speed 2
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}
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 |
Check if a plugin is enabled/disabled on the server.
Plugin names can be found in the plugin's 'plugin.yml' file or by using the '/plugins' command, they are NOT the name of the plugin's jar file.
When checking if a plugin is not enabled, this will return true if the plugin is either disabled or not on the server.
When checking if a plugin is disabled, this will return true if the plugin is on the server and is disabled.
Plugin names can be found in the plugin's 'plugin.yml' file or by using the '/plugins' command, they are NOT the name of the plugin's jar file.
When checking if a plugin is not enabled, this will return true if the plugin is either disabled or not on the server.
When checking if a plugin is disabled, this will return true if the plugin is on the server and is disabled.
Examples:
if plugin "Vault" is enabled:
if plugin "WorldGuard" is not enabled:
if plugins "Essentials" and "Vault" are enabled:
if plugin "MyBrokenPlugin" is disabled:
if plugin "WorldGuard" is not enabled:
if plugins "Essentials" and "Vault" are enabled:
if plugin "MyBrokenPlugin" is disabled:
| Patterns: |
|
| Since: | 1.4.4 |
Checks whether an entity is poisoned.
Examples:
player is poisoned:
cure the player from poison
message "You have been cured!"
cure the player from poison
message "You have been cured!"
| Patterns: |
|
| Since: | 2.7 |
| Requirements: | 1.16.5+, Paper 1.19.2+ (blockdata) |
Checks whether an item is the preferred tool for a block. A preferred tool is one that will drop the block's item when used. For example, a wooden pickaxe is a preferred tool for grass and stone blocks, but not for iron ore.
Examples:
on left click:
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
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.10 |
| Requirements: | Minecraft 1.21.2+ |
Checks if a player is pressing a certain input key.
Examples:
on player input:
if player is pressing forward movement key:
send "You are moving forward!"
if player is pressing forward movement key:
send "You are moving forward!"
| Patterns: |
|
| Since: | 2.0 |
Tests whether an entity is riding another or is in a vehicle.
Examples:
player is riding a saddled pig
| Patterns: |
|
| Since: | 2.5 |
Checks to see if an entity is currently using the Riptide enchantment.
Examples:
target entity is riptiding
| Patterns: |
|
| Since: | 2.10 |
Checks whether a given entity (horse or steerable) is saddled.
If 'properly' is used, this will only return true if the entity is wearing specifically a saddle item.
If 'properly' is used, this will only return true if the entity is wearing specifically a saddle item.
Examples:
send whether {_horse} is saddled
| Patterns: | |
| Since: | 2.3 |
Tests whether a chunk is a so-called slime chunk.
Slimes can generally spawn in the swamp biome and in slime chunks.
For more info, see the Minecraft wiki.
Slimes can generally spawn in the swamp biome and in slime chunks.
For more info, see the Minecraft wiki.
Examples:
command /slimey:
trigger:
if chunk at player is a slime chunk:
send "Yeah, it is!"
else:
send "Nope, it isn't"
trigger:
if chunk at player is a slime chunk:
send "Yeah, it is!"
else:
send "Nope, it isn't"
| Patterns: | |
| Since: | 1.4.4 |
Checks whether a player is sneaking.
Examples:
# prevent mobs from seeing sneaking players if they are at least 4 meters apart
on target:
target is sneaking
distance of target and the entity is bigger than 4
cancel the event
on target:
target is sneaking
distance of target and the entity is bigger than 4
cancel the event
| Patterns: |
|
| Since: | 2.2-dev36 |
Checks whether an item is solid.
Examples:
grass block is solid
player's tool isn't solid
player's tool isn't solid
| Patterns: |
|
| Since: | 2.7 |
Checks whether an item is stackable.
Examples:
diamond axe is stackable
birch wood is stackable
torch is stackable
birch wood is stackable
torch is stackable
| Patterns: |
|
| Since: | 2.3 |
| Requirements: | 1.13 or newer |
Checks whether a living entity is swimming.
Examples:
player is swimming
| Patterns: |
|
| Since: | 2.10 |
Checks whether an item, block, entity, or entitydata is tagged with the given tag.
Examples:
if player's tool is tagged with minecraft tag "enchantable/sharp_weapon":
enchant player's tool with sharpness 1
if all logs are tagged with tag "minecraft:logs"
enchant player's tool with sharpness 1
if all logs are tagged with tag "minecraft:logs"
| Patterns: |
|
| Since: | 2.5 |
Check if an entity is tameable.
Examples:
on damage:
if victim is tameable:
cancel event
if victim is tameable:
cancel event
| Patterns: |
|
| Since: | 2.2-dev36 |
Checks whether an item is transparent. Note that this condition may not work for all blocks, due to the transparency list used by Spigot not being completely accurate.
Examples:
player's tool is transparent.
| Patterns: |
|
| Since: | 2.5.1, 2.9.0 (breakable) |
Checks whether an item is unbreakable.
Examples:
if event-item is unbreakable:
send "This item is unbreakable!" to player
if tool of {_p} is breakable:
send "Your tool is breakable!" to {_p}
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 |
Checks whether a script is using an experimental feature by name.
Examples:
the script is using "example feature"
on load:
if the script is using "example feature":
broadcast "You're using an experimental feature!"
on load:
if the script is using "example feature":
broadcast "You're using an experimental feature!"
| Patterns: | |
| Since: | 2.7, 2.10 (Scripts & Configs) |
Checks whether something (an entity, a script, a config, etc.) is valid.
An invalid entity may have died or de-spawned for some other reason.
An invalid script reference may have been reloaded, moved or disabled since.
An invalid entity may have died or de-spawned for some other reason.
An invalid script reference may have been reloaded, moved or disabled since.
Examples:
if event-entity is valid
| Patterns: |
|
| Since: | 1.0 |
Checks whether an entity is wearing some items (usually armor).
Examples:
player is wearing an iron chestplate and iron leggings
player is wearing all diamond armour
target is wearing wolf armor
player is wearing all diamond armour
target is wearing wolf armor
| Patterns: |
|
| Since: | 2.5.2, 2.9.0 (enforce, offline players) |
| Requirements: | MC 1.17+ (enforce) |
Whether or not the server or a player is whitelisted, or the server is whitelist enforced.
Examples:
if the player is whitelisted:
if the server is whitelisted:
if the server whitelist is enforced:
if the server is whitelisted:
if the server whitelist is enforced:
| Patterns: | |
| Since: | 2.7 |
| Requirements: | MC 1.17+ (within block) |
Whether a location is within something else. The "something" can be a block, an entity, a chunk, a world, or a cuboid formed by two other locations.
Note that using the is between condition will refer to a straight line between locations, while this condition will refer to the cuboid between locations.
Note that using the is between condition will refer to a straight line between locations, while this condition will refer to the cuboid between locations.
Examples:
if player's location is within {_loc1} and {_loc2}:
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
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 |
Checks whether a location is within a certain radius of another location.
Examples:
on damage:
if attacker's location is within 10 blocks around {_spawn}:
cancel event
send "You can't PVP in spawn."
if attacker's location is within 10 blocks around {_spawn}:
cancel event
send "You can't PVP in spawn."
| Patterns: |
|
| Since: | 1.4 |
Checks whether an item or an entity is of the given type. This is mostly useful for variables, as you can use the general 'is' condition otherwise (e.g. 'victim is a creeper').
Examples:
tool is of type {selected type}
victim is of type {villager type}
victim is of type {villager type}
| Patterns: |
|
| Since: | 2.10 |
| Requirements: | Spigot 1.20.5+ |
Checks whether an item has the enchantment glint overridden, or is forced to glint or not.
Examples:
if the player's tool has the enchantment glint override
send "Your tool has the enchantment glint override." to player
if {_item} is forced to glint:
send "This item is forced to glint." to player
else if {_item} is forced to not glint:
send "This item is forced to not glint." to player
else:
send "This item does not have any glint override." to player
send "Your tool has the enchantment glint override." to player
if {_item} is forced to glint:
send "This item is forced to glint." to player
else if {_item} is forced to not glint:
send "This item is forced to not glint." to player
else:
send "This item does not have any glint override." to player
| Patterns: |
|
| Since: | 2.10 |
| Requirements: | Spigot 1.20.5+ |
Checks whether an item has the enchantment glint overridden, or is forced to glint or not.
Examples:
if the player's tool has the enchantment glint override
send "Your tool has the enchantment glint override." to player
if {_item} is forced to glint:
send "This item is forced to glint." to player
else if {_item} is forced to not glint:
send "This item is forced to not glint." to player
else:
send "This item does not have any glint override." to player
send "Your tool has the enchantment glint override." to player
if {_item} is forced to glint:
send "This item is forced to glint." to player
else if {_item} is forced to not glint:
send "This item is forced to not glint." to player
else:
send "This item does not have any glint override." to player
| Patterns: |
|
| Since: | 2.10 |
| Usable in events: | Unleash |
| Requirements: | Paper 1.16+ |
Checks whether the leash item will drop during the leash detaching in an unleash event.
Examples:
on unleash:
if the leash will drop:
prevent the leash from dropping
else:
allow the leash to drop
if the leash will drop:
prevent the leash from dropping
else:
allow the leash to drop
| Patterns: |
|
| Since: | 2.8.0 |
| Requirements: | Paper 1.17.1+ (entities) |
Checks if living entities or players are left or right-handed. Armor stands are neither right nor left-handed.
Paper 1.17.1+ is required for non-player entities.
Paper 1.17.1+ is required for non-player entities.
Examples:
on damage of player:
if victim is left handed:
cancel event
if victim is left handed:
cancel event
| Patterns: | |
| Since: | 2.10 |
Check to see whether lidded blocks (chests, shulkers, etc.) are open or closed.
Examples:
if the lid of {_chest} is closed:
open the lid of {_block}
open the lid of {_block}
| Patterns: | |
| Since: | 2.5.2 |
Checks whether the defined strings match the input regexes (Regular expressions).
Examples:
on chat:
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!"
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 |
Checks whether a location is contained in a particular region.
This condition requires a supported regions plugin to be installed.
This condition requires a supported regions plugin to be installed.
Examples:
player is in the region {regions::3}
on region enter:
region contains {flags.%world%.red}
message "The red flag is near!"
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 |
Checks state of the resource pack in a resource pack request response event.
Examples:
on resource pack response:
if the resource pack wasn't accepted:
kick the player due to "You have to install the resource pack to play in this server!"
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 |
Checks if current Minecraft version is given version or newer.
Examples:
running minecraft "1.14"
| Patterns: | |
| Since: | 2.10 |
Returns whether the text of a display has drop shadow applied.
Examples:
if {_display} has drop shadow:
remove drop shadow from the text of {_display}
remove drop shadow from the text of {_display}
| Patterns: | |
| Since: | 2.10 |
Returns whether text displays can be seen through blocks or not.
Examples:
if last spawned text display is visible through walls:
prevent last spawned text display from being visible through walls
prevent last spawned text display from being visible through walls
| Patterns: | |
| Since: | 2.0 |
Examples:
command /command-with-cooldown:
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 ...
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 ...
| Patterns: |
|
| Since: | 2.10 |
| Requirements: | Paper |
Checks to see if the firework used in an 'elytra boost' event will be consumed.
Examples:
on elytra boost:
if the used firework will be consumed:
prevent the used firework from being consume
if the used firework will be consumed:
prevent the used firework from being consume