MailboxGUI | Letters, Packages, Money Mail & Mailbox GUIs

MailboxGUI is an advanced mailbox plugin for Minecraft servers. It gives players a polished GUI mail system with letters, packages, money mail, Cash-on-Delivery packages, mailbox styles, Post Office support, scheduled mail, admin tools, and safe storage options built for long-term server use.
MailboxGUI 6.0.0 is a major single-server rewrite focused on cleaner menus, stronger data safety, better configuration, improved admin workflows, and a smoother player experience.
Important Network Notice
MailboxGUI 6.0.0 does not include network mode.
If your server currently depends on the older network system, use MailboxGUI versions 5.0.0 through 5.1.1.

• 6.0.0 is designed for single-server use.
• 6.0.0 does not generate or use network configuration.
• Back up your full plugins/MailboxGUI folder before updating.
• Back up your database before updating if you use SQLite or MySQL/MariaDB.

Features
Player Mail System

• GUI mailbox inbox.
• Paper letters.
• Book letters.
• Standard packages.
• Money mail through Vault.
• Cash-on-Delivery packages.
• COD support for Vault money, item currency, XP, and item templates.
• Delayed mail delivery.
• Mail expiration.
• Mail tracking with /mb track.
• Read-only mailbox checking with /mb check.
• New mail notifications.
• Configurable mailbox kit command with /mb kit.
• Player notification settings.

Admin Tools

• Admin Tools GUI.
• Shared Admin Inbox.
• Check Player Inbox.
• Clear player mailbox data with confirmation.
• Admin mail sending tools.
• Admin package creation.
• Admin COD package creation.
• Scheduled mail management.
• Mail purge and cleanup tools.
• Storage conversion tools.
• Debug test commands when enabled in config.

Mailbox Styles
MailboxGUI 6.0.0 supports multiple physical mailbox designs.

• Chest and trapped chest mailboxes: available on all MailboxGUI-supported Minecraft versions.
• Barrel mailboxes: available on all MailboxGUI-supported Minecraft versions.
• Shulker box mailboxes, including all shulker box colors: available on all MailboxGUI-supported Minecraft versions.
• Utility block mailboxes using droppers, dispensers, and ender chests: available on all MailboxGUI-supported Minecraft versions.
• Chiseled bookshelf mailboxes: require Minecraft 1.20 or newer.
• Crafter mailboxes: require Minecraft 1.21 or newer.
• Copper chest mailboxes, including oxidized and waxed copper chest variants: require Minecraft 1.21.9 or newer.
• Shelf-style mailboxes: require Minecraft 1.21.9 or newer.
• Post Office boxes can use the same supported physical mailbox styles as normal mailboxes.
• Regular wall signs are supported for mailbox signs when that sign material exists on the server version.
• Fence post bases support all fence materials available on the server version.

Mailbox styles are version-aware, so unsupported Minecraft materials are safely ignored on older server versions.
Scheduled Mail
Scheduled Mail lets server owners create automatic mail tasks from config.

• Paper letters.
• Book letters.
• Packages.
• COD packages.
• Money mail.
• Send date and send time support.
• Daily, weekly, monthly, and interval-style repeat behavior.
• Server or configured timezone support.
• Expiration support.
• Catch-up behavior after restart.
• Recipient groups such as all players with mailbox data.

Storage Compatibility
MailboxGUI supports:

• SQLite.
• YAML.
• MySQL/MariaDB.

New installs default to SQLite.
Storage conversion is available through admin commands, and upgrade handling is designed to preserve existing mailbox data, Post Office data, scheduled mail data, queued mail, and registered mailbox locations.
Commands and Permissions
Common Player Commands

• /mb
• /mb open
• /mb check
• /mb track
• /mb kit
• /mb letter
• /mb package
• /mb money
• /mb settings

Common Admin Commands

• /mba
• /mba tools
• /mba reload
• /mba convert
• /mba scheduledmail
• /mba updatecheck
• /mba update

MailboxGUI has a detailed permission system for player commands, admin tools, mail sending, Shared Admin Inbox actions, world access, update notifications, and debug commands.
For the full command and permission list, use the wiki:
https://plugins.imagine-craft.net/mailboxgui/wiki/
Installation
Basic Setup

1. Download the correct MailboxGUI jar.
2. Place the jar in your server's plugins folder.
3. Start the server once to generate files.
4. Stop the server.
5. Review and configure plugins/MailboxGUI/config.yml.
6. Start the server again.
7. Use /mb guide in game to learn how to build and register mailboxes.

For upgrades, always back up the full plugins/MailboxGUI folder and your database before updating.
Dependencies
MailboxGUI can run without most optional hooks, but some features require extra plugins.
Vault
Vault is required for:

• Money mail.
• Vault-money COD packages.
• Economy payouts.

You also need a compatible economy plugin.
DiscBridge / Discord
DiscBridge is the companion plugin for Discord notifications.
Important: DiscBridge 2.0.0 is still under development and will be updated once testing is completed.
DiscBridge may also require DiscordSRV depending on your setup.
Citizens NPC Support
Citizens is optional.
When installed and enabled, MailboxGUI can use Citizens NPCs for Post Office access.
Dynmap
Dynmap is optional.
MailboxGUI can show mailbox and Post Office markers on supported server/Dynmap combinations.
Important Dynmap note: Dynmap markers are not supported on Paper/Purpur 26.1.x or 26.2.x. The core MailboxGUI mail system still works on those server versions, but Dynmap marker support should be disabled or avoided on those builds.
Support
Support Discord:
https://discord.gg/kggbGwRt42
Official wiki:
https://plugins.imagine-craft.net/mailboxgui/wiki/
Resource information:
https://plugins.imagine-craft.net