# Cosmetics creation

## Creation

Here you can find out how to create a cosmetic\
Either without any plugin that supports modified items\
or on the contrary, know how to create cosmetics with this type of plugins such as ItemsAdder or Oraxen.

Different types of cosmetics have unique options that are not shared. This time I will show you the options that are shared by all cosmetics.

```yaml
cosmetics:
  test_balloon: #this will be the id of the cosmetic
    permission: 'cosmetics.test_balloon' #to use the permission, you must have the permissions option enabled in the config.
    item:
      display: '&btest balloon' #name that the cosmetic item will have
      texture: 'here' #in case your item is a head, you can choose the texture of the head with this path!
      material: LEATHER_HORSE_ARMOR #cosmetic material if you use ItemsAdder you can delete this path
      #if you use the ItemsAdder or Oraxen plugin you can just put the name of your item here and it will suffice
      item-adder: balloon #optional
      oraxen: balloon #optional
      lore: #lore of the item if you don't want it to have a lore you can delete the path
      - ''
      - '&cfirst'
      - ''
      unbreakable: true #select if the item will be unbreakable!
      glow: true #selects whether the item will have a glow effect.
      hide-attributes: true #select if the item will hide the attributes.
      modeldata: 10030 #here goes the model data of the item if the item is from the ItemsAdder or Oraxen plugin it will skip this.
      color: '#004F71' #Set the default color of the cosmetic (in case you want one).
    colored: false #select if the cosmetic will be colorable
    type: BALLOON #select the type of cosmetic
    hide-menu: false #It will make the cosmetic visible or not in the menu.
    use-emote: false #This is used to specify if you want a cosmetic to be shown when using an ItemsAdder emote. By default it is disabled.
```

And, these are all options that are shared among all types of cosmetics.

## Balloons

> <mark style="color:red;">**Warning: If you use a Balloon from ModelEngine or ItemsAdder please make sure that your model contains bones for the leash, otherwise your balloon may not work correctly.**</mark>

For MagicCosmetics to detect the leash bone, the name of your bone must begin with "l\_".

<figure><img src="/files/RU6u1rvfkQyarUXFVe7H" alt=""><figcaption><p>ModelEngine (Here you can use as many leash bones as you want).</p></figcaption></figure>

<figure><img src="/files/xJkkmNeiogmq3PrqNwya" alt=""><figcaption><p>ItemsAdder (Only one leash is allowed at the moment)</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://francobm.gitbook.io/magiccosmetics/cosmetics-creation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.