随身虚空宝箱：装备后打开角色绑定的个人容器，支持四级升级、容量与重量配置、附近快速存储以及守护石远程仓库（联机客户端可用，需服务端安装）。虚空宝箱：角色绑定的便携容器，支持附近存储与守护石远程存放，所有安装了该模组的客户端均可使用。

虚空宝箱

一个瓦尔海姆模组：一个随你的角色移动的魔法容器。

装备后按下快捷键即可打开你的个人容器。容器内的物品将绑定至 角色存档 — 丢弃、交易、死亡或升级，其中的物品都不会移动或丢失。附带四级升级链、附近快捷存储以及守卫石远程存放功能。

本地化：英语 / 简体中文 / 繁体中文

---

功能

• 四阶宝箱链：黑金属 → 埃特尔 → 焰金 → 水晶，容量 2x6 / 3x6 / 3x8 / 4x8 （可配置）。
• 角色数据：内容位于字符文件中（玩家.自定义数据）并跟随你穿越世界和服务器；宝箱物品只是一个“钥匙”。
• 装备以开启使用一个工具槽位（兼容ExtraSlots额外槽位），默认热键 B （可配置）。
• 重量上限: 默认值 100 / 150 / 300 / 800 （0 表示无限制，可配置）。
  • 拖动 / Shift+移动超出限制 自动分段 （仅存储能放下的部分）。
  • 满载时，物品 弹回 (无静默丢失)。
  • 容器重量显示为 当前/最大.
  • 附近／远程存储为 不 受重量限制。
• 附近仓库：一键将背包物品存入30米范围内的所有容器（可配置）。
  • 自动忽略：第一排快捷栏、已装备物品、ExtraSlots专属槽位（快捷/弹药/食物/杂项/额外装备），以及被其他玩家正在使用的容器。
• 守卫石远程存放: 不在家时，可远程存入材料至 所有容器 在守卫石领地内，你可以访问。
• 可配置：容量、重量、范围、筛选、远程解锁、快捷键、超时、缓存（支持 ConfigurationManager）。

配方

层级	物品	容量（默认）	材料	空间站
1	黑金属虚空宝箱	2x6	龙之泪 x5 + 优质木材 x10 + 黑金属 x20	锻造
2	埃特尔虚空宝箱	3x6	黑金属虚空宝箱 x1 + 精炼伊米尔之息 x10 + 亚格鲁斯之物 x2	锻造
3	烈焰虚空宝箱	3x8	虚灵虚空宝箱 x1 + 炎铁 x10 + 湮灭遗物 x2	黑锻
4	水晶虚空宝箱	4x8	炎金虚空宝箱 x1 + 血金 x10 + 液态霜 x10	黑铁锻造

用途

1. 装备虚空宝箱（通用槽位）。
2. 按下 B 打开界面。
3. 界面按钮（单个按钮，切换开关）：
   • 附近储物：存入周围的容器中；
   • 远程存款：在守卫石领地内的家中容器中存放（需要埃特尔/L2或更高级箱子；可在配置中设为始终可用）。
4. 原版“全部堆叠/全部拿取”按钮仍然有效。

远程存款备注

• 你一定是那守卫之石 创作者 或者在其上 允许 列表。
• 范围是守卫石自身的领地半径（XZ平面圆形）。
• 适用于多人游戏客户端：服务器（专用或主机）和客户端都必须安装此模组。
  • 客户端向服务器发送经过筛选的背包快照；服务器扫描并存储，然后返回结果；
  • 客户端只移除服务器报告的物品——即使等待期间库存发生变化也安全；
  • 如果服务器没有该模组，约30秒后会显示“无响应”消息；
  • 服务器可以通过以下方式禁用它： 远程存储.已启用 = 假.
• 扫描结果会被缓存（默认每名玩家300秒），重复存入可在几秒内完成。已移除的容器会自动跳过。

配置

文件： BepInEx/配置/触发器.英灵神殿.虚空宝箱.cfg （支持 ConfigurationManager）。

区域	按键	默认	描述
通用	打开热键	B	打开/关闭热键
通用	调试日志	真	调试日志记录
容量	黑金属 / 魔法 / 火焰 / 水晶 行/列	2x6 / 3x6 / 3x8 / 4x8	每阶容量（1-8）
重量	黑金属 / 魔法 / 火焰 / 水晶上限	100 / 150 / 300 / 800	重量限制（0-9999，0 = 无限制）
附近商店	已启用	真	启用附近存储
附近商店	范围	30	搜索半径（1-100米）
附近商店	检查病房	真	跳过你没有权限进入的领地中的容器
附近商店	忽略快捷栏	真实	不要存放快捷栏物品
附近商店	忽略食物 / 忽略弹药 / 忽略蜂蜜酒	假	不要储存食物/弹药/蜂蜜酒
附近商店	超时秒数	2	每个容器的响应超时时间
远程商店	已启用	真	启用远程存款
远程商店	始终可用	假	远程始终可用（false = 由Eitr/L2解锁）
远程商店	缓存秒数	300	扫描缓存时间（0 = 每次重新扫描）

安装

