Discord Notification System Rework

Discord Notification System Rework

MailboxGUI-DiscBridge 2.0.0 is the matching DiscBridge update for the MailboxGUI 6.0.0 release line. This update rebuilds DiscBridge around the new MailboxGUI API behavior, adds cleaner Free/Premium edition handling, improves Discord notification safety, adds expiration-aware messages, refreshes localization, and prepares the addon for the new website release system.

Important Network Warning

DO NOT UPGRADE IF USING NETWORK.

DiscBridge 2.0.0 Free does not include Network Mode support. If your server is currently using the older DiscBridge Network Mode setup from 1.1.1, stay on DiscBridge 1.1.1 until a supported network-ready release is available.

Before updating, make a full backup of:

• plugins/MailboxGUI-DiscBridge/
• config.yml
• language/
• disclanguage/
• data/players.yml

Main Highlights

• Updated DiscBridge for MailboxGUI 6.0.0.
• Added Free/Premium edition-aware build support.
• Added strict MailboxGUI/DiscBridge edition matching.
• Added safer startup validation for wrong edition pairings.
• Added expiration-aware Discord notifications.
• Added {expiration} and %expiration% placeholder support.
• Added new Discord message templates for expiring mail.
• Improved admin/API mass-mail notification behavior.
• Fixed disabled mass-mail DMs still sending.
• Added safer mass-mail DM queue controls.
• Added website release update checking.
• Added release, beta, and alpha update channels.
• Added update staging for next restart.
• Cleaned DiscBridge config settings.
• Removed public mode switching from config.
• Refreshed in-game and Discord message language files.
• Fixed corrupted locale text in active language resources.
• Improved DiscordSRV link re-check behavior.

Edition Pairing

MailboxGUI and DiscBridge editions must match.

• MailboxGUI Free must be used with DiscBridge Free.
• MailboxGUI Premium must be used with DiscBridge Premium.
• Free and Premium editions cannot be mixed.

If the wrong edition pairing is installed, DiscBridge will stop loading and print a clear console warning explaining the required pairing.

Free Edition Behavior

DiscBridge Free is now single-server/local only.

• Free listens to local MailboxGUI delivery events.
• Free does not expose Network Mode config.
• Free does not include Premium network classes.
• Free does not generate Premium network resources.
• Free is intended for MailboxGUI Free 6.0.0.

Premium Preparation

DiscBridge Premium has been structurally prepared for future network-rich support.

• Added Premium module build path.
• Added Premium NETWORK_NODE service structure.
• Added Redis subscriber preparation for future MailboxGUI network payloads.
• Added Premium startup checks for MailboxGUI Premium network mode.
• Added protected Premium update login placeholders.

Premium network behavior is still guarded until MailboxGUI Premium network support is ready and fully tested.

Discord Notification Improvements

DiscBridge now supports expiration-aware Discord messages for:

• paper letters
• book letters
• packages
• COD packages
• COD item-currency payment mail
• returned COD packages
• money mail
• admin/API mass-mail channel notices

If a delivered mail item has an expiration timestamp, DiscBridge automatically uses the matching expiration message template. If the mail does not expire, DiscBridge uses the normal non-expiration template.

Mass Mail Improvements

Admin/API mass mail handling was improved so large sends are less spammy and easier to control.

• Mass mail now prefers one channel notice instead of immediate individual DMs.
• Optional mass-mail DMs are controlled by config.
• Eligible recipients are checked before queueing.
• Unlinked players are skipped.
• Players who disabled DiscBridge notifications are skipped.
• Players ignoring admin/server mail are skipped.
• Online DM preferences are respected.
• Queued DMs can be delayed and retried.
• Disabled mass-mail DMs now stop sending properly.

Config Updates

The generated config has been cleaned up for 2.0.0.

• Removed public mode: from config.
• Mode is now controlled by the jar edition.
• Free is always LOCAL.
• Premium is reserved for NETWORK_NODE.
• Added simplified locale settings:
• locale.use-client-locale
• locale.default-language
• Kept separate Discord message language setting:
• discord-messages.default-language
• Old language and locale-detection settings are migrated automatically.
• Old hidden/edition-controlled settings are removed during config sync.
• Existing custom values are preserved where possible.

Update System

DiscBridge now uses the new website release system.

• Free checks the Free update route.
• Premium checks the Premium update route.
• Supported release channels:
• release
• beta
• alpha
• Added update commands:
• /mbdiscord admin updatecheck
• /mbdiscord update
• /mbdiscord update confirm
• Added update response validation.
• Added wrong edition/channel/product protection.
• Added jar validation before staging.

Premium update downloads are prepared to require website account credentials.

Locale And Language Updates

DiscBridge language handling received a full pass.

• In-game /mbdiscord messages support client locale detection.
• Discord DM templates use the player's selected Discord message language.
• Channel notices use the configured default Discord message language.
• Added missing localized /mbdiscord language messages.
• Audited active language keys and placeholders.
• Audited Discord message templates and placeholders.
• Fixed corrupted UTF-8 text in active locale files.
• Command syntax remains untranslated so commands stay usable.

Supported language files:

• English
• German
• Spanish
• French
• Italian
• Japanese
• Korean
• Dutch
• Polish
• Russian
• Swedish
• Ukrainian
• Simplified Chinese
• Hong Kong Traditional Chinese
• Taiwan Traditional Chinese

Commands

Player commands include:

• /mbdiscord help
• /mbdiscord status
• /mbdiscord enable
• /mbdiscord disable
• /mbdiscord online on|off|toggle
• /mbdiscord language <language>
• /mbdiscord ignore <player>
• /mbdiscord unignore <player>
• /mbdiscord ignorelist
• /mbdiscord ignoreadmin
• /mbdiscord unignoreadmin

Admin commands include:

• /mbdiscord admin status
• /mbdiscord admin mode
• /mbdiscord admin reload
• /mbdiscord admin updatecheck
• /mbdiscord update
• /mbdiscord update confirm
• /mbdiscord admin testdm <player>
• /mbdiscord admin testchannel

Permissions

• mailboxguidiscbridge.use
• mailboxguidiscbridge.online
• mailboxguidiscbridge.ignore
• mailboxguidiscbridge.ignoreadmin
• mailboxguidiscbridge.admin
• mailboxguidiscbridge.admin.reload
• mailboxguidiscbridge.admin.status
• mailboxguidiscbridge.admin.test
• mailboxguidiscbridge.admin.update

Upgrade Notes

• Back up your full plugins/MailboxGUI-DiscBridge/ folder before updating.
• Use DiscBridge 2.0.0 with MailboxGUI 6.0.0.
• Make sure the MailboxGUI and DiscBridge editions match.
• Review the regenerated config after updating.
• Review Discord message language files if you customized them.
• Do not update if your current setup depends on Network Mode.
• Test DiscordSRV account linking after updating.
• Test /mbdiscord status.
• Test /mbdiscord enable.
• Test normal mail delivery notifications.
• Test admin/API mass-mail channel notices if you use them.

Compatibility

• Requires MailboxGUI.
• Requires DiscordSRV.
• Requires Java 17.
• Supports Bukkit/Spigot/Paper/Purpur backend servers.
• Does not run directly on Velocity.
• DiscBridge does not store or move MailboxGUI mail data.

Full setup help and command information is available on the wiki:

https://plugins.imagine-craft.net/mailboxgui-discbridge/wiki/