> 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/emotes.md).

# Emotes

Emotes change the player's head texture to display different expressions or animations. This is achieved by cycling through a series of head textures at a defined frequency.

{% code fullWidth="true" %}

```yaml
enabled: true

name: "&cAngry Emote"
description: "Express your anger"

item:
  head: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNGZiOTdiMTdjNjM5NTM5MjY1OGYzMjcxOGFhNDZiZWZhMWMzMWQzNTcyNjUxYzMwZjdkMmJmM2I5M2Y2ZWFkOSJ9fX0=

type: EMOTE # Cosmetic type
frequency: 12
faces:
  1:
    head: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYWJkNTlhMTNlNDY5ZjczYWRhMmFmNmRjOWY1MWI1NDgwY2QzNGE5ODExZjY3OTc1NGMxM2ZmYTVmOWY1ZjYifX19
  2:
    head: ewogICJ0aW1lc3RhbXAiIDogMTczOTYxODk2Mzg3NSwKICAicHJvZmlsZUlkIiA6ICIxNTY3ODg4YTAwYWY0ODc2YjYyNTI3YTNiOGY3YTdlYSIsCiAgInByb2ZpbGVOYW1lIiA6ICJUb3NoaW9YdHJlbWUiLAogICJzaWduYXR1cmVSZXF1aXJlZCIgOiB0cnVlLAogICJ0ZXh0dXJlcyIgOiB7CiAgICAiU0tJTiIgOiB7CiAgICAgICJ1cmwiIDogImh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZDUzNDE3ZGEyYTFmNzhlYjdiMzY3MWU5YzllNTE0NWNkNmZhYjAyNmNjZjQ5YmM1MjA4Y2Y1NTdjNjY3NTM1MyIKICAgIH0KICB9Cn0=
  3:
    head: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvNGZiOTdiMTdjNjM5NTM5MjY1OGYzMjcxOGFhNDZiZWZhMWMzMWQzNTcyNjUxYzMwZjdkMmJmM2I5M2Y2ZWFkOSJ9fX0=
```

{% endcode %}

**Configuration Options:**

* enabled: Enables or disables the cosmetic.
* name: The display name of the cosmetic item.
* description: The description of the cosmetic item.
* item: Defines the item used to represent the cosmetic in menus. Specifically, the head value defines the default head texture.
  * head: A Base64 encoded string representing the player head texture.
* type: Specifies the cosmetic type as EMOTE.
* frequency: The interval (in ticks) at which the head texture is updated. Lower values result in faster animation.
* faces: A list of head textures to cycle through.
  * 1, 2, 3, ...: Each number represents a frame in the animation.
    * head: A Base64 encoded string representing the player head texture for that frame.