建造之家

仅客户端蓝图，支持保存全息影像、滚轮定位、材料清单和锤子自动建造。无需安装服务端。

规划它。收集它。建造它。

一个仅客户端使用的《英灵神殿》蓝图模组，灵感来自Litematica。加载或捕捉建筑，放置私人全息投影，然后用你普通的锤子建造它。

只有你需要这个模组。 服务器和其他玩家不需要Buildheim。你的蓝图保存在本地；你建造的部件会成为普通的世界物体。建造会消耗你库存中的材料。

安装

在你的 r2modman 配置文件中：

1. 安装 BepInExPack Valheim 5.4.2333 或更高版本 和 尤顿 2.30.0 或更高版本.
2. 复制此项目的 Buildheim.dll 进入以下文件夹 BepInEx/插件升级时请移除旧的PlanBuild DLL。配置文件中只保留一个Buildheim DLL。
3. 使用以下方式启动 开始模组模式，加入一个世界，然后按下 结束.

从以下位置下载ZIP文件 发布 或 操作，或使用以下命令构建 DLL： 开发说明。使用本项目的构建版本：原版 PlanBuild 包的工作流程不同。替换 DLL 后重启 Valheim。

兼容性： 针对 Valheim 的编译与自动检查均已通过 1.0.7，BepInExPack 5.4.2350，以及约顿巨人 2.30.0这是一个开发版本。新的UI、目标锁定和重连流程仍需在游戏内验证；多人游戏兼容性尚未完全验证。

你的第一个流派

1. 按 结束，打开 蓝图，然后点击 打开文件夹 打开你配置的蓝图目录。将 蓝图 或 .vbuild 文件在那里。请先解压下载的ZIP文件。子文件夹也可以。全新安装使用 BepInEx/配置/Buildheim/蓝图 在你的个人资料里。
2. 返回蓝图选项卡并点击 刷新。选择一座建筑以加载其全息影像并打开 建造 标签页
3. 关闭规划器，使用下方快捷键摆放全息影像。加载或移动全息影像不消耗材料。
4. 打开 材料 查看你需要什么。收集补给品，并携带你想放置的部件所需材料。
5. 选择 点击建造，关闭规划器，装备你的普通锤子。瞄准缺失的全息图部件并点击。Buildheim 会选择其配方、位置和旋转角度，然后 Valheim 会检查并放置它。

当加载的世界中检测到已完成的碎片时，它们会从全息影像中消失。

要制作你自己的蓝图，请使用 新蓝图 在蓝图选项卡中或打开 占领.

占领建筑

1. 输入蓝图名称并选择 选择/编辑框.
2. 瞄准一个表面并 左键点击 设置角落 A （青色）。 右键点击 设置对角 B （橙色）。一个可见的方框显示了捕获区域。
3. 用以下工具调整你最后点击的角落 Ctrl + 滚轮 （前进/后退）， Ctrl + X + 滚轮 （侧身），或 Alt + 滚轮 （高度）。步长为0.1米；按住 Shift 1分钟。 中键点击 切换你调整的角落。再次点击任意鼠标键，将该角落重新定位到你的瞄准点。
4. 将整栋建筑围起来，包括地基和屋顶。如果两个角都在地面高度，则抬高B Alt + 滚轮。盒子需要宽度、高度和深度。
5. 按 结束 查看边角、盒子尺寸和片数，然后选择 保存蓝图. 使用 选择/编辑框 再次进行优化。

捕获范围包括已装载、玩家建造且放置点位于框内的部件。部件可能超出这些放置点，因此请在建筑周围留出空间。角点A将成为蓝图的原点。现有文件绝不会被覆盖。

选择时，鼠标点击只会选取角落，不会攻击、放置或移除棋子。已载入的布局会暂时隐藏，自动建造也会关闭。打开规划器会退出选择模式； 清除选择 移除该框。选择角标在当前世界会话期间持续存在。

位置控制

在已加载全息影像且规划器关闭时使用这些。移动方向跟随你摄像机镜头的水平朝向。

控制	动作
结束	打开或关闭规划器
Ctrl + 滚轮	向前或向后移动
Ctrl + X + 滚轮	向侧面移动
Alt + 滚轮	升高或降低全息影像
Ctrl + Alt + 滚轮	旋转全息影像
Shift 以定位快捷键	使用更大的步幅
主页	规划器关闭时切换自动建造
F7	在规划器关闭时启用或禁用当前放置
F8	在规划器关闭时显示或隐藏Buildheim的HUD

