# Making your own custom emojis

**Emojis** are one of the core parts of **social**. They are used everywhere: in the chat, books, signs, anvils... Server owners who wish to add their own emojis can do so very easily by customizing the emojis module in settings.

<figure><img src="https://4118553225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIuZYDEHzi3qCMdABwKd%2Fuploads%2FktuRzIq9Nf9QQtnItd0R%2FScreenshot%202024-11-15%20at%2019.29.00.png?alt=media&#x26;token=ad0bde06-a8e4-48f5-bdce-2cc200c9ac2b" alt=""><figcaption></figcaption></figure>

Let's have a look at this example:

```yaml
  emojis:
  ...
  - name: crossed_swords
    aliases: []
    unicodeCharacter: \u2694\uFE0F
```

* **name:** Name of this emoji that will also be used as an identifier. Must be unique.
* **aliases**: Aliases of this emoji.
* **unicodeCharacter**: Unicode character (or characters) that form this emoji.

This adds the crossed swords emoji (:crossed\_swords:), which can be used with `:crossed_swords:`

## Getting a unicode character

We recommend using the [Emojipedia](https://emojipedia.org) website since it contains every emoji and it's updated frequently. It also provides the technical information we need.

For this example we'll look at the [crossed swords entry](https://emojipedia.org/crossed-swords):&#x20;

<figure><img src="https://4118553225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIuZYDEHzi3qCMdABwKd%2Fuploads%2FqYC0AWoToN9mTPbb0djL%2FScreenshot%202024-11-15%20at%2019.02.13.png?alt=media&#x26;token=244194ee-6b2e-4557-a18f-387e5c74a693" alt=""><figcaption></figcaption></figure>

The **technical information** tab contains the information we need:

<figure><img src="https://4118553225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FhIuZYDEHzi3qCMdABwKd%2Fuploads%2FyfVxmV1Pj0BFyFGk55xp%2FScreenshot%202024-11-15%20at%2019.03.07.png?alt=media&#x26;token=c77011d3-76cf-41da-aa88-e55dd3698c5d" alt=""><figcaption></figcaption></figure>

In this case, the unicode character would be `\u2694\uFE0F`.

## Using raw emojis

Raw emojis are emojis that don't add any formatting. This means that **emoji descriptions** will not be shown, making them a good alternative to normal emojis for server-related messages.

Using raw emojis is as easy as replacing `:emoji_name:` with :`raw_emoji_name:`. For example, `:crossing_swords:` would be `:raw_crossing_swords:`. It's worth noting that raw emojis cannot directly be used by players.


---

# 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://docs.mythmc.ovh/social/administration/making-your-own-custom-emojis.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.