HubSuite v0.5.0-beta.1（钓竿系统全量）

客户端

⬆️ 建议更新 —— 客户端 v0.5.0-beta.1
客户端指纹：5a5fcd31bf553b4d（alpha.2 是 fad05fd11877bd71）
这一版客户端多了：装配台界面、装配台方块、钓竿的裂纹层与抛竿层。

服务端

v0.5.0-beta.1 —— 0.6「钓竿系统」的全部七步都在这一版里。

新玩法

• 装配台（新方块）：钓竿 + 杆 / 线 / 钩 四个语义格。放材料即消耗：同种杆材料修补回满、
  不同种换底（耐久回满）、换线 / 换钩不动耐久；放错部位的材料根本放不进去。
  配方：钓竿 + 铁锭 + 工作台 + 4 木板（配方书里能看到）。关界面把东西还给你，拆了方块东西掉出来。
• 铁砧升级：钓竿 + 钻石 / 绿宝石 / 青金石 / 红石 → 打上该升级（只有一个升级槽，再来一个直接替换）。
  花费走原版累计惩罚：升得越多越贵。
• 耐久与断线：钓上来一次 −1；断线（线的概率，5‰~7‰）→ 空手而归 + −3 + 装备损坏音效；
  耐久见底不能钓（模型叠裂纹），只能回装配台修。
• 青金石附魔：钓上来的装备按附魔台 15 级等价附魔；挂青金石升级则按 30 级
  并有 25% 追加一个宝藏附魔（附魔台本来不给的那几种，诅咒除外）。
• 岩浆钓鱼改看钩：黑曜石钩 / 下界合金钩才能在岩浆里钓 —— 不再需要专用竿。

⚠️ 迁移提示（请务必看一眼）

• 旧的熔岩钓竿不会消失：进服时会自动换成「原版钓竿 + 黑曜石钩」，附魔与自定义名字保留、
  磨损比例照搬（旧竿快坏了，新竿也快坏）。换完会有提示。
• 没装客户端模组的玩家：玩法（钓上来的东西、附魔、装配台）完全一样，只是钓竿外观是原版样子、
  装配台看起来像锻造台。

最低客户端版本

不强制（clientCompat.mode 默认 warn：只提示，不拦人）。想强制就在配置里改成 enforce。

怎么装

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

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

已验证（开发环境实机 + 自检 268 项）：

• 装配台界面与方块（界面截图、方块在世界里渲染、注册表同步不再断线）
• 钓竿全链路的数据契约：材质表 / 属性公式 / 装配规则 / 铁砧升级 / 断线边界 / 附魔宝藏池 / 旧竿换算
• 双端握手、真物品、分层渲染的素材齐全性

未验证 / 已知问题：

• 客户端的画面仍未在你的正式环境验收过（只有作者的开发客户端）—— 这一版内容很多，麻烦重点看一眼
• 装配台的美术仍然是占位色块（四个格子 + 标签），方块贴图也是占位；真图待美术
• /rod 管理员命令还在（方便测试）；正常玩家用装配台方块
• 客户端仍不是强制安装；资源包 / Polymer 下线要等切强制安装之后

HubSuite v0.5.0-alpha.2（装配台界面）

客户端

⬆️ 建议更新 —— 客户端 v0.5.0-alpha.2
客户端指纹：fad05fd11877bd71（与 alpha.1 的 2cd1c01e57718f4e 不同 → 这一版客户端确实有改动，请一并更新）

服务端

v0.5.0-alpha.2

• 装配台（新）：自定义菜单 + 自定义界面（标题「钓竿装配台」，四个语义格：钓竿 / 杆 / 线 / 钩）。
  规则已实现：杆位同种材料修补回满、不同种换底（耐久回满）、线 / 钩只换属性不动耐久、
  放错部位的材料根本放不进去、耐久满时不浪费材料；关界面把东西还给玩家。
  目前用管理员命令 /rod 打开（0.6 会换成方块 + 方块实体）。
