1.0.0 - Stable Discord Notification Bridge

MailboxGUI-DiscBridge 1.0.0 - Stable Discord Notification Bridge

MailboxGUI-DiscBridge 1.0.0 is the first stable release of the DiscordSRV notification addon for MailboxGUI. This release upgrades the bridge from beta into a cleaner, network-ready addon with support for standalone servers and MailboxGUI network setups.

Highlights

• Updated for MailboxGUI 5.0.0.
• Added LOCAL and NETWORK_NODE operating modes.
• Added support for one-backend Discord notification nodes in MailboxGUI network setups.
• Added Discord notifications for MailboxGUI delivery events.
• Added individual Discord DMs for eligible player mail.
• Added admin/API mass-mail channel notices.
• Added optional queued mass-mail DMs with recipient caps.
• Added duplicate event protection.
• Added client-locale command messages.
• Added website-powered update checks and staged update commands.
• Added /mbdiscord admin mode diagnostics.
• Expanded /mbdiscord admin status.
• Added config synchronization from 0.1.0-Beta to 1.0.0.
• Added language file synchronization and full 1.0.0 language polish.

MailboxGUI Addon

MailboxGUI-DiscBridge is a standalone addon plugin for MailboxGUI.

It requires:

• MailboxGUI 5.0.0 or newer
• DiscordSRV
• Java 17 or newer
• A Bukkit/Paper/Spigot/Purpur backend server

DiscBridge is not bundled into MailboxGUI and does not run on Velocity itself.

Operating Modes

LOCAL Mode

LOCAL mode is the default mode for standalone or single-backend servers.

Use this mode when MailboxGUI, DiscordSRV, and MailboxGUI-DiscBridge are installed on the same server.

DiscBridge listens to local MailboxGUI delivery events and sends Discord notifications through the local DiscordSRV instance.

NETWORK_NODE Mode

NETWORK_NODE mode is for MailboxGUI network setups.

Use this mode when MailboxGUI is installed on multiple backend servers, but DiscordSRV and DiscBridge should only run on one backend.

In this setup:

• MailboxGUI runs on every backend that uses mail.
• MailboxGUI network mode must be enabled.
• DiscordSRV and MailboxGUI-DiscBridge run on one backend only.
• DiscBridge listens for MailboxGUI network notification events.
• Other backends do not need DiscordSRV or DiscBridge.

This avoids copying the same DiscordSRV bot setup across every backend.

Notification Behavior

Individual mail can send Discord DMs when the player is linked and allowed by settings.

Supported mail types include:

• Letters
• Packages
• COD packages
• Returned COD packages
• Money mail
• Admin/server mail
• API/system mail

Online players do not receive Discord DMs by default because MailboxGUI already provides in-game notifications. Players can enable online DMs with:

/mbdiscord online on

Admin and Mass Mail

Admin/API mail sent to multiple recipients sends one Discord channel notice by default.

Optional mass-mail DMs are available but disabled by default. When enabled, DiscBridge checks actual DM eligibility before counting recipients and sends DMs through a queue to avoid sending too many messages at once.

Commands

Player commands:

/mbdiscord help
/mbdiscord help 1
/mbdiscord help 2
/mbdiscord status
/mbdiscord enable
/mbdiscord disable
/mbdiscord online on
/mbdiscord online off
/mbdiscord online toggle
/mbdiscord ignore <player>
/mbdiscord unignore <player>
/mbdiscord ignorelist
/mbdiscord ignoreadmin
/mbdiscord unignoreadmin

Admin commands:

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

Update System

DiscBridge now supports website-powered update checks and staged update downloads.

Useful commands:

/mbdiscord admin updatecheck
/mbdiscord update
/mbdiscord update confirm

The update command stages a newer valid DiscBridge jar for the next restart. It does not hot-swap the plugin while the server is running.

Configuration and Language Sync

DiscBridge 1.0.0 includes upgrade-safe synchronization for:

• config.yml
• language files
• player preference data

Existing custom values are preserved where possible. The old beta default server-name: "ImagineCraft" is replaced with the generic Minecraft Server when it was not customized.

Upgrade Notes

If upgrading from 0.1.0-Beta:

1. Stop the server.
2. Back up /plugins/MailboxGUI-DiscBridge/.
3. Replace the old jar with the 1.0.0 jar.
4. Start the server.
5. Check /mbdiscord admin status.
6. Check /mbdiscord admin mode.
7. Test /mbdiscord admin testdm <player>.
8. Test /mbdiscord admin testchannel.

For network setups, make sure MailboxGUI network mode is working before setting DiscBridge to NETWORK_NODE.

Compatibility

MailboxGUI-DiscBridge remains a backend plugin. It is intended for Paper, Spigot, and Purpur servers that run MailboxGUI and DiscordSRV.

For Velocity networks, install DiscBridge only on the backend server that will act as the Discord notification node.