智能背包管理器

智能背包管理器

轻量级的Fabric客户端模组，增加了安全的图标按钮和快捷键，以便快速整理库存和常见容器。

工具

智能背包管理器预览查看大图

智能背包管理器

智能背包管理器是一款客户端侧的 Fabric 模组，提供快速、安全的背包整理功能，配有简洁的图标按钮、按键绑定、多种排序模式、JSON 配置恢复、Mod Menu 支持以及广泛的语言本地化。

作者：Matfi1

功能特性

  • 在背包界面中整理玩家背包。
  • 整理常见容器：箱子、木桶、潜影盒、漏斗、发射器和投掷器。
  • 使用紧凑的图标按钮代替大号文字按钮。
  • 通过游戏内图标按钮切换排序模式。
  • 模式图标会随所选排序模式变化。
  • 长悬停提示文字解释每个图标的含义。
  • 可通过主菜单/暂停菜单和按键绑定访问设置。
  • 启用 ignoreHotbar 时，整理会保护已锁定的快捷栏槽位。
  • 整理会尊重已配置的 lockedSlots。
  • 无效的配置文件会被备份，并用默认配置替换。
  • MVP 版本不含 Mixin。

排序模式

  • 物品 ID
  • 类别
  • 数量
  • 耐久度
  • 名称 A-Z
  • 名称 Z-A

操作控制

默认按键绑定：

  • I：整理玩家背包
  • O：整理已打开的容器
  • K：打开智能背包管理器设置

你可以在 Minecraft 的控制设置中更改这些绑定。

支持版本

构建好的 Modrinth JAR 文件保存在 dist/modrinth/ 目录下。

Minecraft 版本 JAR 文件
1.21 SmIm-1.21.jar
1.21.1 SmIm-1.21.1.jar
1.21.2 SmIm-1.21.2.jar
1.21.3 SmIm-1.21.3.jar
1.21.4 SmIm-1.21.4.jar
1.21.5 SmIm-1.21.5.jar
1.21.6 SmIm-1.21.6.jar
1.21.7 SmIm-1.21.7.jar
1.21.8 SmIm-1.21.8.jar
1.21.9 SmIm-1.21.9.jar
1.21.10 SmIm-1.21.10.jar
1.21.11 SmIm-1.21.11.jar
26.1 SmIm-26.1.jar
26.1.2 SmIm-26.1.2.jar

Minecraft 26.1 和 26.1.2 需要 Java 25。

安装方法

  1. 安装对应 Minecraft 版本的 Fabric Loader。
  2. 安装对应 Minecraft 版本的 Fabric API。
  3. 将匹配的 SmIm-*.jar 文件放入你的 mods 文件夹中。
  4. 可选：安装 Mod Menu 以从模组列表中打开配置界面。

这是一个仅客户端模组。服务器端不需要安装。

配置文件

配置文件在以下位置创建：

config/smartinventorymanager.json

配置项：

  • enableInventorySort
  • enableContainerSort
  • buttonSide
  • buttonScale
  • animationEnabled
  • sortMode
  • ignoreHotbar
  • lockedSlots

如果 JSON 文件损坏，智能背包管理器会将其重命名为带时间戳的 .broken 备份文件，并创建一个新的默认配置。

本地化

已包含的语言：

  • 英语 (en_us)
  • 俄语 (ru_ru)
  • 德语 (de_de)
  • 法语 (fr_fr)
  • 西班牙语 (es_es)
  • 葡萄牙语（巴西）(pt_br)
  • 意大利语 (it_it)
  • 波兰语 (pl_pl)
  • 乌克兰语 (uk_ua)
  • 土耳其语 (tr_tr)
  • 荷兰语 (nl_nl)
  • 捷克语 (cs_cz)
  • 匈牙利语 (hu_hu)
  • 简体中文 (zh_cn)
  • 繁体中文 (zh_tw)
  • 日语 (ja_jp)
  • 韩语 (ko_kr)

兼容性

智能背包管理器使用 Fabric 屏幕事件，并避免使用不安全的控件列表索引。如果某个屏幕无法识别，功能路径会以软失败方式处理，而不会导致客户端崩溃。

手动兼容性测试目标：

  • Sodium
  • Iris
  • Mod Menu
  • Mouse Tweaks
  • Shulker Box Tooltip
  • JEI
  • libIPN

这些是手动测试目标，并非完整的兼容性认证。如果两个模组同时移动背包槽位，可能会发生冲突。

构建方法

构建所有支持的 Modrinth 文件：

./scripts/build-modrinth.sh

构建单个 Minecraft 版本：

./gradlew clean build -PmcVersion=1.21.11

使用 Java 25 构建 26.x 版本：

JAVA_HOME="$PWD/.jdks/jdk-25" ./gradlew clean build -PmcVersion=26.1
JAVA_HOME="$PWD/.jdks/jdk-25" ./gradlew clean build -PmcVersion=26.1.2

构建成功的 JAR 文件会被复制到：

dist/modrinth/

手动测试计划

  • 打开玩家背包界面。
  • 确认排序和模式图标位于背包 GUI 外部，而不是中心区域。
  • 打开箱子、木桶、潜影盒、漏斗、发射器和投掷器。
  • 在每个支持的屏幕中点击排序按钮。
  • 切换排序模式，确认模式图标会相应变化。
  • 使用按键绑定进行玩家背包和容器排序。
  • 更改 GUI 缩放比例并重新打开屏幕。
  • 损坏配置文件 JSON，确认备份文件生成以及默认配置重新创建。
  • 使用 Mod Menu 启动，确认配置界面能打开。
  • 使用 Sodium/Iris 启动，确认 GUI 仍能正常渲染。

开发路线图

未来版本计划的功能想法：

  • 快速堆叠
  • 补充快捷栏
  • 自动填充
  • 交互式槽位锁定界面
  • 清理背包

许可证

MIT