MailboxGUI

MailboxGUI 5.0.1 - Backend Access & Offline Admin Sends Update

This Hangar upload includes the major MailboxGUI 5.0.0 Network Support Update plus the follow-up 5.0.1 update.

MailboxGUI 5.0.1

MailboxGUI 5.0.1 is a small follow-up update focused on optional command mailbox access, offline-player admin targeting, and language/config polish.

Added

• Added optional /mailbox open and /mb open command access.
  • Disabled by default.
  • Useful for backend servers, network setups, or servers that want optional command-based mailbox access.
• Added new config option:

mailbox:
  command-open:
    enabled: false

• Added new permission:

mailboxgui.player.open

• Added offlineplayers support for admin send-mail commands.
  • Works alongside allplayers and onlineplayers.
  • Useful for offline rewards, vote rewards, shop deliveries, compensation, event rewards, and scheduled reward systems.

Admin send recipient tags now include:

allplayers
onlineplayers
offlineplayers

Updated

• Updated config version to 11.
• Updated bundled language files to file-version: 12.
• Added language messages for command-open behavior.
• Added help text for /mailbox open when command access is enabled.
• Improved network player index support for offline-player recipient targeting.
• Confirmed MailboxGUI-DiscBridge 1.0.0 remains compatible with MailboxGUI 5.0.1.

Notes

/mailbox open is disabled by default because MailboxGUI is designed around physical mailbox access points, public Post Office boxes, and Post Office NPCs.

Enable it only if you want command-based mailbox access for your server.

MailboxGUI 5.0.0 - Network Support Update

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

Major 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 synchronization for:
  • mail delivery refreshes
  • inbox updates
  • paper notifications
  • admin tools
  • reload broadcasts
  • presence
  • 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 for mailboxes and PO boxes registered on other backend servers.
• Added network sync for:
  • inbox changes
  • admin inbox edits
  • mailbox removals
  • Post Office removals
  • sign refreshes
  • paper notifications
• Added /mailbox unregister GUI with:
  • Selection Mode
  • Manage Personal Mailboxes
• Added player-controlled online mail sound alerts.
• Added website-powered update checks and staged update commands.
• Added network-mode warnings for update commands because each backend must be updated separately.
• Added support for MailboxGUI-DiscBridge 1.0.0 network notification behavior.
• Completed final 5.0.0 language and configuration polish.

Network Mode Notes

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

Network mode requires:

• MySQL/MariaDB shared storage
• Redis
• a unique server-id for each 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.

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

Upgrade Notes

For normal single-server setups:

1. Back up your plugins/MailboxGUI/ folder.
2. Replace the old jar.
3. Start the server.
4. Confirm config/language synchronization completes.
5. Test mailbox access, inbox actions, and admin tools.

For network setups:

1. Back up MailboxGUI data.
2. Keep network.enabled: false.
3. Configure MySQL/MariaDB storage.
4. Start one backend only.
5. Run /mba convert MYSQL.
6. Confirm /mba convert current shows MySQL.
7. Stop the backend.
8. Configure /plugins/MailboxGUI/network/config.yml on every backend.
9. Give every backend a unique server-id.
10. Start one backend and verify startup.
11. Start remaining backends.

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

Compatibility

MailboxGUI remains compatible with normal single-server setups.

Network mode is optional. If you are not running a multi-backend setup, leave network mode disabled and continue using MailboxGUI normally.