Commands
MineMail's only command is /minemail, with aliases /mail and /mm. With no arguments, help, or an unknown subcommand, it shows a help listing. The buyslot and group lines only appear when those features are enabled, and admin lines only appear for senders with minemail.admin.
Names with spaces can be quoted, for example /minemail send Steve "Front Door". Mailbox names are matched case-insensitively.
Player commands
Player commands must be run in-game and need minemail.use. The one exception is list, which from the console lists every mailbox on the server instead (see /minemail list).
| Command | Description | Extra permission |
|---|---|---|
/minemail help | Shows help. | none |
/minemail create <name> | Starts creating a mailbox. Left-click a barrel with a stick to finish. | none |
/minemail delete <name> | Deletes one of your own mailboxes. Refused while it holds mail. | none |
/minemail list | Lists your mailboxes and group mailboxes, with new-mail counts. | none |
/minemail directory (alias dir) | Opens the directory of every mailbox on the server. | none |
/minemail send <player> [mailbox] | Opens a compose menu addressed to <player>. | none |
/minemail open <mailbox> | Opens one of your own mailboxes or a group mailbox you belong to. | none |
/minemail share <mailbox> <player> | Gives <player> view-only access to one of your mailboxes. | minemail.mailbox.share |
/minemail unshare <mailbox> <player> | Removes <player>'s view-only access. | minemail.mailbox.share |
/minemail buyslot | Buys an extra mailbox slot. Only when mailbox.extra-slots.enabled is true. | none |
/minemail receipts | Turns read receipts for mail you send on or off. | none |
/minemail group ... | Mail group commands. See Group commands. | see below |
Admin commands
Admin commands need minemail.admin (op by default). They don't need minemail.use, and all except inspect also work from the console.
| Command | Description |
|---|---|
/minemail reload | Reloads config.yml and messages.yml and restarts the particle and expiration tasks. |
/minemail cleanupholograms | Removes every MineMail hologram and rebuilds them. |
/minemail inspect <player> [mailbox] | Opens a player's mailbox read-only. In-game only. |
/minemail list (console) | Lists every mailbox on the server with its owner, location, mail counts, and group. Runs from the console without a permission check. |
/minemail log <player> [page] | Shows a player's transaction history, newest first. |
/minemail recover <entryId> | Restores the contents of a returned, expired, or deleted mail from the transaction log. |
/minemail export | Writes a CSV of every mailbox to plugins/MineMail/exports/. |
/minemail itemtest | Self-test: round-trips a complex item through the attachment storage format and reports pass or fail. |
/minemail delete <name> -f | Force-deletes one of your own mailboxes even though it holds mail. --force also works. In-game only. |
See Admin & Maintenance for details.
Group commands
/minemail group needs groups.enabled: true (the default). Group names are unique across the server. For add, remove, promote, demote, transfer, and link, the group name is the first argument, so quote it if it has spaces.
| Command | Who can run it |
|---|---|
/minemail group create <name> | Anyone with minemail.group.create, up to groups.max-per-player groups. |
/minemail group delete <name> | The group owner. Refused while any linked mailbox holds mail. |
/minemail group add <group> <player> | Owners and managers with minemail.group.manage, up to groups.max-members. |
/minemail group remove <group> <player> | Owners and managers with minemail.group.manage. The owner can't be removed. |
/minemail group promote <group> <player> | Owners and managers with minemail.group.manage. Makes a member a manager. |
/minemail group demote <group> <player> | Owners and managers with minemail.group.manage. Makes a manager a member. |
/minemail group transfer <group> <player> | The group owner. The new owner must already be a member. |
/minemail group list | Anyone. Lists your groups with your role and member count. |
/minemail group info <name> | Group members, and admins. Shows owner, members, roles, and linked mailboxes. |
/minemail group link <group> <mailbox> | Owners and managers with minemail.group.manage, for one of their own mailboxes. |
/minemail group unlink <mailbox> | The owner of the mailbox. |
Command Notes
/minemail create <name>
Starts a creation session. The mailbox isn't created until you left-click a barrel with a stick in your main hand, within mailbox.creation-timeout-seconds (default 60). The name can be several words. It is checked against mailbox.max-name-length, your mailbox limit, and your existing mailbox names (it must be new to you). If economy.mailbox-creation-cost is set, your balance is checked now and the cost is charged when the mailbox is created.
If you're at your limit and extra slots are enabled, MineMail offers to sell you a slot first. You can add a description later from the mailbox's Manage Mailbox menu.
/minemail delete <name>
Deletes a mailbox you own and removes its hologram. It is refused while the mailbox holds any mail, read or unread. Collect or delete the mail first. Admins can override this with -f, and the forced delete is recorded in the transaction log.
/minemail list
A chat listing of the mailboxes you own plus group mailboxes you belong to (tagged [group]). The new-mail count is shown for mailboxes that have some. If extra slots are enabled, it also shows how many you've bought.
Run from the console, it lists every mailbox on the server instead, sorted by owner then name, with the total first. Each line shows the owner, mailbox name, world and coordinates, mail and unread counts, and group. Mailboxes in worlds that aren't loaded are listed too, marked "world not loaded".
/minemail directory / dir
Opens a paginated menu (directory.items-per-page, default and maximum 28) listing every mailbox on the server, sorted by name, with owner, location, group, and description. Clicking a mailbox you have access to opens it. Clicking anyone else's shows a "No Access" screen, so use /minemail send to write to them. Players with minemail.admin get a read-only view instead, as with /minemail inspect.
/minemail send <player> [mailbox]
Opens the compose menu addressed to <player>. If you leave out the mailbox, MineMail uses their only mailbox or asks you to pick one. The recipient can be offline, but must have joined the server before and own at least one mailbox. Anyone can send to any mailbox; no sharing is needed.
/minemail open <mailbox>
Opens one of your own mailboxes, or a group mailbox you belong to, without walking to it. Mailboxes that are only shared with you (view-only) can't be opened this way.
/minemail share <mailbox> <player> / /minemail unshare <mailbox> <player>
Must be run by the mailbox owner. Shared players get view-only access: they can open the mailbox and read mail, but can't collect attachments or currency, delete mail, or mark mail as read. For shared access with collecting, use a group. The player must be online or have joined the server before.
/minemail buyslot
Opens a confirmation showing the price of your next extra mailbox slot: mailbox.extra-slots.price × price-multiplier ^ (slots already bought), up to max-purchasable slots. Purchased slots are added on top of your rank limit.
/minemail receipts
Toggles whether you get read receipts for mail you send. Receipts are on by default, and can be turned off server-wide with mail.read-receipts.enabled.
Group members menu
Owners and managers can also run a group from its members menu: open a mailbox linked to the group, then Manage Mailbox → Manage Group. Clicking a member opens a dialog to make them a manager or member, or remove them from the group. The owner is shown but can't be changed or removed; use /minemail group transfer first.
Tab Completion
- First argument: every player subcommand, plus the admin subcommands for admins.
delete,open,share,unshare: mailboxes you can open, including group mailboxes.send,inspect,log: known mailbox owners, then (forsendandinspect) that player's mailbox names.share,unshare: online players for the player argument.group: group subcommands, then your group names, then online players where a player is expected.