Magic Shulker Boxes

简体中文

适用于 Minecraft Java 1.21.11 · Fabric · Java 21 的潜影盒自动收纳与补货模组，采用 MIT 许可证。当前版本为 0.6.1。

开启拾取自动入盒后，背包满了时把拾取余量依次放入同类专用盒、空盒、杂物盒；可开启其他单类盒兜底。此功能默认关闭。兼容 Carpet 堆叠潜影盒，支持安全拆盒、自动腾栏、零散物品和杂物盒复用。

• 多人服仅服务端安装即可收纳；单人和局域网由房主执行。
• 自动入盒与原理图取料各自独立开关；服务端可开放玩家个人设置，由玩家覆盖服务端默认值。
• 0.6.1 恢复合成补货默认开启，已有明确关闭的配置保持关闭。
• 0.6.0 新增管理员玩家设置管理、全部设置的点击命令预览，以及全部个人布尔项可自行绑定的切换快捷键；合成补货默认关闭，已有显式选择保留。
• 0.5.0 支持容器与村民交易入盒、可选末影箱取料、IPN 旧工具回来源原格，以及服务器逐项授权玩家设置。两端使用 GUI/取料/IPN 时需一起升级。
• 可选 Mod Menu + YACL 中英文图形设置。
• IPN 消耗品与工具补货可从背包潜影盒取物，沿用 IPN 的触发、匹配和排序规则，独立开关 ipnRefill。
• 背包/工作台合成可从潜影盒补材料，支持点击配方、连续取出成品和 Shift 合成，独立开关 craftRefill，不依赖 IPN。
• 0.2.0-alpha 新增 Litematica 轻松放置自动取料：缺料时从潜影盒补到背包，支持自动腾栏及可关闭的失败提示，需要客户端与服务端都更新。

下载版本 · 在线使用文档 · 开发文档

安装

安装 magic-shulker-boxes-fabric-0.6.1+mc1.21.11.jar 和 Fabric API，使用 Fabric Loader 0.18.4 或更新版。不要安装 -sources.jar。升级前移走旧版 JAR，避免重复加载。

0.4.0 保留 0.3.2 配置和已有选择，新增 ipnRefill、craftRefill 默认开启。完整新增功能和安装要求见 0.4.0 发布说明。

升级到 0.3.2 会先备份，再把 0.3.1 配置中的 enabled 改名为 pickupStorageEnabled，保留其原值；新配置标记为 configVersion: 2。服务端允许个人设置时，玩家可独立开启入盒和取料，即使服务端默认关闭。使用个人设置或取料时两端都需升级。完整变更和备份位置见 0.3.2 发布说明。

客户端设置界面另需 Mod Menu 17.0.1 和 YACL 3.8.2；专用服务端无需这两项。Carpet 可选，其堆叠规则需自行开启。

完整配置、收纳顺序和注意事项见使用文档。开发、测试和 GitHub Actions 发布方式见开发文档。

English

Automatic shulker storage and refilling for Minecraft Java 1.21.11 · Fabric · Java 21, licensed under MIT. The current version is 0.6.1.

After enabling pickup storage, store overflow in matching, empty, then mixed boxes, with an optional single-type fallback. Pickup storage is off by default. Supports Carpet shulker stacking, safe box splitting, automatic space-making, partial stacks and mixed-box reuse.

• Server-only installation works for multiplayer; singleplayer and LAN storage runs on the host.
• Pickup storage and schematic refilling have independent switches. Servers can permit personal preferences, letting players override either server default.
• 0.6.1 restores crafting refill to enabled by default; existing explicit disabled choices are retained.
• 0.6.0 adds administrator player management, clickable command previews for all settings, and locally chosen toggle keys for every personal boolean; crafting refill defaults off and explicit existing choices are retained.
• 0.5.0 adds container/trade storage, optional own ender sources, IPN original-slot tool returns and per-option server permissions. Update both sides for GUI/refill/IPN.
• Optional Mod Menu + YACL settings in English and Simplified Chinese.
• IPN consumable and tool refilling can use backpack shulker boxes, retaining IPN's triggers, matching and sorting, independently controlled by ipnRefill.
• Inventory/crafting-table ingredients can refill from carried boxes for recipe placement, output clicks and Shift crafting, independently controlled by craftRefill without IPN.
• 0.2.0-alpha adds Litematica Easy Place refilling from inventory shulker boxes, with optional space-making and failure notices. Both client and server need the new version for this feature.

Download · User guide · Development

Install

Install magic-shulker-boxes-fabric-0.6.1+mc1.21.11.jar and Fabric API with Fabric Loader 0.18.4 or newer. Do not install the sources JAR. Remove older mod JARs before upgrading.

0.4.0 retains 0.3.2 settings and choices; new ipnRefill and craftRefill switches default to enabled. See the 0.4.0 release notes for features and installation requirements.

Upgrading to 0.3.2 backs up 0.3.1 settings, renames enabled to pickupStorageEnabled, and preserves its value. New files use configVersion: 2. When the server permits personal settings, a player may independently enable pickup storage and material refilling even if the server defaults are off. Update both sides for personal settings and refilling. See the 0.3.2 release notes for migration details and backup locations.

The client settings screen additionally needs Mod Menu 17.0.1 and YACL 3.8.2. Dedicated servers do not need either library. Carpet is optional; enable its stacking rule separately.

Read the user guide for all behavior and configuration details, or the development guide for building, testing and releases.