
聊天同步
将客户端 Minecraft 聊天同步到 Discord webhook。
查看大图ChatSync - Minecraft 到 Discord 聊天同步
一个适用于 Minecraft 1.21.10 的客户端 Fabric 模组,可将游戏内聊天消息同步到 Discord webhook。
功能特性
- 🔄 同时将聊天消息和游戏消息同步到 Discord
- 🎯 可通过正则表达式配置消息过滤
- ⚙️ 简单的 JSON 配置
- 🎮 通过 Mod Menu 提供游戏内配置界面
- 🚀 异步发送 webhook(不会造成游戏卡顿)
- 🔒 仅客户端(可在任意服务器上使用)
安装
- 确保你已为 Minecraft 1.21.10 安装 Fabric Loader
- 安装 Mod Menu(可选,但游戏内配置需要用到)
- 下载 ChatSync 模组 JAR 文件
- 将其放入你的
.minecraft/mods文件夹 - 启动 Minecraft
配置
你可以通过两种方式配置 ChatSync:
方式 1:游戏内配置界面(推荐)
- 安装 Mod Menu
- 在 Minecraft 中,前往:Mods → ChatSync → Config
- 输入你的 Discord webhook URL
- 自定义消息前缀
- 切换启用/禁用状态
- 点击 "Done" 保存
方式 2:手动配置文件
首次启动时,模组会在 .minecraft/config/chatsync.json 创建配置文件
设置你的 Discord Webhook
- 前往你的 Discord 服务器设置
- 导航到 Integrations → Webhooks
- 点击 "New Webhook"
- 复制 webhook URL
- 打开
.minecraft/config/chatsync.json - 将
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 事件:
- 聊天消息:玩家聊天消息
- 游戏消息:系统消息(死亡、成就等)
当收到消息时,它会:
- 检查模组是否已启用
- 检查 webhook URL 是否已配置
- 检查消息是否匹配任何忽略模式
- 如果所有检查均通过,则异步将消息发送到 Discord
故障排除
消息未出现在 Discord 中
- 检查配置文件中的 webhook URL 是否正确
- 确保
enabled设置为true - 检查 Minecraft 日志中是否有任何错误消息
- 确认你的 webhook 在 Discord 中仍然有效
部分消息被忽略
检查你的 ignoredMessages 模式——它们使用正则表达式,因此请确保模式正确。
模组未加载
- 确保你有 Fabric Loader 0.18.4 或更高版本
- 确保你有 Fabric API 0.138.4+1.21.10 或更高版本
- 检查 Minecraft 日志中是否有错误
许可证
本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。
支持
加入我们的 discord!Discord
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。