Rismr1's Plugins

MailboxGUI release

5.0.0 - Network Support Update

Adds optional network mode with MySQL/Redis sync, network-aware admin tools, safer shared mail handling, player mailbox management, update commands, and DiscBridge support

Back to Releases Back to MailboxGUI
Release
Version
5.0.0
Published
May 25, 2026
Minecraft
1.18.2 - 1.21.11 / 26.1.X
Java
Java 17+

Release Notes

MailboxGUI 5.0.0 - Network Support Update

MailboxGUI 5.0.0 is a major network and admin-experience update. This release keeps full single-server support while adding optional multi-backend network mode for servers that run MailboxGUI across multiple backend servers.

Highlights

  • Added optional MailboxGUI Network Mode for multi-backend server setups.
  • Added shared MySQL/MariaDB support for network mail data.
  • Added Redis-backed network sync, presence, refresh events, and mail safety locks.
  • Added network-aware recipient lookup for player and admin mail.
  • Added /mba networkindex for indexing backend playerdata into shared network lookup.
  • Added network-aware admin tools for registered player mailboxes and Post Office boxes.
  • Added server/world/status display for mailbox management while network mode is enabled.
  • Added remote-server status handling so mailboxes on other backends no longer appear as broken local mailboxes.
  • Added network sync for inbox changes, paper notifications, admin inbox tools, mailbox removals, PO box removals, and reloads.
  • Added /mailbox unregister GUI with Selection Mode and Manage Personal Mailboxes.
  • Added player-controlled online mail sound alerts.
  • Added website-powered update checks and staged update commands.
  • Added network-mode warning for update commands because each backend must be updated separately.
  • Added improved language/config synchronization and final 5.0.0 language polish.

Network Mode

Network mode is optional and is only needed for multi-backend setups.

When enabled, MailboxGUI requires:

  • MySQL/MariaDB shared storage
  • Redis
  • a unique server-id for each backend
  • the same MailboxGUI version on every backend

Single-server setups do not need Redis and can continue using normal YAML, SQLite, or MySQL storage.

Admin Tools Improvements

Admin tools now understand network ownership for physical mailboxes and Post Office boxes.

In network mode, admin tools can show:

  • server
  • world
  • physical status
  • remote-server status

Removing registered mailboxes or Post Office boxes now broadcasts network cleanup events so other backends can refresh signs, inbox state, paper notifications, and open admin GUI views.

Player Improvements

Players now have a better unregister flow.

/mailbox unregister opens a menu with:

  • Selection Mode
  • Manage Personal Mailboxes

The new personal mailbox management GUI lets players unregister their own mailboxes without walking to the physical mailbox. In network mode, it also shows server/world/status information.

Players can also control online mail sound alerts:

/mailbox settings notification soundalert <on|off>

The sound itself is configured in sounds.yml.

Update System

MailboxGUI now supports website-powered update checks and staged update downloads.

Useful commands:

/mba updatecheck
/mba update
/mba update confirm

When network mode is enabled, the update command warns admins that it only stages the update on the current backend. Admins must update and restart each backend individually.

Network Recipient Lookup

MailboxGUI 5.0.0 improves typed recipient lookup in network mode.

Use:

/mba networkindex

on backend servers that have older local playerdata. This helps shared network lookup find legacy players who may not have logged in since MailboxGUI network mode was installed.

MailboxGUI-DiscBridge Support

MailboxGUI 5.0.0 includes the network event and API foundation needed for MailboxGUI-DiscBridge 1.0.0.

For network Discord notifications:

  • Install MailboxGUI on every backend that uses mail.
  • Install DiscordSRV and MailboxGUI-DiscBridge on only one backend.
  • Set DiscBridge to NETWORK_NODE on that backend.
  • DiscBridge listens for MailboxGUI network notification events and sends Discord messages through the one local DiscordSRV instance.

Upgrade Notes

Before enabling network mode:

1. Back up your MailboxGUI data.
2. Keep network mode disabled.
3. Configure MySQL/MariaDB storage.
4. Convert storage to MySQL with /mba convert MYSQL.
5. Confirm /mba convert current shows MySQL.
6. Configure network/config.yml on each backend.
7. Start one backend first, then the rest.

Storage conversion is disabled while network mode is active to protect shared mail data.

Compatibility

MailboxGUI remains compatible with single-server setups. Network mode is optional.

The plugin continues to support Spigot, Paper, and Purpur servers across the supported MailboxGUI version range.