快速堆叠到附近的箱子，热键查找物品存放位置，Ctrl+O搜索周围箱子中的所有物品，以及根据队友材料解锁的配方。客户端功能；服务器可选择强制执行其配置。

整理宝箱

瓦尔海姆1.0的泰拉瑞亚风格快速堆叠。A 储物箱 物品栏中的按钮会将你的材料、食物、弹药和战利品移入附近已存放该类物品的箱子中（默认范围为10米）。装备、工具、武器、已装备物品、任务物品以及快捷栏模组的槽位会保持原位。当你想知道某样东西放在哪里时，在物品栏中指向它并按下 T背包关闭后，范围内所有装有该物品的宝箱都会亮起，屏幕上显示箭头和数量。 Ctrl+O 列出你周围所有宝箱中的物品，并附带搜索框。在合作模式中，队友放入这些宝箱的材料会自动为你解锁相应配方，无需再逐一寻找每个新堆叠去触碰。A 排序 胸板上的按钮会整理打开的箱子，并且它可以与 多用户箱子，即使另一名玩家也打开了同一个宝箱。

客户端：将其安装到每个需要使用它的玩家的游戏中。服务器端无需任何操作，未安装该模组的玩家也可以在同一服务器上游戏。

来源、问题和版本： github.com/egor-muindor/ValheimMods.

功能

