大气3D蜃景宝箱预览、物品搜索栏、实时3D宝箱定位器、直接拖放存入宝箱，以及一键整理容器。

宝箱助手

瓦尔海姆客户端模组，添加实时3D宝箱定位器、物品搜索栏和一键容器整理功能。

功能

物品搜索栏

• 在玩家背包窗口正上方添加一个搜索输入框。
• 输入任何物品或材料名称（支持英语和俄语）会高亮显示基地周围所有匹配的箱子，并暗化背包中不匹配的物品。
• 输入文字时，角色移动（WASD、冲刺、跳跃）和快捷栏槽位会暂停，以防止误操作。按回车键可恢复完整移动，同时保持已找到的宝箱高亮显示。
• 随时按 Escape 键或点击清除按钮即可清除搜索内容。

宝箱定位与符合世界观的物品高亮（v2.0.0 全面重制）

• 将光标悬停在物品栏中的任意物品上时，会高亮显示附近所有包含该物品的宝箱。
• 贴合网格的雾状裹尸布将生硬的平面高光替换为程序化双层体积雾，沿容器表面法线方向直接挤出（+1.8cm 和 +3.8cm），并带有有机呼吸感和反向滚动的烟雾动画。
• 北欧灵光信标：标记着一个柔和发光的小精灵和三个在3D倾斜轨道上环绕的谐波余烬，紧凑地悬浮在盖子上方（+22厘米）。
• 运输已锚定：光灵与幕布附着于容器变换上，会平滑跟随移动的船只（卡维、长船、德拉卡尔）和推车。
• 智能视线过滤：零 GC 内存分配（物理.非分配射线检测）具备智能碰撞体过滤功能，因此架子上或堆叠中相邻的箱子永远不会互相遮挡。
• 可配置 最大墙体障碍物 （默认2）透过隔断和货架框架照亮箱子，同时遮挡多面厚石墙。

3D幻影宝箱预览

• 查看交互距离内的任何箱子或储物容器，即可投射出虚幻的3D幻影提示框，无需打开就能显示其中的物品。
• 有机烟熏美学半透明深色雾板，边缘模糊且不规则，带有微妙的呼吸波纹动画。
• 自适应3D广告牌：在容器最近的一面前方投影，并朝你的镜头轻轻倾斜，营造出真实的立体投影感。
• 通用存储支持适用于木制/铁制/黑金属箱子、推车、长船、卡夫船、湮灭器以及模组容器。
• 安全与隐私： 自动遵循结界与钥匙保护（若访问被拒绝则静默隐藏）。
• 空仓储处理显示一团微弱的、轻薄的烟雾，并带有本地化文本（"Storage is empty" / "Хранилище пусто"）。
• 人体工学快捷键: 按下 H （Valheim 中默认自由）切换预览模式开/关。可配置为 按住 或 总是 开。

直接3D箱子存入与多人游戏安全（v2.0.0增强）

• 从你的背包中拖拽任意物品堆叠，直接悬停在3D世界中附近的箱子上方（在触及距离内，默认为4.5米）。
• 被拖拽的物品图标会平滑缩小（透视深度效果）并显示放置提示。
• 多人游戏占用保护：与 Valheim 原生系统集成 使用中 网络变量。如果其他玩家打开了箱子、马车或船只，提示会变成红色（宝箱使用中 / 购物车使用中 / 船只使用中）并且押金已被安全锁定，不会踢出另一位玩家。
• 原子事务安全: 只有在容器确认成功添加后，才会从玩家库存中扣除物品。永远不会丢失物品！
• 松开鼠标按钮后，整叠物品会直接存入带木盖的箱子中，伴随木质盖合音效和漂浮反馈（+X 物品名称），而不会打开箱子界面。
• 如果宝箱已满，会出现警告，物品会保持在光标下（绝不会掉落到地上）。

容器分类

• 在箱子界面原版的“全部拿走”和“全部堆叠”按钮正下方添加一个“排序”按钮。
• 自动合并未满的堆叠。
• 按类别分组物品：武器与工具 -> 护甲与弹药 -> 食物与药水 -> 制作材料 -> 奖杯 -> 杂项。
• 次级排序按本地化名称、品质等级和耐久度对物品进行字母排序。
• 安全可用：当物品正在被拖拽时不会执行任何操作，并且如果其他界面模组移动了原版按钮，也包含备用放置方案。

配置

首次启动时会生成配置文件，位于：
Valheim/BepInEx/config/com.awuushy.chesthelper.cfg

章节	按键	默认	描述
宝箱预览	开启宝箱幻影	真	启用宝箱内容的3D幻影预览
宝箱预览	幻影激活模式	切换	激活模式：'切换'、'按住'或'始终'
宝箱预览	幻影切换键	H	切换/按住胸部预览的热键（默认“H”）
宝箱预览	幻影微光	真	启用烟雾波纹和呼吸动画
宝箱预览	最大网格列数	5	预览网格中物品图标的最大列数
宝箱预览	幻景世界规模	1.0	3D幻影的世界缩放倍数
高亮	高亮半径	25.0	搜索半径（米）（5 到 60）
高亮	检查视线	真	过滤掉被多堵墙挡住的宝箱
高亮	最大墙体障碍物	2	可容忍的墙/梁障碍物数量
高亮	高亮颜色	#FFE600	信标和宝箱发光的颜色
高亮	启用宝箱信标	真	在匹配的容器上方显示3D信标
高亮	启用宝箱光效	真	在匹配的集装箱上方生成点光源
高亮	宝箱表面光效	0.55	胸部模型的表面发光强度
功能	启用搜索栏	真	在玩家物品栏上方显示搜索栏
功能	启用直接存入箱子	真	启用直接拖放到3D箱子中
功能	直接存款最大距离	4.5	直接存入箱子所需距离（米）
排序	排序按钮文本	自动	按钮文本（“自动”跟随游戏语言）

兼容性

• 多人游戏完全客户端运行。可在专用服务器和原版多人游戏中工作，无需服务器或其他玩家安装该模组。
• 快速堆叠模组：兼容TidyChests或QuickStackStore等模组。
• 保存安全：不会添加自定义物品、预制体或世界数据。可随时在现有世界中安全安装或移除。

安装

通过模组管理器（推荐）

通过 r2modman 或 Thunderstore Mod Manager 安装。

手动安装

1. 安装BepInExPack Valheim。
2. 下载此包并解压 ChestHelper.dll 进入你的 Valheim/BepInEx/plugins/ 目录。
3. 启动游戏。