# Sending Letters

**Sending Letters is Simple.**

It all depends on the **sending option** set inside the letter asset. Choose from:

📌 **Automatic** – When running the **Send Letters** instruction, it checks all letters and sends those that meet their specified conditions.\
🎲 **Random** – Sent by the **Send Random Letter** instruction. Each letter has a value between 0.1 and 100, where 100 means a 100% chance of being sent. **However, it's still not guaranteed,** since the **Send Random Letter** instruction picks one letter at random, it may still select another letter instead.\
🖐 **Manual** – Sent only when running the **Send Letter** instruction.

A **Mailbox can only receive one of each letter asset at a time**. If you need to resend the **same** letter later, you must **delete** (not hide) the letter from the mailbox first. However, be aware that if the letter's sending option is **Automatic** and its conditions are still met, it will be **re-sent the next time the Send Letters instruction is run**.

## 📌 Automatic

Each letter set to **Automatic** has a **Sending Conditions** field, where you can define any requirements that must be met before the letter is sent.

* If the conditions are **met**, the letter will be sent when running the **Send Letters** instruction.
* If no conditions are set, the letter will be sent **immediately** when the **Send Letters** instruction is executed.

<figure><img src="/files/Rl5ArByMNxSxiMcT7wm6" alt=""><figcaption><p><strong>Sending Conditions:</strong> In this case, if the quest to <strong>locate and return Mr. Whiskers</strong> is <strong>completed</strong>, the letter containing <strong>gold coins as a reward</strong> will be sent the next time the <strong>Send Letters</strong> instruction is run.</p></figcaption></figure>

<figure><img src="/files/Q1De1ewiI0Xg3AN0LPla" alt=""><figcaption><p><strong>Sending Letters Instruction</strong><br>The <strong>Send Letters</strong> instruction checks all available letters and delivers those that meet their conditions. This example is inspired by <em>Stardew Valley</em>, where you can trigger this instruction based on a global variable tracking the in-game day to simulate daily letter deliveries!</p></figcaption></figure>

## 🎲Random

Each letter set to **Random** has a **Send Chance** field, which determines the probability of it being sent when the **Send Random Letter** instruction is run.

* If the **Send Chance** is set to **10**, the letter has a **10% chance** of being selected and sent.
* If the **Send Chance** is set to **100**, the letter has the **highest possible chance** of being sent, but it's **still not guaranteed**, since the **Send Random Letter** instruction picks one letter at random, it may still select another letter instead.
* This system allows for **unpredictable letter deliveries** while still weighting certain letters to be **more likely than others**.

Like the **Automatic** option, **Random** letters can also have **Sending Conditions**. This means that even if a letter has a **100% Send Chance**, it **will not be sent** unless its conditions are met.

Additionally, the **Send Chance** field is a **number decimal property**, allowing it to be dynamically adjusted based on other game mechanics. For example:

* If a letter has a **2% chance** of being sent, and your game uses the **Stats module**, you can link the **Send Chance** to a stat.
* If the player drinks a **Lucky Potion**, the stat could **increase the Send Chance to 20%**, making that letter more likely to be sent.

This makes **Random Sending** highly flexible, allowing for **dynamic and condition-based letter deliveries.**

<figure><img src="/files/vIFrAnF8flBVZmw78IiR" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/b0g94qRWPmZR6pEKSQ0V" alt=""><figcaption><p><strong>Sending Random Letter:</strong> You can trigger the <strong>Send Random Letter</strong> instruction in various ways, such as when the player explores a new area or after a certain amount of in-game time has passed, simulating unexpected deliveries. The <strong>Send Random Letter</strong> instruction also includes a <strong>Force Send</strong> option. If enabled, it guarantees that a letter will be sent as long as there’s at least one available, but this ignores probability settings, making it less random.</p></figcaption></figure>

## 🖐Manual

A letter set to **Manual** will **only** be sent when you use the **Send Letter** instruction with that specific letter selected.

* This option gives you **full control** over when and how the letter is sent.
* Unlike **Automatic** or **Random**, the letter **won’t** be sent unless explicitly triggered.
* Ideal for **scripted events**, **story-driven moments**, or **player-triggered actions** where a letter should be delivered at a precise time.

<figure><img src="/files/TaEJhV6XoN1GLVdAoHUz" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/opDZ3pS3W7B1cBHj31xM" alt=""><figcaption></figcaption></figure>


---

# 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.fullscreen.no/info/game-creator-2-assets/mailbox/guides-and-demo-scene/sending-letters.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.