• 储物箱按钮：库存中每种可堆叠的普通物品都会送往半径内最近的、已经装有同名物品的箱子。优先补满已有的堆叠，然后使用空槽位，剩余部分继续送往下一个箱子。箱子、加固箱和黑金属箱、推车以及船的货舱都算数。没有存放你任何物品的箱子绝不会被碰，所以你的分类方式始终归你掌控。新的堆叠会放入符合该箱子排序规则的空槽位（[排序] 排序顺序 和 排序布局），当有空间时放在同一物品旁边，但箱子里已有的物品不会被移动：只有排序按钮才会移动它们。
• 留下的已装备的物品；工具、武器、护甲及其他装备；任务物品；快捷栏（可选）；Extra Slots 的快捷、装备、食物、弹药及杂项槽位；EquipmentAndQuickSlots 的所有槽位；Better Archery 的箭袋行；黑名单中的任何内容；已锁定的物品和槽位；不在允许列表中的物品类型。
• 锁：指向物品并按下 Shift+L 将其锁定，而“存放”按钮则会让该物品留在原地不动。指向一个槽位并按下 Shift+K 锁定槽位本身，让放入其中的物品保持不变。按住 Shift 打开物品栏即可看到锁：锁定物品上显示灰色挂锁，锁定槽位上显示红色挂锁，指针所在槽位会显示带有按键提示的工具提示。再次按下即可解锁。按键和锁本身都保存在配置中，因此重启后仍然保留，并且可以编辑。
• 排序按钮：整理你已打开的箱子，且仅在你按下时才会执行。相同物品的堆叠会合并，然后按物品ID（或按名称，或按类型）排列，默认每个物品另起一列。只需切换一个配置开关，即可改为按行排列或排成一条无间隔的连续序列。箱子没有锁定槽位，因此箱内所有物品都会参与整理。两次按下间隔小于0.2秒将被忽略。
• 兼容MultiUserChest当另一名玩家先打开箱子并拥有其所有权时，排序按钮会将 MultiUserChest 自己的移动请求发送到该玩家的游戏中，由对方按顺序执行。如果对方在同一时刻移动了某样东西，那些不再适合的请求会被拒绝，因此箱子可能只完成部分整理，但不会有任何物品丢失或复制。如果没有 MultiUserChest，或者箱子归你所有，则会一次性重写并保存一次，其开销不超过移动单个物品。
• 找到钥匙 (T 默认）：打开背包后，指向某件物品并按下按键。范围内所有存有该物品的箱子会获得脉冲光效、自发光染色以及带有数量和距离的屏幕标记，默认持续8秒。背包会关闭以便你环顾四周；如果没有箱子存有该物品，会显示一条提示信息，背包保持打开。对已打开箱子中的物品以及合成面板中的物品同样有效：指向所选配方的原料、配方图标或配方列表中的条目，即可查看哪些箱子存有该物品。
• 宝箱列表 (Ctrl+O 默认情况下）：扫描半径内所有箱子中的每件物品，每种一行，显示总数、有多少箱子装着它以及最近的箱子有多远。输入即可按名称筛选；点击某一行关闭列表并高亮所有装有该物品的箱子，或按回车选择第一行。按 Escape 或同一个键关闭。打开时角色原地站立，滚轮滚动列表而不是缩放镜头。表头可按名称或数量排序，行左侧的菱形可将该物品固定到列表顶部——它会留在那里，数量显示为 0，即使最后一个也已用尽。
• 从宝箱中学习你周围箱子里的物品会被视为已找到，因此它们的配方会解锁。Valheim通常只会在材料进入你自己的物品栏后才解锁配方，而在多人游戏中，这意味着你得把队友收集的每一堆材料都找出来。奖杯也算数。 此操作无法撤销：转向 从宝箱学习 稍后关闭不会再次锁定配方。
• 已本地化：按钮标签和消息会跟随游戏语言（包含英语和俄语，其他地区为英语）。
• 多人游戏: 与 多用户箱子 物品通过它的请求处理，共享箱子也是如此运作。没有它的话，其他玩家已打开的箱子、使用中的推车以及船只货物（在多人模式下）都会被跳过，并且模组会在写入之前取得箱子的所有权，就像打开箱子一样。

安装

需要 BepInEx 5.

• 使用模组管理器（r2modman、Thunderstore Mod Manager）：按常规方式安装。
• 手动操作：解压发布包并将 整洁宝箱 导入文件夹 BepInEx/plugins，所以这个模组最终位于 BepInEx/plugins/TidyChests/TidyChests.dll.

配置文件 BepInEx/配置/muindor.TidyChests.cfg 在首次启动时创建。

配置

服务器

按键	默认	描述
配置优先级	假	仅限服务器。开启后，此服务器的设置将覆盖所有同样安装了该模组的客户端的设置。

在专用服务器上或主持会话的机器上安装此模组，然后打开 配置优先级 让每位玩家都拥有相同的触及范围和相同的规则：每个同样安装了Tidy Chests的客户端都将按照服务器的设定运行 启用, 半径, 包含快捷栏, 物品类型, 黑名单, 扫描半径, 扫描间隔 和 从宝箱学习。他们被标记了 已同步 在生成的 .cfg.

按键、储物箱按钮、面板和高亮显示都归每位玩家自己掌控：服务器没有理由决定某人的按钮该放在哪里，或者哪个键打开他的箱子列表。

这绝不会使该模组在任一方成为必需：

• 没有该模组的玩家不受影响。该模组不属于游戏版本检查的一部分，因此无论是否安装，都不会阻止连接。
• 拥有该模组的玩家仍然可以加入没有该模组的服务器，或者加入后离开 配置优先级 关闭，并保留各自的设置。
• 客户的 .cfg 从不写入。服务器的值在连接持续期间一直存在于内存中，并在连接结束时被丢弃。
• 在运行中的服务器上更改设置会立即将其发送给已连接的玩家。

通用

按键	默认	描述
已启用	真	启用模组：储物箱按钮、查找键、箱子列表以及从箱子中学习。
调试模式	假	记录每次物品决策以及存储时考虑过的每个箱子。

储物箱

按键	默认	描述
半径	10	玩家周围此米数内的宝箱可被使用，通过按钮和查找键，1到20。
快捷栏	假	同时也会从第一行物品栏中存放物品。
物品类型	材料，消耗品，弹药，非装备弹药，奖杯，杂项，鱼类	可能被存放的物品类型。移除 弹药 要保留箭矢，请添加 火把 用于存放火把等物品。有效名称已在配置文件中列出。
黑名单	空	从不存入储物箱的物品，以逗号分隔的预制体名称或物品名称： 木头，$item_coal，树脂.
显示消息	真	隐藏后显示一条带有结果的消息。
按排序顺序放置	真	将每个新牌堆放至可容纳它的空格中 [排序] 排序顺序 和 排序布局 最好放在同类物品旁边（如果有空间的话）。箱子中已有的物品不会移动。 假：第一个空单元格，就像游戏自带的按钮一样。

锁

按键	默认	描述
显示按键	左Shift键	打开物品栏时按住此键可查看锁，并在指针所指的槽位上显示包含锁键的提示信息。 None 从不给他们看。
锁定物品钥匙	左Shift	打开物品栏时，指向物品并按下此键可锁定或解锁。已锁定的物品无论位于何处都不会被存入仓库。允许使用修饰键。
锁定槽位键	K + 左Shift	打开物品栏后，指向某个槽位并按此键可锁定或解锁。已锁定槽位中的物品永远不会被存入仓库。允许使用组合键。
锁定物品	空	已锁定的物品，逗号分隔的游戏物品名称（$item_wood, $item_coal). 按键时书写；可手动编辑。
已锁定槽位	空	锁定的槽位，用逗号分隔 列:行 从0开始计数，快捷栏为第0行（0:1，7:3随按键输入而书写；可手动编辑。

查找

按键	默认	描述
查找钥匙	T	打开物品栏后，指向一件物品（物品栏中的物品，或制作面板中的材料或配方），然后按下此键。允许使用修饰键，例如 T + 左Ctrl.
高亮持续时间	8	找到的宝箱保持高亮显示的秒数，1到60。
屏幕标记	真	在发现的每个宝箱上绘制一个带有物品数量和距离的箭头，当宝箱不在视野内时，箭头显示在屏幕边缘。
光	真	用脉冲光芒点亮每个已发现的宝箱。
发光	真	为每个已找到的宝箱添加自发光光晕（仅适用于着色器带有自发光颜色的材质）。
关闭背包	真	找到宝箱时关闭物品栏。

按钮

按键	默认	描述
显示按钮	真实	在背包中显示储藏按钮。 整洁箱子储物箱 在控制台中无需它也能正常工作。
按钮偏移	41, -56	按钮相对于物品栏面板重量显示的位置，以UI像素为单位（x向右，y向上）。如果有其他UI模组在那里放了东西，请调整此位置。
按钮大小	120, 38	UI 像素中按钮的宽度和高度。

排序

按键	默认	描述
显示排序按钮	真	在箱子面板上显示排序按钮。 整理宝箱 排序 在控制台中无需它也能正常工作。
排序顺序	ID	ID：按物品的预制体名称（煤, 石头, 木头），在所有语言中都是一样的。 名称：以当前语言中显示的名称。 类型：武器、盾牌、工具、护甲、弹药、食物、材料、战利品，然后是其余的，每组按 编号同一物品中，品质更高、世界等级更高的优先。
排序布局	列	列每个物品都会新建一列，从上到下排列。 行每件物品都另起一行，从左到右排列。 顺序：所有物品从左到右紧密排列，不留空隙。当物品数量超过列数（或行数）时，其余物品同样紧密排列，不留空隙。
排序按钮偏移	0, 0	按钮从其原本位置（宝箱面板“全部堆叠”按钮旁边）的偏移量，单位为UI像素（x向右，y向上）。

排序设置由每位玩家自行决定，服务器不会进行设定。

扫描

被宝箱列表和宝箱学习功能使用。

按键	默认	描述
扫描半径	50	此距离内的宝箱可被读取，范围5至90米。超过约90米后，宝箱将不再加载，因此不会发现更多内容。
扫描间隔	5	两次扫描之间的秒数，1到60。内容未变化的箱子会被跳过，因此短间隔开销很低。

知识

钥匙	默认	描述
从宝箱中学习	真实	将范围内箱子中的物品计为已找到，从而解锁它们的配方。无法撤销；见上文。

浏览器

按键	默认	描述
浏览器密钥	左Ctrl + O	打开和关闭宝箱列表。允许使用修饰键；将其设置为 无 禁用该面板。
浏览器尺寸	520, 560	面板的宽度和高度，以 UI 像素为单位。
排序	降序	搜索框为空时列表的排序方式： 降序计数, 升序计数, 名称升序 或 名称降序. 通过点击标题设置，并保存在此处。
收藏	空	固定物品，以逗号分隔，使用游戏自身的物品名称（木头, 煤). 通过点击列表中的菱形设置，保存于此。

