# Mails

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

```yaml
# Enables /rmail /mail and the whole feature
enableMails: true
```

{% endcode %}

## Commands

<div align="center"><figure><img src="https://4192870058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mix0kMe6uMSoQG3GdY-%2Fuploads%2Ft735nvCDRiEtlEtRvwCe%2Fimage.png?alt=media&#x26;token=d2c2bf37-0c42-4238-b9c9-3ca437f642ac" alt=""><figcaption><p>The send command</p></figcaption></figure></div>

### <mark style="color:orange;">`/rmail (or /mail) send <playerName/-Public> mail-title`</mark>

You can use it with <mark style="color:yellow;">`redischat.mail.write`</mark> permission\ <mark style="color:yellow;">`redischat.mail.writepublic`</mark> for public mails

* After you run this command, a clickable message will appear in the chat.
* That message links to a [**web editor**](https://webui.advntr.dev/) where you can modify your mail with MiniMessage format
* When you’re done editing, click the save button: **a command will be copied to your clipboard**

<figure><img src="https://4192870058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mix0kMe6uMSoQG3GdY-%2Fuploads%2FP9MUJldU3h2i0VRp4jyM%2Fimage%20(1).png?alt=media&#x26;token=08f49eb3-5ecf-47d2-9f79-a00022989971" alt=""><figcaption><p>The save button</p></figcaption></figure>

* Then paste and execute the command in-game and choose one of the three options

<figure><img src="https://4192870058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mix0kMe6uMSoQG3GdY-%2Fuploads%2FH7Vw5zXYvvICyL9O9Ehr%2Fimage.png?alt=media&#x26;token=dc5052ae-91dc-4028-94d5-61eb3750f6ea" alt=""><figcaption><p>Chat GUI on mail send</p></figcaption></figure>

* By clicking *Confirm* you will send the mail to the recipient

## <mark style="color:orange;">`/rmail`</mark>

Permission: <mark style="color:yellow;">`redischat.mail.read`</mark>

```
redischat.mail.read
```

Executing only /rmail opens a GUI with all your mails

<figure><img src="https://4192870058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mix0kMe6uMSoQG3GdY-%2Fuploads%2FK44JfGOy0ajDSM9y5QlL%2Fimage.png?alt=media&#x26;token=8c127d8b-b153-42fb-b1c3-ea923c58fb21" alt="" width="397"><figcaption><p>Mail window</p></figcaption></figure>

<figure><img src="https://4192870058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mix0kMe6uMSoQG3GdY-%2Fuploads%2FEFR7ZQMwyujNHfo0l0mj%2Fimage.png?alt=media&#x26;token=c3cd579c-00e7-44bb-a4da-71f2477ddfb1" alt=""><figcaption><p>Mail preview inside lore</p></figcaption></figure>

## Mail options

By right-clicking a mail you can delete it or mark it as unread

<figure><img src="https://4192870058-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mix0kMe6uMSoQG3GdY-%2Fuploads%2Fj1TpYy5wPSswW2UJMpBL%2Fimage.png?alt=media&#x26;token=60e6c2ee-4f11-4610-bad9-c9a45615fa52" alt="" width="415"><figcaption><p>Mail option preview</p></figcaption></figure>

### Mail options permissions

* `redischat.mail.delete` - With this perm you can delete your PRIVATE mails
* `redischat.mail.deletepublic` - With this perm you can delete your PUBLIC mails
* `redischat.mail.unread`- With this perm you can unread any mail

## /redischat-setitem \<item\_name>

Use this command to set the item you have in the main hand into the mail GUI selected slot

The available items are&#x20;

`backButton, forwardButton, mailItem, privateButton, publicButton`


---

# 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://emibergo.gitbook.io/redischat/unique-features/mails.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.
