MailboxGUI release

4.2.1 - Barrel Mailbox Support & Maintenance Polish

MailboxGUI 4.2.1 - Barrel Mailbox Support & Maintenance Polish release notes, compatibility details, and official download links.

Release
Version
4.2.1
Published
May 18, 2026

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 updatecheck and /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.

Official downloads

Platform Links

Official platform links are not available for this release yet.