MailboxGUI 5.0.1 - CurseForge Changelog

This CurseForge upload includes the major MailboxGUI 5.0.0 Network Support Update plus the follow-up 5.0.1 quality-of-life update.

MailboxGUI 5.0.1

MailboxGUI 5.0.1 is a small follow-up update focused on command access options and admin send-mail recipient targeting.

Added

• Added optional /mailbox open and /mb open support.

  • This is disabled by default.
  • When enabled, players with permission can open the main MailboxGUI menu by command.
  • Useful for backend servers or setups that do not use physical mailbox access points everywhere.

• Added a new config option:

mailbox:
  command-open:
    enabled: false

• Added new permission:

mailboxgui.player.open

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

Supported 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.

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 is 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, inbox refreshes, paper notifications, admin tools, reloads, and 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, signs, and paper notifications.
• 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 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

Network mode is optional and is 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

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

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

Player Improvements

New Unregister GUI

/mailbox unregister now opens a GUI instead of immediately entering physical selection mode.

The GUI includes:

• Selection Mode

  • Right-click a physical mailbox chest/barrel/sign to unregister it.

• Manage Personal Mailboxes

  • View and unregister your own registered mailboxes from a GUI.
  • In network mode, the GUI can show server/world/status.
  • In single-server mode, the server line is hidden.

Online Mail Sound Alerts

Players can control online mail sound alerts with:

/mailbox settings notification soundalert <on|off>

The alert sound itself is configurable in sounds.yml.

Admin Tools Improvements

Admin tools are now network-aware.

In network mode, admin tools can show:

• Server
• World
• Status

Status behavior:

• Same-backend loaded mailbox: Loaded
• Same-backend missing/unloaded mailbox: Unloaded
• Mailbox registered on another backend: Remote Server

Admin removals and inbox edits now synchronize across backend servers so signs, paper notifications, and open admin GUI views update correctly.

Admin Send-Mail Improvements

Admin and console send-mail commands support command-based workflows for rewards, shops, quests, crates, events, and compensation.

Examples of supported use cases:

• Vote rewards
• Shop purchases
• Quest rewards
• Crate rewards
• Event rewards
• Compensation after downtime or rollback
• Daily/login rewards
• Console automation
• Other plugins that run server commands

Admin send-mail commands support:

• Letters
• Packages
• COD packages
• Money mail
• XP packages
• Saved item templates
• Multiple recipients
• Bulk recipient tags
• Custom sender names with --from
• Delayed delivery with --delay

Update System

MailboxGUI includes website-powered update checks and staged update commands.

Useful commands:

/mba updatecheck
/mba update
/mba update confirm

In network mode, the update command only stages the update on the backend where it is run. Admins must stage and restart each backend separately.

Upgrade Notes

Before enabling network mode:

1. Back up your 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 the 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, you can leave network mode disabled and continue using MailboxGUI normally.