User Guide

Everything a player needs to know to use MineMail, without the admin/setup details.

1. Build a mailbox

MineMail mailboxes are barrels.

1. Place a barrel wherever you want your mailbox.
2. Run /minemail create <name> (multi-word names are fine, e.g. /minemail create Front Porch).
3. Left-click the barrel with a stick in hand to confirm. This finishes creating the mailbox.

If your server charges for mailboxes (economy.mailbox-creation-cost), you'll need enough balance to cover it. You're also limited to a maximum number of mailboxes (mailbox.max-per-player, default 5) and a max name length (default 32 characters).

Right-click your barrel at any time to open your mailbox.

2. Send mail

You don't need to know someone's mailbox in advance - either:

• Command: /minemail send <player> <mailbox> opens that player's named mailbox for you to compose into.
• Directory: run /minemail directory (or /minemail dir) to browse every public mailbox on the server, then click one to open it and hit Compose Mail.

In the compose screen:

1. Click Subject and type it in chat (or type cancel to abort).
2. Click Message and type it in chat.
3. (Optional) Drop up to 9 items into the attachment slots.
4. (Optional) Click Currency and type an amount, if currency attachments are enabled on your server and you have balance to spare.
5. Click Send.

Clicking Cancel at any point returns any items you've placed back to your inventory. Anyone can send mail to any mailbox - you don't need to be shared on it first.

3. Read your mail

Right-click your mailbox barrel to open it. Unread mail shows as a map icon; read mail shows as paper. Click a piece of mail to open it - this marks it as read.

From there you can:

• Collect attachments - click each attached item to move it to your inventory (one at a time; make sure you have space).
• Collect currency - click the currency button to deposit any attached money.
• Delete the mail - only the mailbox owner can do this (a lava bucket icon on the mail's detail screen).

4. Get notified

If you have unread mail when you log in, you'll get a chat message with your unread count a couple of seconds after joining, along with a sound - you don't need to check every mailbox manually.

5. Share a mailbox

By default, only you (the owner) can open your mailbox. To let someone else read and collect mail from it too:

/minemail share <mailbox> <player>

To revoke access:

/minemail unshare <mailbox> <player>

Shared players can read mail and collect attachments/currency, but they can't delete mail or delete the mailbox itself - only the owner can do that.

Commands you can use

Command	What it does
/minemail create <name>	Start creating a mailbox (then confirm by left-clicking a barrel with a stick).
/minemail delete <name>	Delete one of your own mailboxes.
/minemail list	List your mailboxes and their unread counts.
/minemail directory (/minemail dir)	Browse every public mailbox on the server.
/minemail send <player> <mailbox>	Open a player's mailbox to compose mail into it.
/minemail open <mailbox>	Open one of your own mailboxes.
/minemail share <mailbox> <player>	Grant a player access to your mailbox.
/minemail unshare <mailbox> <player>	Revoke a player's access to your mailbox.

Full command reference (including admin commands): Commands.

Tips

• Mailboxes must be barrels - no other block works.
• Attachments are capped at 9 items per mail, regardless of what your server's config says the max is.
• Breaking your own mailbox's barrel deletes it, but is blocked while it still has mail in it - read/collect everything first.
• Deleting via /minemail delete (or the Manage Mailbox GUI) does not have that same protection - double-check for unread mail before deleting that way.
• If a feature you expected - mail groups, custom mailbox icons, expiring mail - doesn't seem to work, it's likely not implemented yet rather than a bug. See Troubleshooting & FAQ.