> For the complete documentation index, see [llms.txt](https://cosmetics.advancedplugins.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cosmetics.advancedplugins.net/cosmetics-system/wearable-cosmetics.md).

# Wearable Cosmetics

3D cosmetics are 3D models created in Blockbench that players can wear. These models are loaded directly by the plugin without requiring resource packs.

```yaml
enabled: true
model: cosmetics:arcade_machine_hat # model file folder location, full location for this example /plugins/AdvancedCosmetics/models/cosmetics/arcade_machine_hat/

# name: "&darcade machine hat" # You can override model's name here
# description: "A arcade machine hat." # You can override model's description here

item: # You can override model's shown item here
  head: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvY2ZjZTdlYWMyZTFmNjVjZDEzYTRiZGFmMDFhY2JiOGI0YmM2MjBlYjQxM2M4NzVmMDQ0YjQxNjMyZjJhMWM2ZCJ9fX0=

type: HAT
```

**Configuration Options:**

* enabled: Enables or disables the cosmetic.
* model: The path to the model file, relative to the models directory of the plugin (e.g., /plugins/AdvancedCosmetics/models/). In the provided example, it looks for folder arcade\_machine\_hat inside a folder called cosmetics in the models folder.
* name (Optional): Overrides the model's default name. If commented out, model's name will be used.
* description (Optional): Overrides the model's default description. If commented out, model's description will be used.
* item (Optional): Overrides the item that shows in the cosmetics menu instead of the models default item.
* type: Specifies the cosmetic type as **HAT, BACKPACK,WINGS,GROUND**