简单R键整理

SimpleSorterR

一款轻量级的客户端侧物品整理模组。

---

功能特性

一键智能整理

打开物品栏或容器后按 R 键即可整理物品。

• 自动堆叠合并 — 自动将相同物品的零散堆叠合并为完整堆叠，释放宝贵的物品栏空间
• 创造模式标签页原生排序 — 物品按照 Minecraft 创造模式的标签页顺序排列，并支持模组物品
• 自定义排序顺序 — 调整配置文件中的 tabOrder 以更改标签页优先级
• 固定物品 — 配置 pinnedItems 以将特定物品始终排在前面
• 动态容器黑名单 — 默认情况下所有存储容器均可整理（包括强化箱子等模组容器）。功能性容器通过 blockedContainers 中的精确类名进行排除；你也可以在打开容器时按 B 键自动将其加入黑名单
• 无界面主物品栏整理 — 启用 sortInventoryWhenNoScreen 后，可在未打开任何界面时按 R 键整理玩家主物品栏
• 配置热重载 — 直接编辑 simplesorter.json，更改将在下一次按 R 键整理时生效，无需重启游戏
• 纯客户端侧运行 — 整理通过模拟点击完成，因此服务器无需安装此模组

---

鼠标快捷操作

Shift + 拖动快速移动

按住 Shift 并在多个格子间 左键拖动 — 经过的每个格子的物品都会立即快速移动到对面的物品栏中。

适合一次性移动大量物品。

Shift + 双击移动所有同类物品

在光标 持有物品 时，对同类物品 Shift + 双击 即可立即将该物品栏中 所有同类物品 快速移动到另一侧。

适合从箱子中取出所有同类物品。

空格 + 双击全部移动

按住 Space 并对容器中的任意格子 双击，即可将该物品栏中的 所有物品 立即快速移动到对面。

适合快速清空箱子。

V + 双击存入匹配物品

按住 V 并对容器中任意已填充的格子 双击，可将玩家主物品栏中的匹配物品快速移入容器，但仅限该物品已存在于容器中时。

• 不会移动快捷栏格子
• 不会移动已锁定的格子
• 不会移动容器中不存在的物品
• 光标持有物品时不会触发

适合从主物品栏向已整理的箱子补充物品。

---

格子锁定

按住 Alt 并 点击 任意格子即可进行 锁定 — 锁定的格子会显示覆盖层。

• 按 R 键整理时，锁定的格子 绝不会被移动
• 锁定的快捷栏格子 受保护不会因 Q 键掉落（防止意外丢弃）
• 锁定状态 自动保存，并针对每个存档独立保存
• 再次 Alt + 点击 即可解锁
• 按住 Alt + 左键拖动 可一次锁定或解锁多个格子。第一个格子的状态决定后续操作是锁定还是解锁
• 覆盖层颜色可通过 lockOverlayColor 自定义，支持 #RRGGBB 和 #AARRGGBB 两种格式

颜色值使用 十六进制颜色代码。支持 #RRGGBB 和 #AARRGGBB 两种格式。8 位格式使用 ARGB 顺序：AA 不透明度、RR 红色、GG 绿色、BB 蓝色。不是 RGBA。

常用 AA 值：40 非常透明、80 半透明、C0 基本不透明、FF 完全不透明。示例：#80FF0000 半透明红色、#8000FF00 半透明绿色、#800000FF 半透明蓝色。

适合将工具固定放置在特定格子中，并减少意外丢弃。

---

自动替换器

• 工具损坏替换 — 当手中的工具损坏时，自动从物品栏中装备同类型的替换工具
• 可堆叠物品补充 — 当手中的可堆叠物品用完时（例如放置方块），自动从物品栏中补充
• 可在设置界面中 开启/关闭

适合需要重复放置或挖掘物品的建造和挖矿场景。

---

Caps Lock + 双击批量丢弃

按住 Caps Lock 并对任意格子 双击，即可丢弃该物品栏中 所有同类物品（使用 Q 键丢弃操作）。

适合快速清理大量同类物品。

---

游戏内配置

按 Z + I（默认组合键）可在游戏内打开图形化设置面板：

• 标签页排序顺序（tabOrder） — 自定义创造模式标签页的优先级
• 固定物品（pinnedItems） — 指定始终排在整理最前面的物品 ID
• 容器黑名单（blockedContainers） — 添加要排除整理的容器类名，或在打开容器时按 B 键自动写入当前类名
• 锁定覆盖层颜色（lockOverlayColor） — 自定义锁定格子的覆盖层颜色，例如 #80FF0000
• 无界面整理（sortInventoryWhenNoScreen） — 允许在未打开界面时按 R 键整理玩家主物品栏
• Z 键保护开关 — 禁用 Z 键要求，仅按 I 即可打开设置
• 自动替换器开关 — 启用/禁用自动工具和物品替换
• 本地化界面 — 设置界面自动适配游戏语言（英文 / 中文）

如果安装了 Mod Menu，也可以从其中访问。

高级设置可直接编辑 config/simplesorter.json。更改将在下一次按 R 键整理时生效。

⚠️ blockedContainers 使用 精确类名匹配，而非模糊匹配。根据映射表和 Minecraft 版本，类名可能显示为 GenericContainerScreenHandler 而非 ChestMenu；最安全的方式是打开目标容器后按 B 键，让模组自动写入正确的名称。

---

前置要求

依赖	是否必需	说明
Fabric Loader ≥ 0.16.5	✅ 必需	模组加载器
Fabric API	✅ 必需	核心 API 库
Fabric Language Kotlin	✅ 必需	Kotlin 运行时支持
Cloth Config API	❌ 内置	配置界面框架（已包含在模组 jar 中）
Mod Menu	❌ 可选	在模组列表中添加入口

---

安装方法

1. 安装 Fabric Loader 和 Fabric API
2. 下载 Fabric Language Kotlin 并放入 mods 文件夹
3. 选择与你的 Minecraft 版本匹配的 jar 文件，放入 mods 文件夹
4. 启动游戏

---

按键绑定参考

所有按键绑定均显示在 Minecraft 控制设置中的 SimpleSorterR 分类下，可在此处更改。

按键	动作	适用场景
R	整理物品栏	打开容器时；如果启用，也可在无界面时整理主物品栏
Alt + 点击	锁定 / 解锁格子	防止该格子被整理
Alt + 左键拖动	批量锁定 / 解锁格子	在多个格子上拖动
B	切换当前容器黑名单	当当前容器不应被整理时
Caps Lock + 双击	批量丢弃同类物品	快速清理大堆叠物品
Shift + 拖动	快速移动多个格子	按住 Shift 在格子上拖动
Shift + 双击	移动所有同类物品	光标持有物品时
空格 + 双击	移动容器中所有物品	一次性清空整个物品栏
V + 双击	存入匹配物品	仅从主物品栏移动容器中已有的物品
Z + I	打开设置界面	随时可用

---

SimpleSorterR
一款简单的 Minecraft 物品整理工具。