Chat Sync

模组

· 作者 sea4_18

将客户端的 Minecraft 聊天内容同步到 Discord Webhook。

0 本站下载 0 关注 更新于 8 个月前

需要前置:Fabric API

最新 1.0.0 · 1.21.11 · Fabric

一键开服(送7天)

ChatSync - Minecraft 至 Discord 聊天同步

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

功能特性

  • ? 同步聊天消息和游戏系统消息至 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 事件:

  • Chat Messages: 玩家聊天消息
  • Game Messages: 系统消息(死亡、成就等)

当收到消息时,它会:

  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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源