HyDiscordX - 新手盒子

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

HyDiscordX — 连接 Hytale 与 Discord 的桥梁

HyDiscordX 是一个功能完备的 Discord ↔ Hytale 桥接插件，能让你的服务器与社区实现实时连接。

聊天内容可在 Hytale 和 Discord 之间无缝流转，即使玩家离线也能参与互动。管理员可以监控对话、更快响应，无需登录游戏即可保持社区活跃。无论是全局聊天还是系统消息，HyDiscordX 都能让你的服务器全天候充满活力。

HyDiscordX 注重性能、稳定性和简洁配置，适用于从小型 SMP 到依赖 Discord 作为核心中心的大型网络等各种场景。

Wiki: https://wiki.thelegacyvoyage.xyz/HyDiscordXWiki

✨ 功能特性

🔗 账号关联 — 使用一次性验证码关联 Discord 和 Hytale 账号
🎫 关联码 — 可配置长度和过期时间
🧾 关联存储 — 默认使用 SQLite (links.db)，支持 MariaDB/MySQL (通过 JDBC)
🧹 关联清理 — 移除已离开服务器的 Discord 用户的关联
🛡️ 安全关联 — 防止重复关联 Discord 或 Hytale 账号
🎭 可选角色授予 — 关联时自动赋予 Discord 角色
🪪 可选昵称同步 — 关联时设置 Discord 昵称
🔁 关联前缀刷新 — 每 60 秒自动从 LuckPerms 同步关联前缀
💬 Discord → Hytale 聊天桥接 — 中继指定频道的消息
🎨 内联颜色解析 — Discord 消息和关联前缀支持传统颜色码 (& / §)、十六进制和标签格式颜色
💬 Hytale → Discord 聊天桥接 — 可选提及净化功能
🪝 Webhook 聊天支持 — 若设置 chatwebhook，Hytale → Discord 使用 Webhook 发送消息
🖼️ Webhook 头像 — Webhook 消息使用玩家 UUID 从 Hytale Tracker 获取头像
👤 关联名称显示 — 关联的 Discord 消息可显示玩家名而非 Discord 昵称
🏷️ 前缀支持 — 仅从 LuckPerms 获取前缀（暂不支持其他前缀插件）
🎨 角色格式 — 不同角色的前缀文本及名称/消息颜色
🏷️ Discord 标签 — 在 Hytale 聊天中自定义标签文字和颜色
📢 公告 — 加入/离开/启动/停止消息发送至 Discord
⚔️ 死亡/击杀信息 — 可选 Discord 频道用于战斗消息
📈 状态更新 — Discord 机器人使用状态模板显示实时在线玩家数
🌐 多服务器状态 — 合并多个服务器的玩家数
🧾 服务器状态命令 — 显示所有已配置服务器的当前/最大玩家数
📊 实时统计嵌入 — 包含 TPS、内存、运行时间等的丰富状态消息
🛂 Discord 白名单 — 基于角色的允许/拒绝访问，可附带踢出
🎙️ 语音频道通知 — 在游戏中通知关联用户加入特定语音频道
🧠 资料 + 游戏时间 — 资料命令、游戏时间查询和前十排行榜
🌍 多语言支持 — 内置语言：阿拉伯语、孟加拉语、德语、英语（美国）、西班牙语（西班牙）、印地语、日语、旁遮普语、葡萄牙语（巴西）、俄语、简体中文
🏷️ 角色 → 用户组同步 — 将 Discord 角色映射到 LuckPerms 用户组
⚡ 强制同步 — 随时手动执行角色 → 用户组同步
♻️ 重载支持 — 在游戏中重载角色映射
🧰 调试开关 — 关闭所有插件控制台日志，除非启用调试
🧩 API — 集成详情请查阅 Wiki

命令

/link — 在 Discord 上使用以生成一次性关联码（也可使用 !links 通过私信发送）
/playerlist — 在 Discord 上使用以查看在线玩家（也可使用 !playerlist）
/profile — 显示玩家资料（Discord）
/playtime — 显示游戏时间（Discord）
/playtimetop — 显示游戏时间前十名（Discord）
/unlink — 取消 Discord 账号与 Hytale 账号的关联（仅游戏内）
/hydiscordx reload — 重载插件配置
/hydiscordx servers — 显示所有已配置服务器的玩家数
/hydiscordranksx reload — 重载角色 → 用户组同步配置
/hydiscordranksx forcesync — 强制进行角色 → 用户组同步

需求

HyDiscordX (用于账号关联)
LuckPerms (用于用户组/权限组管理)

权限节点

thelegacyvoyage.hydiscordx.command.link
thelegacyvoyage.hydiscordx.command.unlink
thelegacyvoyage.hydiscordx.command.reload
thelegacyvoyage.hydiscordx.command.servers
thelegacyvoyage.hydiscordx.admin

实时统计 (Live Stats)

⬤ 实时统计嵌入可显示：
- 玩家数
- TPS
- 内存
- 运行时间
- 服务器 IP
- 版本
- 下次重启时间
- 服务器名称（可开关）
- 在线玩家轮播列表（每次更新最多显示 5 人）

语音频道通知 (Voice Announce)

⬤ 可选语音频道通知功能：
- 检测关联用户加入已配置的语音频道
- 在游戏中发送消息，格式如：[游戏内名称] 加入了 [语音频道名称]，快来加入他们吧！

多语言支持 (Language Support)

⬤ 内置语言：英语、简体中文、西班牙语、印地语、阿拉伯语、孟加拉语、葡萄牙语（巴西）、俄语、日语、旁遮普语、德语。
⬤ 支持自定义语言文件。

面向其他插件的 API

⬤ HyDiscordX 提供一个轻量级 Java API：
- 查询关联玩家
- 监听关联/取消关联/游戏时间更新事件
- 获取在线关联玩家列表

命令列表（小结）

/link — 生成一次性验证码（Discord 或游戏内均可）
/unlink — 取消 Discord 账号与 Hytale 的关联（游戏内）
/playerlist — Discord 命令，列出在线玩家
/hydiscordx reload — 重载配置
/hydiscordx servers — 显示所有已配置服务器的状态

如果你需要任何更改或添加，请尽管提出，并报告你发现的任何错误。

Discord: https://discord.gg/U58ax8cZZ2

你可以在你的服务器上下载并使用此插件。

The Legacy Voyage 团队

HyDiscordX — 连接 Hytale 与 Discord 的桥梁

评论