MailboxGUI-DiscBridge 1.1.1 Modrinth Changelog

Chinese Language Update

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

---

Added

• Added new Hong Kong Traditional Chinese language support: zh_hk.
• Added new in-game command language file:

language/messages_zh_hk.yml

• Added new Discord DM/channel template file:

disclanguage/messages_zh_hk.yml

• Added zh_hk support for:

/mbdiscord language <language>

• Added zh_hk support for the main in-game language config:

language: "zh_hk"

• Added zh_hk support for the default Discord message language:

discord-messages:
  default-language: "zh_hk"

---

Changed

• Updated Simplified Chinese in-game command language file:

language/messages_zh_cn.yml

• Updated Simplified Chinese Discord DM/channel template file:

disclanguage/messages_zh_cn.yml

• Updated supported Chinese language options to include:

zh_cn
zh_hk
zh_tw

• Updated language synchronization so old default zh_cn values can upgrade to the new bundled translation while preserving server-owner custom edits.
• Updated Discord message template synchronization so old default zh_cn Discord templates can upgrade safely while preserving server-owner custom edits.

---

Improved

• Improved language file generation for existing servers when a new supported language is added.
• Improved upgrade handling for the new zh_hk language files.
• Improved zh_cn upgrade behavior for both:
  • in-game /mbdiscord command messages
  • Discord DM/channel message templates

---

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 After Updating

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.

---

Contributor

Special thanks to nice for contributing the updated Simplified Chinese (zh_cn) language files and the new Hong Kong Traditional Chinese (zh_hk) language files for MailboxGUI-DiscBridge 1.1.1.

This contribution includes:

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