Update Offhand authored by Ashijin's avatar Ashijin
Offhands are a type of cosmetic that replaces your offhand item, and are held in your offhand even if you don't have anything equipped. Offhands are purely cosmetic and will not override the armor, stats, or abilities of any shields or other items that are equipped.
## Configuration
Configuration for offhands is simple! Just create or modify a file inside the `offhands` folder within whatever [pack](Packs) you're using with the following:
Offhands go in a configuration file located in any pack:
```plugins/MythicMobs/packs/cosmetics/offhands/your_file.yml```
You can have one or more files in the folder, and a file can have multiple cosmetics in it.
To add an offhand cosmetic, create or modify a file inside the `offhands` folder within whatever [pack](Packs) you want and use the following config format:
```
ICECREAM_CONE:
Material: IRON_INGOT
Model: 1337
Display: "<gold>An Ice Cream Cone"
icecream_cone:
Model: item/cosmetics/offhands/icecream_cone
Display: "Icecream Cone"
Description:
- "<white>Held in your hand!"
- "A delicious frozen treat!"
```
**Offhands have the following options**:
* `ID` - *The ID of the cosmetic* (in this case `ICECREAM_CONE`)
* `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
#### Basic Options
**Backs have the following options**:
| Option | Description |
| ------ | ----------- |
| `ID` | The ID of the cosmetic (in the example: `icecream_cone`) |
| `Model` | The model path to the cosmetic 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 |