• 钓竿外观补两层：抛竿时叠「钓线」层（不再整根变成原版抛竿贴图）、耐久见底时叠「裂纹」层
• 修复：用 /register、/login 命令登录成功后，进服时弹出的登录表单不会自己关、
  一直盖在屏幕上（玩家只能手动点退出）。现在认证成功即关闭。
• 自检 263 项全部通过

最低客户端版本

不强制（clientCompat.mode 默认 warn：只提示、不拦人）。

怎么装客户端

hubsuite-client-0.5.0-alpha.2.jar → 玩家客户端的 mods/（同样的 Fabric Loader + Fabric API 26.1.2）。
不装也能玩：没装的客户端继续走 Polymer 映射，看到的是原来的样子。

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

已验证（开发环境实机）：

• 装配台界面能在客户端打开（截图确认标题、四个语义格与标签、玩家背包）
• 装配规则 12 组断言（修补 / 满耐久不消耗 / 换底 / 换线换钩不动耐久 / 非法材料原样返回）
• 钓竿裂纹层与抛竿层在客户端正常叠出来
• 命令登录后，服务端确实把那张登录表单关掉了

未验证 / 已知问题：

• 客户端渲染与界面仍未在正式环境验收过（只有作者的开发客户端）—— 装配台是这一版的新东西，尤其麻烦看一眼
• 装配台的美术是占位色块（四个格子 + 标签），真图以后替换；也还没有方块，用 /rod 打开
• 装配台只有 4 个语义格 + 背包，没有结果格（所以不存在免费合成的工作台漏洞）
• /rod 目前需要管理员权限（0.6 方块化之后会变成任何人都能用）

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 命令注册成功后，先前弹出的注册对话框不会自动关闭

HubSuite v0.4.0-alpha.6（Minecraft 26.1.2 / Fabric）

测试版（Alpha）。0.x 阶段不保证存档 / 配置格式兼容。

新内容

渔桶可以混装钓饵

• 一只桶能装任意几种钓饵（6 种都能进），容量按总个数算：木 64 / 铁 256 / 钻 1024。
• 钓鱼时按档次 二重压缩 → 压缩 → 普通 顺序消耗（先扣最高档），加速按"这次会扣的那种"算。
• 装 / 取仍是原版收纳袋那套：左键全装、右键装一个、右键空格子取一组；tooltip 显示"内容物 总数/容量 + 明细"。

"用错环境"的规则

副手	环境匹配	环境不匹配
散饵（钓饵本身）	加速 +10% / +25% / +45%	速度 −40%（等待 ×1.67），而且照样扣 1 个
渔桶	按桶里最高档的匹配饵加速	完全不生效（不减速、也不扣，桶护饵）

• 普通饵只在水里、地狱饵只在岩浆里"算数"；压缩不压缩一个价。
• 惩罚值可配：fishing.bait.familyMismatchPenalty（默认 0.40）。

数值与贴图

• 钓饵堆叠上限 16（原 8）。
• 渔桶贴图只看 空 / 有饵 两种：装了任何饵（含混装）都是 <桶>_bait，不再按饵的种类分。
• 资源包瘦身：渔桶模型从 21 个降到 6 个，HubSuite-资源包模板.zip 现在 47 个条目。
• 熔岩钓竿的两张贴图（普通 / 抛竿）已按提供的图放进资源包模板。

升级注意

• 必须装 Polymer：把 polymer-bundled-0.16.5+26.1.2.jar 放进 mods/，否则 Fabric Loader 拒绝加载本模组。
• 自定义物品的外观需要资源包（pack_format = 84）：解压仓库根目录的 HubSuite-资源包模板.zip，改完贴图直接用。
• 钓饵堆叠 8 → 16：老存档里已有的 8 个一组不会自动合并（无害）。
• alpha 阶段不承诺存档 / 配置格式兼容。

验证

