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.

# Example 1
if: onlinePlayers 10

# Example 2
if: onlinePlayers 1-10

# Example 3
if: onlinePlayers 1;3;5

# Example 4
if: onlinePlayers 10+

# Example 5
if: onlinePlayers 10-

Event Conditions

Click Type Equals

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

# Example 1
if: clickTypeEquals left_click

# Example 2
if: clickTypeEquals left_click, right_click

# Example 3
if: clickTypeEquals left_click, right_click sneaking=true # aliases: shift, sneak, sneaking

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.

# Example 1
if: hasExp 500

# Example 2
if: hasExp 0-500

# Example 3
if: hasExp 100;250;500

# Example 4
if: hasExp 1000+

# Example 5
if: hasExp 1000-

Has Exp Level

Checks a player's current experience level.

# Example 1
if: hasExpLevel 10

# Example 2
if: hasExpLevel 10-100

# Example 3
if: hasExpLevel 10;50;100

# Example 4
if: hasExpLevel 100+

# Example 5
if: hasExpLevel 100-

Has Item

Confirms if a player has a specific item in their inventory.

# Example 1
if: hasItem diamond

# Example 2
if: hasItem item_name

# Example 3 (MythicMobs)
if: hasItem MythicMobs:SkeletonKingSword

# Example 4 (ExecutableItems)
if: hasItem ExecutableItems:Free_Wifi_Crafting_Table

# Example 5 (EcoItems)
if: hasItem EcoItems:enchanted_cobblestone

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

if: hasFreeSlot

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)

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..

# Example 1
if: toolIsSimilar iron_pickaxe

# Example 2
if: toolIsSimilar stone_pickaxe, iron_pickaxe, diamond_pickaxe

# Example 3
if: toolIsSimilar item_name

# Example 4 (MythicMobs)
if: toolIsSimilar MythicMobs:SkeletonKingSword   # alias: mm

# Example 5 (ExecutableItems)
if: toolIsSimilar ExecutableItems:Free_Wifi_Crafting_Table   # alias: ei

Tool Type Equals

Checks if the player is holding a specific item type.

# Example 1
if: toolTypeEquals stone_axe

# Example 2
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. Compatible with PlaceholderAPI.

# Example 1
if: placeholderEquals joshua id={player} ignoreCase=true

# Example 2
if: placeholderEquals joshua id=%player_name% ignoreCase=true

# Example 3
if: placeholderEquals 10 id=%player_health%

# Example 4
if: placeholderEquals 10-20 id=%player_health%

# Example 5
if: placeholderEquals 10;15;20 id=%player_health%

# Example 6
if: placeholderEquals 10+ id=%player_health%

# Example 7
if: placeholderEquals 10- id=%player_health%

Vault Conditions

Has Money

Checks a player's current money balance.

# Example 1
if: hasMoney 100

# Example 2
if: hasMoney 100-1000

# Example 3
if: hasMoney 100;500;1000

# Example 4
if: hasMoney 1000+

# Example 5
if: hasMoney 1000-

Auraskills Conditions

Has Aura Level

Checks a player's level in a certain skill.

# Example 1
if: hasAuraLevel 10 # default skill is mining

# Example 2
if: hasAuraLevel 10-100 skill=foraging

# Example 3
if: hasAuraLevel 10;50;100 skill=foraging

# Example 4
if: hasAuraLevel 90+ skill=foraging

# Example 5
if: hasAuraLevel 90- skill=foraging

Has Aura Mana

Checks a player's mana amount.

# Example 1
if: hasAuraMana 10

# Example 2
if: hasAuraMana 10-100

# Example 3
if: hasAuraMana 10;50;100

# Example 4
if: hasAuraMana 100+

# Example 5
if: hasAuraMana 100-

McMMO Conditions

Has Mcmmo Level

# Example 1
if: hasMcmmoLevel 10 # default skill is mining

# Example 2
if: hasMcmmoLevel 10-100 skill=woodcutting

# Example 3
if: hasMcmmoLevel 10;50;100 skill=woodcutting

# Example 4
if: hasMcmmoLevel 100+ skill=woodcutting

# Example 5
if: hasMcmmoLevel 100- skill=woodcutting