胸部整理

ChestSort

ChestSort 是一个适用于 Minecraft 1.21.x 与 26.2 的 Fabric 模组，可帮助你追踪物品存放的位置（箱子与木桶），并借助基于单个容器的规则，快速将物品栏中的物品整理进容器内。

太长不看

ChestSort 是高级分类红石装置的轻量化替代方案，让你无需接触红石就能获得部分分类便利，只需点击按钮即可完成整理。

---

是否曾经有一堆箱子和木桶，却忘了某个物品放在哪里？ChestSort 允许你搜索某个物品，并查看哪些容器中存有它，同时在世界和 UI 中高亮显示。

在 Minecraft 游戏前期，你大概总会有一个“箱子怪物”——一大排用来倾倒物品的箱子。玩家之后会开始搭建自动分类系统，但这些系统可能很复杂，还需要大量资源。ChestSort 是一个轻量化替代方案，让你无需搭建红石装置，只需点击按钮，就能获得部分分类便利。

你可以为每个容器设置过滤规则，指定哪些物品属于其中，然后一键将物品栏中匹配的物品快速整理进已打开的容器。

你还可以在我们的 github 上找到适用于任意世界的预制预设。

功能

• 持久化容器数据库

  • 仅追踪箱子和木桶。
  • 存储每个容器的物品数量及最后更新时间戳。
  • 数据库在重启后依然保留。

• 快速物品查找

  • 搜索某个物品，并获取包含它的容器列表。

• 查找时的世界高亮

  • 执行 /cs find 后，在世界中高亮匹配的容器（轮廓渲染）。

• GUI 内高亮

  • 当你打开一个包含当前搜索物品的箱子/木桶时，该容器会在 UI 中被高亮。

• 高亮模式

  • /cs highlights on|off|until_opened 控制是否显示高亮，以及是否在你打开高亮容器后自动清除。
  • /cs highlights dismiss 清除当前高亮。

• 打开时自动刷新

  • 每当你打开一个箱子/木桶时，该容器保存的快照会自动刷新。

• 每容器过滤规则（白名单 + 黑名单）

  • 每个箱子/木桶都可以基于以下内容拥有白名单 + 黑名单规则：
    • 明确的物品 ID（例如 minecraft:cobblestone）
    • 物品标签（例如 #minecraft:logs）并支持每个标签的例外项
    • 应用的预设（可重复使用的已保存规则集）
  • 如果某个物品同时匹配白名单和黑名单，你可以通过每个容器的优先级开关选择哪一方优先。

• 一键整理

  • 当容器拥有任意规则时，会出现一个 整理（Sort） 按钮。
  • 点击 整理 会将你物品栏中匹配的物品移动到已打开的容器中。
  • 匹配黑名单的物品不会被移动（除非将白名单设置为在冲突中获胜）。

• 整理反馈 + 撤销

  • 在整理/自动整理/组织之后，左侧会显示通知，说明移动/更改了什么。
  • 包含一个 撤销（Undo） 按钮，用于还原最近一次操作。

• 自动整理模式

  • 每玩家自动整理模式（never、selected、always），以及每个容器的自动整理开关。

• 组织（Organize）

  • 组织 按钮会重新排列已打开的容器，以合并堆叠并归类物品。

• 预设编辑器 + 导入/导出

  • 在专用 UI 中编辑预设。
  • 预设支持 白名单/黑名单 选项卡（与容器相同）。
  • 以可分享的 cs2| 字符串导入/导出预设（包含黑名单数据）。

• 魔杖（区域批量编辑）

  • 将任意物品绑定为魔杖并选择区域：
    • 左键设置 pos1
    • 右键设置 pos2
  • 选择区域会在世界中被高亮，并显示区域方块数量和容器数量。
  • 在所选区域中批量应用过滤器/自动整理。

命令

所有命令均位于 /cs 下。

• /cs help

  • 显示游戏内帮助页面，说明 UI 和命令用法。

