⭐ 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, Server Public Mailbox Access, Public Access NPCs, scheduled mail, admin tools, and safe storage options built for long-term server use.
All features listed on this page are specifically for MailboxGUI Free, which is designed for single-server use and does not include network mode.
Version Support
MailboxGUI 5.1.1 and older are no longer supported. Versions 6.0.0 and 6.1.0 include upgrade systems for servers running older versions. If you encounter issues and need support, please update to 6.1.0 first. Back up your MailboxGUI files and database before upgrading.
Features
GUI Customization

• Customize your GUI experience with gui.yml, added in 6.1.0.

Player Mail System

• GUI mailbox inbox.
• Paper letters.
• Book letters.
• Standard packages.
• Packages with messages.
• Money mail through Vault.
• Money mail with messages.
• 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 supports multiple physical mailbox designs, Server Public Mailbox Access, and Public Access NPCs through Citizens. These public access options are ideal for mail rooms, post offices, or other public access points.

• 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.
• Server Public Mailbox Access 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.
• Hanging signs are not used as mailbox registration signs.

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, public mailbox access data, scheduled mail data, queued mail, and registered mailbox locations.
Languages Supported
MailboxGUI includes language files and live GUI localization support.
Supported language files include:

• English
• German
• Spanish
• French
• Italian
• Japanese
• Korean
• Dutch
• Polish
• Brazilian Portuguese
• Russian
• Swedish
• Ukrainian
• Simplified Chinese
• Traditional Chinese
• Hong Kong Traditional Chinese

Command syntax supports localization. Set locale.command-syntax.default in config.yml before the plugin loads to register commands in the selected language's syntax. English commands are always registered, and the help menu displays the selected language's command syntax. Restart the server after changing this setting so the plugin can register the new language's commands.
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.
ItemsAdder
ItemsAdder is optional and can be used for a customized GUI experience.
Vault
Vault is required for:

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

You also need a compatible economy plugin.
Downloads:
Vault: https://www.spigotmc.org/resources/vault.34315/
Economy Plugin (Recommended but any economy plugin that uses vault is fine): https://www.spigotmc.org/resources/xconomy.75669/
DiscBridge / Discord
DiscBridge is the companion plugin for Discord notifications.
DiscBridge requires DiscordSRV.
Downloads:
DiscBridge: https://www.spigotmc.org/resources/...srv-mail-notifications-for-mailboxgui.135557/
DiscordSRV: https://www.spigotmc.org/resources/discordsrv.18494/
Citizens NPC Support
Citizens is optional.
When installed and enabled, MailboxGUI can use Citizens NPCs as Public Access NPCs for mail rooms, post offices, or other public access points.
Dynmap
Dynmap is optional.
MailboxGUI can show mailbox and public mailbox access 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.
Download: https://www.spigotmc.org/resources/dynmap®.274/
Support
Support Discord:
https://discord.gg/kggbGwRt42
Official wiki:
https://plugins.imagine-craft.net/mailboxgui/wiki/
Contributors

• nice — Simplified Chinese and Hong Kong Traditional Chinese translations.
• De4d__ — Brazilian Portuguese translation and MailboxGUI's new icon and color formatting style.

Want to contribute? Join the Discord support server and post in Plugin Discussion. Rismr1 will respond to you. We're always looking for translators!