> For the complete documentation index, see [llms.txt](https://cosmeticscore.devs.beer/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cosmeticscore.devs.beer/adding-content/balloon-advanced/modelengine.md).

# ModelEngine

{% hint style="warning" %}

### This balloons type require ModelEngine to work.

{% endhint %}

## Creating a balloon

### Step 1

Create an ModelEngine entity, read the ModelEngine tutorials on their wiki (if available).\
Note that I'm not its developer.

### Step 2

Create the cosmetic configuration

```yaml
  # Example custom kite created with ItemsAdder entities 
  # (supports also animated ItemsAdder entities models)
  star_kite:
    display_name: "Star Kite"
    type: MEG_BALLOON_ENTITY
    balloon:
      leash: true
    # Showing a different item into the GUI 
    # (in this case it's a must because ModelEngine entities can't be put in GUIs)
    model:
      gui: minecraft:egg
      normal: star_kite
    dye:
      enabled: true # To allow this item from being colored.
```

As you can see I set the `normal` model to the name of the **custom entity** created with ModelEngine.

### Step 3

You're done

![](https://517658335-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcHqkAbmdfwmU7TFYbk0w%2Fuploads%2FElH8ZFoxbcspXG5vdYvx%2Fimage.png?alt=media\&token=5bd62ea3-a9e9-4d6c-912f-cedb5fc59b00)

## Final notes

{% hint style="info" %}
You can even create animated balloons, just animate the idle animation of the entity using Blockbench.\
For example you can create a complex dragon or a rotating UFO.  
{% endhint %}

## Leash location

{% content-ref url="/pages/YTfQd9PZMO9TNsRA0Ef4" %}
[Leash location](/adding-content/balloon-advanced/leash-location.md)
{% endcontent-ref %}