MailboxGUI release

5.0.1 - Added /mb open and new Offlineplayers tag

Adds optional /mb open command access and offlineplayers admin-send targeting for offline users. DiscBridge does not need to be updated; version 1.0.0 works with MailboxGUI 5.0.1.

Release
Version
5.0.1
Published
May 27, 2026
Minecraft
1.18.2 - 1.21.11 / 26.1.X
Java
Java 17+

Release Notes

MailboxGUI 5.0.1 - Backend Access & Offline Player Admin Sends

MailboxGUI 5.0.1 is a small feature update focused on network/backend server access and improved admin mail targeting.

New: /mailbox open / /mb open

A new optional command-based mailbox access feature has been added:

/mailbox open
/mb open

When enabled, players can open the main MailboxGUI menu directly from a command. This is useful for backend servers, Velocity network setups, or servers where players may not have direct access to physical mailboxes, Post Office boxes, or Post Office NPCs.

This feature is disabled by default.

mailbox:
  command-open:
    enabled: false

New permission:

mailboxgui.player.open

Players also need the normal base permission:

mailboxgui.player.use

New: offlineplayers Admin Recipient Tag

Admin send commands now support the new offlineplayers recipient tag.

Supported commands:

/mba sl offlineplayers 'Welcome to the server' --from ExampleServer --delay 10
/mba sp offlineplayers ...
/mba scod offlineplayers ...
/mba sm offlineplayers ...

This allows admins to send mail to all known offline players without sending to players who are currently online.

Recipient tags now include:

allplayers
onlineplayers
offlineplayers

The new tag also works with MailboxGUI network-aware player tracking where available.

Language Update

Language files have been updated to:

file-version: 12

New translated messages were added for the command mailbox access feature and related help menu text.

DiscBridge Compatibility

MailboxGUI-DiscBridge does not need to be updated for this release.

MailboxGUI-DiscBridge 1.0.0 works with MailboxGUI 5.0.1.

The new /mb open command does not affect DiscBridge, and the new offlineplayers admin recipient tag still uses the existing MailboxGUI delivery events that DiscBridge already supports.

Updating

You can update manually by replacing your current MailboxGUI jar with MailboxGUI 5.0.1 and restarting the server.

You can also update from the server using the built-in update command:

/mba update

If an update is available, confirm it with:

/mba update confirm

Then restart the server to complete the update.

The update command downloads and stages the new jar for the next restart. It does not live-reload the plugin.

Velocity / Network Setup Note

If you run MailboxGUI on multiple backend servers, run the update command on each backend server that has MailboxGUI installed:

/mba update
/mba update confirm

Then restart each backend server so the whole network is updated.

Notes

  • /mb open is disabled by default.
  • offlineplayers is intended for admin send commands.
  • DiscBridge users can stay on MailboxGUI-DiscBridge 1.0.0.