v1.3.0 — 10 个 MC 版本 / 20 个构建

新增 1.21.4 / 1.21.5 / 1.21.8 / 1.21.9 / 1.21.10 / 26.1 / 26.2 / 26.3 支持，加上原有 1.21.1 / 1.21.11，共 10 个 MC 版本 × Fabric / NeoForge = 20 个构建。

各版本验证：

• 1.21.4–1.21.10 五个版本：Fabric 专用服务器 + mineflayer 机器人 E2E 每版本 22/22 全绿（床原地睡觉全链路 10 项、手持界面打开 9 项、潜影盒写读 3 项）；
• 26.1：机器人实测睡眠全链路 5/5 通过（协议 775）；菜单槽探针受机器人协议伪影影响不可用（已取证：服务端 stillValid 恒真、客户端未发包，非模组缺陷），以启动自检容器读写回路补证；
• 26.2 / 26.3：机器人协议数据暂缺，仅服务器 RCON 冒烟（全过）；
• NeoForge 侧编译验证，核心类与 Fabric 逐字节一致。

注意：26.x 需要 Java 25（1.21.x 仍为 Java 21）；1.21.9 与 26.3 两条线的 NeoForge 官方仅有 beta（21.9.16-beta / 26.3.0.37-beta），已编译验证。

v1.2.2 — GPL-3.0

许可证由 MIT 改为 GPL-3.0（LICENSE、fabric.mod.json / neoforge.mods.toml 的 license 字段、README 同步更新）。代码逻辑零改动。

• 4 个构建全部在本机重新编译打包：handyshulkers-{fabric,neoforge}-{1.21.1,1.21.11}-1.2.2.jar
• 说明：此前版本（≤1.2.1）的 jar 以 MIT 发布，已下载的旧副本仍按 MIT；自本版本起改为 GPL-3.0。

v1.2.1 — 朝任意方向睡觉

修复

• 手持床睡觉朝向：之前原地睡觉永远躺在固定方向（临时床没设置 FACING，始终是默认朝向）。现在床的朝向跟随玩家视线方向，四个方向（东南西北）都能睡。
• 对没有原版床属性的 modded 伪床做了 hasProperty 兜底，放置更稳。

验证

• 四项目（1.21.1 / 1.21.11 × Fabric / NeoForge）构建通过，启动自检 PASS。
• 专用服务器 E2E：四个方向睡觉 → 床头/床尾方块与朝向逐一核对 → 醒来后临时床清理，12/12 通过。

Handy Shulkers 1.2.0

手持即用全类目：附魔台/切石机/制图台/砂轮/锻造台/铁砧（不耗耐久）/末影箱全部支持；床睡觉改用临时真床方案，修复原地睡觉被强制起身与幽灵放置；新增启动自检（SELF-TEST）确定性验证容器读写回环。1.21.1 与 1.21.11 双版本、Fabric+NeoForge 双加载器。

Handy Shulkers 1.1.1

修复审计发现的 7 个 bug：手持工作台/织布机界面秒关；手持床右键崩溃及'放床消失'；超过54格的模组盒子截断丢数据（现在拒绝打开并提示）；requireSneak=true 时模组完全失效；相同盒子导致的容器数据错写；配置文件缺失键丢失默认值；CI 产物名非法。便携合成/织布机改用子类菜单，睡觉保留原版规则（夜晚/怪物/主世界），1.21.11 使用 BedRule 环境属性系统。

Handy Shulkers 1.1.0

新增'手持即用'：右键（不潜行）直接使用手持功能性物品——潜影盒打开、床原地睡觉（保留夜晚/怪物等原版规则）、工作台打开合成界面、织布机打开织布机界面；对着箱子等带界面方块时方块优先；潜行+右键放置。全部标签可扩展，服务端逻辑客户端不吞包。

Handy Shulkers 1.0.1

修复交互模型：改为 Quick Shulker 同款——正常右键=方块功能优先（床睡觉/工作台/织布机/按钮全部正常），潜行+右键=打开盒子；修复客户端吞包导致部分交互无响应的问题。仍无任何'戴头上'机制。

Handy Shulkers 1.0.0

MC 1.21.1 与 1.21.11 的 Fabric / NeoForge 构建。安装：服务端必装，客户端可选。