3.0.0-beta.4 for Fabric 26.1.2
on 2026 May 083.0.0-beta.3 for Fabric 26.1.2
on 2026 May 073.0.0-beta.2 for Fabric 26.1.2
on 2026 May 073.0.0-beta.1 for Fabric 26.1.2
on 2026 May 06新增功能
首先，为本次更新的延迟发布致歉，生活琐事耽搁了进度。
不过，本次更新中包含了一些令人兴奋的新功能，你一定要了解！
仅客户端支持
物品栏整理器不再需要服务端支持！我知道许多玩家一直在期待这一功能！但请注意，该方案在系统层面稳定性较低，因此只要条件允许，请务必优先使用服务端支持——这将为底层系统带来更佳的整体体验。
在仅客户端模式下，我们通过模拟一系列同步点击操作来实现排序，本质上是向 Minecraft 突发式地发送大量待处理指令。所有仅客户端整理器均采用此类机制，但其效果并不理想。而服务端模式则以数据驱动为主，对 Minecraft 本体造成的性能负担显著更低。
排序规则！
排序规则可让物品栏整理器对特定物品给予特殊处理，且无需替换默认排序模式。
例如：可将所有潜影盒置顶、将收纳袋移至末尾、保持已命名工具位置不变，或将任何具备容器类物品数据的物品从整理后物品栏的中央区域移开。
规则位于设置界面中的“排序优先级规则”选项下。每条规则包含两个部分：
- 匹配表达式：决定该规则适用于哪些物品堆叠
- 位置设定：决定匹配到的物品堆叠将如何被放置
可用的位置设定如下：
置顶：匹配的物品堆叠排在所有其他物品之前默认：匹配的物品堆叠遵循常规排序顺序置底：匹配的物品堆叠排在所有其他物品之后忽略：匹配的物品堆叠完全不参与排序，并保留在当前槽位中
忽略 是一个特例，其优先级刻意设计得高于其他设定。若某物品匹配了忽略规则，则它会在首轮/默认/置底规则被评估前即被剔除出排序流程。此功能适用于“请勿触碰”类场景，例如工具、已命名的套装，或你始终固定存放在特定箱子槽位中的特殊物品。
规则顺序至关重要
规则按其在列表中出现的顺序依次校验。
若两条规则设定了不同位置，则由位置决定大致排列顺序：置顶 物品最先排列，默认 物品居中，置底 物品最后排列。
若两条规则设定了相同位置，则列表中靠前的规则获胜。例如：
[
{ "match": "#minecraft:shulker_boxes", "position": "first" },
{ "match": "#minecraft:bundles", "position": "first" }
]
在此配置下，潜影盒会排在收纳袋之前，因为潜影盒规则位于列表首位。两组物品内部仍会依据你选定的排序类型（如名称、模组、类别或ID）进行排序。
忽略规则不遵循常规优先级判定逻辑。若某物品匹配任意一条忽略规则，它将始终保留在原始槽位中，即使它同时也匹配了置顶或置底规则。
匹配物品ID
最简单的规则即直接指定物品ID：
minecraft:bundle
该规则仅匹配收纳袋。对于原版 Minecraft 物品，minecraft: 前缀可省略：
bundle
对于模组物品，请使用完整ID：
some_mod:example_item
匹配物品标签
标签可匹配整组物品：
#minecraft:shulker_boxes
该规则匹配所有颜色的潜影盒，而不仅限于某一种具体潜影盒物品。
实用的原版示例包括：
#minecraft:shulker_boxes
#minecraft:bundles
标签对整合包尤其有用，因为数据包与模组可在不重写全部排序规则的前提下，向标签中添加更多物品。
匹配物品数据组件
组件规则可匹配携带特定类型 Minecraft 物品数据的物品：
@minecraft:container
这对内部可存储内容的宽泛物品类别非常实用。例如，可将带有容器数据的物品移至末尾，从而避免装满内容的类存储物品混入普通方块与材料的中间区域。
另一个实用示例是：
@minecraft:bundle_contents
该规则匹配已包含收纳袋内容数据的收纳袋堆叠。
匹配物品名称
名称规则可匹配物品显示名称：
name:"Meza's *"
其中 * 表示“此处可为任意文本”，因此该规则可匹配如下名称：
Meza's Pickaxe
Meza's Fortune Pickaxe
Meza's Axe
名称匹配不区分大小写，因此 MEZA'S Axe 与 Meza's Axe 均匹配同一条规则。
名称模式必须完全匹配整个显示名称。这一点至关重要：
name:"Meza's"
该规则仅匹配名称恰好为 Meza's 的物品，无法匹配 Meza's Pickaxe。
若需实现前缀、后缀或包含式匹配，请使用 *：
name:"Meza's *"
name:"*Pickaxe"
name:"*meza's*"
名称规则既可匹配自定义物品名称，也可匹配原版显示名称。在多人服务器上，原版翻译名称以服务器语言设置为准，因此基于翻译后原版名称制定的规则更适合作为便捷选项，而非最可靠的跨平台方案。物品ID、标签及组件在共享服务器与整合包中更为可靠。
使用逻辑组合规则
匹配表达式可相互组合：
name:"Meza's *" & !minecraft:diamond_pickaxe
其含义为：“名称为 Meza's ... 的物品，但排除钻石镐”。
支持的运算符包括：
!表示“非”&表示“且”|表示“或”- 圆括号用于分组
例如：
#minecraft:shulker_boxes | #minecraft:bundles
匹配潜影盒或收纳袋。
@minecraft:container & !#minecraft:shulker_boxes
匹配带有容器数据的物品，但排除潜影盒。
无效规则
无效规则将在排序过程中被自动忽略，不会导致整个物品栏排序中断。
配置界面与命令会尽力报告语法问题以便你及时修正；但若无效规则意外写入配置文件，物品栏整理器将跳过该规则并继续执行其余规则。
示例
将所有潜影盒置顶：
{ "match": "#minecraft:shulker_boxes", "position": "first" }
将收纳袋置底：
{ "match": "#minecraft:bundles", "position": "last" }
将所有名称为 Vault ... 的物品精确保留在当前槽位：
{ "match": "name:\"Vault *\"", "position": "ignore" }
将已命名工具置底，但排除某一种特定工具：
{ "match": "name:\"Meza's *\" & !minecraft:diamond_pickaxe", "position": "last" }
先将潜影盒置顶，再将收纳袋紧随其后置顶：
[
{ "match": "#minecraft:shulker_boxes", "position": "first" },
{ "match": "#minecraft:bundles", "position": "first" }
]
若希望收纳袋排在潜影盒之前，只需交换这两条规则的顺序即可。
收纳袋排序
收纳袋排序功能使物品栏整理器能在排序过程中主动利用收纳袋，而非仅将其视作普通物品。
若某收纳袋内已存在某种物品，则排序时可将该物品的散装堆叠自动移入该收纳袋。例如，一个已装有苹果的收纳袋，只要 Minecraft 判定其仍有足够空间，即可从同一物品栏中收集散装苹果堆叠。
该功能严格遵循 Minecraft 原生收纳袋规则。物品栏整理器不会另行设计独立容量系统，因此收纳袋填充度、嵌套收纳袋重量、物品限制及组件匹配均完全符合原版行为。
现有内容决定收纳范围
收纳袋仅接收其已直接包含的物品。
空收纳袋在排序过程中不会成为“将所有物品塞入其中”的通用目标。此举确保收纳袋排序行为可预测，因为收纳袋内已有的内容即明确告知物品栏整理器其用途。
例如：
- 装有苹果的收纳袋可继续接收更多苹果
- 装有线的收纳袋可继续接收更多线
- 空收纳袋在收纳袋排序过程中始终保持为空
- 装有苹果的收纳袋不会接收木棍、红石粉或其他无关物品
匹配要求精确。若收纳袋内为已命名苹果，则仅匹配同名苹果，而非所有苹果；其他 Minecraft 物品数据（如耐久值、附魔、自定义名称及组件）亦同理。
小堆叠优先填入
收纳袋在处理较小堆叠时效果最佳，因此物品栏整理器会优先尝试数量最少的匹配堆叠。
若存在多个可填入某收纳袋的散装堆叠，数量较小的堆叠将获得优先填入权。若某收纳袋已填满，物品栏整理器可继续尝试下一个匹配的收纳袋（若存在）。
Minecraft 本身最终决定实际能容纳多少。若某堆叠仅部分填入，剩余部分将保留在物品栏中并继续参与常规排序。
不展开嵌套收纳袋
仅收纳袋的直接内容会被考虑。
若某收纳袋内含另一收纳袋，且该内层收纳袋中装有线，则外层收纳袋不会被视为“线收纳袋”。此举确保行为易于理解，并避免物品栏整理器试图逐层解析所有嵌套存储物品。
非空收纳袋亦不会作为本功能的一部分被移入其他收纳袋。若某收纳袋已包含物品，物品栏整理器将视其为具有独立意义的物品，而非尝试将其打包进另一收纳袋。
玩家物品栏与快捷栏收纳袋
对玩家物品栏进行排序时，快捷栏上的收纳袋同样可作为收纳目标。此功能由设置项“排序玩家物品栏时启用快捷栏收纳袋”控制。
该功能仅适用于玩家物品栏排序。对箱子或其他容器进行排序时，不会从你的快捷栏中抽取物品填入该容器。
排序规则依然生效
收纳袋排序属于常规排序流程的一部分，因此排序规则仍然有效。
忽略 规则具有最高优先级。若某散装物品匹配忽略规则，则它不会被移入任何收纳袋。此机制可确保“请勿触碰”类物品精确保留在原位，即使存在匹配的收纳袋。
置顶、默认 与 置底 规则仍会影响收纳袋填入完成后的最终顶层物品栏顺序。例如，你既可通过排序规则将收纳袋置顶或置底，又可同时允许匹配的散装物品被填入其中。
仅客户端支持
收纳袋排序功能在服务端支持及仅客户端模式下均可正常工作。
在服务端支持下，物品栏整理器可直接在服务端应用排序结果。在仅客户端模式下，它会模拟玩家手动操作所需的原生点击流程：拾起散装堆叠 → 点击收纳袋 → 交由 Minecraft 插入可容纳内容 → 继续排序。
服务端路径在可用时仍是更优选择，但收纳袋排序功能本身并不要求服务端安装该模组。
更新日志
3.0.0-beta.1（2026年5月6日）
⚠ 破坏性变更
- 支持 26.1 版本。停止对 26.1 之前版本的主动开发
新增功能
- 新增基于显示名称的排序规则（f1ae5f8）
- 新增排序忽略规则，解决 #232（6607345）
- 新增排序规则，解决 #190（25eede3）
- 新增仅客户端排序回退方案（185f031）
- 排序现可将相同物品填入已含该物品的收纳袋（52f2ba5）