Richer Mail, Custom GUIs & Expanded Localization

What's New

This update expands mail customization, package capacity, localization, and integration support while improving storage, delivery, and upgrade reliability.

Package And Money Messages

• Attach optional messages to standard packages, COD packages, and money mail through player composition, Admin Tools, supported commands, scheduled mail, and the API.
• Messages remain attached when COD packages are accepted or returned.
• Inbox lore displays a localized Message heading, with dividers separating mail information, the message, and click actions.
• Added --message "message" support, validation, help, and tab completion to applicable sending commands.
• Expanded packages to 28 content slots, arranged as four rows of seven inside a six-row GUI. Removed the obsolete package.size-in-rows setting.

Colors And Letter Customization

• Added compact HEX colors such as &#4498DB and visual MiniMessage formatting, including gradients, decorations, and rainbow text. Existing & formatting remains supported.
• Added /n for manual line breaks and //n for a literal /n.
• Paper letters and package/money messages support 256 visible characters and up to 17 rendered lines, including automatic wrapping and manual breaks.
• Paper and book letters now have separate player sending, command, world restriction, admin sending, sender-name, and delivery-delay settings.
• Disabling a letter type for players does not disable administrator, scheduled, or API sending, or access to existing letters.
• Added a customizable, localized book information page with sender, date, title, expiration, and navigation controls.

Custom GUI And Resource-Pack Support

• Added optional gui.yml customization for navigation, fillers, recipient icons, mail appearances, and floating new-mail notification items.
• Shared controls use consistent settings across menus. Packages and money mail support applicable message and expiration variants; letters use base and expiration appearances.
• Supports materials, CustomModelData, supported modern item models, tooltip styles, and optional ItemsAdder custom items.
• Added /mb settings resourcepack on|off|auto. Automatic mode uses server-pack load confirmation; manually installed client packs can use on.
• Added optional automatic-only detection and a public resource-pack status API for external pack providers.
• Built-in icons remain available when automatic detection has not confirmed a loaded pack. MailboxGUI does not send a resource pack.
• gui.yml is generated only when customization is enabled. /mba reload generates or reloads it.

Languages, Commands And Settings

• Added Brazilian Portuguese, bringing support to 16 locales, with country-aware date/time formatting.
• Expanded translations for GUI text, mail information, filters, click actions, notifications, help, and errors.
• Added localized command roots, subcommands, abbreviations, help, and tab completion while retaining English commands.
• Command syntax has separate locale controls. Localized roots register at startup; changing the default root language requires a restart.
• Consolidated player sending under /mb send <letter|package|money>. Help lists only available sending types.
• Reorganized settings help and added /mb settings notification status. Resource-pack and Discord instructions stay within their respective settings sections.

Public Access And Inbox Management

• Renamed Post Office Mailboxes/NPCs to Public Access Mailboxes/NPCs across configuration, interfaces, messages, and Dynmap integration.
• Migrates existing settings and %postofficename% formats to %publicmailboxname%, preserving customized values.
• Public mailbox unregistering now uses Shift-Right-Click; removing the final entry returns to registration.
• Added an administrator Shift-Right-Click package deletion action in player inbox management.
• Improved live inbox refreshes, package session handling, older-server mail recognition, and book-reading mailbox animations.

Delivery, Storage And Upgrade Safety

• Delayed mail uses absolute delivery deadlines rather than tick-counted countdowns. Existing queued deadlines retain their remaining wait.
• Scheduled packages and money mail support messages, formatting, and explicit delivery-delay overrides. Schedule reload does not trigger restart catch-up.
• Data version 7 upgrades supported older mail and packages while preserving contents and registrations.
• Improved custom-item metadata preservation for packages, API sends, and item templates; fixed phantom template entries caused by modern serialization metadata.
• Fixed configuration reloads overwriting saved edits and improved storage conversion, revision handling, validation, and shutdown safety.
• Verified Citizens NPC identities are excluded from player imports; mistakenly imported records receive guarded, backed-up cleanup.
• Expanded /mba clean coverage for upgrade backups while protecting active data, migration markers, incomplete snapshots, and backups still required by upgrade journals.

APIs, Placeholders And Companion Integration

• Expanded the public API with inbox queries, revision-aware mutations, mail lifecycle events, scheduling, registry snapshots, custom item codecs, notification providers, and formatting helpers.
• Added PlaceholderAPI values for unchecked mail, mail types/value, capacity, pending delivery, expiration, registrations, kits, and notification preferences.
• DiscBridge commands integrate under /mb settings discord and /mba discord, with compatibility checks and conditional help visibility.
• Use DiscBridge 2.1.0 Free with this release when Discord notifications are required.

Updates And Compatibility

• /mba updatecheck reports newer release, beta, and alpha builds; /mba update continues to follow the configured release channel.
• Updated compatibility handling for Spigot, Paper, and Purpur 1.18.2–1.21.11 and 26.1–26.3.
• Consolidated unsupported item-template warnings into a single count.

Before Updating

Back up your plugin folder and database. Keep your existing configuration, language files, and data so the upgrader can preserve customizations. Verify mail, registrations, templates, and scheduled tasks after updating. Install the final release JAR, not an original-* build artifact.