[Moonlight] Unify

Unify

Unify 是一个用于 Hytale 服务器的 Discord 聊天桥。 它将游戏内聊天与 Discord 频道连接起来，使玩家和社区成员能够跨平台自然交流。

简单、轻量，专注于做好一件事。

---

功能

• Hytale 与 Discord 之间的双向聊天
• 玩家聊天消息实时同步
• 死亡消息转发至 Discord
• 自动创建和管理 Webhook
• 使用 Webhook 而非机器人刷屏，输出整洁的 Discord 消息

---

前提条件

你需要准备：

• 一个 Discord 机器人应用
• 一个机器人令牌
• 已将机器人添加到你的 Discord 服务器
• 在目标频道拥有管理 Webhook 的权限

必需的 Discord 权限

确保机器人拥有以下权限：

• 查看频道
• 发送消息
• 管理 Webhook
• 读取消息历史

没有 Webhook 权限，Unify 将无法运行。

---

安装

1. 将 Unify 插件放入服务器的 plugins 文件夹
2. 启动一次服务器以生成配置文件
3. 停止服务器
4. 编辑配置文件
5. 再次启动服务器

---

配置

Unify 会生成一个必须填写的配置文件。 除 Webhook URL 外，所有内容都是必需的。该部分会自动处理。

token = "YOUR_BOT_TOKEN_HERE"
guildId = 123456789012345678
chatChannelId = 123456789012345678
chatWebhookUrl = "AUTO_GENERATED"

配置选项

token

你的 Discord 机器人令牌。 请保密。如果泄露，请立即重新生成。

guildId

Unify 要连接的 Discord 服务器 ID。

chatChannelId

聊天和死亡消息将显示的 Discord 频道。

chatWebhookUrl

请勿修改此值。 Unify 会自动创建和维护 Webhook。

---

同步内容

从 Hytale 到 Discord：

• 玩家聊天消息
• 死亡消息

从 Discord 到 Hytale：

• 在配置的频道中发送的普通文本消息

---

故障排查

Discord 中未显示任何内容

• 确认机器人是否在线
• 检查服务器 ID 和频道 ID
• 确认 Webhook 权限

Webhook 错误

• 确保机器人能够管理 Webhook
• 尝试手动删除 Webhook 并重启服务器

消息重复

• 确保只运行了一个 Unify 实例
• 移除其他聊天桥插件

---

备注

Unify 使用 Discord Webhook 让聊天保持可读性，并避免频道被机器人消息刷屏。 如果出现问题，日志通常会清晰地说明原因。

---

祝您使用愉快的统一聊天。