排序和固定

列表带有包含两个可点击列的标题。 名称 和 数量 每列均按该列排序；点击已决定顺序的列会翻转其排序方向，活动列会显示其排序方式（计数 9-1, 名称 A-Z）。列表按堆叠数量从大到小依次展开。

每一行左侧的钻石图标可以钉住物品。被钉住的物品会置于其他所有物品之上，而钉住区块的排序方式与其余部分相同。有两点让它不止是一个书签：

• 一旦范围内没有宝箱再包含该物品，它便会以数量0留在列表中并变暗，而不是消失。这样你就能看出亚麻是用完了，而不是注意到它不见了。点击这样一行不会有任何反应——因为没有宝箱可以点亮。
• 它能在重启和切换语言后依然保留：图钉是按游戏内部物品名称存储的，而不是按屏幕上显示的名称。

在搜索框中输入内容时，固定项会被忽略。搜索应优先返回最匹配的结果，而不是固定项；排序仍决定同等匹配结果之间的顺序。

控制台命令

整理箱子 存放 # 立即存放，无需按钮 整理箱子 排序 # 整理打开的箱子，无需按钮 整理箱子 扫描 # 扫描范围内的箱子，查找你尚未知晓的物品 整理箱子 状态 # 显示当前生效的设置及其来源 整理箱子 重载 # 重新读取配置文件

