MailboxGUI

Letters, Packages, Money Mail, Public Mailbox Access, Admin Tools, and Scheduled Mail 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.

This page describes MailboxGUI Free, designed for single-server use.

Version Support

MailboxGUI Release Support

Features - v6.1.0

GUI Customization

• Customize your GUI experience with gui.yml.
• Customize navigation controls, fillers, recipient icons, mail appearances, and floating new-mail notification items.
• Use built-in materials, CustomModelData, supported modern item models, and optional ItemsAdder items.
• Keep built-in icon fallbacks when a configured appearance is unavailable.
• Let players choose resource-pack appearance preferences with /mb settings resourcepack on|off|auto.

GUI customization is optional. Enable it in configuration to generate and load gui.yml. MailboxGUI does not provide or force a client resource pack.

Player Mail System

• GUI mailbox inbox.
• Paper letters.
• Book letters.
• Standard packages with up to 28 content slots.
• Packages and COD 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.

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.

Text Formatting and Styling

• Keep traditional color and formatting codes such as &6, &a, and &l.
• Use compact HEX colors such as &#4498DB, alongside existing expanded HEX formatting.
• Use supported visual MiniMessage formatting, including HEX colors, gradients, and text styles.
• Customize configurable messages, GUI titles, item names, lore, sender names, notifications, and server branding.
• Apply supported formatting to paper letters, book letters, package messages, and money mail messages.

PlaceholderAPI Integration

• Use optional PlaceholderAPI placeholders for mail counts, inbox capacity, delivery, expiration, registrations, kits, and notification preferences.

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 <letter/package/money>. Choose the type you want to send.

Player Commands

Admin Commands

mailboxgui.admin grants the common admin permissions below. Players also need mailboxgui.player.use; individual tool actions may have additional permissions.

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 for full syntax, permission inheritance, and additional admin commands.

Support

• Discord: Support server
• Wiki: MailboxGUI documentation