Configuring Race Levels

### **In order to set up race levels, you MUST have a race created already. Take a look here if you don't.**

In this section, you will be learning how to set up the levels for races. This can be beneficial if you want to have a race that over time can gradually have more health or a race that unlocks a certain ability when it reaches a level.

For this tutorial, we will be using the Werewolf race we created here.

```
race:
    name: Werewolf
    max-level: 30
    require-unlock: true
    gui:
        slot: 29
        icon:
            type: player_head
            owner: Werewolf
            display-name: "&cWerewolf &7| &aUnlocked"
            lore:
            - '&7At night, a dark curse falls upon'
            - '&7this race turning it into a vicious'
            - '&7werewolf!'
        icon-selected:
            type: player_head
            owner: Werewolf
            display-name: "&cWerewolf &7| &eSelected"
            lore:
            - '&7At night, a dark curse falls upon'
            - '&7this race turning it into a vicious'
            - '&7werewolf!'
            enchants:
            - unbreaking 1
            item-flags:
            - hide_enchants
        icon-locked:
            type: skeleton_skull
            display-name: "&c??? &7| &cLocked"
            lore:
            - '&7Defeat the Feral Lycan to'
            - '&7unlock this race.'

```

So now that you have this race, what you'll need to do is add a new section and call it **levels**. Within this new section, you can define how much experience the player needs in order to level up, and how many skillpoints they gain from leveling up.

```
race:
    name: Werewolf
    max-level: 30
    require-unlock: true
    gui:
        slot: 29
        icon:
            type: player_head
            owner: Werewolf
            display-name: "&cWerewolf &7| &aUnlocked"
            lore:
            - '&7At night, a dark curse falls upon'
            - '&7this race turning it into a vicious'
            - '&7werewolf!'
        icon-selected:
            type: player_head
            owner: Werewolf
            display-name: "&cWerewolf &7| &eSelected"
            lore:
            - '&7At night, a dark curse falls upon'
            - '&7this race turning it into a vicious'
            - '&7werewolf!'
            enchants:
            - unbreaking 1
            item-flags:
            - hide_enchants
        icon-locked:
            type: skeleton_skull
            display-name: "&c??? &7| &cLocked"
            lore:
            - '&7Defeat the Feral Lycan to'
            - '&7unlock this race.'
    levels:
        1: # The first level
            xp: 200 # How much experience you need to level up
            skillpoints: 1 # How many skillpoints you get for leveling up
        2:
            xp: 250
            skillpoints: 1
        3:
            xp: 275 # You don't need to define skillpoints either, but you MUST define how much xp it takes for you to level up.
        4:
            xp: 300
            skillpoints: 1
        5:
            xp: 350
            skillpoints: 2
        # You can define as many levels as you want below
```
And just like that, you have levels set up for your race. Now this is only the first part. As of now, they have no usage. Refer to the pages below to give them a use.

**Obtaining Race Experience:**

- Race Triggers

- Race Abilities

**Features Incorporated With Levels:**

- Race Attributes

- Race Permissions

- Race Triggers

- Race Abilities