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. Within 60 seconds, left-click the barrel with a stick in your main hand. This finishes creating the mailbox.

Each of your mailboxes needs a different name. The server may limit how many mailboxes you can own (there's no limit by default, and higher ranks often get more) and a maximum name length (32 characters by default). If the server charges for mailboxes, you'll need enough balance to cover it. If the server sells extra slots, /minemail buyslot gets you more.

Right-click your barrel at any time to open your mailbox. To place blocks against it instead, sneak while holding a block.

2. Send mail

• Command: /minemail send <player> opens a letter addressed to that player. If they have more than one mailbox, you'll be asked which one, or you can name it: /minemail send Steve "Front Door".
• From a mailbox: open a mailbox you have access to and click Compose Mail.

The player can be offline, but must have joined the server before and own a mailbox. Anyone can send mail to any mailbox; you don't need to be shared on it.

In the compose menu:

1. (Optional) Click To to change who the letter is going to. You get a list of every player who owns a mailbox, online players first, or choose Type a name... to enter one.
2. (Optional) Click Subject and type it into the dialog. Without one, the letter is sent as "No Subject".
3. Click Message and type your letter. A message is required, and it can run over several lines.
4. (Optional) Place up to 9 item stacks in the empty row of attachment slots (the server may allow fewer).
5. (Optional) Click Attach Money and enter an amount, if the server has an economy.
6. Click Send.

If the server charges to send mail, that's taken together with any currency you attached. If the mailbox is full, nothing is taken and you're told. Clicking Cancel, or just closing the menu, returns your items. If you walk away for 5 minutes, or disconnect, your items are returned too (on your next join if needed).

3. Read your mail

Right-click your mailbox barrel to open it (or use /minemail open <mailbox>). The sign at the top shows the mailbox's name, owner, and description. Mail is listed newest first. New mail shows as a map, read mail as paper. Click a letter to open it and mark it read.

Along the bottom of the mailbox:

• Sort: newest first, oldest first, unread first, sender (A-Z), or subject (A-Z).
• Filter: all mail, unread, read, has items or money, or returned to you.
• Search: type text to find in the subject, sender, or message. Search for nothing to clear it.

Your sort, filter, and search stay in place while you open letters and come back.

From an open letter you can:

• Collect attachments: click each item to take it. If your inventory is full, it drops at your feet.
• Collect currency: click the gold ingot to deposit any attached money.
• Reply: click the feather to write back to the sender's mailbox, with the subject set to Re: .... If they have several mailboxes, you're asked which one. Returned mail can't be replied to.
• Forward: click the book and quill to send the letter's text on to someone else, with the subject set to Fwd: .... Items and money stay with the original letter.
• Delete the letter: click the lava bucket. If it still has items or money in it, you'll be asked to confirm and they're given to you first.

The sender is sent a read receipt the first time you read their letter, unless they've turned receipts off with /minemail receipts.

4. Get notified

When new mail arrives while you're online, you get a chat message and a sound. If you have new mail when you log in, you're told how many letters are waiting a couple of seconds after joining. Anything held for you while you were away (returned mail, currency, read receipts) is delivered at the same time.

5. Manage your mailbox

Open your mailbox and click Manage Mailbox to:

• Rename it.
• Edit its description, shown in the directory and at the top of the mailbox. Descriptions can be several lines long (up to 512 characters by default).
• Turn its hologram (the floating name above the barrel) on or off.
• Pick a particle, if the server gives you access to particle choices.
• Manage access: add or remove view-only players. For a group mailbox this is Manage Group instead, where you click a member to change their role or remove them.
• Delete it. Only works once it's empty.

6. Share a mailbox

By default, only you can open your mailbox. There are two ways to let others in.

View-only sharing: they can open the mailbox and read mail (and reply to or forward it), but can't take anything, delete mail, or mark it read.

/minemail share <mailbox> <player>
/minemail unshare <mailbox> <player>

You can also add online players from Manage Mailbox → Manage Access.

Groups: for a shared household or shop mailbox where others collect mail too.

/minemail group create Farmers
/minemail group add Farmers Alex
/minemail group link Farmers Front Porch

Group members can read, collect, and delete mail. Managers can also manage the mailbox and the group. Only the owner can delete the mailbox. See Commands for every group command.

7. Returned mail

If the server has mail expiration on, mail still in a mailbox after the set number of days (30 by default), read or not, is returned to its sender with its items and money, marked "Returned". It isn't deleted.

Commands you can use

Command	What it does
/minemail create <name>	Start creating a mailbox (then left-click a barrel with a stick).
/minemail delete <name>	Delete one of your own mailboxes, once it's empty.
/minemail list	List your mailboxes and group mailboxes, with new-mail counts.
/minemail directory (/minemail dir)	Browse every mailbox on the server.
/minemail send <player> [mailbox]	Write a letter to a player.
/minemail open <mailbox>	Open one of your own or group mailboxes.
/minemail share <mailbox> <player>	Give a player view-only access to your mailbox.
/minemail unshare <mailbox> <player>	Remove a player's view-only access.
/minemail buyslot	Buy an extra mailbox slot, if the server sells them.
/minemail receipts	Turn read receipts for your sent mail on or off.
/minemail group ...	Create and run mail groups.

Full command reference, including admin commands: Commands.

Tips

• Mailboxes must be barrels. No other block works.
• A mailbox with mail in it can't be broken or deleted. Collect or delete its mail first.
• Mailbox barrels can't be blown up, pushed by pistons, or emptied by hoppers.
• A letter shows up to 7 attachments at a time. Collect some to see the rest.
• Custom mailbox icons aren't available yet.