⭐ MailboxGUI-DiscBridge | DiscordSRV Mail Notifications for MailboxGUI

DiscBridge connects MailboxGUI mail delivery to Discord through DiscordSRV. Players can receive Discord notifications when new mail arrives, even while they are away from the server, and choose which notifications they want to receive.

All features listed on this page are specifically for DiscBridge Free, designed for single-server MailboxGUI setups.


Features

Discord Mail Notifications

• Direct messages for paper letters and book letters.
• Package and money mail notifications, including attached messages.
• Cash-on-Delivery package notifications.
• COD item-currency payment and returned COD package notifications.
• Expiration-aware messages for mail with an expiration date.
• Configurable Discord message templates and placeholders.
• Admin and API mass-mail channel notices.
• Optional queued direct messages for mass mail.
• Persistent notification outbox with retry and restart recovery for accepted work.

Player Notification Controls

• Enable or disable Discord mail notifications.
• Choose whether to receive direct messages while online.
• Ignore or unignore specific senders.
• Manage admin/server mail direct-message preferences.
• Choose a language for Discord notification messages.
• Check notification settings and Discord account link status.
• Access Discord settings and a setup guide directly through MailboxGUI.

Admin Tools

• View DiscBridge status.
• Reload configuration and message templates.
• Check for updates and stage an update for the next restart.
• Configure mass-mail channel notices and direct-message delivery.
• Enable or disable player access to Discord commands after checking setup readiness.

Languages Supported

DiscBridge includes separate language files for in-game messages and Discord notification templates.

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

In-game messages follow MailboxGUI's language and client locale settings. Discord direct messages use the player's selected Discord language, falling back to MailboxGUI's default language. Channel notices use MailboxGUI's default language.

DiscBridge commands are integrated into MailboxGUI and inherit its command-syntax locale. Set locale.command-syntax.default in MailboxGUI's config.yml before startup to register localized command roots alongside English. Help and tab completion support localized syntax. Changing registered command roots requires a server restart.


Commands and Permissions

Player Commands

• /mb settings discord — Show Discord notification help.
• /mb settings discord guide — Open the player setup guide.
• /mb settings discord status — Check notification settings and account link status.
• /mb settings discord enable — Enable Discord mail notifications.
• /mb settings discord disable — Disable Discord mail notifications.
• /mb settings discord online on|off — Control notifications while online.
• /mb settings discord language <language> — Choose your Discord notification language.
• /mb settings discord ignore <player> — Ignore a sender's notifications.
• /mb settings discord unignore <player> — Allow a sender's notifications again.
• /mb settings discord ignorelist — View ignored senders.
• /mb settings discord ignoreadmin or /mb settings discord unignoreadmin — Control admin/server mail direct messages.

Admin Commands

• /mba discord — Show DiscBridge admin help.
• /mba discord status — View plugin and DiscordSRV readiness status.
• /mba discord reload — Reload configuration and message templates.
• /mba discord playercommands on|off — Enable or disable player Discord commands.
• /mba discord updatecheck — Check for updates.
• /mba discord update — Begin the update workflow.

These examples use English syntax, which is always available. DiscBridge includes permissions for player controls and admin tools. Player Discord commands must be enabled by an administrator after setup checks pass.

For the full command and permission list, use the official wiki.


Installation

Basic Setup

1. Install MailboxGUI and DiscordSRV.
2. Place the DiscBridge jar in your server's plugins folder.
3. Start the server to generate files, then stop it and review plugins/MailboxGUI-DiscBridge/config.yml.
4. Configure DiscordSRV and start the server again.
5. Check /mba discord status, then enable player controls with /mba discord playercommands on when setup is ready.
6. Players can use /mb settings discord guide for account linking and notification setup.

For upgrades, back up the DiscBridge and MailboxGUI folders and MailboxGUI's database. Keep existing player preference and pending-notification files.

Dependencies

DiscBridge requires both plugins below to function:

MailboxGUI

MailboxGUI provides the mail system and delivery events. DiscBridge is a companion plugin and does not send mail by itself. DiscBridge 2.1.0 Free requires MailboxGUI 6.1.0 Free.

Download MailboxGUI on SpigotMC.

DiscordSRV

DiscBridge requires DiscordSRV.

DiscordSRV provides Discord connectivity and account linking. Players must link their Minecraft and Discord accounts through DiscordSRV to receive direct messages, and their Discord settings must allow delivery.

Download DiscordSRV on SpigotMC.


Support

For setup questions, bug reports, or configuration help, join the Discord support server.

Official wiki:

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