Conditions

Conditions
Condition Type

Conditions show/hide items based on player data, placeholders, permissions, etc. Placed inside item definition:

codeconditions:
  has-permission:
    permission: myplugin.vip
  has-money:
    required-balance: '500'
  is-integer:
    value: '%input%'
  conditional-placeholder:
    condition: '%vault_eco_balance_fixed%>1000'

Common Conditions:

  • has-permission.permission: Player must have the given permission.

  • has-money.required-balance: Player’s economy balance must be >= this amount.

  • is-integer.value: Checks if placeholder parsed as integer is valid.

  • conditional-placeholder.condition: Complex comparison (==, !=, <, >, <=, >=).

If conditions fail, the item does not appear.

conditionFailMessage: Optional key to show message to player if conditions fail and they try to interact. Usually needed only on click events.


General Syntax:

codeconditions:
  conditionName:
    key: value

Supported Conditions:

  1. has-permission:

    codeconditions:
      has-permission:
        permission: myplugin.use
    • Player must have myplugin.use permission.

  2. has-money:

    codeconditions:
      has-money:
        required-balance: '1000'
    • Player’s Vault economy balance >= 1000.

  3. is-integer:

    codeconditions:
      is-integer:
        value: '%input%'
    • Checks if %input% placeholder is a valid integer.

  4. double (is-double or parse double):

    codeconditions:
      is-double:
        value: '%input%'
    • Checks if %input% can be parsed as a double number.

  5. conditional-placeholder:

    codeconditions:
      conditional-placeholder:
        condition: '%vault_eco_balance_fixed%>500'
    • Allows complex comparisons:

      • ==, !=, <, >, <=, >=

    • Compare two numeric placeholders or strings.

If multiple conditions are listed under conditions:, all must be true for the item to appear.

Last updated