Conditions
All 95. Every condition accepts inverse: true. Args are read with placeholders and arithmetic resolved, so y: "%player_y% - 10" works.
Player state
| condition |
true when |
args |
health_below |
Player health is below a value |
health |
health_above |
Player health is above a value |
health |
health_percent_below |
Player health is below a percentage of max |
percent |
health_percent_above |
Player health is above a percentage of max |
percent |
food_below |
Food level below a value |
food |
food_above |
Food level above a value |
food |
xp_level_above |
XP level is above a value |
level |
xp_level_below |
XP level is below a value |
level |
is_sneaking |
Player is sneaking |
- |
is_sprinting |
Player is sprinting |
- |
is_swimming |
Player is swimming |
- |
is_flying |
Player is flying |
- |
is_gliding |
Player is gliding with an elytra |
- |
is_blocking |
Player is blocking with a shield |
- |
is_on_ground |
Player is standing on the ground |
- |
in_water |
Player is in water |
- |
in_lava |
Player is in lava |
- |
on_fire |
Player is on fire |
- |
is_frozen |
Player is freezing in powder snow |
- |
is_riding |
Player is riding something |
- |
is_sleeping |
Player is in a bed |
- |
is_op |
Player is a server operator |
- |
has_permission |
Player has a permission |
permission |
gamemode |
Player is in one of these gamemodes |
gamemodes |
has_potion_effect |
Player has a potion effect |
effect |
air_below |
Remaining air below a value (ticks) |
air |
is_invisible |
Player is invisible |
- |
is_glowing |
Player is glowing |
- |
name_is |
Player name matches |
names |
is_online_more_than |
Player has been online this session longer than (seconds) |
seconds |
is_night |
It is night in the player's world |
- |
is_day |
It is day in the player's world |
- |
is_raining |
It is raining |
- |
is_thundering |
It is thundering |
- |
is_clear |
The weather is clear |
- |
players_online_above |
More than this many players online |
count |
players_online_below |
Fewer than this many players online |
count |
victim_is_player |
The victim is a player |
- |
victim_is_mob |
The victim is not a player |
- |
victim_health_below |
Victim health below a value |
health |
victim_health_percent_below |
Victim health below a percentage |
percent |
victim_on_fire |
Victim is burning |
- |
victim_has_potion_effect |
Victim has a potion effect |
effect |
victim_is_boss |
Victim is a boss mob |
- |
victim_is_hostile |
Victim is a hostile mob |
- |
victim_is_animal |
Victim is a passive animal |
- |
victim_is_baby |
Victim is a baby |
- |
victim_is_tamed |
Victim is tamed |
- |
Location
| condition |
true when |
args |
in_world |
Player is in one of these worlds |
worlds |
in_biome |
Player is in one of these biomes |
biomes |
below_y |
Player is below a Y level |
y |
above_y |
Player is above a Y level |
y |
in_region_box |
Player is inside a box (x1,y1,z1,x2,y2,z2) |
x1, y1, z1, x2, y2, z2, world |
near_location |
Player is within a radius of a point |
x, y, z, radius, world |
light_below |
Light level at the player is below |
light |
light_above |
Light level at the player is above |
light |
sky_visible |
Sky is visible above the player |
- |
standing_on |
Block under the player is one of these |
blocks |
standing_in |
Block at the player's feet is one of these |
blocks |
in_dimension |
Player is in overworld, nether or the_end |
dimension |
altitude_between |
Y is between two values |
min, max |
World, time and weather
| condition |
true when |
args |
time_between |
World time is between two ticks |
from, to |
moon_phase |
Moon phase is one of these (0-7) |
phases |
tps_above |
Server TPS is above |
tps |
Inventory and items
| condition |
true when |
args |
in_mainhand |
Holding one of these in the main hand |
items |
in_offhand |
Holding one of these in the off hand |
items |
wearing |
Wearing one of these as armour |
items |
has_item |
Has at least N of an item anywhere in inventory |
item, amount |
has_empty_slot |
Has a free inventory slot |
- |
inventory_full |
Inventory has no free slot |
- |
mainhand_enchanted |
Main-hand item has any enchantment |
- |
mainhand_durability_below |
Main-hand durability below a percentage |
percent |
item_is |
The context item is one of these |
items |
item_amount_above |
The context item stack is bigger than |
amount |
victim_in_mainhand |
Victim (if a player) holds one of these |
items |
victim_wearing |
Victim (if a player) wears one of these |
items |
The trigger's facts
| condition |
true when |
args |
value_above |
The trigger's value is above |
value |
value_below |
The trigger's value is below |
value |
block_is |
The context block is one of these |
blocks |
block_above_is |
The block above the context block is one of these |
blocks |
block_below_is |
The block below the context block is one of these |
blocks |
entity_is |
The context entity is one of these types |
entities |
data_equals |
A context placeholder equals a value |
key, value |
placeholder_equals |
A placeholder (incl. PAPI) equals a value |
placeholder, value |
placeholder_above |
A numeric placeholder is above a value |
placeholder, value |
placeholder_below |
A numeric placeholder is below a value |
placeholder, value |
expression |
An arithmetic/comparison expression is true |
expression |
chance |
Random chance in percent (for conditions that gate other things) |
percent |
Victim
| condition |
true when |
args |
has_victim |
There is a victim |
- |
victim_is |
The victim is one of these types |
entities |
victim_distance_above |
Victim is further than N blocks away |
distance |
victim_distance_below |
Victim is closer than N blocks |
distance |
Economy
| condition |
true when |
args |
balance_above |
Balance is above a value |
amount |
balance_below |
Balance is below a value |
amount |
has_economy |
An economy plugin is available |
- |
Not-met effects
A condition on an effect can carry not-met-effects, run when the player
tries the trigger but fails the check - the classic "you need MVP to do that"
message without a second effect block.