按快捷键（Alt+R）整理附近箱子。空间排序、优先填充已标记箱子、堆叠合并、安全溢出处理、修复地面物品复制问题。支持多人模式。

Valheim自动整理 v2.4.0

按需一键整理附近箱子。箱子会根据自身内容推断类别；你可以通过游戏内容器中的类别下拉菜单永久固定类别。通过ZDO同步兼容多人游戏。

功能

功能	详情
按键绑定排序	按下 Alt+R （可配置）对范围内所有箱子进行排序 扫描半径
空间排序	宝箱按阅读顺序填充（左上→右，然后向下）；同类宝箱归为一组
先填满优先标记	同类的标记宝箱会先完全填满，再溢出到下一个。
类别推断	宝箱中木质物品占主导时“拥有”木材——无需设置
标签覆盖	自动排序标签 木材 看着箱子时，会永久钉在木桩上
地面吸附	掉在地上的物品会定期被吸入对应的箱子中
悬停提示	显示宝箱分类、已标记或推断信息，以及排序快捷键提示
视觉效果	已分类箱子上的蓝色高亮+粒子特效（可配置）
多人游戏	移动物品至此 + ZDO脏标记；无需服务器插件

配置

首次启动后的配置文件位置：

BepInEx/config/com.yourname.valheim.autosort.cfg

可在游戏内编辑，通过 r2modman 配置编辑器 或任何文本编辑器。

1 — 通用

按键	默认	描述
已启用模组	真	主开关。无需卸载即可禁用所有功能。
调试日志	假	用于故障排除的详细 BepInEx 控制台日志记录。

2 — 宝箱标记

按键	默认	描述
启用标签覆盖	真	允许 自动整理标签 <Category> 用于标记宝箱。若在游戏进程中更改，需重新登录才能对已有宝箱生效。

3 — 排序通过

按键	默认	范围	描述
排序按键	Alt+R	任意按键组合	触发完全排序的键盘快捷键。可通过r2modman配置。
扫描半径	16	4 – 64米	排序时纳入玩家周围半径范围内的宝箱。

4 — 地面物品

按键	默认	范围	描述
启用地面吸附	真	—	定期将地面物品拉入匹配的箱子中。
地面吸附半径	8	2 – 32 米	玩家周围搜索地面物品的半径。独立于 扫描半径.
地面吸附间隔	5	1 – 60 秒	地面扫描间隔秒数。数值越低响应越快，CPU占用略高。

5 — 效果

按键	默认	描述
高亮容器	真	物品整理进箱子时，箱子会闪蓝光。
Ping容器	真	在排序后的宝箱处生成粒子特效。
Ping特效	生命值中药水特效	特效预制体名称。留空则禁用。 浏览预制体

---

用途

基础（零配置）

将箱子建造在彼此附近，并在每个箱子中放入不同类型的物品。存入几次后，模组会推断出每个箱子的分类。按下 Alt+R 随时为你重新分配物品。

手动标记宝箱

查看箱子，打开控制台（F5）：

自动排序标签 石头

有效类别（不区分大小写）：

石头、木材、金属、矿石、宝石、皮革、骨头、纤维、种子、食物、药水、鱼、箭、武器、盾牌、护甲、工具、魔法、战利品、家具、杂项

清除标签：

自动分类标签

---

工作原理

玩家按下 Alt+R │ ▼ Patch_Player_Update 检测到 SortKeybind.IsDown()（若背包/地图/商店界面已打开则拦截） │ ▼ SortEngine.TriggerSortPass() ├─ 设置 IsRearrangingItem = true（拦截所有 AddItem 回调） ├─ 让出一帧 │ └─ DoSort(playerPosition) ├─ ChestOwnershipResolver.Resolve() │ ├─ 已标记箱子 → 固定分类，优先级 1 │ │ └─ 同分类多个已标记箱子：最右侧优先 │ └─ 推断箱子 → 主导物品分类，优先级 2 │ ├─ ChestOwnershipResolver.PlanSortFull() │ ├─ SortInferredByPosition() │ │ ├─ 第一遍：阅读顺序（左上 → 右，再向下） │ │ ├─ 第二遍：找到每个分类最早的空间锚点 │ │ └─ 第三遍：将同分类箱子聚拢到其锚点 │ │ │ └─ FindDest() 优先级链（与单物品路径一致）： │ 1. 已标记箱子（最右侧优先，先填满再溢出） │ 2. 已持有该物品的推断箱子（合并） │ 3. 该分类的任意推断箱子（按空间顺序） │ 4. 空闲/未占用箱子（空间上最早） │ ├─ 执行移动（延迟移除以避免 HashSet 变更崩溃） │ ├─ 对每个脏箱子执行 PackInventorySlots() │ ├─ 每个被修改的箱子仅调用一次 MarkDirty()（ZDO 写入） │ └─ 重新读取实时背包 → 通知玩家任何无家可归的分类