MailboxGUI

MailboxGUI adds GUI-based letters, packages, COD packages, XP packages, and money mail for Spigot/Paper servers. Supports physical mailboxes, Post Office boxes, Citizens NPCs, Vault economy, Dynmap markers, languages, and 1.18.2–1.21.11 plus 26.1.x.
Download

File Details
Download

MailboxGUI-4.2.0

ByRismr1
  • R
  • May 17, 2026
  • 822.75 KB
  • 5
  • 26.1.2+26

File Name

MailboxGUI-4.2.0.jar

Supported Versions

  • 26.1.2
  • 26.1.1
  • 26.1
  • 1.21.11
  • 1.21.10
  • 1.21.9
  • 1.21.8
  • 1.21.7
  • 1.21.6
  • 1.21.5
  • 1.21.4
  • 1.21.3
  • 1.21.2
  • 1.21.1
  • 1.20.6
  • 1.20.5
  • 1.20.4
  • 1.20.3
  • 1.20.2
  • 1.20.1
  • 1.20
  • 1.19.4
  • 1.19.3
  • 1.19.2
  • 1.19.1
  • 1.19
  • 1.18.2

MailboxGUI 4.2.0

MailboxGUI 4.2.0 is a quality-of-life and polish update focused on better player onboarding, safer upgrades, cleaner economy handling, improved admin tools, and updated language support.

Highlights

  • Added /mailbox guide and /mb guide to help players understand personal mailboxes, public Post Office boxes, Post Office NPCs, and how to get started.
  • Added /mailbox check and /mb check to show new unchecked mail counts without opening the inbox.
  • Improved Vault/economy detection so money and COD options are hidden from GUIs when unavailable.
  • Added configurable money display formatting for money mail, admin money mail, COD prices, and COD return payments.
  • Improved COD fail-safes so COD mail stays safely dormant if Vault/economy is unavailable and becomes usable again when support returns.
  • Updated default mailbox sign wording for clearer personal mailbox and public Post Office access signs.
  • Added legacy sign compatibility and automatic handling for old default sign formats.
  • Added /mailbox admin convert current and /mba convert current to show the active storage mode.
  • Simplified storage conversion to /mailbox admin convert <YAML|SQLITE|MYSQL> and /mba convert <YAML|SQLITE|MYSQL>.
  • Added /mailbox admin clean and /mba clean to safely clean MailboxGUI-generated backup files after confirming upgraded data is working.
  • Improved backup organization under plugins/MailboxGUI/data/backups/.
  • Improved Citizens Post Office NPC cleanup when NPCs are removed.
  • Updated bundled language files and language upgrade handling for 4.2.0.

Economy & Non-Economy Improvements

  • MailboxGUI now adapts more cleanly when Vault or an economy plugin is not installed.
  • Servers without economy support still get letters, packages, mailbox access, public Post Office boxes, and Post Office NPC support.
  • Money mail and COD options are hidden when unavailable instead of showing unusable GUI buttons.
  • COD packages stay dormant when economy support is missing and resume when Vault/economy is restored.

Storage & Upgrade Safety

  • Existing legacy YAML installs remain on YAML unless manually converted.
  • Older mail data is upgraded safely without requiring a mail wipe.
  • Storage conversion validates the target storage before switching.
  • MySQL conversion/startup safety remains protected by connection/login/table validation.
  • Generated backups are better organized and can be cleaned after confirming the upgrade is working.

Notes

  • Vault and a compatible economy plugin are required only for money mail and COD package payments.
  • Citizens, Dynmap, and PlaceholderAPI remain optional hooks.
  • For full commands, permissions, screenshots, setup guides, API documentation, and configuration details, visit the wiki:

https://plugins.imagine-craft.net/mailboxgui/wiki/