1. 安装 Valheim 的 BepInExPack.
2. 安装 尤顿.
3. 掉落 虚空宝箱.dll 进入 BepInEx/plugins/VoidChest/.

依赖项

• BepInExPack 英灵神殿 5.4.2350+
• 约顿 2.29.2+
• 可选： 瓦尔海姆增强版 （兼容；附近存储运行时，自动堆叠扩散会被抑制）
• 可选： 额外栏位 （额外通用槽位支持）

仓库

https://github.com/1264600905/valheim-voidchest

建造

cd VoidChest dotnet build .\VoidChest.csproj -c Release

输出： BepInEx/plugins/VoidChest/VoidChest.dll （输出路径已预配置）。

已知限制

• 远程存入需要 服务器和客户端上的模组版本相同 （否则你会收到“无响应”的提示）。
• 更改容量后，超出可见范围的物品仍保留数据但会被隐藏（增大容量后重新可见）。
• 卸载模组会使该宝箱物品失效；角色数据仍会保留（重新安装即可恢复）。

更新日志

• 0.5.0：远程存款支持多人客户端（自定义RPC：客户端快照→服务器处理→基于差异的移除）；按玩家扫描缓存。
• 0.4.x：可配置容量/重量；远程解锁（默认Eitr/L2）；单一切换按钮；本地化物品描述（英/中/繁中）；L3配方材料修复。
• 0.3.2：远程存储性能（完整快照分类、缓存、8毫秒帧预算、分阶段性能统计）。
• 0.3.1：修复了ZDO对象池重用风险（仅存储ZDOID）。
• 0.3.0P2 守卫石远程仓库。
• 0.2.0：P1附近储物，ExtraSlots兼容性，V+大门，UI按钮。
• 0.1.x：P0基础（物品/配方/虚拟容器/存档/快捷键）。

---

简体中文

一个 Valheim 模组：一件随角色旅行的魔法容器。

装备后按热键打开专属容器；内容绑定在角色存档上——丢进箱子、交易、掉落、合成升级都不会丢失或转移。支持四级升级链、附近快速存储与「守护石」远程仓库。

• 四级宝箱链：黑金属 → 魔能 → 烈焰 → 水晶，容量 2×6 / 3×6 / 3×8 / 4×8（可配置）。
• 角色级数据：内容存于角色档案，跨世界、跨服务器随身携带。
• 装备打开：占用 Utility 槽（兼容 ExtraSlots 额外槽），默认热键 B。
• 重量上限：100 / 150 / 300 / 800（0 = 无限制）；超额自动分堆，满了物品回弹。
• 附近存储：一键存入周围 30m 内所有箱子（忽略快捷栏/已装备/ExtraSlots 专用槽/被占用箱子）。
• 守护石远程仓库：远程存入有权限守护石领地内的家箱（联机需服务端同版本）。
• 可配置容量、重量、范围、过滤、远程解锁、快捷键、超时与缓存。

等级	物品	容量（默认）	配方材料	工作台
1	黑金属虚空宝箱	2×6	龙之泪×5 + 细木×10 + 黑金属×20	熔炉
2	魔能虚空宝箱	3×6	黑金属虚空宝箱×1 + 埃达精华×10 + 裂魂×2	熔炉
3	烈焰虚空宝箱	3×8	魔能虚空宝箱×1 + 焰金属×10 + 青焰龙王圣物×2	黑熔炉
4	水晶虚空宝箱	4×8	烈焰虚空宝箱×1 + 血金×10 + 液态冰霜×10	黑熔炉

---

繁体中文

一个《英灵神殿》模组：一件随角色旅行的魔法容器。

装备后按热键打开专属容器；内容绑定在角色存档上——丢进箱子、交易、掉落、合成升级都不会遗失或转移。支持四级升级链、附近快速存储与“守护石”远程仓库。

• 四级宝箱链：黑金属 → 魔能 → 烈焰 → 水晶，容量 2×6 / 3×6 / 3×8 / 4×8（可设置）。
• 角色级数据内容存于角色档案，跨世界、跨服务器随身携带。
• 打开装备：占用 Utility 槽（兼容 ExtraSlots 额外槽），默认热键 B。
• 重量上限：100 / 150 / 300 / 800（0 = 无限制）；超额自动分堆，满了物品回弹。
• 附近存储：一键存入周围 30m 内所有箱子（忽略快捷栏/已装备/ExtraSlots 专用槽/被占用箱子）。
• 守护石远程仓库：远程存入有权守护石领地内的家箱（连线需伺服器同版本）。
• 可设置：容量、重量、范围、过滤、远程解锁、热键、超时与缓存。

等级	物品	容量（默认）	配方材料	工作台
1	黑金属虚空宝箱	2×6	龙之泪×5 + 细木×10 + 黑金属×20	熔炉
2	魔能虚空宝箱	3×6	黑金属虚空宝箱×1 + 埃达精华×10 + 裂魂×2	熔炉
3	烈焰虚空宝箱	3×8	魔能虛空寶箱×1 + 焰金屬×10 + 青焰龍王聖物×2	黑熔炉
4	水晶虚空宝箱	4×8	烈焰虚空宝箱×1 + 血金×10 + 液态冰霜×10	黑熔炉