> For the complete documentation index, see [llms.txt](https://floodeer.gitbook.io/wizards/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://floodeer.gitbook.io/wizards/fundamentals/leveling-up-system.md).

# Leveling Up System

Disabled by default. Enable it at options.yml.

When enabled, a new file will be generated, levels.yml, with this file you will be able to add your levels, rewards and more:

```
Levels:
  Level-1: #Do not change the Level-1 section
    exp: 0 #Required Exp
    display-name: "&6Level 1" #Display name in level up message
    prefix: "&6[1]" #Chat prefix, if enabled, hooked to PAPI
    commands-to-execute: [] #Commands to execute when reaching the level
    level-up-message: [] #Message to display
  Level-2: #From now on you can change
    exp: 10
    display-name: "&6Level 2"
    prefix: "&6[2]"
    commands-to-execute:
      - wizards coins add %player% 100
    level-up-message:
      - '&7&m--------------&7[&6&lWIZARDS&7]&m--------------'
      - ''
      - '&a&lLevel Up &e&l%level%'
      - ''
      - '&9Next level: &b%next_level% &7(%until_next_level%/%next_level_exp% EXP)'
      - ''
      - '&7&m-------------------------------------'
  Level-3:
    exp: 20
    display-name: "&6Level 3"
    prefix: "&6[3]"
    commands-to-execute:
      - wizards coins add %player% 100
    level-up-message:
      - '&7&m--------------&7[&6&lWIZARDS&7]&m--------------'
      - ''
      - '&a&lLevel Up &e&l%level%'
      - ''
      - '&9Next level: &b%next_level% &7(%until_next_level%/%next_level_exp% EXP)'
      - ''
      - '&7&m-------------------------------------'
```

Please do not change Level-1 as it is the default Database value, you can just use display-name to not show "Level-1" in game, the section name is just a backend thing.\
\
Note that the reload command will not apply changes for levels.yml ATM.\
\
***How to Earn Exp***​

Players can earn Exp by playing, kills/assists, wins cand capturing points, check options.yml and you will see a new Exp section to modify.\
\
***Give Exp to old players***​\
Set *Options.Update-Levels* to true in options.yml, when a player joins the server after this update, players will get exp based on wins, games played and kills/assists.\
\
Note that some exp methods (like point captured) is not stored to calculate.\
\
What if I don't want to use Leveling syJust don't enable the option. Everything will work just fine without it.

**Percentage System**

Rewards from leveling up can have a percentage system.

Example:

* '100%: eco give %player% 100' -> 100% chance of giving 100 coins.
* '25%: eco give %player% 100' -> 25% chance of giving 25 coins.

and so on.