MailboxGUI 3.1.0

Initial Hangar release for MailboxGUI.

MailboxGUI is an advanced GUI-based mail system for Spigot/Paper servers. Players and admins can send letters, packages, COD packages, package experience, and money mail through physical mailboxes, public Post Office boxes, and optional Post Office NPCs.

Highlights

• Initial Hangar release
• One-jar compatibility for modern Spigot/Paper servers
• Supports Spigot/Paper 1.18.2 through 1.21.11
• Supports Spigot/Paper 26.1.x
• Physical player mailbox system
• Public Post Office Boxes
• Optional Citizens Post Office NPC support
• Optional Dynmap marker support
• Letters, packages, COD packages, package experience, and money mail
• Powerful Admin Tools GUI
• Offline and online mail notifications
• Auto-organized player inboxes
• Multi-world mailbox location safety
• Safe language file upgrade system
• Pre-upgrade backup system

New / Major Features

Post Office Boxes

• Added public Post Office Boxes as shared mailbox access points.
• Players can open their mailbox from registered PO Boxes.
• Admins can register, remove, and view PO Boxes from the Admin Tools GUI.
• PO Boxes automatically number and renumber when removed.
• Works without Citizens.

Package Experience

• Players can add experience directly into packages.
• Experience appears as a Bottle o' Enchanting inside the package.
• XP takes up a real package slot.
• Receivers can right-click or shift-left-click to deposit XP.
• Admin packages can include experience without using the admin's own XP.

Dynmap Support

• Added optional Dynmap markers for:
  • Player mailboxes
  • Post Office Boxes
  • Post Office NPCs
• Marker layer: Mailboxes/PO Boxes/NPC
• Dynmap is optional. MailboxGUI runs normally without it.

Note: Dynmap marker support is currently unsupported on 26.1.x until Dynmap releases a compatible build for that version.

Admin Tools

• Added Post Office Registration tools.
• Added server-side mail sending for letters, packages, COD packages, package experience, and money mail.
• Added tools for all mailboxes, online mailboxes, and selected recipients.
• Added registered mailbox management.
• Added player inbox inspection and editing tools.

Improvements

• Improved package receive handling.
• Improved partial package withdrawal behavior.
• Improved accepted COD package handling.
• Improved Vault detection and safe economy fallback.
• Improved Citizens compatibility across older and newer builds.
• Improved safe handling for missing or unloaded worlds.
• Improved inbox click protection.
• Improved online and offline mail notification summaries.
• Improved config and language organization.
• Improved sound handling across supported Minecraft versions.

Compatibility

Supported server versions:

Spigot/Paper 1.18.2 through 1.21.11 Spigot/Paper 26.1.x

Tested versions include:

1.18.2 1.19.4 1.20.1 1.20.6 1.21.10 26.1.x

Java Notes

• MailboxGUI is compiled with Java 17 for broad compatibility.
• Older server versions may require Java 17.
• Newer server versions may require Java 21.
• Use the Java version required by your server jar.

Optional Dependencies

• Vault: required for money mail and COD packages
• Citizens: required for Post Office NPCs
• Dynmap: required for map markers

Upgrade Notes

This is the first Hangar release, but MailboxGUI includes safe upgrade handling for existing users from previous releases.

• Existing mailbox data remains compatible.
• Existing letters, packages, COD packages, and money mail remain compatible.
• Existing Post Office data remains compatible.
• Existing Citizens Post Office NPCs remain compatible.
• Language files upgrade safely while preserving customized text.
• Backup systems are included for safer version upgrades.

A manual backup is still strongly recommended before updating.