Rismr1's Plugins

MailboxGUI release

5.1.1 - Vault2.0 Custom Currency and Language Update

Adds Vault2.0 custom currency support for money mail and COD amount input, improves chat-input normalization, updates zh_cn, adds zh_hk, credits nice, uses language file-version 14, and expands /mba clean backup cleanup.

Back to Releases Back to MailboxGUI
Release
Version
5.1.1
Published
June 27, 2026
Minecraft
1.18.2 - 1.21.11 / 26.1.X - 26.2.X
Java
Java 17+

Release Notes

MailboxGUI 5.1.1 Website Release Notes

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. This release improves Vault2.0 custom currency support, strengthens chat-based input handling, updates Chinese language support, and expands backup cleanup behavior.

---

Highlights

  • Added improved Vault2.0 custom currency support for money mail and Vault-money COD amount input.
  • Improved amount parsing for custom currency names, currency symbols, commas, color codes, and hidden formatting.
  • Fixed compatibility issues where renamed Vault2.0 currencies could cause COD or money input prompts to reject valid values.
  • Improved chat input normalization for cancel, off, XP amounts, COD amounts, money amounts, typed recipient input, Book Letter drafts, admin prompts, and Post Office name prompts.
  • Updated the Simplified Chinese (zh_cn) language file.
  • Added new Hong Kong Traditional Chinese (zh_hk) language support.
  • Added contributor credit for nice for the updated zh_cn and new zh_hk language files.
  • Bumped active language files to file-version 14.
  • Added language upgrade support so old default zh_cn values can upgrade to the new contributed translation while preserving custom edits.
  • Updated /mba clean so newer generated backup folders can be cleaned after the admin confirms the plugin is working correctly.

---

Vault2.0 Custom Currency Support

MailboxGUI now better supports Vault2.0 setups that rename or customize the server currency.

Players and admins can safely enter money/COD amounts using plain numbers or formatted currency text, such as:

12
12 Coins
12 Dollars
12 <custom currency name>
$12
12.50
1,000

This improves compatibility for:

  • Player money mail
  • Admin money mail
  • Player Vault-money COD package input
  • Admin Vault-money COD package input
  • Combined COD flows where Vault money is used

---

Chat Input Improvements

MailboxGUI now normalizes chat input before validating special prompt values or parsing amounts.

This helps protect input prompts from:

  • Currency names added by custom economy providers
  • Legacy Minecraft color codes
  • Hidden formatting characters
  • Non-breaking spaces
  • Currency symbols
  • Comma-formatted numbers

Improved input handling applies to:

  • Money mail input
  • Package COD amount input
  • Package XP amount input
  • Typed recipient input
  • Player Book Letter draft cancel input
  • Admin Book Letter draft cancel input
  • Admin/server mail prompts
  • Post Office mailbox name input

---

Language Updates

Updated Simplified Chinese

The zh_cn language file has been updated with a new contributed translation from nice.

New Hong Kong Traditional Chinese

MailboxGUI now includes a new Hong Kong Traditional Chinese language file:

messages_zh_hk.yml

Supported Chinese language files now include:

messages_zh_cn.yml
messages_zh_hk.yml
messages_zh_tw.yml
Language file-version

Active language files now use:

file-version: 14

The language upgrade system can replace old default zh_cn values with the new contributed translation while preserving server-owner custom edits.

---

Contributor Credit

Special thanks to nice for supporting MailboxGUI and contributing the updated Chinese language files:

messages_zh_cn.yml
messages_zh_hk.yml

These files improve Chinese language support for MailboxGUI users and server owners.

---

Backup Cleanup Update

/mba clean now cleans newer MailboxGUI-generated backup folders under:

plugins/MailboxGUI/data/backups/

Use this only after confirming that the upgrade is working correctly.

Command:

/mailbox admin clean

or:

/mba clean

---

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

Java target:

Java 17

Use the Java version required by your server jar.

---

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/

MailboxGUI will synchronize supported files safely.

---

Recommended Tests

If you use 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

---

Summary

MailboxGUI 5.1.1 is recommended for servers using:

  • Vault2.0
  • Custom economy/currency names
  • Chinese language files
  • MailboxGUI 5.1.x Book Letters and item-currency COD
  • Paper/Purpur 26.2.x compatibility from the 5.1.x line

Thank you to everyone who reported issues and tested edge cases, and special thanks again to nice for the Chinese language file contributions.