Commands
MineMail's only command is /minemail, with aliases /mail and /mm. With no arguments (or help) it shows a help listing; admins also see admin-only entries.
| Command | Description | Permission |
|---|---|---|
/minemail or /minemail help | Shows help. Admin-only lines (reload, cleanupholograms) only appear for senders with minemail.admin. | none |
/minemail create <name> | Starts creating a mailbox with the given name (multi-word names supported). Prompts you to left-click a barrel with a stick to confirm. | minemail.use |
/minemail delete <name> | Deletes one of your own mailboxes by name. | minemail.use |
/minemail list | Lists your own mailboxes with unread mail counts. | minemail.use |
/minemail directory (alias dir) | Opens the server-wide directory of every public mailbox. | minemail.use |
/minemail send <player> <mailbox> | Opens the named mailbox belonging to <player> so you can compose mail to it. | minemail.use |
/minemail open <mailbox> | Opens one of your own mailboxes by name. | minemail.use |
/minemail share <mailbox> <player> | Grants <player> access to one of your mailboxes. | minemail.mailbox.share |
/minemail unshare <mailbox> <player> | Removes <player>'s access to one of your mailboxes. | minemail.mailbox.share |
/minemail reload | Admin. Reloads config.yml and messages.yml. | minemail.admin |
/minemail cleanupholograms | Admin. Removes and recreates every mailbox hologram. | minemail.admin |
Tab completion suggests your own mailbox names for delete/open/share/unshare, and online player names where a player argument is expected.
Command Notes
/minemail create <name>
Only starts a creation session - the mailbox isn't created until you left-click a barrel with a stick to confirm it. The name can be multiple words. Subject to mailbox.max-name-length, your mailbox.max-per-player cap, and (if configured) the economy.mailbox-creation-cost charge. Mailboxes currently can't be given a description through this command - see Configuration for why.
/minemail delete <name>
Deletes a mailbox you own and removes its hologram. Unlike breaking the barrel in-world, deleting via this command does not check whether the mailbox still has unread mail in it - deleting a mailbox with mail in it here will lose that mail. See Troubleshooting & FAQ.
/minemail list
A plain chat listing of your own mailboxes and their unread counts - useful as a quick check without opening a GUI.
/minemail directory / dir
Opens a paginated GUI (directory.items-per-page, default 45 per page) listing every mailbox on the server, regardless of owner, with owner name, coordinates, and world. Clicking one opens it.
/minemail send <player> <mailbox>
Resolves <player> even if they're offline (via UUID lookup) and opens the target mailbox for you to compose mail into. There's no ownership or access check on sending - anyone can send mail to any mailbox by design.
/minemail open <mailbox>
Opens one of your own mailboxes directly, skipping the directory.
/minemail share <mailbox> <player> / /minemail unshare <mailbox> <player>
Must be run by the mailbox owner. Grants or revokes another player's ability to open and read mail in that mailbox (they still can't delete mail or the mailbox itself). Works for offline players too, since access is tracked by UUID.
/minemail reload
Admin command. Reloads config.yml and messages.yml from disk without restarting the server.
/minemail cleanupholograms
Admin command. Removes every MineMail hologram and recreates one per existing mailbox - use this if holograms are duplicated, missing, or orphaned. See Admin & Maintenance.