MailboxGUI 4.0.0

MailboxGUI 4.0.0 is a major backend and polish update focused on safer upgrades, new storage support, cleaner mail lore, better recipient selection, and long-term plugin stability.

Highlights

• Added YAML, SQLite, and MySQL storage support.
• Fresh installs now default to SQLite.
• Existing installs with old YAML data from 3.1.2 or older safely stay on YAML during upgrade.
• Added storage conversion commands for YAML, SQLite, and MySQL.
• Added MySQL connection validation and fallback safety.
• Added safer legacy data migration into the new 4.0.0 data structure.
• Updated old mail upgrade handling so previous letters, packages, COD packages, and money mail stay usable.
• Added one shared startup conversion timestamp for old mail that did not previously have timestamps.

Storage

• Added new storage layout under plugins/MailboxGUI/data/.
• Added SQLite database support for fresh installs.
• Added MySQL support for servers that want an external database.
• Added conversion backups before storage conversions.
• Added config update protection so failed MySQL conversions do not switch the plugin to MySQL.
• Added startup fallback so failed MySQL connections fall back to SQLite instead of breaking the plugin.

Mail & GUI Polish

• Updated lore formatting for letters, packages, COD packages, returned packages, money mail, and admin mail.
• Updated recipient menus to default to Online Players.
• Updated recipient filter order to Online Players -> All Players -> Offline Players.
• Updated Type Player Name so it searches all stored MailboxGUI players.
• Updated typed player search to be case-insensitive.
• Added new chat mail notification options for simple, advanced, or disabled offline summaries.
• Added online delivery notification toggle.

Admin & Config

• Added /mailbox admin convert <YAML|SQLITE|MYSQL> to <YAML|SQLITE|MYSQL>.
• Added /mba convert <YAML|SQLITE|MYSQL> to <YAML|SQLITE|MYSQL>.
• Added /mailbox admin import player <name1>[,<name2>].
• Added /mba import player <name1>[,<name2>].
• Added mailboxgui.admin.convert permission.
• Added mailboxgui.admin.import permission.
• Added money.admin-server-name config option for admin/server money mail.
• Moved sounds.yml to the main MailboxGUI folder.
• Added legacy mailboxsounds/sounds.yml migration.

Languages

• Updated language files to file-version: 5.
• Added and updated language keys for the new 4.0.0 systems.
• Updated non-English language files with translated section comments.
• Kept language files organized to match the English file structure.

Compatibility

• Supports Spigot/Paper 1.18.2 through 1.21.11.
• Supports 26.1.x, 26.1.1, and 26.1.2.
• MailboxGUI is compiled with Java 17 for broad compatibility.
• Use the Java version required by your server jar.

Dynmap Note

Dynmap marker support is not currently supported on 26.1.x / 26.1.1 / 26.1.2 until Dynmap has compatible builds.

MailboxGUI will still run normally without Dynmap on those versions.

Important Upgrade Note

If upgrading from 3.1.2 or older, back up your plugins/MailboxGUI folder before updating.

Legacy YAML data will be detected and migrated automatically. Existing legacy installs will stay on YAML storage until you manually convert to SQLite or MySQL.