MailboxGUI

MailboxGUI 3.1.0 — Compatibility Update

MailboxGUI 3.1.0 is a major compatibility-focused update that expands MailboxGUI into a broader one-jar build for modern Spigot/Paper servers.

Highlights

• Added one-jar support for Spigot/Paper 1.18.2 through 1.21.11
• Added support for Spigot/Paper 26.1.x
• Removed the old -1.21 version suffix
• Compiled with Java 17 for broader compatibility
• Changed Spigot API baseline to 1.18.2
• Updated plugin API baseline to 1.18
• Improved sign compatibility across supported versions
• Improved sound resolving across supported versions
• Hardened Citizens NPC support for older and newer Citizens builds
• Isolated Dynmap support so missing or incompatible Dynmap builds do not break startup
• Improved Vault/economy hook detection and startup logging
• Added safer multi-world location handling for missing or unloaded worlds
• Fixed package receive/back-out behavior for partially withdrawn packages
• Improved package handling for newer versions such as 1.20.6
• Added a safe language upgrade path from 3.0.0-1.21 → 3.1.0
• Added and reorganized supported language files

Tested Versions

1.18.2
1.19.4
1.20.1
1.20.6
1.21.10
26.1.x

Dynmap Note for 26.1.x

MailboxGUI works on 26.1.x, but Dynmap does not currently have a release build for that version. Dynmap marker support is therefore unsupported on 26.1.x for now. MailboxGUI will still run normally without Dynmap.

Language Updates

• Reorganized language files so all supported languages mirror the same key order
• Added/updated translated language files
• Added support for Dutch
• Added support for Italian
• Added support for Japanese
• Added support for Korean
• Added support for Polish
• Added support for Russian
• Added support for Ukrainian
• Added support for Chinese Traditional
• Improved language upgrader to preserve customized messages during upgrades

Upgrade Notes

Existing data should continue working when upgrading from 3.0.0-1.21 to 3.1.0:

• Existing mailbox data remains compatible
• Existing letters remain compatible
• Existing packages remain compatible
• Existing COD packages remain compatible
• Existing money mail remains compatible
• Existing Post Office boxes remain compatible
• Existing Citizens Post Office NPCs remain compatible
• Dynmap markers refresh from MailboxGUI data
• Language files upgrade safely while preserving customized text

As always, back up your server before updating.