1.1.1 — Chinese Language Update

MailboxGUI-DiscBridge 1.1.1 Website Release Notes

Chinese Language Update

MailboxGUI-DiscBridge 1.1.1 is a focused language and synchronization update for the 1.1.x release line. This release updates Simplified Chinese support, adds Hong Kong Traditional Chinese support, and improves upgrade handling for in-game language files and Discord message templates.

---

Highlights

• Updated Simplified Chinese (zh_cn) in-game command language file.
• Updated Simplified Chinese (zh_cn) Discord DM/channel message template file.
• Added new Hong Kong Traditional Chinese (zh_hk) in-game command language file.
• Added new Hong Kong Traditional Chinese (zh_hk) Discord DM/channel message template file.
• Added zh_hk support for /mbdiscord language <language>.
• Added zh_hk support for language: "zh_hk" in config.yml.
• Added zh_hk support for discord-messages.default-language: "zh_hk".
• Updated language synchronization so old default zh_cn values can upgrade to the new contributed translation while preserving server-owner custom edits.
• Updated Discord message synchronization so old default zh_cn Discord templates can upgrade safely.
• Added contributor credit for nice in the bundled Chinese language files and project documentation.

---

New zh_hk Language Support

DiscBridge now supports:

zh_hk

This applies to both in-game command messages and Discord message templates:

plugins/MailboxGUI-DiscBridge/language/messages_zh_hk.yml
plugins/MailboxGUI-DiscBridge/disclanguage/messages_zh_hk.yml

The new zh_hk language can be used for:

• /mbdiscord command messages
• Discord direct-message templates
• Discord channel message templates
• Player-selected Discord DM language
• Server default Discord message language

---

Updated zh_cn

The existing Simplified Chinese files have been updated:

plugins/MailboxGUI-DiscBridge/language/messages_zh_cn.yml
plugins/MailboxGUI-DiscBridge/disclanguage/messages_zh_cn.yml

When upgrading, DiscBridge can replace old default zh_cn values with the new contributed translation where the server owner has not customized them.

Customized values are preserved.

---

Contributor Credit

Special thanks to nice for supporting MailboxGUI-DiscBridge and contributing the updated Chinese language files.

This contribution includes:

language/messages_zh_cn.yml
language/messages_zh_hk.yml
disclanguage/messages_zh_cn.yml
disclanguage/messages_zh_hk.yml

These files improve both Minecraft-side /mbdiscord messages and Discord DM/channel notification templates.

---

Player Language Command

Players can now select Hong Kong Traditional Chinese for their Discord DM notifications:

/mbdiscord language zh_hk

Simplified Chinese remains available:

/mbdiscord language zh_cn

Traditional Chinese remains available:

/mbdiscord language zh_tw

Supported Chinese language options now include:

zh_cn
zh_hk
zh_tw

---

Config Support

The main in-game language can now be set to Hong Kong Traditional Chinese:

language: "zh_hk"

The default Discord message language can also be set to Hong Kong Traditional Chinese:

discord-messages:
  default-language: "zh_hk"

This controls the fallback Discord message language and the language used for admin/API mass-mail channel notices.

---

Discord Message Template Support

DiscBridge 1.1.1 includes the new Discord message template file:

disclanguage/messages_zh_hk.yml

This file is used for:

• Letter DMs
• Book Letter DMs
• Package DMs
• COD package DMs
• COD item-currency payment DMs
• Returned COD package DMs
• Money mail DMs
• Admin/API mass-mail channel notices

The existing disclanguage/messages_zh_cn.yml file has also been updated.

---

Upgrade Behavior

When upgrading to 1.1.1:

• Missing zh_hk files are generated automatically.
• Existing zh_cn files are synchronized safely.
• Old default zh_cn values are updated to the new contributed translation.
• Customized server-owner zh_cn values are preserved.
• Existing config values are preserved.
• Existing Discord message customizations are preserved where possible.

Managed folders:

plugins/MailboxGUI-DiscBridge/language/
plugins/MailboxGUI-DiscBridge/disclanguage/

---

Compatibility

MailboxGUI-DiscBridge 1.1.1 keeps the same core compatibility target as the 1.1.x line.

Requirements:

MailboxGUI 5.1.0 or newer
DiscordSRV
Java 17 or newer
Spigot/Paper/Purpur-compatible backend

Recommended:

MailboxGUI 5.1.1 or newer

MailboxGUI 5.1.1 is recommended when using Vault2.0 custom currency support and the matching language updates.

---

Upgrade Notes

To upgrade:

1. Stop the server.
2. Back up the full plugins/MailboxGUI-DiscBridge/ folder.
3. Replace the old MailboxGUI-DiscBridge jar with the 1.1.1 jar.
4. Start the server.
5. Watch the console for config/language synchronization messages.
6. Run /mbdiscord admin reload.
7. Test /mbdiscord language zh_cn.
8. Test /mbdiscord language zh_hk.
9. Test Discord DM notifications using the selected language.

You should not need to delete:

config.yml
language/
disclanguage/
data/

---

Recommended Tests

Run:

/mbdiscord admin reload
/mbdiscord language zh_cn
/mbdiscord language zh_hk
/mbdiscord status
/mbdiscord admin testdm <player>
/mbdiscord admin testchannel

Then test real MailboxGUI deliveries:

Classic letter
Book Letter
Package
COD package
COD item-currency payment mail
Returned COD package
Money mail
Admin/API mass mail channel notice

Expected behavior:

• zh_cn language files load correctly.
• zh_hk language files load correctly.
• Individual Discord DMs use the player-selected language.
• Mass-mail channel notices use discord-messages.default-language.
• Existing customized language/message values are preserved during synchronization.

---

Summary

MailboxGUI-DiscBridge 1.1.1 is recommended for servers that want:

• Updated Simplified Chinese support
• Hong Kong Traditional Chinese support
• Chinese Discord DM/channel templates
• Better language upgrade behavior from 1.1.0
• Full compatibility with the MailboxGUI 5.1.x notification payload system

Thank you to everyone testing and supporting DiscBridge, and special thanks again to nice for the Chinese language file contributions.