潜影盒口袋

潜影盒口袋

一个 Fabric 模组，能将副手中的潜影盒变成一个即时可用的可滚动工具腰带。 潜行 + 滚轮 可在潜影盒与主手之间循环切换物品：无需打开物品栏界面，无需调整快捷栏。

为什么需要这个 Mod

携带一堆工具会导致快捷栏杂乱无章，或者需要反复打开物品栏。潜影盒口袋让单个副手潜影盒成为你的工具腰带：滚动滚轮就能将下一个物品立刻拿到手上，无需打开任何界面。你的快捷栏可以保持整洁，专注于重要物品。

工作原理

1. 将任意潜影盒（或其他 minecraft:container 物品）放在副手。
2. 按住潜行（或你在 选项 → 控制 → 物品栏 中绑定的按键），然后滚动鼠标滚轮。
3. 手持物品会在潜影盒内容物中循环切换；滚过最后一个物品后可以切换为空手状态。

没有自定义覆盖层。原版已经在快捷栏上方显示了手持物品的名称变化，而且你知道盒子里有什么。

安装

需要 Fabric Loader 和 Fabric API，游戏版本为 1.20.5 至 26.1.x。必须在客户端和服务端同时安装。

从 Modrinth 下载 或从 GitHub 发行版 获取 jar 文件。

配置

安装 Mod Menu（可选）即可在游戏中编辑所有设置：在 Mod Menu 中找到潜影盒口袋一行，点击其配置按钮即可打开设置界面。否则，可以手动编辑 config/shulker_pocket.json（首次启动时生成）文件。

键名	默认值	含义
invertScroll	false	反转滚动方向。
cooldownMs	250	两次滚动触发之间的最小间隔（防抖动）。
allowEmptyPosition	true	允许光标停在"空手"位置。
playSounds	true	播放微弱的交换/拒绝音效。
useActivationKey	false	使用可绑定的按键激活，而非潜行键。
showTooltipHint	true	在潜影盒的工具提示中显示使用提示。

从源码构建

需要 JDK 25（Gradle 工具链会为旧版 Minecraft 目标拉取 JDK 21）。该模组使用 Stonecutter 从单一源码树构建所有支持的 Minecraft 版本：当前版本的方言是源真，旧版本由它生成。

./gradlew chiseledBuild   # 构建并测试所有支持的 Minecraft 版本
./gradlew build           # 仅构建并测试当前活跃版本 (26.1.x)
./gradlew runClient       # 为当前活跃版本启动开发客户端

每个版本的 jar 文件会生成在 versions/<mc>/build/libs/ 目录下。设计和交换算法的文档记录在 SPEC.md 中。

许可证

基于 MIT 许可证 发布。