MailboxGUI

MailboxGUI 4.1.0

MailboxGUI 4.1.0 is the API and command integration update. This release adds new tools for plugin integrations, console automation, system shops, item templates, persistent delayed delivery, and PlaceholderAPI support.

Highlights

• Added public MailboxGUI API for plugin integrations.
• Added new admin/console sending commands:
  • /mba sl
  • /mba sp
  • /mba scod
  • /mba sm
• Added item templates for command-based package sending.
• Added PlaceholderAPI support with %mailboxgui_*% placeholders.
• Added persistent delayed mail that survives server restarts.
• Added delayed mail support for YAML, SQLite, and MySQL.
• Added delayed mail preservation during /mba convert.
• Added typed-recipient auto-import from server playerdata.
• Added COD return-recipient support with /mba scod r:<player>.
• Cleaned up help menus and language files.

API & Plugin Integration

MailboxGUI now includes a public API that lets other plugins send:

• Letters
• Regular packages
• Cash-On-Delivery packages
• Money mail

The API supports multiple recipients, custom sender names, delayed delivery, full ItemStack package contents, and optional COD payment return behavior.

Full API documentation will be available on the MailboxGUI wiki.

New Admin / Console Sending Commands

These commands are useful for admins, console automation, and other plugins that run commands.

/mba sl <recipients> [from] '<message>'
/mba sp <recipients> [from] <item:amount...>
/mba scod <recipients> [from] <codPrice> [r:<returnPlayer>] <item:amount...>
/mba sm <recipients> [from] <amount>

Item Templates

Item templates allow admins to save real items and send them through package commands.

/mba itemtemplate save <id>
/mba itemtemplate list
/mba itemtemplate delete <id>
/mba itemtemplate give <id> [player]

Templates preserve item metadata such as enchantments, written books, lore, custom names, CustomModelData, and custom plugin data.

Example:

/mba sp Rismr1 template:starter_sword:1
/mba scod Rismr1 ServerShop 1000 r:Seller template:rare_pickaxe:1

Persistent Delayed Mail

Delayed mail now survives server shutdowns and restarts.

This applies to:

• Player letters
• Player packages
• API-created mail
• Command-created mail
• Admin/console delayed mail

Delayed mail uses the active storage backend:

• YAML
• SQLite
• MySQL

Queued delayed mail is also preserved during /mba convert.

PlaceholderAPI

MailboxGUI now supports PlaceholderAPI when PlaceholderAPI is installed.

Example placeholders:

%mailboxgui_has_mailbox%
%mailboxgui_inbox_total%
%mailboxgui_pending_total%
%mailboxgui_storage_type%
%mailboxgui_delayed_mail_queued%

MailboxGUI still works normally without PlaceholderAPI.

Fixes & Improvements

• Fixed admin/API COD package accept behavior.
• Improved COD return handling for command and API packages.
• Improved declined COD package return behavior when a return recipient is provided.
• Improved package size validation for API and command-created packages.
• Improved typed-recipient handling for player and admin send flows.
• Improved admin multi-recipient validation.
• Improved help menu organization and paging.
• Updated language files for 4.1.0.

Upgrade Notes

Existing 4.0.2 mail data remains compatible with 4.1.0.

No mailbox reset is required.