Discord 聊天集成

Discord 聊天集成

将你的Minecraft聊天带入Discord。无需机器人即可在Discord与Minecraft之间收发消息和命令。

社交

Discord-Chat-Integration-Banner

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 插件和模组均需安装。

使用方法

快速开始指南

  1. 启动已安装模组的 Minecraft
  2. 加入一个世界或服务器
  3. 打开已启用 Discord 插件的 Discord
  4. 插件将自动连接(如果启用了“自动连接”且端口号匹配)
  5. 在配置的 Discord 频道中发送消息/命令,它们将出现在 Minecraft 聊天中/被执行
  6. 在 Discord 中接收消息或命令反馈(如果启用了“转发到 Discord”)

设置与配置

快速访问设置

quick access setttings

插件启用后,聊天输入框旁边会出现一个齿轮图标。点击它即可快速访问 Minecraft Chat 设置,无需浏览 Discord 的设置菜单。当至少有一个客户端连接时,该图标会变为绿色。


添加 Minecraft 客户端

  1. 在快速访问菜单中点击 “Add Client”

  2. 配置每个客户端:

    • Name:此客户端的友好名称
    • Port:WebSocket 端口
    • Channel ID:要与此客户端桥接的 Discord 频道 ID
    • Enabled:用于启用/禁用此客户端连接的开关
    • Forward to Discord:用于启用/禁用将 Minecraft 聊天转发到 Discord 的开关
    • Sync Group:将客户端分配到同步组以实现 tick 级精确同步
  3. 获取频道 ID:

    • 在 Discord 中启用开发者模式(用户设置 → 高级 → 开发者模式)
    • 右键点击你想使用的频道
    • 点击“复制频道 ID”
    • 粘贴到插件设置中

多客户端设置

[IMPORTANT] 不同的 Minecraft 客户端不能共享同一端口,你可以通过命令更改端口。

你可以运行多个 Minecraft 客户端,每个客户端连接到不同或共享的 Discord 频道:

不同频道:

  1. 客户端 1:端口 25580 → Discord 频道 123456789
  2. 客户端 2:端口 25581 → Discord 频道 987654321
  3. 客户端 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。

使用方法:

  1. 在插件设置中启用“高级功能”
  2. 点击聊天栏齿轮图标打开设置
  3. 开启“聊天延迟”以开始排队消息
  4. 点击“Send Queue”一次性释放所有排队消息

同步组

将多个 Minecraft 客户端分配到同步组(A-F),以实现 tick 级精确的消息执行。当同一同步组中的客户端接收到消息时,如果分配到同一 Discord 频道或使用聊天延迟,它们将在完全相同的服务器游戏 tick 上执行。

配置方法:

  1. 在插件设置中启用“高级功能”
  2. 在客户端配置中,设置每个客户端的“Sync Group”(A-F 或 None)
  3. “None”会禁用该客户端的同步

自动化

创建基于触发器的自动化规则,当 Minecraft 聊天中出现特定消息时执行操作。

配置方法:

  1. 在插件设置中启用“高级功能”
  2. 点击聊天栏齿轮图标 →“Automations”部分
  3. 点击“+ Add Automation”创建新规则
  4. 配置:
    • 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 上执行时,此命令尤其有用。