• 内置自检：通过 232 项，失败 0 项（看门狗 0 次）。
• 产物按流程从 GitHub 真实下载校验（fabric.mod.json 的 id / version / 依赖）。

已知问题 / 未验证

• 实机手感未验证：渔桶点击交互（装 / 取 / 混装）、岩浆钓鱼、减速手感都要真人试。
• 没有资源包时，自定义物品显示为 Polymer 的占位（试炼钥匙 / 钓竿），名字是翻译键 item.hubsuite.<id>。

HubSuite v0.4.0-alpha.5（Minecraft 26.1.2 / Fabric）

测试版（Alpha）。0.x 阶段不保证存档 / 配置格式兼容。

这个版本改了什么

渔桶（钓饵收纳袋）×3

• 木渔桶 / 铁渔桶 / 钻石渔桶，容量 16 / 64 / 1024 个饵。
• 操作和原版收纳袋一样：背包里把饵"点"到桶上装入（左键全装、右键装一个），
  空手右键点桶（或拿桶右键空格子）取出一组。
• 一桶只装一种饵；普通 / 地狱 / 压缩 / 二重压缩都能进，按"个"计数。
• 副手拿桶钓鱼即可生效：加速按桶里饵的档次算（+10% / +25% / +45%），钓上来从桶里扣 1。
• 桶的贴图随内容变化：空桶 / 装了饵 / 装的哪种饵，各是各的模型
  （资源包要提供 21 个模型 id；仓库根目录的 HubSuite-资源包模板.zip 已含全部 JSON + 占位贴图）。

钓饵堆叠 64 → 8（含压缩档）

大量携带请用渔桶。

修复：配方书发现不了自定义配方

之前的配方解锁 advancement 只有 recipe_unlocked 一个条件（等于"解锁自己"，永远不触发）。
现在拿到对应材料就自动解锁（钓饵 ↔ 水桶、渔桶 ↔ 木板/铁锭/钻石 …共 15 条）。

升级注意

• 资源包要加 3 个渔桶 × 7 状态 = 21 个模型（模板 zip 已含占位贴图，解压改图即可）。
• 无配置 / 存档结构变化，直接换 jar。

已验证 / 未验证

• ✅ 自检 230 项全绿（含渔桶装取 / 容量 / 堆叠 / 假玩家副手消耗 / 模型切换）。
• ⚠️ 收纳袋式点击的手感、动态贴图的实际效果 —— 实机未验证（要资源包 + 真人）。

HubSuite v0.4.0-alpha.4（Minecraft 26.1.2 / Fabric）

测试版（Alpha）。0.x 阶段不保证存档 / 配置格式兼容。

这个版本改了什么

JEI 适配（软依赖）

• 服务端可装 JEI（可选）：装上以后，客户端 JEI 的
  「配方转移（点 + 号自动摆合成格）」和「作弊拿物品」由服务端 JEI 正常接管。
• 不装 JEI 也完全不影响功能（软依赖，fabric.mod.json 里是 suggests）。
• 我们的 12 条自定义配方无论装不装 JEI，都会出现在客户端 JEI 的配方页里
  （走原版配方同步；自定义物品显示为「试炼钥匙 + 资源包模型」）。
• 已知限制：JEI 的物品列表里不会出现自定义物品的独立条目
  （原版客户端注册表里没有这些物品；除非客户端也装本模组 + Polymer）。

技术细节

• JEI 的插件 API（IModPlugin）只在客户端加载，服务端没有可调用的接口 ——
  所以适配 = 探测 + 校验我们自己的内容对 JEI 友好（配方全为原版类型、
  配方引用的自定义物品全部实现了 PolymerItem）。
• 自检新增 3 条 JEI 相关检查（装 / 不装 JEI 都必须绿）。

升级注意

• 与 alpha.3 相比只有 JEI 适配，无配置 / 存档变化，直接换 jar 即可。
• 自定义物品仍需资源包才有正确外观（同 alpha.2 起的说明）。
• 服务端装不装 JEI 由你决定；玩家客户端装不装也随意。

