# Level System

### ranks.yml

What does each setting do:

* Example: `rookie`. This is the rank’s configuration key in the config file.
* id: Determines the output of the %rxylevel\_current\_rank% placeholder.
* min\_level: Specifies the minimum level required for the player to obtain the specified rank.
* max\_level: Specifies the maximum level required for the player to obtain the specified rank.
* pvp\_message: The message sent when a player tries to PvP with someone who is not in the same rank.
* perm: The permission the player will have while they are in the specified rank. Any permission can be given. When the player ranks up, these permissions are revoked and the new rank’s permissions are granted.
* rankup: The message that will be sent when the player ranks up.
* runkup\_commands: The commands that will be executed when the player ranks up.

```yml
ranks:
  rookie:
    id: "Rookie" # rank name displayed in placeholders
    max_level: 50 # maximum level for this rank
    min_level: 0 # minimum level required for this rank
    pvp_message: "You cannot enter PvP with this player because you are not in the same rank!" # message shown when PvP is not allowed
    perm: 'rank.rookie' # permission granted when the player reaches this rank
    rankup: "Congratulations! You leveled up, your new level is: Rookie!" # rank-up message
    rankup_commands:
      - msg %player% hi!
  master:
    id: "Master"
    max_level: 100
    min_level: 51
    pvp_message: "You cannot enter PvP with this player because you are not in the same rank!"
    perm: 'rank.master'
    rankup: "Congratulations! You leveled up, your new level is: Master!"
    rankup_commands:
      - msg %player% hi!
  supreme:
    id: "Supreme"
    max_level: 150
    min_level: 101
    pvp_message: "You cannot enter PvP with this player because you are not in the same rank!"
    perm: 'rank.supreme'
    rankup: "Congratulations! You leveled up, your new level is: Supreme!"
    rankup_commands:
      - msg %player% hi!
```