Rismr1's Plugins

MailboxGUI-DiscBridge release

1.1.0 - MailboxGUI 5.1.0 Notification & Discord Language Update

DiscBridge 1.1.0 adds MailboxGUI 5.1.0 support, Book Letter alerts, COD item-currency notifications, localized Discord messages, and player-selectable DM languages.

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

Release Notes

MailboxGUI-DiscBridge 1.1.0

MailboxGUI-DiscBridge 1.1.0 is the companion update for MailboxGUI 5.1.0, adding support for the new mail delivery payloads, localized Discord message templates, and player-selectable Discord DM languages.

Requirements

  • Requires MailboxGUI 5.1.0 or newer
  • Requires DiscordSRV
  • Requires Java 17 or newer
  • Runs on a Bukkit/Paper/Purpur backend server
  • Does not run on Velocity itself

Compatibility

MailboxGUI-DiscBridge 1.1.0 follows the backend compatibility of MailboxGUI 5.1.0:

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

MailboxGUI 5.1.0 is required for Paper/Purpur 26.2.x support.

---

What’s New

Book Letter Discord Notifications

DiscBridge now supports MailboxGUI 5.1.0 Book Letter delivery events.

New Discord template:

dm-book-letter:
  - "📬 You received a book letter from {sender} on {server}."
  - "Check your mailbox, a public Post Office box, or a Post Office NPC in-game."
COD Item-Currency Payment Notifications

DiscBridge now supports COD item-currency payment mail notifications.

New Discord template:

dm-cod-item-currency-payment:
  - "💜 You received a COD item-currency payment from {sender} on {server}."
  - "Payment: {price}"
  - "Check your mailbox, a public Post Office box, or a Post Office NPC in-game."
Improved COD Price Text

The {price} placeholder now supports MailboxGUI 5.1.0 codPriceText.

It can show:

  • Vault money
  • Item currency
  • XP currency
  • Saved item/template currency
  • Combined COD prices

Example values:

100
Diamond: 4, Gold Nugget: 2, XP: 100
100, Diamond: 3
Rare Sword: 1, XP: 250

---

New Discord Message Language System

Discord DM/channel templates now use the new /disclanguage/ folder:

/plugins/MailboxGUI-DiscBridge/disclanguage/messages_*.yml

Supported Discord message files:

messages_en.yml
messages_de.yml
messages_es.yml
messages_fr.yml
messages_it.yml
messages_ja.yml
messages_ko.yml
messages_nl.yml
messages_pl.yml
messages_ru.yml
messages_sv.yml
messages_uk.yml
messages_zh_cn.yml
messages_zh_tw.yml

Each file includes translated Discord messages and translated comments.

The old root file is not used by the final 1.1.0 system:

/plugins/MailboxGUI-DiscBridge/messages.yml

---

New Player Command

Players can now choose the language used for their own individual Discord DMs:

/mbdiscord language <language>

Examples:

/mbdiscord language English
/mbdiscord language Spanish
/mbdiscord language Español
/mbdiscord language German
/mbdiscord language Deutsch
/mbdiscord language zh_cn

Supported language codes:

en, de, es, fr, it, ja, ko, nl, pl, ru, sv, uk, zh_cn, zh_tw

Player-selected languages affect individual Discord DMs only.

They do not affect admin/API mass-mail channel notices.

---

Config Update

New default Discord message language setting:

discord-messages:
  default-language: "en"

This setting is used when:

  • a player has not selected a Discord DM language
  • DiscBridge sends an admin/API mass-mail channel notice

Mass-mail channel notices always use discord-messages.default-language.

---

Upgrade From 1.0.x

DiscBridge 1.1.0 includes a direct upgrade path from 1.0.x.

Old custom Discord messages from:

/plugins/MailboxGUI-DiscBridge/config.yml

under:

messages:

are migrated into:

/plugins/MailboxGUI-DiscBridge/disclanguage/messages_en.yml

Other translated messages_*.yml files are created from bundled defaults.

After upgrade:

  • disclanguage/messages_en.yml should contain old custom English messages where possible
  • config.yml should no longer contain the old root messages: section
  • root messages.yml should not exist
  • /mbdiscord admin reload should not recreate root messages.yml
Temporary Unreleased Test-Build Migration

If a server used an unreleased 1.1.0 test build that created:

/plugins/MailboxGUI-DiscBridge/messages.yml

DiscBridge migrates that file into:

/plugins/MailboxGUI-DiscBridge/disclanguage/messages_en.yml

Then it backs up and removes the old root messages.yml.

---

Reload Updates

/mbdiscord admin reload now reloads:

  • config
  • Discord message language files
  • in-game language files
  • player data

---

Testing Checklist

Recommended commands:

/mbdiscord admin status
/mbdiscord admin mode
/mbdiscord admin reload
/mbdiscord admin testdm <player>
/mbdiscord admin testchannel
/mbdiscord language
/mbdiscord language Spanish
/mbdiscord language Español
/mbdiscord status

Recommended delivery tests:

Classic Letter DM
Book Letter DM
Package DM
COD package with Vault money
COD package with item currency
COD item-currency payment mail
Returned COD package
Money mail
Admin one-recipient mail
Admin/API mass-mail channel notice
Optional queued mass-mail DMs if enabled

Expected behavior:

  • Individual DMs use the recipient’s selected Discord DM language when set
  • Individual DMs use discord-messages.default-language when no player language is set
  • Book Letters use the Book Letter DM template
  • COD item-currency payment mail uses the item-currency payment template
  • {price} shows MailboxGUI 5.1.0 COD price text
  • Mass-mail channel notices use discord-messages.default-language
  • Player-selected languages do not affect mass-mail channel notices
  • Network mode notifications work through one NETWORK_NODE backend

---

Summary

MailboxGUI-DiscBridge 1.1.0 adds full MailboxGUI 5.1.0 notification support, Book Letter alerts, COD item-currency payment alerts, localized Discord message files, player-selectable Discord DM languages, and safe migration from older custom Discord message templates.