• /cs scan

  • 扫描已加载的区块中的箱子和木桶，将其内容记录到数据库。
  • 记录扫描发生的时间。

• /cs find <item>

  • 查找哪些已扫描的容器包含指定物品。
  • <item> 支持自动补全。
  • 记住你正在“查找”的物品，以便在你打开匹配容器时触发 GUI 高亮。

• /cs autosort <never|selected|always>

  • 设置你的每玩家自动整理模式。

• /cs highlights <on|off|until_opened|dismiss>

  • 控制高亮对你的行为方式。

• /cs tags <item>

  • 输出指定物品的标签（用于构建标签过滤器）。

• /cs blacklist ...

  • 阻止黑名单中的物品被整理/自动整理移动。
  • add <item> / remove <item> / list / clear
  • addPreset <name> <blacklist|whitelist|everything>（从预设的黑名单、白名单或两者中添加物品）

• /cs presets ...

  • 管理预设：
    • add <name> / remove <name> / rename <old> <new> / edit <name> / list
    • import / export <name> / exportAll / exportSelect

• /cs wand ...

  • 区域选择 + 批量操作（仅限已加载区块）：
    • bind（绑定你当前主手中的物品）
    • unbind（移除魔杖绑定）
    • deselect（清除 pos1/pos2 选择）
    • copy [pos]（将目标容器的过滤器复制到剪贴板）
    • paste（将剪贴板过滤器应用到区域内的所有容器）
    • autosort <on|off>（批量切换每个容器的自动整理）
    • clear（清除区域内的过滤器）
    • merge（将区域内所有过滤器合并到剪贴板中）

容器过滤 UI

1. 打开一个箱子或木桶。
2. 点击容器界面右侧的 过滤（Filter）。
3. 使用左侧面板查看已应用的内容：

• 过滤物品
• 过滤标签（含例外项）
• 过滤预设

1. 使用左侧标题选项卡在 白名单 和 黑名单 之间切换。
2. 如果同时使用两个选项卡，请设置冲突优先级（当物品同时匹配两者时哪一方获胜）。
3. 使用右侧面板搜索：

• 输入文本以搜索物品
• 输入 #something 以搜索标签
• 输入 &name 以搜索预设

1. 点击绿色 + 添加规则，点击红色 x 移除。
2. 如果过滤规则非空，点击 整理 将物品栏中匹配的物品移动到容器中。

组织：

• 点击 组织 以打包并归类已打开的容器。

撤销：

• 在整理/自动整理/组织之后，使用 撤销 按钮进行还原。

自动整理：

• 过滤 UI 中包含当前容器的 自动整理 开关。
• 自动整理行为取决于你的 /cs autosort 模式。
• 当自动整理触发时，每当你打开容器，它会自动将物品栏中匹配的物品移动到容器中。

注意：

• 过滤器按容器位置 + 维度存储。
• 本模组仅针对箱子和木桶。

安装

1. 为 Minecraft 1.21.11 安装 Fabric Loader。
2. 安装 Fabric API。
3. 将构建好的模组 jar 放入你的 mods/ 文件夹。

开发

• Minecraft：1.21.11
• Yarn mappings：1.21.11+build.4
• Fabric Loader：0.18.4
• Fabric API：0.141.3+1.21.11
• Java：21

关于扫描的说明

• /cs scan 仅扫描已加载的区块（不会强制加载区块），这意味着它不一定能看到世界中的所有容器。
• 本模组依赖玩家在放置容器或加载新区块后运行 /cs scan；在执行扫描之前，数据可能不准确。不过，当你打开容器时，本模组会自动检测新容器或容器内容的变化。

关于整理的说明

• 整理只会将物品从你的物品栏移动到已打开的容器中；它不会在容器之间移动物品，也不会将物品从容器移动到你的物品栏中。
• 某些服务器可能将此视为不公平优势或游戏修改，并且可能会触发反作弊，因为将物品放入容器会快速连续发送多个数据包。在多人服务器上请谨慎使用。