ImagineCraft Plugins

MailboxGUI release

Major Mailbox Rewrite

Major mailbox rewrite: new inbox, mailbox styles, kits, scheduled mail, storage upgrades, and admin tools. DO NOT UPDATE IF YOU USE NETWORK on 5.0.0-5.1.1; stay on your current build.

Download Version 6.0.0 Back to Older Builds Back to MailboxGUI
Free Beta
Version
6.0.0
Published
August 16, 2026
Minecraft
1.18.2 - 1.21.11 / 26.1.X - 26.2.X
Java
Java 17+

Release Notes

Release Notes

MailboxGUI 6.0.0 is a major update focused on improving the single-server mailbox experience with cleaner GUIs, safer storage handling, better admin tools, new mailbox styles, scheduled mail, mailbox kits, and stronger upgrade protection.

Important Network Warning

Do not update to MailboxGUI 6.0.0 if you are using network mode on MailboxGUI 5.0.0 through 5.1.1.

MailboxGUI 6.0.0 does not include the older free network mode. If your server depends on the 5.0.0 through 5.1.1 network system, stay on your current version until a supported network release is available.

Before updating any server, make a full backup of:

  • plugins/MailboxGUI
  • your SQLite database, if used
  • your MySQL/MariaDB database, if used

Main Highlights

  • Redesigned mailbox inbox experience.
  • Added multiple physical mailbox styles.
  • Added /mb kit for starter mailbox supplies.
  • Added /mb check for read-only mailbox checking.
  • Added /mb track for delayed mail tracking.
  • Added Scheduled Mail for automatic letters, packages, COD packages, and money mail.
  • Added Post Office per-player new mail notifications.
  • Added stronger storage support for SQLite, YAML, and MySQL/MariaDB.
  • Added safer upgrade handling for mailbox data, Post Office data, queued mail, scheduled mail, and registered mailbox locations.
  • Added expanded admin tools and Shared Admin Inbox improvements.
  • Added improved localization and live GUI translation.
  • Added more configurable permissions for player commands, admin tools, world access, update notifications, and debug commands.

Player Mail Improvements

  • Improved GUI inbox layout and bottom-row navigation.
  • Improved mail filtering by date, type, expiration, and admin mail.
  • Removed the redundant New Mail filter.
  • Improved live inbox updating while the player has their mailbox open.
  • Normal new mail notifications can now still show while the inbox is open.
  • Improved paper letter, book letter, package, money mail, and COD handling.
  • Improved mail expiration display and notification text.
  • Added delayed mail tracking with /mb track.
  • Added read-only mailbox checking with /mb check.
  • Added better player command sending controls for letters, packages, and money mail.

Mailbox Styles and Kits

MailboxGUI now supports multiple mailbox build styles with version-aware material checks.

Supported styles include:

  • chest and trapped chest mailboxes
  • barrel mailboxes
  • shulker box mailboxes
  • utility block mailboxes using droppers, dispensers, and ender chests
  • chiseled bookshelf mailboxes on supported versions
  • crafter mailboxes on supported versions
  • copper chest mailboxes on supported versions
  • shelf-style mailboxes on supported versions
  • Post Office boxes using supported mailbox styles

/mb kit can now give players starter mailbox supplies. Kits can be configured, limited by usage count, hidden when unsupported on the server version, and shown in player-facing output with translated item names.

Scheduled Mail

Scheduled Mail allows server owners to create automatic mail tasks from config.

Scheduled Mail supports:

  • paper letters
  • book letters
  • packages
  • COD packages
  • money mail
  • send date and send time
  • daily, weekly, monthly, and interval-style repeats
  • expiration
  • catch-up behavior after restart
  • recipient groups such as all players with mailbox data

Admin Tools

  • Improved Admin Tools GUI.
  • Improved Shared Admin Inbox.
  • Improved Check Player Inbox.
  • Added stronger confirmation flows for destructive admin actions.
  • Improved admin package and COD package management.
  • Improved admin mail sending with delay and expiration support.
  • Added better support for quoted multi-word sender names in admin send commands.
  • Improved hidden debug/test commands when enabled in config.
  • Improved admin help menu formatting and permission visibility.

Storage and Upgrade Safety

  • New installs default to SQLite.
  • YAML storage folders are only created when YAML storage is active.
  • Scheduled mail data now supports YAML, SQLite, and MySQL/MariaDB storage.
  • Improved data upgrade handling from older versions.
  • Improved protection against invalid or stale item data.
  • Improved handling for saved mailbox and Post Office locations.
  • Improved repair behavior for registered mailboxes after restarts or upgrades.
  • Reduced unnecessary migration console logging.

Notifications and Visual Indicators

  • Improved player new mail notifications.
  • Improved paper notification lifecycle for expired mail.
  • Added per-player paper-style notifications for Post Office boxes.
  • Improved notification batching to reduce message and sound spam.
  • Improved notification behavior when mail arrives while a mailbox GUI is open.

Compatibility

  • Supports Spigot, Paper, and Purpur 1.18.2+.
  • Vault is required for money mail and Vault-money COD features.
  • Citizens support is optional for Post Office NPC access.
  • Dynmap support is optional for supported server/Dynmap combinations.
  • Dynmap markers are not supported on Paper/Purpur 26.1.x or 26.2.x.

Upgrade Notes

  • Back up your full plugins/MailboxGUI folder before updating.
  • Back up your database before updating if using SQLite or MySQL/MariaDB.
  • Review the regenerated config after updating.
  • Delete old language files and let 6.0.0 regenerate them if upgrading from 5.1.1 or older.
  • Use /mba reload after config changes where supported, or restart the server for larger setup changes.

Full setup help and command information is available on the wiki:

https://plugins.imagine-craft.net/mailboxgui/wiki/