Placeholder Scripts

Levels Configuration Scripting System

What is it?

The levels scripting engine uses PlaceholderAPI placeholders to determine if level experience is being gained. This is to prevent long standing issues with adding support for dozens of plugins & dozens of plugins requiring support for our plugins.

How to Use

Each level can have unlimited requirements, each on its own line in the config.

levels:
  '1':
    ...
    comparisons:
    - '%guccistats_player;;VOTE% >= 3'
    - '%guccistats_player;;PLAYER_TIME_CONNECTED_r% >= 3600'

Each requirement has 2 parts. Either side can be a PlaceholderAPI placeholder - with its %% formatting. Each comparison has the following requirements

• Must be in the following format

  • <placeholder or value> <operator> <placeholder or value>

  • The values & operators must be separated by a space

• Both sides of the comparison must be the same type

  • Both sides (after placeholders are parsed) must be in the same format.

  • Our scripts currently support the following type comparisons natively.

    • UUID - Comparing UUID's (Player UUID's, Factions, Guilds etc)

    • Number - Comparing 2 Numbers (1, 100, 1.1)

    • String - Comparing 2 Strings (Usernames, Values etc)

• Both values must be separated by a valid comparison operator.

  • == Checks if both sides are the same/equal. Supports Strings, Numbers, and UUID.

  • != Checks if the 2 sides do not equal each other. Supports Strings, Numbers, and UUID.

  • >= Checks if the left side is greater then or equal to the right. Supports Numbers.

  • <= Checks if the left side is less then or equal to the right side. Supports Numbers.

  • > Checks if the left side is greater then the right side. Supports Numbers.

  • < Checks if the left side is less then the right side. Supports Numbers.