DiscordBridge

🔗 DiscordBridge

DiscordBridge 是一款轻量级的 Hytale 服务器插件，通过 Webhook 将服务器事件直接发送到 Discord。

无需 Discord 机器人。
无需令牌。
无需外部托管。

设计为 即插即用、易于配置，并且 适用于公开服务器。

---

✨ 功能特性

• ✅ 服务器 上线/离线 通知
• ✅ 玩家 加入/离开 通知
• ✅ 通过 Discord 嵌入消息 显示加入/离开事件
• ✅ 通过 config.json 完全自定义嵌入消息
• ✅ 支持占位符：
  • {playerName}
  • {serverName}
  • {disconnectReason}
• ✅ 仅使用 Discord Webhook 工作
• ✅ 通过反射机制适应 Hytale API 变更
• ✅ 零运行时依赖

---

📦 安装方法

1. 下载 DiscordBridge-x.y.z.jar
2. 将其放入 Hytale 服务器的 mods/ 目录
3. 启动一次服务器（这将生成 config.json）
4. 编辑 config.json 并设置你的 Discord Webhook URL
5. 重新启动服务器

---

🔧 创建 Discord Webhook

1. 打开 Discord
2. 进入 频道设置 → 集成 → Webhook
3. 点击 新建 Webhook
4. 复制 Webhook URL
5. 粘贴到 config.json 中

---

⌨️ 命令

/discordbridge reload

无需重启服务器 即可重新加载 config.json。

默认权限：
discordbridge.reload

你可以通过 config.json 中的 reloadPermission 修改此权限。

工作流程：

1. 编辑 config.json
2. 执行 /discordbridge reload
3. 更改立即生效

---

⚙️ 配置文件 (config.json)

{
  "webhookUrl": "在此粘贴Webhook地址",
  "serverName": "我的 Hytale 服务器",
  "sendServerStartStop": true,
  "sendJoinLeave": true,
  "useEmbedsForJoinLeave": true,
  "webhookUsername": "Hytale Bridge",
  "webhookAvatarUrl": "",
  "joinEmbed": {
    "title": "玩家加入",
    "description": "➕ {playerName} 加入了 {serverName}",
    "color": 65280,
    "footerText": "{serverName}",
    "thumbnailUrl": "",
    "includeTimestamp": true
  },
  "leaveEmbed": {
    "title": "玩家离开",
    "description": "➖ {playerName} 离开了 {serverName}\n原因：{disconnectReason}",
    "color": 16711680,
    "footerText": "{serverName}",
    "thumbnailUrl": "",
    "includeTimestamp": true
  }
}

---

注意事项

• 嵌入消息颜色值为 十进制整数（Discord 格式）
• 将字段留空可从嵌入消息中省略该内容
• 某些更改可能需要 重启服务器

---

兼容性

• 需要官方 Hytale 服务器
• 基于 Hytale 服务器 API 构建
• Java 版本必须与服务器运行时环境匹配