# Player Emotes

## Emotes / Gestures

Emotes allow you to express yourself with some particular player animations.\
They integrate perfectly with the game and look like an official update.

{% embed url="<https://www.youtube.com/watch?v=posxlbudF8I>" %}

{% tabs %}
{% tab title="Method for 1.21.4+ clients" %}
{% hint style="success" %}
Thanks so much to **Misieur** (**Thomas**) which helped me to implement this new method with his ideas 🩷
{% endhint %}

{% code title="config.yml" %}

```yaml
emotes:
  1_21_4_plus_modern_method: true
```

{% endcode %}

#### Main features

* [Blockbench](https://www.blockbench.net/) extension to animate the Minecraft player model
* Completely Async, no TPS drops
* Optimized for big servers
* Play sounds and particles in animations
* Shows items in player hands and helmet
* Doesn't overwrite any vanilla shader
* Compatible with shader mods (Optifine, Iris, etc.)
* Supports slim arms
* Doesn't cause any issue with placed player heads (skulls)

#### Limitations

* Requires Minecraft 1.21.4 or greater
* More info about emotes issues [here](https://itemsadder.devs.beer/faq/emotes-issues)
  {% endtab %}

{% tab title="(OLD) Method for 1.17 to 1.21.3 clients" %}
{% code title="config.yml" %}

```yaml
emotes:
  legacy_shaders: true
  1_21_5_to_1_21_9_shaders: true
```

{% endcode %}

#### Main features

* [Blockbench](https://www.blockbench.net/) extension to animate the Minecraft player model
* Completely Async, no TPS drops
* Optimized for big servers
* Play sounds and particles in animations
* Shows items in player hands and helmet

#### Limitations

* Won't show the player armor equipment, only mainhand, offhand and helmet.
* Works only on 1.17 to 1.21.3 clients
* More info about emotes issues [here](https://itemsadder.devs.beer/faq/emotes-issues)
  {% endtab %}
  {% endtabs %}

## Installing the Blockbench extension

{% hint style="warning" %}
**Before continuing:**

* Make sure you're running **Blockbench 4.7.4** or **greater**
* Make sure you're running the latest ItemsAdder and latest ItemsAdder Blockbench extension
  {% endhint %}

[Download Blockbench](https://www.blockbench.net/) (don't use the web app).

![](https://708574821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-887967055%2Fuploads%2Fgit-blob-8fb587bcdde9a84fd068e2ab7ae908effb8f16ac%2Fimage.png?alt=media)

\
[Download](https://github.com/LoneDev6/itemsadder-entity/releases) the extension file.

<figure><img src="https://708574821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-887967055%2Fuploads%2Fgit-blob-e4be624576a58188d50f2ba48cb091cd04d14803%2Fia-entities-download-js.png?alt=media" alt=""><figcaption></figcaption></figure>

Then open **Blockbench** and click on File -> Plugins.

![](https://708574821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-887967055%2Fuploads%2Fgit-blob-fc7948d38279308f8fb64576ac5e7fe1be48585e%2Fimage.png?alt=media)

Click on the icon to load plugins from file, then select the file `iaentitymodel.js`.

![](https://708574821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-887967055%2Fuploads%2Fgit-blob-a0973aab154a753511e87dbf4067657e26529c18%2Fimage.png?alt=media)

Press OK

![](https://708574821-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M28TcKgSDvuFN510qye-887967055%2Fuploads%2Fgit-blob-b6b465bbaf8463a31e859a458ee8600e23efd0f9%2Fimage.png?alt=media)

## Enabling emotes

Open `config.yml` of ItemsAdder and enable these two options, then run `/iazip` command.

{% code title="config.yml" %}

```yaml
entities:
  custom-entitites:
    enabled: true
    emotes: true
```

{% endcode %}
