Conditions Variables
Dynamic variables to be used in conditions and abilities.
Conditions can be targeted against different entities. You can use attacker or victim instead of player, for example: %player health%
-> %victim health%
.
List of built-in variables
All variables can start with 'player', 'attacker', and 'victim' Example: '%victim is on fire%'
Parsing for attacker or victim works for placeholders from PlaceholderAPI as well. Example: "%victim checkitem_getinfo:39_mat:%"
Player only variables
Variable
Description
%can break%
True if a player can break the block
%faction land%
Gets faction land player is in.
%food%
Food level of player
%is bleeding%
True if the player is bleeding via McMMO
%helmet%
Equipped Helmet
%chestplate%
Equipped Chestplate
%leggings%
Equipped Leggings
%boots%
Equipped Boots
%is blocking%
True if the player is blocking
%is flying%
True if the player is flying
%is sneaking%
True if the player is sneaking
%level of skill <skill>%
Level of a player's McMMO skill
%permissions%
All player's permissions
%is op%
True if player has OP
Global Variables
%block below%
Block type player/ mob is standing on
%trigger type%
Type of trigger
%combo%
Current combo
%custom name%
Custom name of player/ mob
%has enchantment in hand of <enchant>%
Whether player/ mob has an enchantment on the item in its main hand
%has enchantment in hand of <enchant> level <level>%
Whether player/ mob has an enchantment of a specific level on the item in its main hand
%has enchantment in <armor slot> of <enchantment>%
Whether player/ mob has an enchantment on the item in a specific armor slot
%has potion effect <effect>%
%item in hand level <enhantment>%
Level of enchantment on item in main hand
%health%
The health of player/ mob
%health percentage%
Percentage of health left
%is critical%
Whether attack was a critical hit
%is gliding%
Whether player/ mob is gliding
%is sprinting%
Whether player is sprinting
%is crouching%
Whether player/ mob is crouching
%is holding%
Type of item currently held by player/ mob
%is hostile%
Whether mob is hostile
%is damageable%
Whether the player/mob can be damaged
%is on fire%
Whether player/ mob is on fire
%is removal%
Whether effect is removal (EFFECT_STATIC, HELD, SHIFT, SPRINT)
%is under water%
Whether player/ mob is underwater
%item slot%
Slot of item that triggered enchant
%max health%
Maximum health of player/ mob
%mob type%
Type of mob
%name%
Name of player/ mob
%nearby mobs%
Amount of mobs in a 10 block radius
%offhand item%
Type of item currently held in offhand by player/ mob
%players%
Amount of players in a 10 block radius
%potion effect level <effect> <level>%
Whether player/ mob has a potion effect of a specifc level
%time%
Time of the world
%x%
X coordinate of player/ mob
%y%
Y coordinate of player/ mob
%z%
Z coordinate of player/ mob
%x double%
More precise X coordinate of player/ mob
%y double%
More precise Y coordinate of player/ mob
%z double%
More precise Z coordinate of player/ mob
%block tags%
Array of tags a target block has
%is riding%
Whether player/mob is riding player/mob (or is a passenger)
%passengers%
Passengers of the player/mob
Type-specific variables (global)
%is headshot%
Whether an arrow/ trident hit was a headshot
BOW, BOW_MOB, DEFENSE_BOW, DEFENSE_BOW_MOB
%force%
Force of bow when firing arrow
BOW_FIRE
%damaged from behind%
If victim was damaged from behind by enemy
DEFENSE, DEFENSE_MOB, DEFENSE_BOW, DEFENSE_BOW_MOB
%projectile type%
Type of projectile ("arrow" or "trident")
BOW, BOW_MOB, DEFENSE_BOW, DEFENSE_BOW_MOB
%exp%
Amount of EXP to give/ drop
CATCH_FISH, FISHING, KILL_MOB
%caught%
Type of item player caught
CATCH_FISH, FISHING
%maximum durability%
Maximum durability of item
ITEM_BREAK
%block x%
X coordinate of block broken
MINING
%block y%
Y coordinate of block broken
MINING
%block z%
Z coordinate of block broken
MINING
%block type%
Type of block
MINING, SWING
%block type lowercase%
Type of block but all letters are lowercase
MINING
%block drop type%
Type of item block will drop
MINING
%is crop%
Whether broken block was a crop
MINING
%is fully grown%
Whether broken crop was fully grown
MINING
%block location%
Location of the block (used in location parameter)
MINING, SWING
%damage%
Final damage
Any type triggered by damage or an attack
%raw damage%
Damage before armor
Any type triggered by damage or an attack
%damage cause%
Cause of damage
Any type triggered by damage or an attack
PlaceholderAPI support
E.g: %victim player_level% > 10 : %stop%
, player_level
is a PlaceholderAPI placeholder %player_level%
.
You can use %player %
, %attacker %
or%victim %
It's a must to remove percentage signs from PlaceholderAPI placeholders, more examples: %server_online% -> server_online
-> %player server_online% > 5 : %allow%
Last updated