MailboxGUI 5.1.1 Modrinth Changelog

Vault2.0 Custom Currency and Language Update

MailboxGUI 5.1.1 is a focused compatibility and language update for the 5.1.x release line. It improves Vault2.0 custom currency support, strengthens chat-input parsing for money/COD prompts, updates Chinese language support, and improves backup cleanup behavior.

---

Added

• Added improved Vault2.0 custom currency support for money mail and Vault-money COD amount input.
• Added support for parsing formatted currency input such as:
  • 12 Coins
  • 12 Dollars
  • 12 <custom currency name>
  • $12
  • 12.50
  • 1,000
• Added new Hong Kong Traditional Chinese language support: zh_hk.
• Added messages_zh_hk.yml.
• Added language upgrade support for replacing old default zh_cn values with the new bundled translation while preserving server-owner custom edits.

---

Changed

• Updated the Simplified Chinese language file: zh_cn.
• Updated active language files to:

file-version: 14

• Updated MailboxGUI API version to 5.1.1.
• Updated /mba clean backup cleanup coverage so newer MailboxGUI-generated backup folders can be cleaned after the admin confirms the upgrade is working.

---

Improved

• Improved chat-input cleanup for:
  • Money mail input
  • Vault-money COD amount input
  • Package XP input
  • Typed recipient input
  • Book Letter draft cancel input
  • Admin Book Letter draft cancel input
  • Admin/server mail prompts
  • Post Office mailbox name input
• Improved handling for control words such as:
  • cancel
  • off
  • none
  • 0
• Improved protection against:
  • Currency names added by economy providers
  • Legacy Minecraft color codes
  • Hidden formatting characters
  • Non-breaking spaces
  • Currency symbols
  • Comma-formatted numbers

---

Fixed

• Fixed compatibility issues where renamed Vault2.0 currencies could cause money/COD chat input prompts to reject valid values.
• Fixed cases where formatted or modified chat input could make valid prompt responses fail validation.

---

Compatibility

MailboxGUI 5.1.1 keeps the same compatibility target as the 5.1.x line:

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

Important notes:

• MailboxGUI 5.1.0 or newer is required for Paper/Purpur 26.2.x compatibility.
• MailboxGUI 5.1.1 or newer is recommended for Vault2.0 custom currency support.
• MailboxGUI-DiscBridge 1.1.1 or newer is recommended for the updated zh_cn and new zh_hk language files.

---

Recommended Tests After Updating

If your server uses Vault2.0 or custom currency names, test:

Money Mail -> 12
Money Mail -> 12 <custom currency name>
Money Mail -> cancel

Player COD Package -> 12
Player COD Package -> 12 <custom currency name>
Player COD Package -> cancel

Package XP -> 12
Package XP -> cancel

Typed recipient prompt -> cancel
Book Letter draft -> cancel
Admin Book Letter draft -> cancel

/mailbox language zh_cn
/mailbox language zh_hk
/mba clean

---

Upgrade Notes

To upgrade:

1. Stop the server.
2. Back up the full plugins/MailboxGUI/ folder.
3. Replace the old MailboxGUI jar with the 5.1.1 jar.
4. Start the server.
5. Watch the console for language/config/storage synchronization messages.
6. Test money mail, COD packages, XP packages, Book Letters, and language loading.
7. After confirming everything is working, optionally run /mba clean.

You should not need to delete:

config.yml
network/config.yml
language/
data/

---

Contributor

Special thanks to nice for contributing the updated Simplified Chinese (zh_cn) language file and the new Hong Kong Traditional Chinese (zh_hk) language file.