Skip to content

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.