公会宝箱

公会宝箱

同一个世界。共享储物空间。建造金饰公会宝箱，即可在你的瓦尔海姆世界中访问同一个32格物品栏。支持单人和多人模式，并兼容Vortex安装。

公会宝箱预览查看大图

Guild Chest

一个世界。一个共享仓库。

Guild Chest 添加了一个金色装饰的箱子，它连接到你的 Valheim 世界中一个共享的 32 格库存。在你的主基地、采矿营地和遥远的哨站建造接入点，无论你到哪里冒险，都能获取相同的补给。

观看 45 秒实机演示视频。

Bug 报告和功能请求仅通过 GitHub Issues 跟踪。

功能

  • 每个 Guild Chest 都访问相同的 32 个格子（8 x 4），即使其他接入点远在天边或未加载。额外的箱子增加的是接入点，而不是容量。每个世界有自己的仓库。
  • 存放金属和其他补给。物品品质、耐久度、制作者信息和自定义数据使用 Valheim 的序列化；堆叠按原版规则合并。
  • 同一时间只能有一名玩家访问共享库存。你打开的箱子适用正常的结界权限。
  • 使用常规库存窗口进行拖拽、拆分、快速转移、全部取出和全部堆叠。在使用或丢弃物品前，先将它们移到你的玩家库存中。
  • 内容保存在主机/服务器的世界存档中。销毁箱子会正常返还其建造材料，且绝不会掉落共享内容。
  • 销毁最后一个箱子会保留已保存的仓库，包括跨重启。在该世界中重建一个 Guild Chest 即可再次访问它。

建造配方

在工作台附近使用锤子。Guild Chest 会紧跟在加固箱之后出现在锤子菜单中。

  • 20 优质木材
  • 10 铁
  • 2 焰灵核心
  • 250 金币

需求

在每个客户端和主机/服务器上安装 Guild Chest 及其两个依赖项。使用匹配的 Guild Chest 版本，并在更新后重启。替换文件前请先停止专用服务器。

依赖项需单独下载。存放物品模组的物品时，请在主机和所有客户端上保持这些物品模组处于安装状态。

使用 Vortex 安装

在 Vortex 中管理 Valheim 并安装所需依赖项。使用 Mod manager download 下载 Guild Chest，然后安装、启用并部署它。你也可以通过 Vortex 的本地压缩包安装功能添加发布 ZIP。

GitHub 1.1.0 发布 ZIP 已通过 Vortex 安装并由作者测试成功。请检查你的 Vortex 设置是否提供了所需的依赖版本；列出依赖项并不保证会自动安装。

手动安装

按照依赖项各自的说明安装它们。将发布 ZIP 中的 BepInEx 文件夹解压到你的 Valheim 安装目录。保持两个文件在一起：

BepInEx/plugins/GuildChest/GuildChest.dll
BepInEx/plugins/GuildChest/GuildChest.Core.dll

对于多人游戏，请在每个客户端和主机/服务器上重复安装。更新时，替换两个 DLL，并避免在 plugins 文件夹的其他位置留下旧副本。

配置

首次启动后，编辑 BepInEx/config/randenko.GuildChest.cfg：

[Compatibility]
Automation range = 20

主机强制执行此最大距离（以米为单位），用于支持的存储模组传输和资源预览。允许范围：1-100。请一致地配置客户端和主机；集成自身的范围可能会进一步限制它。常规箱子交互保持其通常范围。容量和建造成本是固定的。

兼容性

Guild Chest 支持在装有 BepInEx 的 PC 上进行单人、玩家主持和专用服务器使用。控制台客户端无法加载该模组。

可选适配器已在原生测试环境中使用 AzuAutoStore 3.1.7 和 AzuCraftyBoxes 1.8.27 测试。两者均非必需，也未捆绑。AutoStore 支持玩家热键/单物品存放。CraftyBoxes 支持附近资源预览、制作补给，以及在确认转移后进行建造。AutoStore 的地面掉落自动化以及 CraftyBoxes 的燃料/矿石投喂和 Epic Loot 消耗器均排除公会存储。其他存储模组需要显式集成。

记录的本地检查使用 Valheim 1.0.16（Steam 构建 25527701）。针对较新引用进行编译并不能确立游戏玩法兼容性。有关已测试行为和限制，请参阅验证记录和兼容性详情。

备份与移除

在安装或移除模组之前，请备份完整的世界。要移除它，请先将所有共享内容取出到普通存储中，并在模组安装状态下移除所有 Guild Chest。保存，然后在移除插件文件之前停止游戏/服务器。

保留移除前的备份：在没有模组的情况下加载和保存可能会丢失其自定义预制体和共享状态。仅销毁最后一个箱子并不会清空已保存的仓库。世界和角色存档保持分离；Guild Chest 不会将它们变为一个原子事务，也无法防范被编辑的角色和恶意客户端。在打算保留的世界中使用之前，请先在一次性世界中进行测试更改。

故障排除与支持

被拒绝的转移会显示主机的原因，并保持你的物品不变。检查版本是否匹配、结界访问权限、可用空间和所需的物品模组。查看 BepInEx/LogOutput.log 了解详情。

提交 bug 报告时请附上版本、复现步骤和相关日志。也请在 GitHub 上提交功能请求。GitHub Issues 是唯一的跟踪渠道。

源代码与致谢

Guild Chest 在 MIT 许可证下免费开源。

源代码 | 发布说明 | Thunderstore | 可选的 Ko-fi 支持

感谢 BepInEx 和 Jötunn 团队，以及 Iron Gate Studio 带来的 Valheim。这些项目及其资产保留各自的许可证和所有权。

媒体披露：展示截图是对实际游戏截图的 AI 辅助编辑；原始截图保留在源代码仓库中。宣传徽章使用了生成的图像。本页描述在 AI 协助下编写，并在发布前由作者审核。