Skip to main content

MineMail

A fully immersive postal system for your Minecraft server.

MineMail lets players build real, physical mailboxes out of barrels, then send each other letters, item attachments, and (optionally) currency through them. Mail is delivered whether or not the recipient is online, players are notified of new mail when they log in, and a server-wide directory lists every mailbox on the server.

How it works​

  1. A player places a barrel, runs /minemail create <name>, then left-clicks the barrel with a stick to confirm.
  2. Right-clicking the barrel opens the mailbox, showing incoming mail (newest first) with its attachments and currency.
  3. Anyone can send mail to a player with /minemail send <player>. Letters are written in a compose menu, with Paper dialogs for the recipient, subject, message, and currency amount.
  4. Data is saved to YAML files within a couple of seconds of every change. Mailboxes get a floating name tag (with an unread count) and ambient particles.

Key features​

  • Physical mailboxes: any barrel can become a mailbox. A mailbox that still holds mail can't be broken or deleted, and mailbox barrels are protected from explosions, pistons, and hoppers.
  • Full mail system: subject, message, up to 9 item attachments per mail, and an optional currency attachment via Vault. Letters can be replied to or forwarded.
  • Sort, filter, and search: sort a mailbox by date, unread, sender, or subject, filter it to unread, read, has items or money, or returned mail, and search subject, sender, and message text.
  • Offline delivery: mail can be sent to players who are offline. Anything that couldn't be handed over (returned mail, currency, read receipts) is delivered when they next join.
  • Read receipts: senders are told when their mail is first read. Players can opt out with /minemail receipts.
  • Sharing and groups: owners can give other players view-only access, or link a mailbox to a group whose members can collect mail and whose managers can run the mailbox.
  • Mail expiration: optional. Expired mail is returned to the sender with its items and currency, never deleted.
  • Rank limits and extra slots: mailbox count and mailbox capacity can be set per rank with permission nodes, and players can optionally buy extra mailbox slots.
  • Bedrock support: with Floodgate installed, Bedrock players get native forms for every dialog; Java players get Paper dialogs.
  • Holograms and particles: built-in floating name tags (no hologram plugin needed), toggleable per mailbox, and per-mailbox particle choices that can be unlocked by permission.
  • Transaction log and recovery: every delivery, collection, and deletion is logged. Admins can view a player's history and restore returned or deleted contents.
  • Mailbox tours: RallyPoint can load every mailbox as a tour with /rally tour load minemail.

Status​

MineMail 1.2.0 is available from the releases page. Known limitations in this release:

Known limitations
  • Composing from the directory: players can't compose to a mailbox they have no access to from the directory. Use /minemail send <player> instead.
  • Custom mailbox icons: the minemail.mailbox.icon permission is declared but never checked, and there's no in-game way to set an icon.
  • minemail.sounds: declared but never checked. Sounds always play.
  • MySQL/SQLite storage: storage.type is not read. Only YAML storage exists.

Where to go next​