已验证 / 未验证

• ✅ 自检 226 项全绿（装 JEI 与不装 JEI 各跑一遍）。
• ✅ 服务端装 JEI 启动无冲突（JEI 29.47.0.109）。
• ⚠️ 客户端 JEI 里的实际显示效果（配方页图标 / 名字）实机未验证（需要资源包 + 真人看）。

HubSuite v0.4.0-alpha.3（Minecraft 26.1.2 / Fabric）

测试版（Alpha）。0.x 阶段不保证存档 / 配置格式兼容。

⚠️ 先看这条：上一个预发布（alpha.2）起不来

v0.4.0-alpha.2 把"熔岩钓竿标记接口"放进了 mixin 包，普通代码又去引用它 ——
服务端在 Bootstrap 阶段就抛
IllegalClassLoadError: ... is in a defined mixin package ... and cannot be referenced directly，
模组根本加载不了。这一版把接口移到业务包（feature/LavaFishingHook），已能正常启动。

这个版本改了什么

修复

• 启动崩溃（见上）。
• 熔岩钓竿合成表是坏的：pattern 写成了 4 列（" B N"），
  加载报 Invalid pattern: too many columns, 3 is maximum，配方根本不存在。
  已按原版钓竿形状改成 " B" / " BN" / " BN"（3 烈焰棒 + 2 地狱线）。
• 12 条配方补了 advancement：以前配方书里看不到（只能凭记忆手摆），现在会出现。
• 钓饵扣费时机：改成"确认这一杆真的按自定义表出货"之后才扣，配置写坏时不会白扣。
• 老配置拿不到岩浆表：配置版本升到 v4，升级时会自动把 fishing 段换成新默认表
  （alpha.2 加岩浆表时忘了升版本号，老配置里一直没有岩浆渔获）。

文档 / 开发

• README、安装部署把 Polymer 标成硬依赖（少了它模组不加载）；配置说明补了
  fishing.bait、岩浆表与 8 个自定义物品。
• build.gradle 加 runtimeOnly polymer-bundled：开发者 runServer 开箱即跑。

合成表（12 条）

配方	摆法	产物
地狱线	下界岩 / 线 / 下界岩；中间下方黑曜石（N-S-N + 上 N 下 O）	地狱线 ×1
普通钓饵	4 任意肉类围 1 水桶（返还空桶）	钓饵 ×4
地狱钓饵	上中肉、左右肉、下烈焰粉、中岩浆桶（返还空桶）	地狱钓饵 ×4
熔岩钓竿	3 烈焰棒（斜）+ 2 地狱线（右列）	熔岩钓竿 ×1
压缩 ×2 种	9 个低级饵	1 个压缩饵
二重压缩 ×2 种	9 个压缩饵	1 个二重压缩饵
解压 ×4 条	1 个压缩/二重压缩	9 个低级饵（可逆）

升级注意

• 必须装 Polymer：把 polymer-bundled-0.16.5+26.1.2.jar 放进 mods/，
  否则 Fabric Loader 会拒绝加载本模组。
• 自定义物品的外观还需要客户端资源包（可选）：
  assets/hubsuite/models/item/<物品id>.json + lang/。
• alpha 阶段不承诺存档 / 配置格式兼容。

已知问题 / 未验证

• 岩浆钓鱼、副手钓饵、自定义物品的实机手感仍未验证（要真人拿竿试）。
• 没有资源包时，自定义物品显示为 Polymer 的占位物品（试炼钥匙 / 钓竿），
  名字是翻译键 item.hubsuite.<id>。
• 岩浆表同时挂在两座下界：海岛下界（岩浆海）真能用；经典空岛下界是纯虚空，
  除非玩家自己倒一桶岩浆，否则用不到。

HubSuite v0.4.0-alpha.2（Minecraft 26.1.2 / Fabric）