工作原理

物品的移动方式与原生“全部堆叠”按钮使用的物品栏调用相同（添加物品 + 移除物品 对于整堆，位置 将物品移动到此 （关于堆叠部分的拖放操作），因此拦截这些调用的箱子共享模组能够继续正常工作。哪个物品放到哪里，由一个基于背包和范围内箱子快照的小型规划器决定，同样的规则也在单元测试中运行。

读取箱子不会消耗任何网络流量。游戏已经将周围箱子的内容发送给每个客户端（ZDOMan 复制活动区域内所有物体的ZDO数据），并每秒重新读取一次（检查容器变更），所以宝箱列表和学习只查看内存中已有的内容，数据修订版本未发生变化的宝箱甚至不会被重新读取。已知材料是本地玩家数据，保存在角色文件中，而不是网络对象中。这两个功能都不会发送任何额外的数据包，也不会取得宝箱的所有权；只有存储按钮会写入。

功能	帮派成员
容器列表	容器.唤醒 和 容器.销毁时 后缀会记录已加载容器的列表
储物箱按钮	显示物品栏界面 后缀将“全部拿取”按钮复制到玩家面板中
按钮标签，消息	设置语言 后缀会添加该模组对应已加载语言的字词
排序按钮	相同 显示库存界面 后缀会克隆宝箱面板上的“全部堆叠”按钮
控制台命令	终端.初始化终端 后缀
宝箱列表输入	玩家.接收输入 和 玩家控制器.接收输入 后缀停止交互、行走和鼠标视角， 游戏相机.更新鼠标捕获 后缀让光标保持空闲， ZInput.获取鼠标滚轮 后缀把控制权交给了列表，而不是摄像机缩放， ZInput.GetButtonDown 前缀会保留搜索框中的地图键，并让回车键不进入聊天， 更新 让 Esc 关闭列表而不是打开游戏菜单

物品通过游戏本身的 玩家.添加已知物品，每帧几个，这样奖杯、解锁消息和配方列表就仍由原版处理，而一仓库未知材料会在一秒内解锁，而不是让某一帧卡死。

读取查找键时使用的是明文 更新; 悬停的物品栏物品按游戏查找工具提示的方式找到，合成面板的材料图标、配方图标和配方列表条目也以相同方式针对指针进行测试。如果补丁抛出错误，它会记录错误并让原版运行。

兼容性

• 额外槽位、EquipmentAndQuickSlots 3.x、Better Archery：它们的槽位通过模组自身的 API 检测，绝不会被收纳。
• 多用户箱子：支持仓库和排序按钮，见上文。其他玩家拥有的箱子通过多用户箱子的 容器处理.在箱子中移动物品；如果未来版本移除它，按钮会显示宝箱正在使用中。
• 从容器中制作功能是互补的，而非重叠的。它会消耗附近箱子中的资源来制作你已经学会的配方；而本模组则是从一开始就解锁该配方。这里不涉及任何制作所需的资源消耗。
• 其他快速堆叠模组（QuickStackStore、QuickerStack等）应可同时运行；它们会添加自己的按钮和快捷键。未进行过兼容性测试。
• 无“全部拿取”按钮的Auga或其他UI替换模组：不显示储藏按钮；请使用 整洁宝箱储物箱 或使用快捷键模组将其绑定到按键。

许可

麻省理工学院