Release Notes
MailboxGUI 4.2.1 - Barrel Mailbox Support & Maintenance Polish
MailboxGUI 4.2.1 is a focused maintenance update that adds barrel mailbox support, improves language upgrade handling for older 4.x installs, adds new Notification API helpers, and improves the admin update-check workflow.
Highlights
- Added barrel support for player mailboxes.
- Added barrel support for public Post Office boxes.
- Player mailboxes can now use a single chest or barrel on top of the fence post.
- Post Office boxes can now use a single chest or barrel as the public access container.
- Signs must be attached to the front face of the chest or barrel.
- Existing chest mailbox setups continue working normally.
- Paper new-mail notifications work with player barrel mailboxes.
- Added Notification API helpers for future integrations and addon modules.
- Added
/mailbox admin updatecheckand/mba updatecheck. - Improved update-check output with clearer version status and the official MailboxGUI download link.
- Improved language upgrade handling for older 4.x installs so old default text can update while customized language text stays protected.
Barrel Support
MailboxGUI now supports barrels as valid mailbox containers.
Player mailbox setup now supports:
Fence Post
Single Chest OR Barrel placed on top
Sign attached to the front face of the chest/barrel
Public Post Office boxes now support:
Single Chest OR Barrel
Sign attached to the front face of the chest/barrel
Post Office boxes remain public access points and are not registered to one specific player.
Notification API
MailboxGUI 4.2.1 adds new Notification API helpers for future bridge modules and plugin integrations.
New support includes:
- Checking unchecked mail count.
- Checking pending login notification count.
- Checking whether a player has a pending mail notification.
- Refreshing a player’s physical mailbox notification.
- Clearing a player’s mail notification state.
Update Checker Improvements
Admins can now manually check for updates with:
/mailbox admin updatecheck
/mba updatecheck
The update checker still uses the Spigot update source for version checks and displays the official MailboxGUI download page:
https://plugins.imagine-craft.net/mailboxgui/download/
Language Upgrade Repair
MailboxGUI 4.2.1 improves language upgrade handling for older 4.x installs.
This helps older servers receive updated default text for:
- Chest/barrel mailbox setup wording.
- Admin command/help wording.
- Typed-recipient wording.
- Newer feature guidance.
Customized language text is preserved where possible.
Upgrade Notes
- No mailbox data conversion is required.
- Existing chest mailboxes continue working.
- Existing Post Office boxes continue working.
- Existing language customizations are preserved where possible.
- Servers upgrading from older 4.x versions receive safer language text updates.