
DiscBridge 是 MailboxGUI 的一个附加组件,通过 DiscordSRV 将邮件投递与 Discord 连接起来。当有新邮件到达时,玩家即使不在服务器上也能收到 Discord 通知,并且可以自行选择接收哪些通知。
本页列出的所有功能均专为 DiscBridge Free 设计,适用于单服务器版的 MailboxGUI 部署。
版本支持
| 平台 |
Minecraft 版本 |
存储方式 |
语言 |
| Paper • Spigot • Purpur • Bukkit |
1.18.2–26.3 |
偏好设置和待处理通知使用本地 YAML 文件 |
English • German • Spanish • French • Italian • Japanese • Korean • Dutch • Polish • Brazilian Portuguese • Russian • Swedish • Ukrainian • Simplified Chinese • Traditional Chinese • Hong Kong Traditional Chinese |
DiscBridge 发布版本支持
| DiscBridge 版本 |
支持状态 |
升级信息 |
| 1.0.0–1.1.1 |
不再支持 |
如果遇到任何问题或需要技术支持,请升级至配合 MailboxGUI 6.1.0 Free 使用的 DiscBridge 2.1.0 Free。 |
| 2.0.0+ |
受支持 |
请使用下方对应的 MailboxGUI 版本。对于本页所列的功能,请更新至 DiscBridge 2.1.0 Free 和 MailboxGUI 6.1.0 Free。更新前请备份插件文件夹及 MailboxGUI 的数据库。 |
DiscBridge 发布版本兼容性
| DiscBridge 版本 |
所需 MailboxGUI 版本 |
部署说明 |
| 2.1.0 Free |
6.1.0 Free |
单服务器;DiscBridge、MailboxGUI 和 DiscordSRV 需部署在同一后端。 |
| 2.0.0 Free |
6.0.0 Free |
本页列出的功能与此组合存在差异。请使用 DiscBridge wiki 并选择 Wiki 版本 2.0.0 以查看其功能与部署说明。 |
功能 - v2.1.0
Discord 邮件通知
- 纸质信件和书籍信件的私信通知。
- 包裹和金钱邮件通知,包括附带消息。
- 货到付款(COD)包裹通知。
- COD 物品货币支付及退回的 COD 包裹通知。
- 针对设有过期日期的邮件,提供具备过期提醒功能的消息。
- 可配置的 Discord 消息模板和占位符。
- 管理员和 API 群发邮件频道公告。
- 可选的用于群发邮件的排队私信功能。
- 持久化的通知发件箱,支持重试和重启恢复已接受的任务。
玩家通知控制
- 启用或禁用 Discord 邮件通知。
- 选择是否在在线期间接收私信。
- 忽略或取消忽略特定发件人。
- 管理管理员/服务器邮件的私信偏好设置。
- 选择 Discord 通知消息的语言。
- 检查通知设置和 Discord 账号绑定状态。
- 通过 MailboxGUI 直接访问 Discord 设置和设置指南。
游戏内消息遵循 MailboxGUI 的语言和客户端区域设置。Discord 私信使用玩家选择的 Discord 语言,若未选择则回退到 MailboxGUI 的默认语言。频道公告使用 MailboxGUI 的默认语言。
DiscBridge 的命令已集成至 MailboxGUI 中,并继承其命令语法的区域设置。在启动前,请在 MailboxGUI 的 config.yml 中设置 locale.command-syntax.default,以便注册带有本地化根命令的英文命令。帮助和自动补全功能支持本地化语法。更改已注册的命令根节点需要重启服务器。
命令与权限
玩家命令
所有玩家命令均需具备 mailboxgui.player.use 和 mailboxgui.player.discord 权限。可在 DiscBridge 的 config.yml 中启用 player-commands.enabled,或在通过设置检查后使用 /mba discord playercommands on。集成的权限会提供 mailboxguidiscbridge.use;以下额外的偏好设置权限默认处于启用状态。
| 命令 |
额外权限 |
要求 / 操作 |
/mb settings discord |
无额外权限 |
显示 Discord 通知帮助信息。 |
/mb settings discord guide |
无额外权限 |
打开账号绑定和通知设置指南。 |
/mb settings discord status |
无额外权限 |
检查通知设置和账号绑定状态。 |
/mb settings discord enable / /mb settings discord disable |
无额外权限 |
启用或禁用 Discord 邮件通知。 |
/mb settings discord online <on/off> |
mailboxguidiscbridge.online |
控制在线期间的私信接收。 |
/mb settings discord language <language> |
无额外权限 |
选择用于 Discord 通知的语言。 |
/mb settings discord ignore <player> / /mb settings discord unignore <player> |
mailboxguidiscbridge.ignore |
忽略或允许某玩家的 notifications。 |
/mb settings discord ignorelist |
mailboxguidiscbridge.ignore |
查看被忽略的发件人列表。 |
/mb settings discord ignoreadmin / /mb settings discord unignoreadmin |
mailboxguidiscbridge.ignoreadmin |
控制单个管理员/服务器邮件的私信接收。 |
管理员命令
mailboxgui.admin.discord 授予对 DiscBridge 管理的集成访问权限。作为替代方案,可使用 mailboxguidiscbridge.admin 配合下方所示的具体操作权限。玩家还需要 mailboxgui.player.use 才能使用 MailboxGUI 的命令根节点。
| 命令 |
DiscBridge 操作权限 |
要求 / 作用 |
/mba discord |
mailboxguidiscbridge.admin |
显示 DiscBridge 管理员帮助。 |
/mba discord status |
mailboxguidiscbridge.admin.status |
查看插件和 DiscordSRV 的准备就绪状态。 |
/mba discord reload |
mailboxguidiscbridge.admin.reload |
重新加载配置和消息模板。 |
/mba discord playercommands <on/off> |
mailboxguidiscbridge.admin.playercommands |
启用或禁用玩家控制;启用前需通过设置准备检查。 |
/mba discord updatecheck |
mailboxguidiscbridge.admin.update |
检查更新;需要联网。 |
/mba discord update |
mailboxguidiscbridge.admin.update |
开始更新流程;重启以加载已暂存的更新。 |
这些示例使用英文语法,该语法始终可用。权限控制命令访问权;链接的账户、通知偏好、机器人连接性和 Discord 投递设置仍然适用于实际通知。
如需完整的命令和权限列表,请参阅官方 Wiki。
安装
要求
- DiscBridge 2.1.0 Free 需要 MailboxGUI 6.1.0 Free 和 DiscordSRV。
- 在同一个受支持的 Spigot、Paper 或 Purpur 服务器上安装这三个插件。
- 插件字节码需要 Java 17 或更高版本。请使用你的 Minecraft 服务器版本所需的 Java 运行时环境。
- Discord 通知需要一个已配置的 DiscordSRV 机器人和互联网访问权限。不支持 Folia。
基本设置
- 安装 MailboxGUI 和 DiscordSRV。
- 将 DiscBridge jar 文件放入服务器的
plugins 文件夹中。
- 启动服务器以生成文件,然后停止服务器并查看
plugins/MailboxGUI-DiscBridge/config.yml。
- 配置 DiscordSRV 并再次启动服务器。
- 检查
/mba discord status,当设置准备好时,使用 /mba discord playercommands on 启用玩家控制。
- 玩家可以使用
/mb settings discord guide 进行账户链接和通知设置。
对于升级,请备份 DiscBridge 和 MailboxGUI 文件夹以及 MailboxGUI 的数据库。保留现有的玩家偏好和待处理通知文件。
依赖项
这两个插件都是必需的。DiscBridge 是 MailboxGUI 的附加组件,本身不发送游戏内邮件。
| 插件 |
要求 / 用途 |
下载 |
| MailboxGUI Free |
6.1.0 Free 版本为 DiscBridge 2.1.0 Free 提供邮件系统和投递事件。 |
Modrinth 上的 MailboxGUI |
| DiscordSRV |
通过你配置的 Discord 机器人提供 Discord 连接性和账户链接。 |
从 Modrinth 下载 DiscordSRV。 |
玩家必须通过 DiscordSRV 链接他们的 Minecraft 和 Discord 账户才能接收私信,并且他们的 Discord 设置必须允许投递。Discord 通知需要一个连接的机器人和互联网访问权限。
限时优惠券优惠 — 高级捆绑包节省约 74% + 免费资源包优惠
重要提示: DiscBridge Premium 是 MailboxGUI Premium 网络设置的配套组件。只有在你需要网络功能时才选择 Premium。对于单服务器设置,请使用 MailboxGUI Free + DiscBridge Free。
DiscBridge Free 无法与 MailboxGUI Premium 配合使用。 MailboxGUI 和 DiscBridge 的版本必须匹配:Free + Free 或 Premium + Premium。无论哪种 DiscBridge 版本都需要 DiscordSRV。
可选的 MailboxGUI Resource Pack 在一个捆绑包中支持 MailboxGUI Free 和 Premium。它自定义了 MailboxGUI 的外观,可以单独获取,不包含在 DiscBridge Free 下载中。两个 Free 插件都可以在不使用它的情况下使用。
有关 Premium 版本和可选资源包的更多信息,请访问 ImagineCraft Plugins 网站。
不需要网络?使用 MailboxGUI Free + DiscBridge Free,并使用优惠券代码 RESOURCE 为你的 Free 设置获取 MailboxGUI Resource Pack — 免费!
使用代码 LAUNCH 可节省约 74% 的全套捆绑包:MailboxGUI Premium 50% 折扣 + DiscBridge Premium 免费 + Resource Pack 免费。
两项优惠均于 2026 年 11 月 1 日太平洋时间凌晨 12:00 结束。两种优惠券代码届时失效,之后无法使用。
账户和优惠券支持
如果在创建账户、使用优惠券代码或验证电子邮件方面遇到问题,请加入 Support Discord 服务器 并在 ?︱license-support 中寻求帮助。
支持
QQ: 中文支持 · QQ 交流群
无法访问 Discord,或需要中文帮助?欢迎加入 ImagineCraft 插件 QQ 交流群,咨询插件使用、配置及问题反馈。
QQ群号:101849876 · 群内联系人:AFK·落子无悔
贡献者
- nice — 简体中文和香港繁体中文翻译。
- De4d__ — 巴西葡萄牙语翻译。
想要做出贡献?加入 Discord support server 并在 Plugin Discussion 中发帖。Rismr1 会回复你。欢迎提交翻译贡献、错误报告和功能建议!

