Conditions

A list of all conditions with examples.

Server Conditions

Chance

Is met based on probability, value must range from 0.0 (0%) to 1.0 (100%)

if: chance 0.1

Online Players

Check the number of players currently online. You can specify an exact number a range, or multi.

if: onlinePlayers: 10

if: onlinePlayers: 1-10

if: onlinePlayers: 1;3;5 

Event Conditions

Click Type Equals

Checks the click type used by the player to interact with a block

if: clickTypeEquals left_click

if: clickTypeEquals right_click, physical 

Player Conditions

Has Permission

Verifies if a player has a specific permission node.

if: hasPermission example.permission.node

Has Flag

Checks if a player has a particular flag assigned to them.

if: hasFlag example_flag

Has Exp

Checks a player's current experience points. You can use an exact value, range or multi.

if: hasExp 500

if: hasExp 0-500

if: hasExp 100;250;500

Has Exp Level

Checks a player's current experience level. This also supports an exact value, range or multi.

if: hasExpLevel 100

Has Item

Confirms if a player has a specific item in their inventory. You can define the item by its material or an item from the /items/ folder, and specify a quantity.

if: hasItem diamond:3

if: hasItem item_name:3

Has Played Before

A simple check to see if the player has previously joined the server.

if: hasPlayedBefore

Has Free Slot

Check if the player has an empty slot in it's inventory

Is Flying

Detects if the player is currently flying.

if: isFlying

Is Sneaking

Detects if the player is currently sneaking.

if: isSneaking

Tool Equals (coming soon)

Tool Equals (coming soon)

Checks if the player is holding a specific item. Matches item amount.

• Must match: type, amount, name, lore, enchants, etc..

Tool Is Similar

Checks if the player is holding a specific item. Ignores item amount.

• Must match: type, name, lore, enchants, etc..

if: toolIsSimilar iron_pickaxe

# Check for multiple items
if: toolIsSimilar iron_pickaxe, item_name

Tool Type Equals

Checks if the player is holding a specific item type. Ignores everything else.

if: toolTypeEquals diamond_axe

if: toolTypeEquals stone_axe, iron_axe, diamond_axe

Tool Name Equals

Checks if the player's held tool has a specific name. Ignores color codes.

if: toolNameEquals <Legendary Pickaxe> # Use <> if value contains spaces

Tool Lore Line Equals

Checks if the player's held tool has a lore line with a specific value. Ignores color codes.

if: toolLoreLineEquals <This is the first lore line> line=1

Tool Lore Equals

Checks if the player's held tool lore matches these values. Ignores color codes.

if: toolLoreEquals <This is the first line>, <This is the second line>, <This is the third line>

Tool Has Enchant

Checks if the player's held tool has a specific enchantment and level.

if: toolHasEnchant silk_touch level=1

Tool Has Custom Model

Checks if the player's held tool has a specific custom model data.

if: toolHasCustomModel 100007

Placeholder Equals

Compares a placeholder's value to a specific string or amount (fixed, ranged, multi).

if: placeholderEquals joshua id=%player_name% ignoreCase=true

if: placeholderEquals 10 id=%player_health%

if: placeholderEquals 10-20 id=%player_health%

if: placeholderEquals 10;15;20 id=%player_health%

Has Money

Checks a player's current money balance. Requires vault. Supports amount (fixed, ranged, multi)

if: hasMoney 100

if: hasMoney 100-1000

if: hasMoney 100;1000;10000

Extra Conditions

AuraSkills

Has Aura Level

Checks a player's level in a certain skill.

if: hasAuraLevel 10 # default skill is mining

if: hasAuraLevel 10-100 skill=foraging

Has Aura Mana

Checks a player's mana amount.

if: hasAuraMana 20

if: hasAuraMana 20-100

McMMO (coming soon)