⚠️ 测试阶段说明
本版本处于公开测试阶段，面向站长试用与反馈。
核心功能（账号绑定、组映射、Store 升组、多服 server-id、论坛展示等）已可使用，但尚未视为最终稳定版。请务必先在测试论坛 / 测试服完整验证后再考虑正式环境；部署生产站请自行评估风险并做好备份。欢迎提交问题与建议，我们将根据反馈持续完善。
一句话：
双端插件连接 XenForo 与 Minecraft：绑定账号、组映射、用户升级自动升组、服内注册与论坛展示游戏身份；支持多服共用同一论坛。（公开测试中）
这是什么
HuoNiu Minecraft Sync 把 XenForo 论坛 与 Minecraft 服务器 连成同一套身份体系。
玩家将游戏账号绑定到论坛后：游戏权限可反映到论坛，论坛会员也可回到游戏自动开组。站长不必再对着名单手工加组、反复核对「论坛是谁、游戏是谁」。
一包两端：
内容
用途
xenforo/*.zip
XenForo 后台安装
paper/*.jar
放入 Minecraft 服 plugins/
安装说明.txt
安装、API、多服说明
解决什么问题
游戏里是 VIP，论坛发帖却看不出身份
论坛卖了用户升级 / 会员，进服还要管理员手工加权限，到期容易忘撤
想把服内玩家引流进论坛，又怕开放注册招来脏号
开了生存服、小游戏服，仍希望共用一套论坛账号与会员
玩家怎么用
绑定账号
进入已安装插件的游戏服
输入 /link
获得论坛确认链接与绑定码
打开链接确认，或进入 账户设置 → Minecraft 手动填写绑定码
绑完后：一个 Minecraft 账号对应一个论坛账号（避免串号）。
服内注册
游戏输入 /register
打开注册链接完成论坛注册
注册页会标明正在关联的 Minecraft 账号
站长可开启「仅允许通过服务器注册」：关闭普通注册入口，玩家必须先通过游戏 /register。
绑定成功后的反馈
站长可配置欢迎语与控制台命令。对应服务器领取「待发奖」后，玩家进服可看到提示或获得设定好的奖励动作。
站长核心能力（详解）
1. 组映射：游戏组 ↔ 论坛用户组
后台： HuoNiu Minecraft Sync → 组映射
每条可配置：游戏内组名（与 LuckPerms 一致）、对应论坛用户组（可选「无」仅展示）、显示名称、徽章颜色、优先级、启用/停用。
效果： 玩家进服同步组信息后，论坛按映射授予或收回用户组；可允许玩家自选展示徽章。
→ 游戏里混出的身份，论坛里也能认出来。
2. Store 升组：论坛会员 → 游戏权限
对接 XenForo 用户升级。
步骤：
论坛选项开启 Store
后台「Store 升组」配置：某用户升级 → 某游戏组
游戏端 config.yml 设置 enable-store: true
效果： 已绑定玩家会员生效 → 自动加组；到期/取消 → 自动撤掉本插件管理的映射组（不乱删其它手工组）。
→ 论坛收款卖会员，游戏权限跟着变。
3. 论坛看得见会员的游戏身份
位置
能看到什么
个人资料页
Minecraft 名、皮肤、展示徽章
帖子 / 留言旁
同上（可关）
头像
可用 Minecraft 皮肤（可强制覆盖）
用户条件
「已绑定 / 未绑定」用于晋升、专属版块、广告位
后台编辑用户
查看绑定、清除误绑
选项可开关：展示块、头像、强制头像、头像 URL 模板等。
4. 多台 Minecraft 服务器
各服安装同一游戏端插件：
website-url、api-key：相同（同一论坛）
server-id：每台唯一（如 survival、minigame，不要都用 default）
绑定码与待发奖带本服 server-id，多服互不抢队列。
说明：绑定关系仍是「一个 Minecraft ↔ 一个论坛号」，不是一服一绑。
5. 服务器状态小部件
外观 → 小部件 → Minecraft 服务器状态：显示在线/离线与人数。多服可放多个小部件。
6. 其它站长可控项
允许绑定 / 允许解绑 / 绑定码有效期
允许玩家自选展示组
仅允许通过服务器注册
用户组权限：绑定、解绑、查看展示、选择展示组
/hnmc status、/hnmc reload 运维命令
环境要求
端
要求
论坛
XenForo 2.3.0+，PHP 8.0+
游戏
Paper 26.1+，Java 25
推荐
LuckPerms（组映射与 Store）
最短接通顺序
ACP 安装论坛端 zip
创建 API 密钥，勾选全部「HuoNiu MC：…」权限范围（用 Store 则含 Store）
游戏服安装 jar，填写 api-key、website-url、server-id
/hnmc reload → /hnmc status → /link 试绑定
按需配置组映射 / Store / 展示 / 小部件
完整步骤与排错见包内《安装说明》。
测试阶段特别提醒
请先在测试环境走通：绑定、组同步、买升级升组、多服 server-id
生产站上线前做好数据库与插件备份
反馈请尽量附带：版本号、/hnmc status 信息、论坛报错
