![MailboxGUI](https://plugins.imagine-craft.net/assets/wiki/Release-Branding/MailboxGUI-Modrinth-Banner.png) MailboxGUI is an advanced mailbox plugin for Minecraft servers. It gives players a GUI-based mail system with letters, packages, money mail, mailbox styles, Server Public Mailbox Access, Public Access NPCs, scheduled mail, admin tools, localization, and storage options built for long-term server use. All features listed on this page are specifically for **MailboxGUI Free**. ## Version Support | Platforms | Minecraft Version | Storage | Languages | | --- | --- | --- | --- | | Paper • Spigot • Purpur • Bukkit | 1.18.2–26.3 | SQLITE (Default) • MYSQL • YAML | English • German • Spanish • French • Italian • Japanese • Korean • Dutch • Polish • Brazilian Portuguese • Russian • Swedish • Ukrainian • Simplified Chinese • Traditional Chinese • Hong Kong Traditional Chinese | ### MailboxGUI Release Support | MailboxGUI Version | Support Status | Upgrade Information | | --- | --- | --- | | 2.1.0–5.1.1 | Unsupported | Upgrade to 6.1.0 if you encounter issues or need support. | | 6.0.0+ | Supported | Includes upgrade systems for older MailboxGUI installations. If you encounter problems, upgrade to 6.1.0. Back up your plugin folder and database before updating. | --- ## Features - v6.1.0 ### GUI Customization - Customize your GUI experience with `gui.yml`. ### 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. ### API Integration Connect other server plugins to MailboxGUI through its public developer API. MailboxGUI Free includes: - Send paper letters, book letters, standard packages, COD packages, and money mail. - Attach messages to packages and money mail, include package XP, and send up to 28 package item stacks. - Configure recipients, sender names, delivery delays, expiration, and notification behavior. - Query, filter, and paginate inboxes, with safe mail claim and deletion operations. - Track deliveries, inspect delayed mail, and cancel queued deliveries. - Create, manage, enable, disable, and run scheduled mail tasks. - Read registered player mailboxes, Public Access Mailboxes, and Public Access NPCs. - Preserve custom item data through package serialization and custom item codecs. - Integrate custom notification providers and listen for mail sending, delivery, claim, deletion, expiration, and registration events. - Report verified resource-pack load status for custom GUI appearances. - Check API capabilities and receive structured operation results. For setup, supported API methods, and integration examples, see the [API Integration Guide](https://plugins.imagine-craft.net/mailboxgui/wiki/6.1.0/api/). ### Mailbox Styles - Personal + Public Access Mailboxes - **Chests and trapped chests** — 1.18.2+. - **Barrels** — 1.18.2+. - **Shulker boxes, including all colors** — 1.18.2+. - **Droppers, dispensers, and ender chests** — 1.18.2+. - **Chiseled bookshelves** — 1.20+. - **Crafters** — 1.21+. - **Copper chests, including oxidized and waxed variants** — 1.21.9+. - **Shelves** — 1.21.9+. Personal and Public Access Mailboxes use the same supported styles. Public Access NPCs are available through Citizens, ideal for mail rooms, post offices, and public access points. Mailbox registration supports regular wall signs and fence bases available on your server version. Hanging signs are not registration signs. Unsupported materials are safely ignored on older versions. ### Scheduled Mail Scheduled Mail lets server owners create automatic mail tasks from config. **Scheduled Mail Supports:** - Send date. - Send time. - Daily, weekly, monthly, and interval-style repeat behavior. - Server or configured timezone. - Expiration. - Catch-up behavior after restart. - Recipient groups such as all players with mailbox data. --- ## Commands and Permissions Player commands require `mailboxgui.player.use`. Additional permissions and settings are listed below; configuration paths refer to `config.yml`. Enabled world restrictions still apply. The mail-sending command is **`/mb send `**. Choose the type you want to send. ### Player Commands | Command | Permission | Requirement / Action | | --- | --- | --- | | `/mb` or `/mb help` | `mailboxgui.player.use` | Show command help. | | `/mb open` | `mailboxgui.player.open` | Enable `mailbox.command-open.enabled`; opens your mailbox. | | `/mb guide` | `mailboxgui.player.use` | Show the mailbox setup guide. | | `/mb register` / `/mb unregister` | `mailboxgui.player.use` | Register or unregister a personal mailbox through selection. | | `/mb check` | `mailboxgui.player.use` | Read-only check; `mailbox.mailbox-check-command.setting` selects GUI or text. | | `/mb track` | `mailboxgui.player.use` | Requires `mailbox.mail-tracking.enabled`; shows queued delayed mail. | | `/mb kit [kitname]` | `mailboxgui.player.kit` | Requires `mailbox.kit.enabled` and an enabled, supported kit; configured claim limits apply. | | `/mb send letter` | `mailboxgui.player.lettercommandsend` | Enable `enabled` and `player-command-send.enabled` under `letter.paper-letter` and/or `letter.book-letter`. | | `/mb send package` | `mailboxgui.player.packagecommandsend` | Requires `package.enabled` and `package.player-command-send.enabled`. | | `/mb send money` | `mailboxgui.player.moneycommandsend` | Requires `money.enabled`, `money.player-command-send.enabled`, Vault, and a compatible economy plugin. | | `/mb settings` | `mailboxgui.player.use` | View player settings and notification options. | | `/mb settings resourcepack ` | `mailboxgui.player.use` | Requires `gui-customization.enabled`; manual preferences are available when `gui-customization.require-automatic-detection` is false. | | `/mb settings discord` | `mailboxgui.player.discord` | Requires DiscBridge Free and DiscordSRV; an administrator must enable DiscBridge player commands after setup checks. | ### Admin Commands `mailboxgui.admin` grants the common admin permissions below. Players also need `mailboxgui.player.use`; individual tool actions may have additional permissions. | Command | Permission | Requirement / Action | | --- | --- | --- | | `/mba` or `/mba help` | Any applicable admin permission | Show the available admin commands. | | `/mba tools` | `mailboxgui.admin` or `mailboxgui.admin.tools.*` | Open Admin Tools; individual actions have their own permissions. | | `/mba reload` | `mailboxgui.admin.reload` | Reload configuration and language files; command-syntax changes require a restart. | | `/mba convert` | `mailboxgui.admin.convert` | Show storage conversion options; back up your files and database first. | | `/mba scheduledmail` | `mailboxgui.admin.scheduledmail` | Manage configured tasks; reload, run, and management actions have separate child permissions. | | `/mba admininbox` | `mailboxgui.admin.admininbox.open` | Open the Shared Admin Inbox; claiming and management actions have separate permissions. | | `/mba updatecheck` | `mailboxgui.admin.update` | Check release information; requires internet access. | | `/mba update` | `mailboxgui.admin.update` | Start the update workflow; requires internet access and a restart to load a staged update. | | `/mba discord` | `mailboxgui.admin.discord` | Requires DiscBridge Free and DiscordSRV; show Discord administration help. | **Localized syntax:** Set `locale.command-syntax.default` before the plugin loads to register the selected language's syntax. English commands are always registered; help displays the selected syntax. Restart after changing this setting. See the [official wiki](https://plugins.imagine-craft.net/mailboxgui/wiki/) for full syntax, permission inheritance, and additional admin commands. ---

Installation

### Basic Setup 1. Download the MailboxGUI Free 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. **GUI customization:** Enable `gui-customization.enabled` and run `/mba reload` to generate/load `gui.yml`. MailboxGUI does not build, send, or force a client resource pack. **Java:** Plugin bytecode requires Java 17 or newer; use the Java runtime required by your Minecraft server version. Folia support is not included. **Version upgrades:** MailboxGUI 5.1.1 and older are no longer supported. Versions 6.0.0 and 6.1.0 include upgrade systems for older installations. Update to 6.1.0 before requesting support for an older release.

Dependencies

The core mailbox system requires no additional plugins. Install optional integrations only for the features you want to use. | Integration | Needed For | Download / Requirement | | --- | --- | --- | | **ItemsAdder** | Optional custom GUI appearances. | [ItemsAdder](https://www.spigotmc.org/resources/73355/) | | **Vault + economy plugin** | Money mail, Vault-money COD packages, and economy payouts. | [Vault](https://www.spigotmc.org/resources/vault.34315/) plus any Vault-compatible economy plugin. [XConomy Reload](https://modrinth.com/plugin/xconomy-reload) is a suggestion. | | **DiscBridge Free** | Optional Discord mail notifications. | [MailboxGUI DiscBridge](https://modrinth.com/plugin/mailboxgui-discbridge); pair DiscBridge 2.1.0 Free with MailboxGUI 6.1.0 Free. | | **DiscordSRV** | Required by DiscBridge for Discord connectivity and account linking. | Download [DiscordSRV on Modrinth](https://modrinth.com/plugin/discordsrv). | | **Citizens** | Optional Public Access NPCs for mail rooms, post offices, or public access points. | [Citizens](https://www.spigotmc.org/resources/citizens.13811/); physical Public Access Mailboxes work without it. | | **Dynmap** | Optional personal and Public Access Mailbox map markers. | [Dynmap](https://modrinth.com/plugin/dynmap); server-version restrictions apply below. | **Dynmap compatibility:** Markers are not supported on Paper/Purpur/Spigot 26.1-26.3. The core mail system still works on those versions; disable or avoid Dynmap markers on those builds.

---

Limited-Time Coupon Offers — Save About 74% on the Premium Bundle + FREE Resource Pack Offer

**Important:** MailboxGUI Premium is available for servers that want network features. If your server does not rely on networking, use **MailboxGUI Free**. MailboxGUI 6.0.0 was never released as a network version. If you choose MailboxGUI Premium and want Discord notifications for a network system, you must use the matching **DiscBridge Premium**. **DiscBridge Free does not work with MailboxGUI Premium.** The optional **MailboxGUI Resource Pack** supports both **MailboxGUI Free and Premium** in one bundle. It is available separately and is not included with the MailboxGUI Free download. MailboxGUI Free can be used without this pack. More information about the separate Premium edition and optional resource pack is available on the [ImagineCraft Plugins website](https://plugins.imagine-craft.net).

Don't need networking? Use MailboxGUI Free and coupon code RESOURCE to get the MailboxGUI Resource Pack for your Free setup — FREE!

Use code LAUNCH to save about 74% on the complete bundle: 50% off MailboxGUI Premium + DiscBridge Premium FREE + Resource Pack FREE.

**Both offers end Nov 1, 2026, 12:00 AM PDT. Both coupon codes expire at that time and cannot be used afterward.** ### Account and Coupon Support If you have trouble creating an account, using your coupon codes, or verifying your email, join the [Support Discord server](https://discord.gg/kggbGwRt42) and ask for help in **🔑︱license-support**.

--- ## Support - **Discord:** [Support server](https://discord.gg/kggbGwRt42) - **Wiki:** [MailboxGUI documentation](https://plugins.imagine-craft.net/mailboxgui/wiki/) - **Resource Information:** [ImagineCraft Plugins](https://plugins.imagine-craft.net) ---

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](https://discord.gg/kggbGwRt42) and post in **Plugin Discussion**. **Rismr1** will respond to you. We're always looking for translators!

MailboxGUI

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details