MailboxGUI

# 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 4.0.0 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. ### Storage Conversion Command ```text /mailbox admin convert to /mba convert to ``` ## Mail & GUI Polish - Updated lore formatting for letters, packages, COD packages, returned packages, money mail, and admin mail. - Updated Send Mail GUI polish. - 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 import player [,]`. - Added `/mba import player [,]`. - 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. Mailboxes, inboxes, packages, letters, money mail, Post Office boxes, NPC access, storage, and admin tools can still function normally without Dynmap markers. ## Important Upgrade Note If you are 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.