普通台阶为 0.1米 和 22.5°按住 Shift 键 1米 和 90°。旋转会对齐到普通锤子的角度网格，因此使用标准角度的设计图仍可与普通锤子替换件兼容。已有的保存摆放会保持其精确角度，直到你明确旋转它们。导入的设计图仍可包含非标准部件角度。

放置修饰键按住时建筑暂停，滚轮也不会同时缩放镜头或旋转锤子部件。在定位时，这些快捷键优先于蹲下和坐下。

规划器会按照《英灵神殿》的库存界面节奏滑开和关闭，并使用其打开和关闭音效。关闭时会立即释放控制权；在滑动过程中再次切换则会反转其方向。

移到我脚下 在“建造”标签页中，将蓝图原点重新定位到你的角色身上。按住定位修饰键时会出现定位快捷键，除非你隐藏了HUD。

选择建造方式

模式	会发生什么
仅预览	查看全息影像，自行选择并放置锤子部件。
点击建造	瞄准缺失的全息图碎片并点击。其配方和对齐方式已为你自动选中。
自动建造	装备锤子时行走。附近的合格部件会自动放置，无需瞄准或点击。

两种辅助模式都会在所选部件周围寻找真实的放置表面，因此你的准星不必精确命中其支撑面。普通锤子范围、视线、配方知识、制作站、放置限制、耐力与耐久度仍然适用。当《英灵神殿》提供原因时，HUD会解释放置失败的原因。

自动建造每半秒最多尝试建造一个部件，并会遵循锤子冷却时间。打开菜单和收起锤子会暂停自动建造。按 主界面 将其关闭。加载其他蓝图、死亡或重新连接也会关闭自动建造。

休息一下

按下 F7，或选择 禁用放置 在建造选项卡中，隐藏全息图和其HUD并停止所有建造辅助。你的位置、层数和材料清单会保持保存。放置被禁用时，普通锤子建造和相机控制仍可正常工作，你仍可在采集时使用材料选项卡并记录箱子内容。

按下 F7 再次或选择 启用放置 继续。禁用会关闭自动建造；准备好时需手动重新启用。在你启用之前，该放置功能将在重新连接后保持禁用状态。

若仅隐藏构建状态和快捷键提示，请按 F8 或使用 隐藏界面 在规划器顶部。使用相同的键或 显示HUD 把它带回来。此偏好设置在重启后依然保留，并且不会改变全息影像或建造模式，包括自动建造。

选中的蓝图部件使用英灵神殿常规锤子预览和无效放置着色。被阻挡的目标仍会在全息图中高亮显示。英灵神殿原生信息卡会显示悬停锤子部件的名称、图标、材料消耗和制作站，并用短缺颜色标出库存中缺少的材料。可见预览不会绕过材料、触及范围或放置要求。

建造状态会在当前目标上显示，没有目标或收起锤子时隐藏。捕捉和定位在激活期间会保持各自的说明可见。紧凑状态面板避开了原版建造界面和耐力条。

在点击建造模式下，瞄准部件的可见形状。在自动建造模式下，锤子预览会在尝试前显示下一个候选部件半秒钟。自动建造会跳过缺少材料或配方要求的部件，并在你移动时重新检查所选层。不成功的尝试会推进到另一个候选部件。

从零开始建设

在“建造”选项卡中，选择 底部 显示最低占用层。完成后，然后使用 下一个 向上移动。 上一个 向下移动，并且 所有图层 再次显示整个蓝图。空白图层将被跳过。

仅显示所选图层中的碎片，且只有这些碎片可用于辅助建造。自动建造不会自动推进图层。

层高 范围从 0.5 至 4 米，带着一个 2米 默认。一个建筑块属于包含其原点的层，因此高墙可以延伸到该层之外。更改层高会将选定的层返回到最底层。

材料与采集

材料标签页列出未完成部件的费用。可在整个蓝图和所选层之间切换。

列	含义
需要	剩余部件所需材料
背包	你库存中当前的材料
宝箱	你已打开宝箱的最后已知内容
采集	背包和宝箱数量之外还缺什么

在加载蓝图的情况下正常打开宝箱，即可记录其中的内容。再次打开同一个宝箱时，会更新其数量，而不会重复计数。已观测且已加载的宝箱发生变化时，其数量会更新；未加载的宝箱则保留最后一次已知的内容。如果有人移动了物品，这些计数可能会过时。 忘掉宝箱 清除观察结果。

