Easy Sort
一款轻量级、具有原版质感的 Minecraft 物品栏与箱子整理模组, 适用于 Fabric 和 NeoForge。
一个热键即可对容器进行整理,采用稳定且可配置的排序规则并合并部分堆叠——没有繁琐的物品管理套件膨胀,也没有强制的 GUI 大改。
功能特性
- 整理 ("S") 任何箱子类容器——普通箱子、大型箱子、桶、陷阱箱、末影箱、矿车(含箱子)以及潜影盒
- 整理你的物品栏 ("I",在任何容器界面中均可使用,另设一个可重新绑定的热键) — 仅操作你的 36 个快捷栏+存储槽位,绝不会触碰已装备的护甲或副手物品
- 快速放置 ("Q") — 将物品栏中所有已存在于当前打开容器中的物品移入其中
- 补货 ("R") — 从当前打开的容器中补充你已有的部分堆叠,而不会给你你不携带的物品类型
- 设置 ("G") — 选择你的排序方式(模组 / 物品 ID / 数量 / 名称);按玩家独立保存,跨服务器跟随你的设置
状态
稳定版 (1.0.0)。MVP 及到目前为止的所有后续功能(补货、快速放置、潜影盒支持)在 Fabric 和 NeoForge 上均已完成;请参阅 ROADMAP.md 了解已发布内容和下一步计划。
支持版本
| Minecraft | Loader | Status |
|---|---|---|
| 1.21.10 | Fabric | Release |
| 1.21.10 | NeoForge | Release |
目前暂未计划支持 Forge(详见 ROADMAP.md)。
安装
发布于 Modrinth 和 CurseForge。可直接在 GitHub Releases 获取构建好的 jar 文件。
Fabric 端需要 Fabric Loader 和 Fabric API;NeoForge 端仅需 NeoForge 本身,无需额外的 API 模组。
贡献指南
参见 CONTRIBUTING.md 以报告错误、建议新功能或提交拉取请求,以及 DEVELOPMENT.md 以搭建本地开发环境。
许可证
MIT
Easy Sort
A lightweight, vanilla-feel inventory and chest sorting mod for Minecraft, for both Fabric and NeoForge.
One hotkey sorts a container using a stable, configurable ordering and merges partial stacks — no inventory-management suite bloat, no forced GUI overhaul.
Features
- Sort ("S") any chest-type container — chest, double chest, barrel, trapped chest, ender chest, minecart with chest, and shulker box
- Sort your inventory ("I", on any container screen, plus a rebindable hotkey) — only ever touches your 36 hotbar+storage slots, never equipped armor or your offhand item
- Quick Stack ("Q") — moves everything in your inventory that the open container already has into it
- Restock ("R") — tops up your existing partial stacks from the open container, without handing you item types you weren't already carrying
- Settings ("G") — choose your sort order (mod / item ID / count / name); persisted per-player, follows you across servers
Status
Stable (1.0.0). MVP and all post-MVP-so-far features (Restock, Quick
Stack, shulker boxes) are complete on both Fabric and NeoForge; see
ROADMAP.md for what's shipped and what's next.
Supported versions
| Minecraft | Loader | Status |
|---|---|---|
| 1.21.10 | Fabric | Release |
| 1.21.10 | NeoForge | Release |
Forge support is not currently planned (see ROADMAP.md).
Installation
Published on Modrinth and CurseForge. See GitHub Releases for built jars directly.
Requires Fabric Loader and Fabric API on Fabric; just NeoForge itself on NeoForge, no extra API mod needed.
Contributing
See CONTRIBUTING.md to report bugs, suggest features, or submit pull requests, and DEVELOPMENT.md to set up a local development environment.
License
MIT
下载 Easy Sort
下载 Easy Sort
下载 Easy Sort
下载 Easy Sort
下载 Easy Sort
下载 Easy Sort
下载 Easy Sort
下载 Easy Sort
下载 Easy Sort
下载 Easy Sort
更新日志
本项目的全部重要变更均记录于此文件。
格式基于 Keep a Changelog, 本项目遵循 语义化版本控制。
[未发布]
[1.4.1] - 2026-07-20
已更改
- NeoForge: 将
neoforge_version从26.1.2.78提升至26.1.2.82(针对相同26.1.2Minecraft 目标的最新稳定构建),并将moddev_version(ModDevGradle)从2.0.141提升至2.0.142。
已修复
- NeoForge:
KeyMapping.Category.register(Identifier)在26.1.2.82补丁构建中被弃用,转而使用公共的new KeyMapping.Category(Identifier)构造函数(行为相同,经javap确认)—— 现已切换以规避弃用警告。Fabric 不受影响;此变更仅针对 NeoForge 修补过的原版 jar。
[1.4.0] - 2026-07-13
已添加
- Fabric 构建现也支持 Minecraft 26.2。26.1.2 与 26.2 之间仅存在一个真正的 API 破坏性变更(相比 1.21.11 -> 26.1.2 的跨度要小得多):
Minecraft.setScreen(Screen)被重命名为setScreenAndShow(Screen), 经javap确认为相同行为(设置屏幕并强制渲染帧),并非真正的语义变更。在fabric.mod.json中固定为精确的26.2,而非范围,因为——不同于 26.1 的补丁—— 尚未验证其与其他任何单一版本的兼容性。
已更改
- Fabric 和 NeoForge 现在可以在同一构建中针对不同 Minecraft 版本(
gradle.properties中的fabric_minecraft_version/neoforge_minecraft_version,此前为共享的minecraft_version)—— 这是在 v1.3.0 中放弃 Architectury Loom 而采用原生平台工具的直接结果。NeoForge 仍保持在26.1.2:NeoForge 尚无针对 26.2 的稳定(非 beta)构建。
[1.3.1] - 2026-07-13
已修复
- Fabric: 随附 jar 的
fabric.mod.json仅声明了与26.1.2及更高版本(~26.1.2)的兼容性,尽管 Fabric API 本身在26.1、26.1.1和26.1.2上发布相同的构建——使用26.1/26.1.1的用户会遭遇 Fabric Loader 直接拒绝加载该模组。 现已放宽至26.1.x(26.1 系列的任意补丁)。NeoForge 仍固定为精确的26.1.2——NeoForge 针对26.1/26.1.1的自身构建从未脱离 beta 阶段,因此无论本模组如何声明,这些都不是真正支持的目标。
[1.3.0] - 2026-07-13
已更改
- 移植至 Minecraft 26.1.2,这是 Mojang 在新年度版本号方案下的首个完全去混淆发布版。运行时需 Java 25(此前为 21)—— Mojang 为此前的 26.1 提升了要求。无面向用户的行为变更。
- 放弃 Architectury Loom,改为直接对接各平台自身的官方工具:Fabric 使用
net.fabricmc.fabric-loom, NeoForge 使用net.neoforged.moddev(ModDevGradle)。自 26.1 起 Minecraft 附带去混淆版本,因此 Mojang/Parchment 映射不再存在——Architectury(第三方包装器)在本发布时尚未提供对新构建模型的支持,但 Fabric 和 NeoForge 自身的工具已有。common/从未使用 Architectury 的运行时 API,因此这是一次工具链替换而非重写:build-logic复合构建现提供共享 Gradle 约定,且common/直接向fabric//neoforge/暴露其源码,而非作为编译后的 jar 依赖。 - 1.21.11(此前的目标)冻结于
mc/1.21.11分支;main不再针对其进行构建。
已修复(内部,仅限源码)
- 移植了 26.1.2 升级暴露出的所有真实 API 破坏性变更,通过对比实际 jar 使用
javap/反编译源码确认,而非猜测: Fabric API 重命名(PayloadTypeRegistry.playC2S()->serverboundPlay(),KeyBindingHelper->KeyMappingHelper,ScreenEvents.beforeRender()->beforeExtract()),以及真正的渲染管线重写(GuiGraphics->GuiGraphicsExtractor,AbstractButton.renderContents()->extractContents(),Screen.render()->extractRenderState();fill()/pose()保持不变)。 MixincompatibilityLevel从JAVA_21提升至JAVA_25。
[1.2.0] - 2026-07-13
已更改
- 移植至 Minecraft 1.21.11(Fabric API
0.141.4+1.21.11,NeoForge21.11.42,Parchment2025.12.20,Architectury API19.0.1)。无面向用户的行为变更——此发布仅用于追踪新版 Minecraft。main不再针对 1.21.10 进行构建;该系列冻结于mc/1.21.x分支(最后发布为v1.1.0)。
已修复(内部,仅限源码)
net.minecraft.resources.ResourceLocation在 1.21.11 中重命名为net.minecraft.resources.Identifier——更新了双平台上的所有引用(网络载荷通道 ID、“Easy Sort”键位类别、模组 ID 查找)。AbstractButton.renderWidget(...)在 1.21.11 中变为final;需实现的抽象方法现为renderContents(...)(签名相同)。 重命名了双平台上MiniButton中的重写方法——无行为变更,这与原版内部的此次重命名一致。
[1.1.0] - 2026-07-10
已添加
- 在原版的“控制 > 按键绑定”界面中新增专用的 “Easy Sort” 类别,以及一个新的、可单独配置的 “Sort Container” 键位
(默认未绑定——“S” 是移动键,因此没有安全的默认值)。现有的 “Sort Inventory” 键位(默认
R)现位于同一类别下,而非归入原版的 “Inventory” 部分。
已修复
- 两个平台: 排序键绑定在容器或背包界面打开时从未真正触发——而这正是它们本应工作的场景。根本原因:原版仅在
Minecraft.screen == null时才调用KeyMapping.click()(该调用会驱动KeyMapping.consumeClick());只要显示任何屏幕,就不会调用它,因此之前基于每帧轮询的consumeClick()检测机制永远无法捕捉到按键。修复方案改为直接挂钩每个屏幕的键盘事件:Fabric 使用ScreenKeyboardEvents.afterKeyPress,NeoForge 使用ScreenEvent.KeyPressed.Post。两个键绑定均保持原有的作用域限制——“排序背包”在任何容器屏幕上均可用,“排序容器”仅在受支持的容器(如箱子、潜影盒)上可用。
变更
- 界面内的
S/Q/R/G/I按钮图标现在以 0.75x 比例渲染,而非完整字体大小,使它们在 10px 的按钮内看起来不那么拥挤。
[1.0.1] - 2026-07-10
修复
- 关键问题(Fabric): 发布的 jar 包丢失了 Fabric
client源集的所有类——客户端入口点、配置界面、按钮组件以及两个 mixin(AbstractContainerScreenMixin、CreativeModeInventoryScreenAccessor)均未打包进最终分发的 jar 中。启动时 Mixin 的配置准备阶段失败,一旦有任何类被转换就会抛出InvalidMixinException崩溃(通常会被误认为是其他模组触发了首个 mixin 转换所致,例如 Axiom 的preLaunch);即使没有发生此崩溃,客户端 UI 也从未实际生效。根本原因:fabric/build.gradle中的shadowJar任务仅打包了sourceSets.main.output,从未包含sourceSets.client.output。通过在shadowJar中添加from sourceSets.client.output解决此问题。此问题影响了自common/fabric模块拆分以来(即0.4.0-alpha起)的所有 Fabric 版本;NeoForge 不受影响(因为它不使用分离的源集)。
[1.0.0] - 2026-07-08
首个稳定版本。与 0.4.1-beta 相比无功能变更——所有 MVP 及后续计划的功能(排序、玩家背包排序、Restock、Quick Stack、潜影盒支持、设置界面)均已完成并在 Fabric 和 NeoForge 上正常运行。此版本标志着这一里程碑:Easy Sort 不再处于 alpha/beta 阶段,而是一个可信赖的稳定工具。捆绑包、锁定/忽略槽位、收藏功能和自动排序仍规划为 1.0 之后的小版本更新(详见 ROADMAP.md)。
[0.4.1-beta] - 2026-07-04
首个 beta 版本:MVP + 所有计划的 post-MVP 功能(Restock、Quick Stack、潜影盒支持)已在 Fabric 和 NeoForge 上完成。与 0.4.0-alpha 相比无功能变更——此次发布代表信心的提升,而非新增功能,旨在正式 dedicated-server 测试之前进行验证。
变更
- 在 Fabric 和 NeoForge 上,将占位符 “ES” 图标替换为真实图标(箱子 + 闪光效果)。
[0.4.0-alpha] - 2026-07-04
新增
- NeoForge 支持(1.21.10):功能与 Fabric 完全一致——排序、设置、Restock、Quick Stack、“I” 背包排序按钮/热键以及潜影盒支持均能正常工作。通过 Architectury Loom 构建为新的
neoforge/Gradle 模块,直接基于 NeoForge 自身的网络、事件和键绑定 API 实现。已在两个平台上手动验证游戏内表现。
修复
- 背包排序(“I” 按钮/热键)不再重新排列快捷栏——现在仅对 27 个主存储槽进行排序,适用于 Fabric 和 NeoForge。在使用期间重新排列快捷栏会造成干扰(例如当前手持的工具可能会跳到另一个槽位)。
[0.3.1-alpha] - 2026-07-04
修复
- 修正了潜影盒界面上 “I”(背包排序)按钮的垂直位置——由于
ShulkerBoxScreen在基类已根据imageHeight计算标签位置后调整了imageHeight,导致其相对于箱子类型容器偏移了一个像素。
变更
- 将按钮行尺寸从 12x12 缩小至 10x10,并重新排列为从左到右依次为 S、Q、R、G。
[0.3.0-alpha] - 2026-07-03
新增
- 潜影盒支持:排序、设置、Restock 和 Quick Stack 现在均可在放置的潜影盒上使用,而不仅限于箱子类型容器。
变更
- 通用化了模组查找菜单底层
Container的方式:ShulkerBoxMenu没有公开的 getter(不同于ChestMenu),因此MenuContainers改为从菜单自身的槽位列表中读取它——该技术适用于任何基于原版容器的菜单,而不仅是目前处理的两种类型,因此未来添加更多容器类型时无需新增特定的类型适配代码。
[0.2.0-alpha] - 2026-07-03
首个 post-MVP 功能版本:Restock 和 Quick Stack。
新增
- Restock(“R” 按钮):从打开的容器中补充玩家现有的部分堆叠物品——绝不会在空白的背包槽位中创建新堆叠。
- Quick Stack(“Q” 按钮):将玩家背包中所有已存在于打开容器中的物品移入其中,优先填充现有堆叠,然后再填满容器的空槽位。
- 新增
core.transfer.TransferEngine,独立于 Minecraft 进行测试(单元测试),并与真实容器/玩家进行了集成测试(GameTest),确认这两种操作均永远不会触碰已装备的护甲或副手物品。
[0.1.1-alpha] - 2026-07-03
与 0.1.0-alpha 相比无功能变更。重新发布以激活 Modrinth 和 CurseForge 在发布工作流中的发布功能,如今这两个项目均已存在。
[0.1.0-alpha] - 2026-07-03
首个公开 alpha 版本。箱子类型和玩家背包排序功能端到端完整可用;配置/设置及潜影盒支持仍在进行中。
新增
- 核心排序引擎:合并部分堆叠(受限于每种物品的最大堆叠数量),并通过可配置的顺序(模组 ID / 物品 ID / 数量 / 显示名称)进行确定性排序。
- 箱类容器上的排序按钮(“S”):箱子、大型箱子、 barrels、陷阱箱、末影箱以及带箱子的矿车——均共享原版的
ChestMenu。在操作任何内容之前,服务器会重新验证玩家当前打开的菜单。 - 玩家背包排序:通过“i”按钮(在任何容器界面均可用)和可重绑定的热键(默认为
R,控制 > 库存)实现——仅操作 36 个快捷栏 + 存储槽,绝不触碰已装备的盔甲或副手物品。 - 排序设置界面(设置 / “G” 按钮):选择主要排序键,按玩家持久化保存到
config/easy-sort.json,并在每次排序请求时发送,因此它跟随你跨服务器使用,而不是作为每个服务器的独立设置。 - 紧凑的扁平按钮行(自定义
MiniButton组件,无原版斜面纹理),内联定位在容器标题 / “Inventory” 标签旁。
修复
- 库存排序按钮不再出现在创造模式的项目浏览选项卡(建筑方块、自然方块等)上——仅在创造模式的实际“Inventory”选项卡中显示。
已知限制
- 暂不支持潜影盒(需要单独的
ShulkerBoxMenu类)——计划在 MVP 之后支持。 - Restock 和 Quick Stack 按钮可见但尚未启用功能(为禁用的占位符)。
- 配置屏幕允许你选择一个主要排序键,但不支持完整的多键拖放排序。
测试
- GameTest 集成覆盖(
gametest源集),用于对真实方块实体/玩家/注册表的ContainerAdapter进行测试:箱子合并与排序、最大堆叠数量限制,并确认库存排序绝不可能触及已装备的盔甲或副手物品。作为./gradlew build/CI 的一部分自动运行。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
添加区块认领和玩家组队功能,并与 Xaero's Minimap 和 World Map 集成
模组
添加全屏世界地图,显示你在世界中已探索的区域。与 Xaero's Minimap 搭配使用效果极佳。
评论 0
登录后参与评分
还没有评论,来抢沙发吧