DiscordGate
将你的 Minecraft 服务器通过 Discord 进行访问控制。只有已绑定的玩家才能加入。
由 BaxiBot 提供支持。
流程
- 玩家加入服务器 - 被踢出并获取验证码
- 在 Discord 中执行
/mc link <code> - BaxiBot 验证 - 加入白名单
- 玩家可以正常加入
功能
- Discord gated 白名单
- 兼容 Bedrock/Geyser
/dg(状态/验证码)、/dgunlink- 自动分配角色、公告频道、绑定时发送私信
- MC ↔ Discord 聊天桥接
- Velocity 独立支持
命令
游戏中
| 命令 | 权限 | 描述 |
|---|---|---|
/dg |
all | 状态/验证码 |
/dg unlink |
all | 解绑 |
/dg announce [--discord] <msg> |
admin | 广播 |
/dg reload / lock / unlock |
admin | 服务器控制 |
/dg admin link/unlink <player> |
admin | 手动绑定/解绑 |
Discord
/mc link <code> · /mc unlink · /mc status · /mc admin unlink/lookup <user>
设置 — Paper
port: 4321
bind-address: "0.0.0.0"
secret: "your-secret"
Dashboard → MC Link → API URL + secret → 启用。
设置 - Velocity
BaxiBot - Velocity :4321 → Backends
port=4321
bind-address=0.0.0.0
secret=your-secret
kick-message=<red>Not linked!</red> /mc link {token}
token-ttl-minutes=10
Backends: white-list=false, not internet-facing.
Cross-chat (Velocity network)
Needs both plugins. Same secret everywhere.
Each Paper backend:
chat-bridge-enabled: true
chat-relay-source: "paper"
Velocity:
chat-bridge-enabled=true
chat-relay-source=paper
Dashboard: enable cross-chat, set channel + webhook URL.
Troubleshooting
- No MC-Discord: check Paper log for 401 (secret mismatch)
- No Discord→MC: dashboard API URL not pointing at Velocity
- Duplicate messages:
chat-relay-sourcemissing on Velocity
Requirements
- Paper 1.21.1+ or Velocity 3.3+ (with Paper backend)
- BaxiBot in your Discord server
DiscordGate
Gate your Minecraft server behind Discord. Only linked players can join.
Powered by BaxiBot.
Flow
- Player joins - kicked with code
/mc link <code>in Discord- Baxi verifies - whitelisted
- Player can join normally
Features
- Discord-gated whitelist
- Bedrock/Geyser compatible
/dg(status/code),/dgunlink- Auto-role, announce channel, DM on link
- MC ↔ Discord chat bridge
- Velocity standalone support
Commands
In-game
| Command | Perm | Description |
|---|---|---|
/dg |
all | Status/code |
/dg unlink |
all | Unlink |
/dg announce [--discord] <msg> |
admin | Broadcast |
/dg reload / lock / unlock |
admin | Server control |
/dg admin link/unlink <player> |
admin | Manual link |
Discord
/mc link <code> · /mc unlink · /mc status · /mc admin unlink/lookup <user>
Setup — Paper
port: 4321
bind-address: "0.0.0.0"
secret: "your-secret"
Dashboard → MC Link → API URL + secret → enable.
Setup - Velocity
BaxiBot - Velocity :4321 → Backends
port=4321
bind-address=0.0.0.0
secret=your-secret
kick-message=<red>Not linked!</red> /mc link {token}
token-ttl-minutes=10
Backends: white-list=false, not internet-facing.
Cross-chat (Velocity network)
Needs both plugins. Same secret everywhere.
Each Paper backend:
chat-bridge-enabled: true
chat-relay-source: "paper"
Velocity:
chat-bridge-enabled=true
chat-relay-source=paper
Dashboard: enable cross-chat, set channel + webhook URL.
Troubleshooting
- No MC-Discord: check Paper log for 401 (secret mismatch)
- No Discord→MC: dashboard API URL not pointing at Velocity
- Duplicate messages:
chat-relay-sourcemissing on Velocity
Requirements
- Paper 1.21.1+ or Velocity 3.3+ (with Paper backend)
- BaxiBot in your Discord server
下载 DiscordGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 DiscordGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 DiscordGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 DiscordGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 DiscordGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 DiscordGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 DiscordGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 DiscordGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 DiscordGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 DiscordGate
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
未发布版本 — 冻结而非踢出
⚠️ 更新前必读
与服务器解绑的玩家在加入时不再被踢出。在 Paper 上,他们将留在服务器上并被冻结,直到完成绑定。Paper config.yml 中的 kick-message 已移除——由 freeze-* 相关配置项取代(残留的 kick-message 将被忽略)。Velocity 仍会执行踢出操作,除非你设置了 limbo-server(见下文)。
新增
- 冻结而非踢出(Paper)。 未绑定的玩家可以加入并环顾四周,但无法移动、建造、破坏、战斗、拾取物品、聊天或运行命令(
/dg仍然可用),且不会受到伤害。一旦绑定成功——无论是通过 Discord、API 还是/dg admin link——玩家将被解除冻结并获得常规欢迎信息。 - 提示操作步骤。 通过聊天消息、标题栏和重复显示的动作栏提供链接代码。聊天消息每
freeze-reminder-seconds秒(默认 30)重复一次。 - 一键绑定。 聊天消息中包含
https://<bot>/discordgate/<code>(点击即可打开浏览器,无需手动输入)。代码本身也可点击,点击后会自动复制/mc link <code>到剪贴板。link-url可覆盖默认地址;若同时未设置link-url和bot-api-url,则不显示链接行。 - 原版白名单不再隐藏提示。 当启用
white-list=true时,未绑定玩家之前会在收到绑定提示前被拒绝进入;现在他们会被允许进入并处于冻结状态(封禁和全服限制依然生效)。 - 解绑操作改为冻结而非踢出 —— 使用
/dg unlink、/dg admin unlink或/mc unlink会将在线玩家直接重新置于冻结状态,并生成新的代码。 - Velocity:
limbo-server。 代理服务器无法让玩家原地停留,因此未绑定玩家将被放置在你指定的 limbo 服务器(例如 NanoLimbo)上,并在该处接收相同的提示;绑定成功后,他们将被转发至limbo-return-server(默认:按优先级排序的第一个服务器)。若未设置limbo-server,代理仍会像以前一样执行踢出操作——但现在会附带可点击的链接文本——而不是让未绑定玩家进入真实服务器。
修复
- Velocity:默认的
kick-message/locked-message使用了双反斜杠,导致打印出字面量\n而非换行符。 - 对于未绑定玩家,
/dg命令会显示与冻结状态相同的提示(含链接)。
v1.5.1 — 链接代码修复
修复
- 链接代码在每次加入尝试中不再变化。 之前的机制是每次连接尝试都会生成新代码并使旧代码失效,导致玩家在踢出界面准备输入的代码可能已经过期——这引发了“代码不是实际代码”或“刚拿到就无效或过期”的报告。现在重新签发时将返回相同的代码,仅刷新其有效期,直到过期为止(由
token-ttl-minutes控制)。 {code}和{token}现在在两个平台上的kick-message中均被接受。此前 Paper 仅替换{code},Velocity 仅替换{token},因此跨平台复制配置文件会导致踢出界面显示字面占位符。- 失败的
GET /dg/token/{code}请求会被记录日志(Token lookup miss: <code> (N pending)),以便技术支持案例中能区分错误代码与从未到达服务器的机器人。
v1.5.0 — 状态面板与最新 Minecraft 支持
⚠️ 更新前必读
HTTP API 现在在 secret 仍为 CHANGE-ME 或为空时拒绝启动。任何知晓默认值的人都可能通过 /dg/whitelist 将自己加入白名单。请先设置一个真实的密钥——否则插件虽能加载,但 API 将保持离线状态。
新增
- 支持最新版 Minecraft。 基于 Paper 26.2 API 构建,最低兼容至 1.20.6。
GET /dg/stats—— 单次调用即可获取状态快照:在线状态、平台及 Minecraft 版本、运行时长、玩家数量、TPS/MSPT,以及 Velocity 各后端的玩家分布。- 兼容 ViaVersion。 报告哪些客户端版本可以实际连接。此功能在运行时检测——ViaVersion/ViaBackwards/ViaRewind 仍为可选组件。
- Discord 实时状态面板。 BaxiBot 会在你指定的频道中保持一个自动更新的嵌入卡片。可在仪表盘的 MC Link 部分进行设置。
/mc whois—— 查询某个 Minecraft 用户名对应的所有者,或某位成员关联的账号,包含皮肤头像。此命令对所有人开放,不同于/mc admin lookup。events-relay-source—— 加入/退出事件的转发不再依赖于chat-relay-source。若保持未设置,则维持现有行为。
修复
- 游戏内更新通知检查了一个未注册的权限(
discordgate.admin),导致只有 OP 才能看到——现已更正为dg.admin。 - API 服务器在每次
/reload时会泄漏两个线程。
内部改进
Paper 和 Velocity 现在共享同一套代码库用于链接存储、HTTP 处理和机器人调用,替代了之前两份几乎相同的副本。无行为变更——数据文件和所有端点均保持不变。
未发布版本 — 冻结而非踢出
⚠️ 更新前必读
与服务器解绑的玩家在加入时不再被踢出。在 Paper 上,他们将留在服务器上并被冻结,直到完成绑定。Paper config.yml 中的 kick-message 已移除——由 freeze-* 相关配置项取代(残留的 kick-message 将被忽略)。Velocity 仍会执行踢出操作,除非你设置了 limbo-server(见下文)。
新增
- 冻结而非踢出(Paper)。 未绑定的玩家可以加入并环顾四周,但无法移动、建造、破坏、战斗、拾取物品、聊天或运行命令(
/dg仍然可用),且不会受到伤害。一旦绑定成功——无论是通过 Discord、API 还是/dg admin link——玩家将被解除冻结并获得常规欢迎信息。 - 提示操作步骤。 通过聊天消息、标题栏和重复显示的动作栏提供链接代码。聊天消息每
freeze-reminder-seconds秒(默认 30)重复一次。 - 一键绑定。 聊天消息中包含
https://<bot>/discordgate/<code>(点击即可打开浏览器,无需手动输入)。代码本身也可点击,点击后会自动复制/mc link <code>到剪贴板。link-url可覆盖默认地址;若同时未设置link-url和bot-api-url,则不显示链接行。 - 原版白名单不再隐藏提示。 当启用
white-list=true时,未绑定玩家之前会在收到绑定提示前被拒绝进入;现在他们会被允许进入并处于冻结状态(封禁和全服限制依然生效)。 - 解绑操作改为冻结而非踢出 —— 使用
/dg unlink、/dg admin unlink或/mc unlink会将在线玩家直接重新置于冻结状态,并生成新的代码。 - Velocity:
limbo-server。 代理服务器无法让玩家原地停留,因此未绑定玩家将被放置在你指定的 limbo 服务器(例如 NanoLimbo)上,并在该处接收相同的提示;绑定成功后,他们将被转发至limbo-return-server(默认:按优先级排序的第一个服务器)。若未设置limbo-server,代理仍会像以前一样执行踢出操作——但现在会附带可点击的链接文本——而不是让未绑定玩家进入真实服务器。
修复
- Velocity:默认的
kick-message/locked-message使用了双反斜杠,导致打印出字面量\n而非换行符。 - 对于未绑定玩家,
/dg命令会显示与冻结状态相同的提示(含链接)。
v1.5.1 — 链接代码修复
修复
- 链接代码在每次加入尝试中不再变化。 之前的机制是每次连接尝试都会生成新代码并使旧代码失效,导致玩家在踢出界面准备输入的代码可能已经过期——这引发了“代码不是实际代码”或“刚拿到就无效或过期”的报告。现在重新签发时将返回相同的代码,仅刷新其有效期,直到过期为止(由
token-ttl-minutes控制)。 {code}和{token}现在在两个平台上的kick-message中均被接受。此前 Paper 仅替换{code},Velocity 仅替换{token},因此跨平台复制配置文件会导致踢出界面显示字面占位符。- 失败的
GET /dg/token/{code}请求会被记录日志(Token lookup miss: <code> (N pending)),以便技术支持案例中能区分错误代码与从未到达服务器的机器人。
v1.5.0 — 状态面板与最新 Minecraft 支持
⚠️ 更新前必读
HTTP API 现在在 secret 仍为 CHANGE-ME 或为空时拒绝启动。任何知晓默认值的人都可能通过 /dg/whitelist 将自己加入白名单。请先设置一个真实的密钥——否则插件虽能加载,但 API 将保持离线状态。
新增
- 支持最新版 Minecraft。 基于 Paper 26.2 API 构建,最低兼容至 1.20.6。
GET /dg/stats—— 单次调用即可获取状态快照:在线状态、平台及 Minecraft 版本、运行时长、玩家数量、TPS/MSPT,以及 Velocity 各后端的玩家分布。- 兼容 ViaVersion。 报告哪些客户端版本可以实际连接。此功能在运行时检测——ViaVersion/ViaBackwards/ViaRewind 仍为可选组件。
- Discord 实时状态面板。 BaxiBot 会在你指定的频道中保持一个自动更新的嵌入卡片。可在仪表盘的 MC Link 部分进行设置。
/mc whois—— 查询某个 Minecraft 用户名对应的所有者,或某位成员关联的账号,包含皮肤头像。此命令对所有人开放,不同于/mc admin lookup。events-relay-source—— 加入/退出事件的转发不再依赖于chat-relay-source。若保持未设置,则维持现有行为。
修复
- 游戏内更新通知检查了一个未注册的权限(
discordgate.admin),导致只有 OP 才能看到——现已更正为dg.admin。 - API 服务器在每次
/reload时会泄漏两个线程。
内部改进
Paper 和 Velocity 现在共享同一套代码库用于链接存储、HTTP 处理和机器人调用,替代了之前两份几乎相同的副本。无行为变更——数据文件和所有端点均保持不变。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