聊天同步

聊天同步

将客户端 Minecraft 聊天同步到 Discord webhook。

社交

ChatSync - Minecraft 到 Discord 聊天同步

一个适用于 Minecraft 1.21.10 的客户端 Fabric 模组,可将游戏内聊天消息同步到 Discord webhook。

功能特性

  • 🔄 同时将聊天消息和游戏消息同步到 Discord
  • 🎯 可通过正则表达式配置消息过滤
  • ⚙️ 简单的 JSON 配置
  • 🎮 通过 Mod Menu 提供游戏内配置界面
  • 🚀 异步发送 webhook(不会造成游戏卡顿)
  • 🔒 仅客户端(可在任意服务器上使用)

安装

  1. 确保你已为 Minecraft 1.21.10 安装 Fabric Loader
  2. 安装 Mod Menu(可选,但游戏内配置需要用到)
  3. 下载 ChatSync 模组 JAR 文件
  4. 将其放入你的 .minecraft/mods 文件夹
  5. 启动 Minecraft

配置

你可以通过两种方式配置 ChatSync:

方式 1:游戏内配置界面(推荐)

  1. 安装 Mod Menu
  2. 在 Minecraft 中,前往:Mods → ChatSync → Config
  3. 输入你的 Discord webhook URL
  4. 自定义消息前缀
  5. 切换启用/禁用状态
  6. 点击 "Done" 保存

方式 2:手动配置文件

首次启动时,模组会在 .minecraft/config/chatsync.json 创建配置文件

设置你的 Discord Webhook

  1. 前往你的 Discord 服务器设置
  2. 导航到 Integrations → Webhooks
  3. 点击 "New Webhook"
  4. 复制 webhook URL
  5. 打开 .minecraft/config/chatsync.json
  6. 将 YOUR_WEBHOOK_URL_HERE 替换为你的实际 webhook URL

配置文件结构

{
  "webhookUrl": "https://discord.com/api/webhooks/YOUR_WEBHOOK_URL_HERE",
  "enabled": true,
  "messagePrefix": "> ",
  "ignoredMessages": [
    "^\\[.*\\].*",
    "^>.*"
  ]
}

配置选项

  • webhookUrl:你的 Discord webhook URL
  • enabled:设为 false 可临时禁用模组而无需移除它
  • messagePrefix:添加到每条消息前的文本(默认:"> ")
    • 使用 "" 表示无前缀
    • 示例:"> "、"[MC] "、"🎮 " 等
  • ignoredMessages:用于忽略消息的正则表达式模式数组

忽略消息示例

ignoredMessages 数组使用正则表达式模式来过滤不需要的消息:

"ignoredMessages": [
  "^\\[.*\\].*",           // 忽略以 [方括号] 开头的消息
  "^>.*",                  // 忽略以 > 开头的消息
  ".*joined the game.*",   // 忽略加入游戏消息
  ".*left the game.*",     // 忽略离开游戏消息
  "^!.*",                  // 忽略以 ! 开头的命令
  "^/.*"                   // 忽略以 / 开头的命令
]

工作原理

模组监听两个 Minecraft 事件:

  • 聊天消息:玩家聊天消息
  • 游戏消息:系统消息(死亡、成就等)

当收到消息时,它会:

  1. 检查模组是否已启用
  2. 检查 webhook URL 是否已配置
  3. 检查消息是否匹配任何忽略模式
  4. 如果所有检查均通过,则异步将消息发送到 Discord

故障排除

消息未出现在 Discord 中

  1. 检查配置文件中的 webhook URL 是否正确
  2. 确保 enabled 设置为 true
  3. 检查 Minecraft 日志中是否有任何错误消息
  4. 确认你的 webhook 在 Discord 中仍然有效

部分消息被忽略

检查你的 ignoredMessages 模式——它们使用正则表达式,因此请确保模式正确。

模组未加载

  1. 确保你有 Fabric Loader 0.18.4 或更高版本
  2. 确保你有 Fabric API 0.138.4+1.21.10 或更高版本
  3. 检查 Minecraft 日志中是否有错误

许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。

支持

加入我们的 discord!Discord