Conditions allow you to limit which effects get processed.

<aside> ℹ️

If multiple conditions exist on a rule, they must ALL pass for the rule to be applied.

</aside>

Worlds

nodes string[]

The player must be in ANY of the matched worlds.

! can be used at the start to require the player to NOT be in that world

* can be used anywhere to indicate a wildcard. for example: arena_* would match arena_overworld but not mob_arena_overworld

conditions:
	worlds:
		nodes:
			- "world"
			- "!peaceful_world"
			- "arena_*"

Permissions

nodes string[]

The player must have ANY of the matched permissions.

! can be used at the start to require the player to NOT have said permission

conditions:
	permissions:
		nodes:
			- "player.keepinventory"
			- "player.admin"

Placeholders

<aside> ➕

Requires PlaceholderAPI

</aside>

This condition lets you define a list of placeholders to match, if ANY of the conditions match, the check is passed

placeholder string

The name of the placeholder, Please check with /papi parse me %placeholder%

operator Operator

Value Description
EQUALS Must be the same
NOT_EQUALS Must not be the same
CONTAINS Must contain the value
STARTS_WITH Must start with the value
ENDS_WITH Must end with the value
GREATER_THAN Must be more than the value
LESS_THAN Must be less than the value
GREATER_THAN_OR_EQUALS Must be more or exactly the same as the value
LESS_THAN_OR_EQUALS Must be less than or exactly the same as the value

value Mixed

The value to test the placeholder for

# "Player first joined after 2024"
conditions:
	placeholders:
      1:
        placeholder: "player_first_join"
        operator: ">="
        value: "1717790357452"

Vault

<aside> ➕

Requires Vault

</aside>

Checks wether the player’s economy balance is sufficient to pass the condition

min_balance Double

The minimum balance the player must hold for the check to pass

conditions:
	vault:
		min_balance: 100.0