便捷潜影盒

Handy Shulker

潜影盒就该像收纳袋一样工作。就这样。

原版 Minecraft 为收纳袋提供了简洁的点击插入和悬停预览界面——但潜影盒，这个最早的便携存储，仍然需要你每次都把它放下来。Handy Shulkers 通过两个简单的交互解决了这个问题：

功能

🖱️ 点击插入

在物品栏中手持潜影盒，将物品点击到它上面即可存储——就像收纳袋一样。不再需要放置、打开、插入、关闭和破坏。只需点击。

🔍 悬停 + 滚轮浏览

将鼠标悬停在潜影盒上，即可在 9×3 网格中预览其内容。滚动以循环浏览物品，点击以取出——全程无需放置盒子。

📊 填充度条

潜影盒会显示一条彩色条，展示其填充程度——就像收纳袋一样。一眼就能看出哪些是空的。

🎨 染色提示框

提示框边框与你的潜影盒染料颜色匹配。粉色潜影盒？粉色边框。

🔢 物品数量徽章

当你选中某个物品时，提示框会显示所有槽位的总数——不再需要心算。"圆石 ×204" 精确告诉你手头有多少。

📦 紧凑模式

按住 Shift 查看独特物品的浓缩网格，带有聚合计数且不显示空槽位。大数量会被缩写（1000+ → "1.0k"，10000+ → "10k"）。非常适合快速检查"我的铁够不够？"。

⚙️ 完全可配置

每项功能都可以单独开关。无需重启游戏。安装 Mod Menu 和 YACL 获得游戏内配置界面，或者直接手动编辑 config/handyshulkers.json。两者都是可选的——本模组开箱即用，带有合理的默认值。

为什么做这个模组？

普通 Minecraft 建筑玩家每次游戏大约与潜影盒交互 30 次。每次你都要经历相同的仪式：找一个平面、放下盒子、等待开启动画、打开 GUI、移动物品、关闭、挖回来、捡起来。每次交互大约 5.6 秒——一年下来，累计约 6.9 小时仅仅花在放置和破坏潜影盒上。我们帮你算好了，不用你自己算。不客气。 潜影盒是 27 格的便携箱子，却完全没有 1.21 中收纳袋获得的那些便利功能。Handy Shulkers 将那种原版感觉的 UX 带到了你的潜影盒上。

• 原版风格——没有新物品，没有新方块，没有配置界面。只是更好的潜影盒 UX。
• 轻量——只做好一件事。除 Fabric API 外无库依赖。
• 尊重原版平衡——潜影盒套潜影盒仍被阻止，堆叠大小不变。

兼容性

• 需要 Fabric API
• ✅ 兼容 Mouse Tweaks——可与 Mouse Tweaks 及其他物品栏模组干净共存
• ✅ 兼容 ItemScroller / MaLiLib——滚动事件在 GLFW 输入层被拦截，因此物品栏模组不会干扰
• 应与大多数物品栏模组兼容——如果遇到冲突，提交 issue
• ⚙️ 可选： Mod Menu + YACL 以获得游戏内配置界面（非必需）

安装

单人游戏

1. 安装 Fabric Loader
2. 安装 Fabric API
3. 将 handyshulkers-x.x.x.jar 放入你的 mods/ 文件夹
4. 启动游戏！

服务器

该模组需要在服务器和所有连接的客户端上安装。未安装该模组的玩家将无法正确使用潜影盒交互。

1. 在服务器上安装 Fabric Loader
2. 将 Fabric API 和 Handy Shulker 放入服务器的 mods/ 文件夹
3. 每个连接的玩家都需要安装 Fabric Loader、Fabric API 和 Handy Shulker

灵感来源

这个模组的存在要归功于 Xisuma 和他在 Hermitcraft 第 11 季中的 Bundle Boutique。观看那一集是收纳袋终于恍然大悟的时刻——并立刻让我想知道为什么潜影盒，这个最早的便携存储，不能做同样的事情。

---

Handy Shulkers 在 MIT 许可证下开源。