虚空宝箱

虚空宝箱

Void Chest: a character-bound portable container with nearby storage and guard stone remote deposit. 随身虚空宝箱：装备后打开角色绑定的个人容器，支持四级升级、容量/重量配置、附近快速存储与守护石远程仓库。

虚空宝箱预览查看大图

Void Chest

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

装备后按热键打开你的专属容器。内容绑定在 角色存档 上——丢弃、交易、死亡或升级都不会移动或丢失内容。附带四级升级链、附近快速存储以及守护石远程存入功能。

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

特性

  • 四级宝箱链：黑金属 → 魔能 → 烈焰 → 水晶，容量 2x6 / 3x6 / 3x8 / 4x8（可配置）。
  • 角色级数据：内容存于角色档案（ Player.m_customData）中，随你跨世界、跨服务器携带；宝箱物品只是一个"钥匙"。
  • 装备打开：占用 Utility 槽（兼容 ExtraSlots 额外槽），默认热键 B（可配置）。
  • 重量上限：默认 100 / 150 / 300 / 800（0 = 无限制，可配置）。
    • 拖拽 / Shift 移动超额时 自动分堆（只存入能装下的部分）。
    • 装满时物品 回弹（不会静默丢失）。
    • 容器重量显示为 current/max。
    • 附近 / 远程存储 不 受重量限制。
  • 附近存储：一键将背包物品存入 30 米范围内的所有容器（可配置）。
    • 自动忽略：快捷栏第一行、已装备物品、ExtraSlots 专用槽（快捷/弹药/食物/杂项/额外装备），以及其他玩家正在使用的容器。
  • 守护石远程存入：不在家时，远程将材料存入你有权限的守护石领地内的 所有容器。
  • 可配置：容量、重量、范围、过滤器、远程解锁、热键、超时、缓存（支持 ConfigurationManager）。

配方

等级 物品 容量（默认） 材料 工作台
1 黑金属虚空宝箱 2x6 龙之泪 x5 + 细木 x10 + 黑金属 x20 熔炉
2 魔能虚空宝箱 3x6 黑金属虚空宝箱 x1 + 埃达精华 x10 + 裂魂 x2 熔炉
3 烈焰虚空宝箱 3x8 魔能虚空宝箱 x1 + 焰金属 x10 + 青焰龙王圣物 x2 黑熔炉
4 水晶虚空宝箱 4x8 烈焰虚空宝箱 x1 + 血金 x10 + 液态冰霜 x10 黑熔炉

使用方法

  1. 装备虚空宝箱（Utility 槽）。
  2. 按 B 打开界面。
  3. 界面按钮（单个按钮，切换）：
    • 附近存储：存入周围容器；
    • 远程存入：存入守护石领地内的家箱（需要魔能/2 级或更高宝箱；可在配置中设为始终可用）。
  4. 原版"全部堆叠 / 全部拿取"按钮仍然有效。

远程存入说明

  • 你必须是守护石的 创建者 或在其 许可 列表中。
  • 范围是守护石自身的领地半径（XZ 圆形）。
  • 支持多人客户端：服务器（专用或主机）和客户端都必须安装此模组。
    • 客户端向服务器发送过滤后的背包快照；服务器扫描并存入，然后返回结果；
    • 客户端精确移除服务器报告的物品——即使等待期间背包发生变化也安全；
    • 如果服务器未安装此模组，约 30 秒后会出现"无响应"消息；
    • 服务器可通过 RemoteStore.Enabled = false 禁用它。
  • 扫描结果会被缓存（默认 300 秒，按玩家）；重复存入可在数秒内完成。已移除的容器会自动跳过。

配置

文件： BepInEx/config/trigger.valheim.voidchest.cfg（支持 ConfigurationManager）。

分区 键 默认值 描述
General OpenHotkey B 打开/关闭热键
General DebugLog true 调试日志
Capacity BlackMetal / Magic / Flame / Crystal Rows/Cols 2x6 / 3x6 / 3x8 / 4x8 每级容量（1-8）
Weight BlackMetal / Magic / Flame / Crystal Max 100 / 150 / 300 / 800 重量上限（0-9999，0 = 无限制）
NearbyStore Enabled true 启用附近存储
NearbyStore Range 30 搜索半径（1-100 米）
NearbyStore CheckWard true 跳过你无权限的领地内的容器
NearbyStore IgnoreHotbar true 不存入快捷栏物品
NearbyStore IgnoreFood / IgnoreAmmo / IgnoreMead false 不存入食物 / 弹药 / 蜜酒
NearbyStore TimeoutSeconds 2 每个容器的响应超时
RemoteStore Enabled true 启用远程存入
RemoteStore AlwaysAvailable false 远程始终可用（false = 由魔能/2 级解锁）
RemoteStore CacheSeconds 300 扫描缓存时间（0 = 每次重新扫描）

安装

  1. 安装 BepInExPack for Valheim。
  2. 安装 Jotunn。
  3. 将 VoidChest.dll 放入 BepInEx/plugins/VoidChest/。

依赖

  • BepInExPack Valheim 5.4.2350+
  • Jotunn 2.29.2+
  • 可选：Valheim Plus（兼容；附近存储运行时自动堆叠扩散会被抑制）
  • 可选：ExtraSlots（额外 Utility 槽支持）

仓库

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：可配置容量/重量；远程解锁（默认魔能/2 级）；单个切换按钮；本地化物品描述（英/中/繁）；3 级配方材料修复。
  • 0.3.2：远程存储性能（全快照分类、缓存、8 毫秒帧预算、分阶段性能统计）。
  • 0.3.1：修复 ZDO 对象池复用风险（仅存储 ZDOID）。
  • 0.3.0：P2 守护石远程仓库。
  • 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 黑熔炉

繁體中文

一個 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 黑熔爐