HDiscord 聊天桥接

Hytale-Discord 聊天桥

实时同步你的 Hytale 服务器与 Discord！

🌟 简介

Hytale-Discord 聊天桥是一个强大的插件，可将你的 Hytale 服务器连接到 Discord，实现玩家与 Discord 成员之间的即时双向通信。即使他们身处不同平台，也能保持社区联系。

🔧 主要功能

💬 双向聊天同步

• 游戏消息自动显示在 Discord
• Discord 消息显示在游戏内聊天
• 可自定义前缀系统以识别消息来源

🎮 自动通知

• 玩家加入/离开服务器时实时提醒
• 服务器事件的可配置消息
• 可选地抑制默认服务器消息

🖼️ 完全自定义

• 服务器 webhook 的自定义头像
• 完全可配置的消息

🔧 技术特性

• 故障时自动重连
• 详细日志记录系统用于诊断
• 通过 JSON 文件简单配置

⚙️ 配置

1. 安装

1. 将 .jar 文件放入服务器 mods 文件夹
2. 重启服务器
3. 配置生成的 config.json 文件

2. 配置文件

{
  "botToken": "你的机器人令牌",
  "channelId": "DISCORD频道ID",
  "serverAvatarUrl": "服务器图片URL",
  "enableHytaleToDiscord": true,
  "enableDiscordToHytale": true,
  "discordMessagePrefix": "[Discord] ",
  "hytaleMessagePrefix": "[Hytale] ",
  "hytaleMessageFormat": "[Discord] %s: %s",
  "playerJoinMessage": "🎮 %s 加入了服务器！",
  "playerLeaveMessage": "👋 %s 离开了服务器！",
  "serverStartMessage": "🚀 服务器已启动！",
  "serverStopMessage": "🛑 服务器正在关闭... 我们马上回来！",
  "showJoinLeaveMessages": true,
  "suppressDefaultJoinMessages": true,
  "reconnectAttempts": 3,
  "reconnectDelayMs": 5000
}

3. 获取凭据

• Bot Token：在 Discord 开发者门户 创建机器人
• Channel ID：在 Discord 启用开发者模式并复制频道 ID
• Avatar：使用任何公共图片 URL（PNG、JPG、GIF）

🎯 好处

对于管理员

• 实时监控服务器活动
• 轻松与社区沟通
• 让每个人都了解重要事件

对于玩家

• 游玩时与 Discord 好友互动
• 查看谁在服务器上在线
• 即使不在游戏内也能参与讨论

对于社区

• 增强社区归属感
• 便于组织活动
• 保持每个人连接和参与

🛠️ 要求

• 具有适当权限的 Discord 机器人
• 用于同步的 Discord 文本频道

🔒 所需权限

你的 Discord 机器人需要以下权限：

• VIEW_CHANNEL - 查看频道
• SEND_MESSAGES - 发送消息
• MANAGE_WEBHOOKS - 管理 webhooks
• READ_MESSAGE_HISTORY - 阅读消息历史

📊 使用示例

安装并配置插件后：

1. 玩家在聊天中输入："大家好！"
2. 消息立即显示在 Discord 上，格式为：[Hytale] 玩家名：大家好！
3. Discord 成员回复："欢迎！"
4. 回复在游戏内显示为：[Discord] 用户名：欢迎！

🆘 支持和问题

如果遇到问题：

1. 检查服务器日志中的错误消息
2. 确认所有凭据正确
3. 使用已知头像 URL 测试
4. 在 Discord 上验证机器人权限

---

让你的 Hytale 社区与 Discord 世界保持联系！ 🚀