在原地替换兼容的英灵神殿建筑部件（包括连接的墙壁和地板），并进行安全的材料和放置验证。

PieceReplacer v1.1.9

《英灵神殿》锤子的便捷替换模式。

单次替换

1. 装备锤子。
2. 选择你想用作替换的建筑部件。
3. 瞄准一个现有的兼容建筑部件。
4. 按住 左 Alt 并正常放置。

替换件被锁定在旧的结构槽位上，而旋转仍由 Valheim 玩家的常规操作控制。等效材料的预制体通过其吸附点几何结构进行对齐，而非假设预制体轴心相同，最终部件使用精确可见的预览变换。

已连接曲面替换

v1.1为地板和墙壁等相连的平面表面添加了批量模式。

1. 用锤子选择替换件。
2. 瞄准其中一块表面。
3. 按住 左 Alt + 左 Shift.
4. 查看屏幕底部显示的批次信息。
5. 左键点击替换整个相连表面。

一批只跟随满足以下条件的棋子：

• 使用与瞄准部件相同的源预制体，
• 位于同一几何平面上，
• 并与下一块共享一个实际的吸附点边缘。

这意味着围绕90度拐角的墙壁会被视为一个独立的表面，而仅在一个角对角接触的地砖不会被合并。

种子预览控制整批的旋转增量。例如，将预览墙翻转180度，会使所选表面中的每面墙都相对于其先前朝向翻转180度。

批量材质预览与验证

当 左 Alt + 左 Shift 被持有时，PieceReplacer 显示：

• 连通表面中的碎片数量，
• 来源与替换件，
• 完成整批所需的总材料，
• 每种材料当前有多少可用，
• 买不起这批货时缺失的数量。

除非玩家拥有足够的材料，否则无法进行替换。 整批 在开始之前。旧批次只在新批次放置完成后才会退款，因此退款不会用于资助未完成的替换品。

提交批次前，会检查每个部件的移除权限和所需制作站范围。

兼容性

当两个部件被显式安全组覆盖，或自动结构兼容性检查接受它们时，可以互相替换。

自动检查使用：

• 部件类别，
• 英灵神殿锤子使用标签，
• 功能组件，
• 本地吸附点几何体。

原版梁/杆系列还额外明确兼容水平1/2/4米构件、26°/45°/67°斜梁以及垂直1/2/4米杆。这可避免因不同局部吸附布局的材质变体而导致的误判。

安全默认值

允许边界回退 = false 默认情况下。因此，仅凭视觉大小恰好相似，拼图块不会因吸附点不足而被自动匹配。

连接曲面替换的默认最大值为 250个如果表面超出该限制，操作将被阻止，而不是仅静默替换其中的一部分。

建造

.\build.ps1

构建并安装：

.\build.ps1 -Install

配置

生成于：

BepInEx/配置/uk.ainzworth.valheim.piecereplacer.cfg

重要设置：

[通用] 修饰键 = 左Alt 批量修饰键 = 左Shift [兼容性] 自动兼容 =  true 需要相同类别 = true 需要相同用途标签 = true 吸附点容差 = 0.035 允许边界回退 = false 边界容差 = 0.075 [批量替换] 已启用 = true 最大件数 = 250 连接容差 = 0.08 平面容差 = 0.12 显示HUD = true

用于诊断，请设置 调试日志记录 = true.

v1.1.1 墙壁兼容性修复

直墙尺寸系列现已针对以下内容提供明确的原版兼容性覆盖：

• 满格2x2墙体
• 半格1x2墙
• 四分之一1x1墙壁

这修复了材质替换的情况，即等效墙壁变体使用不同的预制件本地吸附几何体。完整墙、半墙和四分之一墙保持为独立组，因此不同尺寸的墙壁无法相互替换。

v1.1.2 原版兼容性审核

屋顶、屋顶拐角/屋脊、三角形山墙、屋顶交叉、地板、楼梯以及附加梁变体的直接材质等效物现在使用明确的安全兼容组。这避免了原版预制件使用不同本地吸附/轴心数据时出现的误报，同时严格分离角度和形状。

替换交易安全（v1.1.9）

重复单次替换使用缩短的安全窗口（0.10秒 + 0.05秒 + 0.05秒），以便下一根梁可以快速替换，同时生成、支撑和移除验证及回滚机制保持激活。单件替换现在会保留原部件，直到新部件同时通过短暂的网络稳定窗口和支撑隔离检查。这对于专用服务器上的垂直梁/柱尤为重要，因为重叠替换否则可能仅乐观存在或暂时继承被替换部件的支撑。

批量选择和阻挡物 (1.1.11)

批量模式支持连接的梁和其他兼容部件以及平面表面。它会在整个连接组中选择相同的源预制件。非平面部件可以在单个吸附点连接；平面表面仍然需要共享边缘和匹配平面。

在【批量替换】中，MaxPieces 默认值为 250，以限制同步帧卡顿和网络突发。将 MaxPieces = 0 设为无限制选择。大批量仍会在单帧内执行。当尝试被阻止时，因移除权限或站点检查未通过的部件会显示红色轮廓，持续四秒。缺少材料或超出批量上限属于全局失败，没有可高亮的物理阻挡物。

对角批量连接 (1.1.12)

[批量替换] IncludeDiagonalConnections = false 会排除仅角落接触的情况，包括厚板的垂直角边。将其设为 true 可包含对角接触。正常的侧面连接和梁端点仍然受支持。现有的平面和预制件限制仍然适用。