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 text messages, item attachments, and (optionally) currency through them. Mail is delivered whether or not the recipient is online, players get notified of unread mail when they log in, and a server-wide directory lets anyone browse and mail every public mailbox.

How it works​

  1. A player places a barrel and runs /minemail create <name>, then confirms it by left-clicking the barrel with a stick.
  2. Right-clicking the barrel opens the mailbox - showing incoming mail with attachments and currency, and letting the owner share access with other players.
  3. Anyone can send mail to any mailbox using /minemail send <player> <mailbox> or by opening a mailbox and hitting Compose Mail.
  4. Data is saved automatically (YAML flatfile) and mailboxes optionally get a floating DecentHolograms name tag and ambient particles.

Key features​

  • Physical mailboxes - any barrel can become a mailbox; breaking it (as the owner) removes it, and mail-containing mailboxes are protected from accidental deletion.
  • Full mail system - subject, message, up to 9 item attachments per mail, and an optional currency attachment via Vault.
  • Offline delivery - mail can be sent to and read by offline players; they're notified of unread mail on their next login.
  • Sharing - mailbox owners can grant other players view/collect access without transferring ownership.
  • Server-wide directory - a paginated GUI listing every public mailbox on the server.
  • Optional economy costs - mailbox creation and mail sending can each carry a configurable Vault cost.
  • Holograms & particles - optional floating name tags (requires DecentHolograms) and ambient particle effects above mailboxes.

Status​

MineMail is under active development. A few things worth knowing before you deploy it:

:::caution Not yet functional Some permissions and config keys exist for planned features that aren't wired up yet:

  • Mail groups (groups.* config, minemail.group.* permissions) - the group manager exists in code but isn't connected to any command.
  • Mail expiration (mail.expiration.*) - the config toggle exists but expiry is not enforced.
  • Per-mailbox custom icons/particles (minemail.mailbox.icon, minemail.mailbox.particles, minemail.sounds permissions) - declared but not checked anywhere; there's no in-game way to set a custom icon or particle per mailbox yet.
  • MySQL/SQLite storage - storage.type only supports YAML today.

See Configuration and Troubleshooting & FAQ for the current state of each. :::

Where to go next​