MailboxGUI 5.0.0 - Network Support Update

MailboxGUI 5.0.0 is a major update adding optional network support for multi-backend servers while keeping normal single-server setups fully supported.

Highlights

• Added optional MailboxGUI Network Mode for Velocity-style / multi-backend setups.
• Added shared MySQL/MariaDB support for network mail data.
• Added Redis-backed network sync for inbox refreshes, paper notifications, admin tools, reloads, and safety locks.
• Added network-aware recipient lookup for player and admin mail.
• Added /mba networkindex to help index old backend playerdata for shared network recipient lookup.
• Added network-aware admin tools for registered player mailboxes and Post Office boxes.
• Added server/world/status display in mailbox management while network mode is enabled.
• Added Remote Server status for mailboxes and PO boxes registered on other backend servers.
• Added network sync for inbox changes, admin inbox edits, mailbox removals, Post Office removals, signs, and paper notifications.
• Added a new /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 warning that network-mode updates must be staged on each backend separately.
• Added support for MailboxGUI-DiscBridge 1.0.0 network notification behavior.
• Completed final 5.0.0 language/config polish.

Network Setup Notes

Network mode is optional. Single-server setups do not need Redis and can continue using normal MailboxGUI features.

Network mode requires:

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

MailboxGUI should be installed on backend servers that use mail. It does not need to be installed on the Velocity proxy itself.

For setup instructions, use the wiki:

https://plugins.imagine-craft.net/mailboxgui/wiki/

Upgrade Notes

Before enabling network mode:

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

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