⚠️ 这个版本启动即崩溃，请不要使用：标记接口被放进了 mixin 包，
普通代码引用它会抛 IllegalClassLoadError，服务端起不来。请改用 v0.4.0-alpha.3。

测试版（Alpha）。0.x 阶段不保证存档 / 配置格式兼容。 ## 这个版本改了什么 ### 自定义物品（需要装 Polymer） - 新增 8 个自定义物品：熔岩钓竿、地狱线、普通钓饵、地狱钓饵， 以及各自的压缩 / 二重压缩档。 - 它们是服务端真物品（独立 id），配方、统计、NBT 都正常； 原版客户端看到的是"试炼钥匙 + 资源包模型"。 - ⚠️ 服务器必须同时安装 Polymer（把 polymer-bundled-0.16.5+26.1.2.jar 放进 mods/）， 否则模组起不来（硬依赖）。 - ⚠️ 外观需要资源包：不装包会显示成"缺失模型"。 ### 岩浆钓鱼（海岛服下界） - 用熔岩钓竿才能在岩浆里钓（普通钓竿不行）。 - 岩浆有独立渔获表，并按下界群系分化：灵魂沙峡谷钓灵魂沙/灵魂土/下界疣， 绯红森林与诡异森林钓菌类，玄武岩三角洲钓黑石/玄武岩。 - 渔获全是原版物品（岩浆膏、烈焰粉、荧石粉、石英、金粒、远古残骸…）。 ### 副手钓饵 - 放在副手生效，钓上来时消耗 1 个。 - 普通钓饵只在水里生效、地狱钓饵只在岩浆里生效；+10% / +25% / +45%（普通 / 压缩 / 二重压缩）。 ### 配方（正常合成） - 地狱线 = 3 地狱岩 + 1 黑曜石围着 1 根线（线下方放黑曜石） - 熔岩钓竿 = 3 烈焰棒 + 2 地狱线（按配方摆） - 普通钓饵 = 4 任意肉类围着水桶（返还空桶） - 地狱钓饵 = 3 任意肉类 + 岩浆桶 + 烈焰粉（返还空桶） - 9 钓饵 ↔ 1 压缩 / 9 压缩 ↔ 1 二重压缩（可逆） ### 修复 - 换岛后位置记忆指向旧岛，导致"回自己的岛却落在旧岛坐标"（实测差 288 格）。 ## 升级注意 - 必须装 Polymer（本版起是硬依赖）。 - 需要资源包才有正确外观。 - fishing 配置段结构变了（新增钓饵配置 + 岩浆表）。按 0.x 约定旧配置会被整体换成新默认表， 改过配置的服主请重配。 - 旧存档不受影响（岩浆表是新增的）。 ## 已知问题 / 未验证 - 岩浆钓鱼与副手钓饵的实机手感尚未验证（需要真人拿竿试）。 - 岩浆海目前用的是原版下界群系（5 种），没有自定义群系。 - 资源包的模型 / 贴图由服主提供，模组只负责指定模型 id。 ## 技术细节 - 自定义物品走 Polymer：getPolymerItem → trial_key，item_model → hubsuite:item/<id>。 - 岩浆判定：混入 FishingHook.tick 的 FluidState.is(WATER)，对"熔岩竿抛出、且该维度配了渔获表"的钩子放行岩浆。 - 钓饵加速：按概率额外递减咬钩计时器（等效等待时间 ×(1-speedup)），消耗在 retrieve 时。

HubSuite v0.4.0-alpha.1（Minecraft 26.1.2 / Fabric）

这个版本改了什么

• 空岛服 / 海岛服不再有"这是我的岛"限制：任意位置都能破坏与放置（保护整体删除）。
• 海岛服新钓鱼系统：5 个池、40+ 种渔获，稀有度从普通到传说；
  垃圾按群系出（暖海沙子、冷水洋砂砾、冻洋冰块与浮冰），热带鱼只在暖海，
  另有深海奇珍池（钻石 / 附魔金苹果 / 三叉戟 / 海洋之心 / 下界合金碎片）。