勾选单个材料，使用 检查库存 用于标记已无物品可收集的行，或 全选 标记当前列表。 重置检查 清除你的标记。

对勾标记正在收集笔记。 它们不会改变数量或授权建造。箱子里的内容永远不会自动取出：建造时材料必须在你自己背包里。费用不包含不可用的部件，规划器会报告这些。完成计数反映的是已加载世界中检测到的建造情况。

继续上次的进度

你的活动全息图会为每个角色和世界自动保存，包括：

• 一份蓝图副本及其位置与旋转信息。
• 层高和选定层。
• 收集勾选标记以及你是否只选择了预览。
• 是否启用放置。

使用相同角色重新连接到同一世界即可恢复。移动原始蓝图文件不会丢失已保存的计划。 重新连接后自动建造总是关闭。 宝箱观察仅对当前世界会话有效。

每个角色和世界只能激活一个全息影像。加载另一个蓝图会将其替换。 清除全息影像 同时移除其保存的放置位置。如果存档无法读取，规划器会报告问题并保留该文件。

文件和设置

这些路径相对于你的r2modman配置文件：

路径	内容
BepInEx/config/Buildheim/blueprints	已导入并已捕获的蓝图
BepInEx/配置/Buildheim/放置	已保存的全息影像和收集笔记
BepInEx/config/augusdogus.Buildheim.cfg	规划器、自动建造、放置与HUD按键；HUD可见性；蓝图目录
BepInEx/LogOutput.log	模组加载消息和错误

配置文件在首次启动时创建。定位修饰键组合目前是固定的。

从我们早期的PlanBuild版本升级会保留你的设置：Buildheim会复制 marcopogo.PlanBuild.cfg 将其写入新的配置文件（如果尚不存在），包括自定义按键和蓝图目录。如果该配置文件已有 BepInEx/配置/PlanBuild 如果没有 Buildheim 数据文件夹，它会继续使用现有文件夹来保存蓝图和已保存的放置位置。全新安装则使用上方的 Buildheim 路径。原始文件会保留。

蓝图支持

建造海姆解读 蓝图 和 .vbuild 最多 10,000个 和 8 MB 每个文件。

• 地形编辑、容器内容和自定义吸附标记不会应用。
• 非标准尺寸的部件可以显示，但无法通过锤子辅助放置。
• 改装部件需要其原始部件模组，包括在服务器上需要这些模组时。
• 辅助建造需要消耗资源。请关闭世界的免费建造设置以使用此功能。

从原版PlanBuild切换时，请先用原模组完成或移除其共享蓝图，并备份受影响的世界和角色。此版本不会迁移其蓝图对象、符文、蓝图锤或图腾。现有的本地蓝图文件仍可导入。

建造

使用 .NET 8 SDK一个本地英灵神殿安装，以及来自你的模组配置的BepInEx。从仓库根目录：

dotnet build src/Buildheim/Buildheim.csproj -c Release \ -p:GameDir="/path/to/Valheim" \ -p:BepInExDir="/path/to/profile/BepInEx" dotnet test tests/Buildheim.Tests/Buildheim.Tests.csproj \ -p:GameDir="/path/to/Valheim" \ -p:BepInExDir="/path/to/profile/BepInEx"

模组DLL为 src/Buildheim/bin/Release/net48/Buildheim.dll只安装模组DLL，不要安装游戏程序集或整个构建目录。构建不会安装或发布任何内容，也不会修改已安装的游戏程序集。 环境.道具 可以提供本地路径； BepInEx目录 默认为游戏的 BepInEx 目录。

客户端实现位于 src/Buildheim/Client.

测试覆盖蓝图解析、材料核算、层选择、自动建造调度、放置存档，以及锤子和输入钩子使用的游戏方法。它们不运行Unity。运行时验证应包括UI布局、修饰键快捷键、受阻放置、物品栏和箱子转移、重新连接，以及一个带有未装模组观察者的原版服务器。

提交错误报告时，请附上模组和英灵神殿的版本、复现步骤以及相关日志条目。如果问题与特定建筑有关，请一并附上蓝图文件。

开发与发布 · 仓库布局 · 更新日志

致谢与许可

本项目基于 原版PlanBuild，由MarcoPogo创作，Jules、Algorithman、Dreous和Jere参与开发贡献。它使用了 霜巨人.

根据以下许可协议获得授权 WTFPL.