3.2.0 · 1.20～26.3 正式版 · 服务端优先与客户端后台整理

更新内容

• 支持 Minecraft 1.20～26.3 共 24 个正式版，每个正式版单独一个安装 JAR，只匹配对应正式版本；不支持快照、预发布版和 RC。
• 优先服务端整理；服务端未安装整理 Mod 时，自动使用客户端后台整理，正常整理不显示潜影盒界面，可移动及切换视角。
• 保留跨盒合堆、分类与名称排序、大宗分盒、同类满盒锁定、空盒合并和物品数据隔离。
• 背包按钮悬停提示已简化。MOD 介绍中的依赖说明为：服务端未安装本mod时，整理需要QuickShulker Mod依赖。

安装与前置

只下载文件名匹配当前游戏正式版、不带 -sources 后缀的 JAR，放入对应端的 mods 文件夹，并安装匹配游戏版本的 Fabric API。安装本版前移出其他相同 shulkerbox_sort ID 的 JAR。

游戏正式版	Java
1.20、1.20.1、1.20.2、1.20.3、1.20.4	17+
1.20.5、1.20.6、1.21、1.21.1、1.21.2、1.21.3、1.21.4、1.21.5、1.21.6、1.21.7、1.21.8、1.21.9、1.21.10、1.21.11	21+
26.1、26.1.1、26.1.2、26.2、26.3	25+

Fabric Loader 最低声明 >=0.18.4，构建与客户端测试使用 0.19.3。无需 Item Scroller 或 MaLiLib。

• **服务端安装本 Mod：**可直接整理，Quick Shulker 不是必需。未装本 Mod 的客户端也可使用 /shulkersort，无需 OP。客户端安装后可使用背包 ⇅ 按钮；单人游戏由内置服务端整理。
• **服务端未安装本 Mod：**客户端须安装匹配版本的 QuickShulker，服务器也须支持 QuickShulker 开盒。打开背包点击 ⇅ 自动执行后台整理；本 Mod 不会给未安装它的服务器新增命令。
• 客户端后台整理前至少留一个空槽，并放下光标物品。整理期间不要操作背包，等待完成；再次打开背包会被阻止，移动与切换视角仍可用。异常时按提示检查当前容器。
• 服务端模式无需空中转槽，背包全满也可整理。空盒仅在实际允许堆叠时合并；未允许堆叠仍会完成盒内排序，空盒分开保留并提示。

下载文件说明

• 不带 -sources 的 24 个 JAR 是安装包，每个正式版只安装其中一个。
• -sources.jar 是对应版本源码，-source.zip 是完整源码工程，均为非安装文件，不要放入 mods。GitHub 自动生成的 Source code 归档也不是安装包。
• SHA256SUMS.txt 提供安装包、源码和交付清单的 SHA-256 校验值。

逐版构建与自动测试、24 个真实专用端加载检查已经通过；1.20、1.21.4、26.1.2、26.2、26.3 已在隔离客户端中验证真实后台整理。没有声称所有整合包与联机组合均已验收。

详细用法见 README，验证范围见 VALIDATION。

Shulker Box Sort 3.0.2 · Minecraft 26.2 服务端版

适用于 Minecraft Java 26.2 的 Fabric 服务端版。支持跨潜影盒物品合并、全局排序、大宗物品分盒与空盒堆叠。

安装与使用

• 服务端安装本 JAR 和与 26.2 匹配的 Fabric API，运行环境为 Java 25+、Fabric Loader 0.18.4+。
• 客户端可以不安装本模组。 普通玩家直接输入 /shulkersort 整理自己的背包，无需 OP。
• 客户端安装同一版本后，还可使用背包面板内部右上角的 ⇅ 小按钮。
• 单人游戏在本地安装后由内置服务端执行。
• 同一个 mods 目录不要同时放入旧客户端版和本版本。

主要功能

• 服务端直接整理潜影盒，无需反复开关潜影盒、拿取物品或等待逐次网络确认。
• 内置物品滚轮的默认分类与名称排序，不需要安装 Item Scroller、MaLiLib 或 Quick Shulker。
• 大宗物品优先分盒；单一物品且容量完全满的盒子保持不动。相同物品但名称、附魔、耐久等组件不同的物品严格分开。
• 只整理普通原色、未命名、数量为 1 的潜影盒；彩色盒、特殊盒和堆叠的非空盒跳过。背包全满也可整理。
• 空盒按服务端实际允许的规则堆叠。未开启潜影盒堆叠时，仍完成物品整理和排序，并在完成后显示黄色警告，空盒保持分开。
• 模组描述注明服务端用途和无需 OP 的指令用法。

名称使用服务端语言，客户端与指令统一采用服务端默认规则。执行时须放下光标物品并关闭其他容器，连续请求至少间隔 500 ms。

下载与校验

安装文件：shulkerbox_sort-server-fabric-26.2-3.0.2.jar

SHA-256：10B55996D48205BD84B51FFC2C02F8CE4FAF44B9FA7846F9756D190D96D7EAF6

同时提供 .sha256 校验文件；源码可通过本页自动生成的 Source code 归档获取，不是安装文件。原有代码为 MIT，内置排序移植文件为 LGPL-3.0-only，源码及许可证说明已随 JAR 和仓库提供。

已通过 48 项自动测试与无上述前置的专用服务端加载检查，尚未完成真实整合包联机验收。旧 26.1.x 客户端版仍保留在历史 Release。

Shulker Box Sort 2.1.4

Shulker Box Sort 2.1.4

• 对所有符合条件的默认色潜影盒进行全局合并与排序。
• 使用 Item Scroller 当前排序规则构建虚拟大表。
• 通过 Quick Shulker 的真实服务端容器执行后台搬运。
• 新增逐盒 Item Scroller 收尾整理，并在产生新空位时继续补充，直到布局稳定。
• 包含大宗物品分页、不满组直供、乱序页面匹配和安全中止机制。

运行要求

• Minecraft >=26.1 <26.2
• Java 25+
• Fabric Loader >=0.18.4
• 与 Minecraft 26.1.x 匹配的 Fabric API
• Item Scroller（建议 >=0.31.0）
• Quick Shulker（建议 >=3.0.1）

JAR SHA-256：CCB6A7270DA1631B49421CF4912F99477D157D8B48DB4F1B3583C2523685FF3A