Hats.md

 Hats are a type of cosmetic that replaces your helmet. Hats are purely cosmetic and will not override the armor, stats, or abilities of any helmets that are equipped.
 
 ## Configuration
-Configuration for hats is simple! Just create or modify a file inside the `hats` folder within whatever [pack](Packs) you're using with the following:
+Hats go in a configuration file located in any pack:
+```plugins/MythicMobs/pack/cosmetics/hats/your_file.yml```
 
+You can have one or more files in the folder, and a file can have multiple cosmetics in it.
+
+To add a hat, create or modify a file inside the `hats` folder within whatever [pack](Packs) you want and use the following config format:
 ```
-MY_NEW_HAT:
-  Material: IRON_INGOT
-  Model: 1337
-  Display: "<gold>My New Hat"
+BASIC_HAT:
+  Model: item/cosmetics/hats/basic_hat
+  Display: 'Basic Hat'
   Description:
-  - "<white>Created by me!"
+  - "Just a basic hat"
 ```
 
+#### Basic Options
 **Hats have the following options**:
-  * `ID` - *The ID of the cosmetic* (in this case `MY_NEW_HAT`)
-  * `Material` - *The material the cosmetic model is attached to in your resource pack*
-  * `Model` - *The CustomModelData number the cosmetic model is attached to in your resource pack*
-  * `Display` - *The display name of the cosmetic in menus*
-  * `Description` - *The lore of the cosmetic in menus*
\ No newline at end of file
+
+| Option | Description |
+| ------ | ----------- |
+| `ID`   | The ID of the cosmetic (in the example: `BASIC_HAT`) |
+| `Model` | The model path to the hat inside your resource pack item definitions |
+| `Display` | The display name of the cosmetic in menus |
+| `Description` | The lore of the cosmetic in menus |
+
+#### Advanced Options
+If you need to get more specific with your cosmetic definition, you can also use the following options:
+
+| Option | Description |
+| ------ | ----------- |
+| `Item`   | A Mythic item name to use, or Nexo if prefixed with `nexo:` |
+| `Material` | Override the material used |
+| `CustomModelData` | A CustomModelData value to use |
+
+