DiscBridge is an addon for MailboxGUI that connects 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.
Version Support
| Platforms |
Minecraft Version |
Storage |
Languages |
| Paper • Spigot • Purpur • Bukkit |
1.18.2–26.3 |
Local YAML files for preferences and pending notifications |
English • German • Spanish • French • Italian • Japanese • Korean • Dutch • Polish • Brazilian Portuguese • Russian • Swedish • Ukrainian • Simplified Chinese • Traditional Chinese • Hong Kong Traditional Chinese |
DiscBridge Release Support
| DiscBridge Version |
Support Status |
Upgrade Information |
| 1.0.0–1.1.1 |
Unsupported |
Upgrade to DiscBridge 2.1.0 Free with MailboxGUI 6.1.0 Free if you encounter issues or need support. |
| 2.0.0+ |
Supported |
Use the matching MailboxGUI version below. For the features listed on this page, update to DiscBridge 2.1.0 Free and MailboxGUI 6.1.0 Free. Back up plugin folders and MailboxGUI's database before updating. |
DiscBridge Release Compatibility
| DiscBridge Version |
Required MailboxGUI Version |
Setup |
| 2.1.0 Free |
6.1.0 Free |
Single server; DiscBridge, MailboxGUI, and DiscordSRV on the same backend. |
| 2.0.0 Free |
6.0.0 Free |
Features listed on this page differ from this combination. Use the DiscBridge wiki and select wiki version 2.0.0 for its features and setup. |
Features - v2.1.0
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.
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
All player commands require mailboxgui.player.use and mailboxgui.player.discord. Enable player-commands.enabled in DiscBridge's config.yml, or use /mba discord playercommands on after setup checks pass. The integrated permission supplies mailboxguidiscbridge.use; the additional preference permissions below are enabled by default.
| Command |
Additional Permission |
Requirement / Action |
/mb settings discord |
No additional permission |
Show Discord notification help. |
/mb settings discord guide |
No additional permission |
Open the account-linking and notification setup guide. |
/mb settings discord status |
No additional permission |
Check notification settings and account link status. |
/mb settings discord enable / /mb settings discord disable |
No additional permission |
Enable or disable Discord mail notifications. |
/mb settings discord online <on/off> |
mailboxguidiscbridge.online |
Control direct messages while online. |
/mb settings discord language <language> |
No additional permission |
Choose the language used for Discord notifications. |
/mb settings discord ignore <player> / /mb settings discord unignore <player> |
mailboxguidiscbridge.ignore |
Ignore or allow a player's notifications. |
/mb settings discord ignorelist |
mailboxguidiscbridge.ignore |
View ignored senders. |
/mb settings discord ignoreadmin / /mb settings discord unignoreadmin |
mailboxguidiscbridge.ignoreadmin |
Control individual admin/server mail direct messages. |
Admin Commands
mailboxgui.admin.discord grants integrated access to DiscBridge administration. As an alternative, use mailboxguidiscbridge.admin together with the action-specific permission shown below. Players also need mailboxgui.player.use for the MailboxGUI command root.
| Command |
DiscBridge Action Permission |
Requirement / Action |
/mba discord |
mailboxguidiscbridge.admin |
Show DiscBridge admin help. |
/mba discord status |
mailboxguidiscbridge.admin.status |
View plugin and DiscordSRV readiness status. |
/mba discord reload |
mailboxguidiscbridge.admin.reload |
Reload configuration and message templates. |
/mba discord playercommands <on/off> |
mailboxguidiscbridge.admin.playercommands |
Enable or disable player controls; enabling requires setup readiness checks to pass. |
/mba discord updatecheck |
mailboxguidiscbridge.admin.update |
Check for updates; requires internet access. |
/mba discord update |
mailboxguidiscbridge.admin.update |
Begin the update workflow; restart to load a staged update. |
These examples use English syntax, which is always available. Permissions control command access; linked accounts, notification preferences, bot connectivity, and Discord delivery settings still apply to actual notifications.
For the full command and permission list, use the official wiki.
Installation
Requirements
- MailboxGUI 6.1.0 Free and DiscordSRV are required for DiscBridge 2.1.0 Free.
- Install all three plugins on the same supported Spigot, Paper, or Purpur server.
- Plugin bytecode requires Java 17 or newer. Use the Java runtime required by your Minecraft server version.
- A configured DiscordSRV bot and internet access are required for Discord notifications. Folia support is not included.
Basic Setup
- Install MailboxGUI and DiscordSRV.
- Place the DiscBridge jar in your server's
plugins folder.
- Start the server to generate files, then stop it and review
plugins/MailboxGUI-DiscBridge/config.yml.
- Configure DiscordSRV and start the server again.
- Check
/mba discord status, then enable player controls with /mba discord playercommands on when setup is ready.
- 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
Both plugins are required. DiscBridge is a MailboxGUI addon and does not send in-game mail itself.
| Plugin |
Requirement / Purpose |
Download |
| MailboxGUI Free |
Version 6.1.0 Free provides the mail system and delivery events for DiscBridge 2.1.0 Free. |
MailboxGUI on Modrinth |
| DiscordSRV |
Provides Discord connectivity and account linking through your configured Discord bot. |
Download DiscordSRV on Modrinth. |
Players must link their Minecraft and Discord accounts through DiscordSRV to receive direct messages, and their Discord settings must allow delivery. Discord notifications require a connected bot and internet access.
Limited-Time Coupon Offers — Save About 74% on the Premium Bundle + FREE Resource Pack Offer
Important: DiscBridge Premium is the companion for MailboxGUI Premium network setups. Only choose Premium if you need networking. For single-server setups, use MailboxGUI Free + DiscBridge Free.
DiscBridge Free does not work with MailboxGUI Premium. MailboxGUI and DiscBridge editions must match: Free + Free or Premium + Premium. DiscordSRV is required for either DiscBridge edition.
The optional MailboxGUI Resource Pack supports both MailboxGUI Free and Premium in one bundle. It customizes MailboxGUI appearances, is available separately, and is not included with the DiscBridge Free download. Both Free plugins can be used without it.
More information about the Premium editions and optional resource pack is available on the ImagineCraft Plugins website.
Don't need networking? Use MailboxGUI Free + DiscBridge Free and coupon code RESOURCE to get the MailboxGUI Resource Pack for your Free setup — FREE!
Use code LAUNCH to save about 74% on the complete bundle: 50% off MailboxGUI Premium + DiscBridge Premium FREE + Resource Pack FREE.
Both offers end Nov 1, 2026, 12:00 AM PDT. Both coupon codes expire at that time and cannot be used afterward.
Account and Coupon Support
If you have trouble creating an account, using your coupon codes, or verifying your email, join the Support Discord server and ask for help in ?︱license-support.
Support
QQ: 中文支持 · QQ 交流群
无法访问 Discord,或需要中文帮助?欢迎加入 ImagineCraft 插件 QQ 交流群,咨询插件使用、配置及问题反馈。
QQ群号:101849876 · 群内联系人:AFK·落子无悔
Contributors
- nice — Simplified Chinese and Hong Kong Traditional Chinese translations.
- De4d__ — Brazilian Portuguese translation.
Want to contribute? Join the Discord support server and post in Plugin Discussion. Rismr1 will respond to you. Translation contributions, bug reports, and feature suggestions are welcome!
评论 0
登录后参与评分
还没有评论,来抢沙发吧