HubSuite v0.5.0-alpha.1（含客户端模组）

客户端

⬆️ 建议更新 —— 客户端 v0.5.0-alpha.1
装了会看到真物品与逐层叠出来的钓竿；不装也能玩（服务端按玩家能力分流，没装的继续看原来的样子）。

服务端

v0.5.0-alpha.1

• 双端模组：新增可选的客户端模组 hubsuite-client（同一份 Release 里的另一个 jar）
• 握手：进服时交换 版本 / 协议号 / 指纹 / 能力清单（hubsuite:hello / hello_ack / welcome），
  服务端按玩家能力决定发真物品还是发 Polymer 映射 —— 老客户端行为完全不变
• 5 个自定义物品全部支持真物品：地狱线 / 熔岩钓竿 / 三种渔桶（客户端自带模型贴图，含渔桶「有饵」变体）
• 钓竿数据契约：杆 / 线 / 钩 / 升级写在原版钓竿的数据组件里；耐久 ×10 整数（512.5 → 5125）、全程无浮点；
  属性公式（耐久 / 速度 / 幸运 / 断线 / 岩浆）与自检同批落地
• 自检 261 项全部通过

最低客户端版本

不强制（clientCompat.mode 默认 warn：只提示、不拦人）。想强制就把 config/hubsuite/config.json 里的
clientCompat.mode 改成 enforce（没装 / 版本过低的会被踢出并看到下载地址）。

怎么装客户端

hubsuite-client-0.5.0-alpha.1.jar → 玩家客户端的 mods/（同样的 Fabric Loader + Fabric API 26.1.2）。

客户端指纹：2cd1c01e57718f4e —— 下次发版对比这个值（或者看 Release 说明里的这一行）就知道客户端有没有变。

已验证 / 未验证（如实写）

已在开发环境实机验证：

• 双端握手通过、服务端记录到正确的版本 / 协议 / 指纹 / 能力清单
• 真物品：地狱线、熔岩钓竿、三种渔桶（含「有饵」变体）在客户端侧都是真物品 id
• 钓竿分层渲染：给玩家 /give 一根带 custom_model_data 的钓竿，热键栏图标四层颜色正确（钻石杆 + 地狱丝线 + 黑曜石钩 + 青金石升级）

未验证 / 已知问题：

• 客户端渲染没有在正式客户端环境验收过（目前只在作者的开发客户端里跑过）—— 请帮忙看一眼
• 装配台界面、断线/损坏、青金石附魔属于 0.6.0，本版没有
• 进服之前就放在背包里的自定义物品，要等一次同步才会变成真物品（已做「握手后补发背包」，边角情况仍可能出现）
• 与本次无关的老毛病：用 /register 命令注册成功后，先前弹出的注册对话框不会自动关闭