Creating a New Race

Creating a new race within PwingRaces is very easy. Start off by navigating to **/plugins/PwingRaces/races** in your file manager and by default there should be two files called **human.yml** and **dwarf.yml**. With PwingRaces, you are easily able to modify any of the component within those files and even create your own.

To create your own, just create a new file, and call it whatever you please; but for the sake of this tutorial, we will be using **werewolf.yml** as our example and will be creating a new werewolf race. After you've created your new race file, open it up and it should be empty.

Now for the sake of this tutorial, we will be pulling what is already in the **human.yml** file to make this process a bit easier, but what you set this to is entirely up to you. Within **human.yml**, you'll be brought up with something like this:

```
race:
    name: Human
    display-name: "&fHuman"
    max-level: 30
    gui:
        slot: 10
        icon:
            type: player_head
            owner: Steve
            display-name: "&fHuman &7| &aUnlocked"
            lore:
            - '&7A race of intelligence primarily'
            - '&7strengthened in areas of combat'
            - '&7and survival.'
        icon-selected:
            type: player_head
            owner: Steve
            display-name: "&fHuman &7| &eSelected"
            lore:
            - '&7A race of intelligence primarily'
            - '&7strengthened in areas of combat'
            - '&7and survival.'
            enchants:
            - unbreaking 1
            item-flags:
            - hide_enchants
        icon-locked:
            type: skeleton_skull
            display-name: "&c??? &7| &cLocked"
            lore:
            - '&7Complete the tutorial to'
            - '&7unlock this race.'

```

Now, there are many different options presented here. Read below for more information.

There are some more things that can be defined here, but if you'd like to see more on that, please take a look at the respective pages for them.

Here is an example of a werewolf race. As you can see the syntax is very similar to that of the human race. You can change any of these values to whatever you please.

```
race:
   name: Werewolf
   spawn-location: world;100;20;100
   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.'

```

And now you know how to create a race! If you'd like to learn more about how you can make these races actually have a use, take a look at the other pages here.