• 每座岛屿都有自己的一界：经典空岛的下界是虚空式 —— 传送门落点下会自动生成
  一座全下界岩的小岛，虚空里还放行了下界要塞与猪灵堡垒；
  海岛的下界是岩浆海（液面抬到 Y=96）。两座末地都是原版。
• 悬空结构自动补底座：猪灵堡垒一生成就在它下面垫一层下界岩（要塞不补）；
  自然岛上的村庄房屋也有底座。
• 自然岛 = 结构：岛上的建筑来自结构模板（默认原版村庄小房屋），
  结构模板会在它下面垫底座。想完全用自己搭的岛：关掉 naturalIslandTerrain，
  把 /structure save 名字:路径 存下来的模板填进 naturalIslandStructures。

升级注意

• 这是 0.4.0 的第一个 alpha（预发布），alpha 阶段不承诺存档 / 配置兼容。
• 配置文件会自动升到 v2（渔获表换成新的 5 池表）；如果你改过 fishing 段，请重新配。
• 建议清档再测（地形 / 结构 / 维度改动只对新生成的区块生效）：
  删掉 run/hubsuite_skyblock*、各子服的 *_nether / *_end 与 run/config。
  本次新增的存档目录：hubsuite_skyblock_classic_nether、hubsuite_skyblock_classic_end、
  hubsuite_skyblock_ocean_nether、hubsuite_skyblock_ocean_end。
• 需要 Java 25、Fabric Loader 0.19.5+、Fabric API 0.155.3+26.1.2。

已知问题（未实机验证）

• 本次全部改动只过了内置自检（215 项），没有实机验证。建议优先实测：
  钓一次鱼（三个温度带各试几次）、走一趟传送门（空岛 / 海岛各一次）、
  看自然岛（宝箱 / 刷怪笼 / 结构底座）、看岩浆海与虚空下界、看猪灵堡垒底座。
• 自然岛的位置来自配置坐标，不是噪声驱动的原版结构生成；
  村庄是"结构模板"，没有道路与村民（你可以把自己搭的结构填进配置。
• 空岛式下界里的要塞 / 堡垒会悬空生成（虚空里没有地形），堡垒会带底座、要塞不会。

HubSuite v0.3.0

这个版本改了什么

• 下界 / 末地不再串背包：以前在创造服的下界里退出游戏，再进来背包会被带进大厅；现在每个下界 / 末地都有自己的玩家数据，各存各的。
• 回空岛服会回到上次退出的位置：以前每次都固定在岛的出生点。
• 坐在船上退出再进来，船不会丢了：会骑回原来那条船。
• 海岛服死亡重生落在自己的岛上：以前会重生到海中央。
• 光影不再把下界当主世界：发给客户端的维度 key 换回原版（Iris / OptiFine 识别正常）。
• 从下界回主世界按 1:8 算坐标：不会再在出口旁边多建一扇门。
• 下界 / 末地与主维度共用同一个世界种子（原版语义，/seed 三界一致）。
• HuskHomes 的家按子服隔离：在生存服设的家不会出现在创造服；传送指令在所有子服可用。
• 切子服后命令树会重发：/island 不再在大厅里补全。
• 登录 / 注册表单按「是否已注册」决定：不再需要手动切换。
• 启动时检查更新：有新版本会提示管理员（只提示，不自动下载）。
• 箱子式选服界面改版、出生点 / 重生点修复。

升级注意

• 直接替换 mods/ 里的 jar 即可，不需要删存档。
• 需要 Java 25、Fabric Loader 0.19.5+、Fabric API 0.155.3+26.1.2。
• HuskHomes 必须用 Fabric 版 4.11+ 的 26.1 构建（旧版在 26.1.2 上加载失败）。

已知问题

• 本版本的三处隔离修复（下界/末地背包、回城坐标与坐骑、海岛重生落点）由内置自检覆盖，尚未经过实机游玩验证。
• 内置自检 196 项，全部通过。