# Emojis

### Folders setup

Create a folder `contents/myemojis/textures/font/emoji/`

### Image

Inside this folder you have to put your emojis, you should make them 72x72 to make sure they're not too big and they're not pixelated. But you can decide the size you want (only important thing is that height and width is not over 256.

In this example I put an image named `contents/myemojis/textures/font/emoji/smile.png`.

### Configuration

Create a configuration file, for example `contents/myemojis/myconfig.yml` (you can name it whatever you want)

{% code title="contents/myemojis/myconfig.yml" %}

```yaml
info:
  namespace: "myemojis"
```

{% endcode %}

Then add your emoji (in this example I made a **`smile`** emoji) to the list of `font_images`, so your file would look like this:

{% code title="contents/myemojis/myconfig.yml" %}

```yaml
info:
  namespace: "myemojis"
font_images:
  smile:
    permission: 0
    show_in_gui: true
    path: "font/emoji/smile.png"
    scale_ratio: 9
    y_position: 8
```

{% endcode %}

**`scale_ratio`** is the final height in pixels of the emoji because 72x72 pixels is too big, You'd have to scale it but you can set 9 so Minecraft will handle it automatically.\
\&#xNAN;**`y_position`** is the y position in pixels, 8 should be good if you keep emoji 72x72 and `scale_ratio` to 9. If you have different size you'll have to tweak the y\_position based on your tests.

{% hint style="danger" %}
`scale_ratio` must ALWAYS be higher than `y_position`.\
I cannot fix that issue, it's a **Minecraft** limitation.
{% endhint %}

## In-game view

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-af2df32c0c0d810e80e5146242025c14e7d729d8%2Fimage_\(116\)%20\(3\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\)%20\(1\).png?alt=media)

### Using the /e useful suggestions

Write `/e` in chat, press **SPACE** and press **TAB** to start autocompleting.

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-42dc38c1c97d2c18437d379a2ac557023dd7f55d%2Fimage_\(112\).png?alt=media)

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-90093e48646aaf5713581c6c96bf100e6c86e846%2Fimage_\(111\).png?alt=media)

![](https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-b983b0c00efdfdeb852300796b5435d5f2acee5d%2Fimage_\(113\).png?alt=media)

### Using the tab autocomplete in chat

Write `:` in chat and press **TAB** to start autocompleting.

<figure><img src="https://2228257718-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Faipc4QQKwVS0w1Q604ya%2Fuploads%2Fgit-blob-5c234fb4e4a280a802ad67703cfc397b25f37c79%2Femoji_autocomplete_chat.png?alt=media" alt=""><figcaption></figcaption></figure>

### Example

{% @github-files/github-code-block %}