
Discord 聊天集成
将你的Minecraft聊天带入Discord。无需机器人即可在Discord与Minecraft之间收发消息和命令。
Discord Chat Integration
将你的 Minecraft 聊天带入 Discord,并提供额外的自动化功能。无需机器人即可在 Discord 中发送消息/命令并监听 Minecraft。
功能说明
此模组通过本地 WebSocket 连接在 Discord 与 Minecraft 之间架起桥梁,让你无需任何机器人即可直接从 Discord 向 Minecraft 发送消息并执行命令。它还包含其他高级功能,例如聊天延迟和自动化。
- 无机器人 Discord 集成 - 无需设置 Discord 机器人;使用 Vencord 或 BetterDiscord 插件
- 双向聊天 - 从 Discord 向 Minecraft 发送消息/命令,并在 Discord 中接收聊天反馈
- 多客户端支持 - 通过单个 Discord 界面控制多个 Minecraft 客户端
- 同步组 - 在多个 Minecraft 客户端之间实现 tick 级精确同步
- 聊天延迟 - 排队并批量发送消息
- 自动化 - 创建基于触发器的规则,在 Minecraft 聊天事件发生时执行操作
安装 Discord 插件
[IMPORTANT] Discord 插件和模组均需安装。
使用方法
快速开始指南
- 启动已安装模组的 Minecraft
- 加入一个世界或服务器
- 打开已启用 Discord 插件的 Discord
- 插件将自动连接(如果启用了“自动连接”且端口号匹配)
- 在配置的 Discord 频道中发送消息/命令,它们将出现在 Minecraft 聊天中/被执行
- 在 Discord 中接收消息或命令反馈(如果启用了“转发到 Discord”)
设置与配置
快速访问设置
插件启用后,聊天输入框旁边会出现一个齿轮图标。点击它即可快速访问 Minecraft Chat 设置,无需浏览 Discord 的设置菜单。当至少有一个客户端连接时,该图标会变为绿色。
添加 Minecraft 客户端
在快速访问菜单中点击 “Add Client”
配置每个客户端:
- Name:此客户端的友好名称
- Port:WebSocket 端口
- Channel ID:要与此客户端桥接的 Discord 频道 ID
- Enabled:用于启用/禁用此客户端连接的开关
- Forward to Discord:用于启用/禁用将 Minecraft 聊天转发到 Discord 的开关
- Sync Group:将客户端分配到同步组以实现 tick 级精确同步
获取频道 ID:
- 在 Discord 中启用开发者模式(用户设置 → 高级 → 开发者模式)
- 右键点击你想使用的频道
- 点击“复制频道 ID”
- 粘贴到插件设置中
多客户端设置
[IMPORTANT] 不同的 Minecraft 客户端不能共享同一端口,你可以通过命令更改端口。
你可以运行多个 Minecraft 客户端,每个客户端连接到不同或共享的 Discord 频道:
不同频道:
- 客户端 1:端口
25580→ Discord 频道123456789 - 客户端 2:端口
25581→ Discord 频道987654321 - 客户端 3:端口
25582→ Discord 频道555555555
共享频道: 多个客户端可以分配到同一个 Discord 频道。此时:
- 来自 Discord 的消息会发送到分配到该频道的所有 Minecraft 客户端
- 转发到 Discord 的消息会包含
[Client Name]标签以标识来源 - 如果多个客户端处于同一同步组,消息/命令将在同一服务器 tick 上发送
更多配置可在 用户设置 → Vencord/BetterDiscord → 插件 → MinecraftChat 中找到
| 设置 | 描述 | 默认值 |
|---|---|---|
| Auto Connect | Discord 启动时自动连接到所有已启用的客户端 | true |
| Advanced Features | 启用高级功能(聊天延迟、同步组、自动化) | false |
| Connection Logging Channel | 发布连接/断开事件所在的 Discord 频道 ID(留空则禁用) | 空 |
| Enable Console Logging | 将插件调试消息记录到浏览器控制台(DevTools F12) | true |
Minecraft 模组配置
此模组使用默认端口 25580。你可以使用游戏内命令更改它:
/discordchat port <port_number>
端口必须介于 1024 和 65535 之间,并且与 Discord 中配置的客户端设置匹配。
高级功能
在插件设置中启用高级功能,以解锁强大的自动化和同步能力。可通过聊天栏齿轮图标访问这些功能。
聊天延迟
将来自 Discord 的消息排队,并在同一游戏 tick 一次性发送到 Minecraft。
使用方法:
- 在插件设置中启用“高级功能”
- 点击聊天栏齿轮图标打开设置
- 开启“聊天延迟”以开始排队消息
- 点击“Send Queue”一次性释放所有排队消息
同步组
将多个 Minecraft 客户端分配到同步组(A-F),以实现 tick 级精确的消息执行。当同一同步组中的客户端接收到消息时,如果分配到同一 Discord 频道或使用聊天延迟,它们将在完全相同的服务器游戏 tick 上执行。
配置方法:
- 在插件设置中启用“高级功能”
- 在客户端配置中,设置每个客户端的“Sync Group”(A-F 或 None)
- “None”会禁用该客户端的同步
自动化
创建基于触发器的自动化规则,当 Minecraft 聊天中出现特定消息时执行操作。
配置方法:
- 在插件设置中启用“高级功能”
- 点击聊天栏齿轮图标 →“Automations”部分
- 点击“+ Add Automation”创建新规则
- 配置:
- Name:标识你的自动化
- Enabled:用于激活/停用的开关
- Listen to:选择哪些 Minecraft 客户端触发此自动化
- Trigger:要在 Minecraft 聊天中匹配的文本
- Absolute Match:如果勾选,消息必须与触发器完全匹配(区分大小写)
- Cooldown:两次触发之间的最小毫秒数
- Actions:触发时要执行的操作
可用操作:
- Send to Minecraft:向选定的客户端发送消息/命令
- Send to Discord:向配置的日志频道发布消息
- Enable Chat Delay:开启消息排队
- Disable Chat Delay:关闭排队并发送所有排队消息
- Wait:下一个操作前的延迟毫秒数
命令
此模组提供 /discordchat 命令,包含以下子命令:
/discordchat 或 /discordchat status
显示当前连接状态:
- 服务器状态(Running/Stopped)
- 当前端口
- 已连接客户端数量
/discordchat port <number>
更改 WebSocket 服务器端口。必须介于 1024 和 65535 之间。
/discordchat reconnect
重启 WebSocket 服务器。
/discordchat disconnect
停止 WebSocket 服务器并断开所有 Discord 客户端。使用 /discordchat reconnect 重新连接。
/discordchat ticktest
显示 tick 同步诊断信息。适用于调试同步组并验证 tick 级精确执行。
显示:
- 玩家名称
- 当前服务器 tick
- 客户端时间(毫秒)
- 网络延迟
- 当前同步组分配
- 上次同步执行详情(目标 tick、执行 tick、时序)
在使用同步组验证来自多个客户端的消息是否在正确的游戏 tick 上执行时,此命令尤其有用。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。