Skip to content
Matcha! Mods

Your First Mail

Your First Mail

Section titled “Your First Mail”

Let’s send your first mail. Run this:

/mail send PlayerName Hello "Welcome to the server!"

Done. PlayerName gets notified, opens their inbox with /mail, and reads your message. No GUI needed, no configuration — just a command.

Compose GUI

Section titled “Compose GUI”

Prefer clicking to typing? Open the full compose interface:

/mail compose PlayerName

Pick a recipient, write a subject and body, attach items or Pokemon, and hit Send. The recipient gets the mail immediately — or the next time they log in if they’re offline.

You can also get there from the inbox. Run /mail, click Compose, and fill everything in from the GUI.

Attaching Items

Section titled “Attaching Items”

In the compose GUI, drag items from your inventory into the attachment slots. They’re removed from your inventory when you send and delivered when the recipient claims them.

You can attach multiple items to a single mail. The recipient claims them all at once.

Receiving and Claiming

Section titled “Receiving and Claiming”

When mail arrives, the recipient sees a notification. Here’s the flow:

  1. Run /mail to open the inbox
  2. Click the unread mail
  3. Read the message, claim any attachments

Attachments go where you’d expect:

Items : Straight to inventory.

Pokemon : Party first, PC if the party’s full.

Currency : Deposited to the player’s balance.

Commands : Executed immediately.

If the player’s inventory or party is full, unclaimed items go to the Package Locker — overflow storage that keeps everything safe.

Sending a Preset

Section titled “Sending a Preset”

Presets are pre-built mail templates. Perfect for welcome kits, event rewards, daily login bonuses. Create once, send to anyone — or everyone — with a single command.

Here’s a starter kit preset:

File: config/courier/presets/starter_kit.conf

preset {
    sender = "Server"
    subject = "Welcome Package"
    body = "Welcome to the server! Here are some items to get you started."
    notification = PROMINENT
    packages {
        items = [
            {
                item = "minecraft:diamond_sword"
                count = 1
            }
            {
                item = "minecraft:golden_apple"
                count = 5
            }
        ]
        pokemon = [
            {
                species = "eevee"
                level = 10
            }
        ]
    }
}

Reload, then send it:

/mailadmin reload
/mailadmin preset send starter_kit PlayerName

Send to everyone online:

/mailadmin preset send starter_kit online

That’s it. Every online player gets a diamond sword, 5 golden apples, and a level 10 Eevee in their inbox.

Next Steps

Section titled “Next Steps”

You’ve got the basics down. Time to go deeper: