Integrated Discord Controls and Message Notifications

What's New

DiscBridge 2.1.0 integrates Discord settings directly into MailboxGUI, supports the new package and money messages, and improves notification delivery, localization, and upgrade safety.

Package, COD And Money Messages

• Updated the MailboxGUI integration for its new delivery events and message attachments.
• Added {message} support for standard packages, COD packages, returned COD packages, COD item-currency payments, and money mail when an attachment is present.
• Added separate customizable messages: templates for mail with and without messages, including expiration variants. Mail without a message no longer displays an empty Message heading.
• Template selection follows the actual attachment and expiration state. Paper/book letters keep their existing inherent-message templates.
• Attachment newlines, Unicode, and MailboxGUI's /n line breaks flow into readable Discord text. Messages are supplied by the API rather than recovered from translated item lore.

Integrated Commands And Setup Guide

• Player commands now use /mb settings discord and administrator commands use /mba discord, including MailboxGUI's full roots and localized aliases. The separate /mbdiscord command root is retired.
• Help menus use MailboxGUI-style formatting while identifying DiscBridge and its version. Player/admin help is paginated with six entries per page and tab completion.
• Added /mb settings discord guide as the first player help entry. Its two-page guide explains DiscordSRV linking, sending the link code to the bot, allowing bot DMs, notification preferences, online delivery, language selection, sender/admin filters, and checking status.
• Added /mba discord playercommands on|off. Player commands default to off on new installations and upgrades where the setting is absent, letting administrators finish DiscordSRV setup first.
• Admin status reports DiscordSRV connection, account-link manager readiness, and player-command availability. Failed setup checks warn the administrator and prevent enablement without erasing saved player preferences.
• Added a local public API for command/status discovery and asynchronous replies used by MailboxGUI's integrated commands.

Localization And Formatting

• Added Brazilian Portuguese, bringing support to 16 languages across in-game messages and Discord templates: English, German, Spanish, French, Italian, Japanese, Korean, Dutch, Polish, Brazilian Portuguese, Russian, Swedish, Ukrainian, Simplified Chinese, Hong Kong Chinese, and Traditional Chinese.
• Expanded translated attachment headings, help, usage, errors, status labels, setup instructions, and explanatory comments. In-game language files and Discord templates remain separately customizable.
• DiscBridge now inherits MailboxGUI's in-game locale and command-syntax settings instead of maintaining duplicate defaults. Localized syntax, help, and tab completion follow MailboxGUI's command context; roots remain owned by MailboxGUI.
• Discord DMs use the player's saved Discord language, falling back to MailboxGUI's default locale. Minecraft client-language detection does not override that Discord preference. Mass-mail channel notices use MailboxGUI's default locale.
• Improved {expiration} formatting to follow the selected Discord language, including Brazilian Portuguese. Dates use the bridge server's timezone without changing the stored expiration instant.
• Added compact HEX and supported visual MiniMessage formatting for configurable in-game text and branding, retaining traditional & formatting. Discord output strips Minecraft colors/visual tags while retaining template-authored Discord Markdown.
• Updated DiscBridge's universal tag to MailboxGUI-style branding. The Discord-language line in player status now matches the surrounding status information without a duplicate prefix.
• Replaced Post Office wording with Public Access Mailbox and Public Access NPC across supported languages.

Notification Delivery And Preferences

• Improved DiscordSRV account-link lookup, including cold caches, newly linked accounts, stale links, asynchronous readiness, and reload/disable races.
• Notification sends and retries resolve the current linked account and recheck notification enablement, online-DM preferences, ignored senders/admin mail, and recipient eligibility.
• Fixed mass-mail DMs being sent while admin-mass-mail-direct-messages.enabled is false. The setting also blocks pending mass DMs; separately enabled channel announcements remain independent.
• Eligibility limits count recipients who qualify, with queue pacing and retry behavior kept separate from channel notices. Unknown eligibility does not authorize a send.
• Added runtime guards and privacy-conscious errors so obsolete Discord callbacks cannot continue after the plugin/runtime is replaced.

Persistent Queues And Upgrade Safety

• Added a durable local notification outbox at data/notification-outbox.yml for admitted work, with stable job identities, retry/completion state, and reload/restart recovery.
• Restored jobs are revalidated against current notification policy and Discord message-size limits. Malformed, oversized, or unreadable persisted work is retained and affected dispatch stopped rather than replaced with an empty queue.
• Durable recovery begins when work is accepted into the outbox. Discord delivery and local completion persistence are not atomic, so retries reduce repeats but do not guarantee exactly-once delivery.
• Added released configuration/language baselines, including 2.0.0, so synchronization can update recognized stock messages while preserving owner-customized text, comments, unknown keys, and player choices.
• Supported upgrades add new template variants and update Public Access terminology without requiring language/configuration deletion. Legacy imports are backed up, and malformed/future schema versions stop synchronization rather than downgrading files.
• Preference saves use backed-up atomic writes and preserve custom fields/comments. Failed saves retain pending edits instead of silently replacing the preference manager during reload.

Compatibility And Updates

• Requires MailboxGUI 6.1.0 Free and DiscordSRV, installed on the same server. This edition handles local, single-server mail events and does not provide network notification delivery.
• Checks MailboxGUI's required companion version and integration protocol independently of website update settings. Incompatible versions or mismatched editions disable normal integration with a clear console warning while preserving files/preferences.
• Recovery-capable incompatible builds retain authorized /mba discord updatecheck and /mba discord update routes through MailboxGUI. A staged replacement requires a server restart; older builds without recovery support need manual replacement.
• Retained configurable passive update checks, admin join notices, and release/beta/alpha channels. Download validation checks plugin identity, edition, version, and artifact safety. Free updates need no website account credentials and do not generate authentication defaults.
• Updated compatibility handling for Spigot, Paper, and Purpur 1.18.2-1.21.11 and 26.1-26.3, retaining Java 17 plugin bytecode. Use the Java runtime and DiscordSRV release appropriate to your server version.

Before Updating

• Back up both plugin folders and MailboxGUI's selected database. Keep existing configuration, language/template, preference, and pending-notification files so migration can preserve them.
• Update MailboxGUI and DiscBridge to matching release lines and editions. Use the final DiscBridge release JAR, not an original-* build artifact.
• Finish DiscordSRV setup, verify /mba discord status, then enable player access with /mba discord playercommands on.
• Players must link through DiscordSRV and allow direct messages from the bot; a second player-account link in DiscBridge is not required.
• Test individual/mass notices, attachment templates, selected Discord languages, online/offline preferences, and restart recovery with your live bot after updating.