解锁并利用现有的原版和模组预制件，支持服务器同步的YAML策略、公开的Hammer访问权限、仅限管理员的调试组，以及更安全的预制件过滤。将矮人桶用作发酵桶，并用盔甲架交换装备。

装备预设

扫描原版英灵神殿及已加载的添加预制件的模组，查找锤子建造表中通常无法获得的现有预制件，然后由服务器决定哪些成为公开建造部件，哪些仅限管理员使用。

它不会添加新的预制件。它帮助你利用已有的预制件。

面向 Valheim 1.0.7，使用 BepInExPack Valheim 5.4.2350。HarnessPrefabs 不再需要 Jotunn；如果其他模组需要，请保留安装。

使用原版盔甲架和HarnessPrefabs解锁的额外盔甲架来交换装备。

矮人桶（增强细节层次）可用作发酵桶。发酵时间可配置。

为什么使用它

• 打开实用的原版和模组预制件，无需再附带一份硬编码的预制件转储文件。
• 让普通玩家保持在精选的公开版本标签页，同时为管理员提供仅用于调试的审核标签页。
• 用可审查、复制和覆盖的 YAML 策略文件替换 MoreVanillaBuildPrefabs 风格的公开解锁内容。
• 对于已知的类别、需求、放置标志、吸附修复和图标行为，使用基于MVBP的默认值。
• 通过ServerSync保持服务器作为权威数据源，使客户端接收当前生效的预制体策略和本地化文本。
• 避免因仅运行时对象（如特效、抛射物、布娃娃、生物、人形和掉落物品）造成Hammer杂乱。

作用

HarnessPrefabs 围绕隐藏预制体构建了一套安全的审核工作流程：

1. 从瓦尔海姆和已加载的模组中发现看起来可建造的预制件。
2. 忽略不适合Hammer放置的预制体，例如角色、掉落物品、生成器、运行时特效、投射物、布娃娃以及类似的控制器对象。
3. 当某个预制件在已审核的 MoreVanillaBuildPrefabs 数据中已知时，从中播种默认值。
4. 根据组件和预制件形状，将其余部分归类为公开或管理类别。
5. 编写供审阅的参考YAML文件。
6. 仅应用你选择写入的覆盖项。
7. 将活动策略从服务器同步到客户端。

这使其既可作为MoreVanillaBuildPrefabs的替代品用于精选公共建筑部件，也可作为大型模组包的管理员审核工具。

锤子类别

在《英灵神殿》1.0.7版本中，仅管理员可用的预制件会出现在顶层 装备预设 管理员（拥有 Valheim 权限）专属的板块，位于分类、材料、最近和收藏旁边。 调试模式 已启用。其预制体不会进入原生列表，因此不会通过分类、材质、最近使用或收藏泄露。 显示线束标签 配置键保留其现有名称，并且可以隐藏该部分。

公开群组保留现有的YAML分类名称：

• 杂项
• 制作
• 建筑
• 石匠工坊
• 家具

HarnessPrefabs 部分包含三个仅限管理员使用的组：

• 驾驭自然
• 马具结构
• 护具

客户端 显示安全带标签页 配置可以在调试模式开启时隐藏整个 HarnessPrefabs 区段。

默认分类

已知的MVBP公开预设默认为公开访问。其他已发现的预制体默认归属Harness Nature、Structures或Props管理员组，除非显式YAML策略分配了公开类别。

通用分类使用预制组件和名称：

• 驾驭自然：植物、可采集物、树木、原木、岩石、矿石、农作物和自然静态预制件。
• 装备架构墙壁、地板、拱门、柱子、楼梯、大门、门、容器、传送门、床、制作台、火堆、船只、推车、可破坏物以及其他类似建筑的交互物。
• 马具道具装饰物、静态道具、旗帜、地毯、桌子、椅子、雕像、宝藏、创作者商店风格道具、杂物、碎片以及类LOD对象。

运行时对象会被有意忽略。预制体命名为 特效_*, 特效_*，或 音效_*，MVBP 效果默认值，以及带有诸如以下组件的预制体 限时摧毁, 范围, 镜头震动, 弹丸，或 布娃娃 不会写入参考文件，也不会添加到Hammer选项卡中。

带有预制体的 掉落物品, 类人，或 角色 其层级中的任何位置都将被忽略。

政策文件

HarnessPrefabs 将策略文件存储在以下位置：

BepInEx/配置/HarnessPrefabs/

可编辑的覆盖文件：

预制件.yml 预制件_*.yml

已生成审查文件：

prefabs.reference.yml prefabs.full.yml

预制件.yml 是自动创建的。额外文件如 prefabs_public.yml 或 prefabs_admin.yml 在基础文件之后加载，并且可以覆盖相同的预制体条目。

请勿编辑 预制体参考.yml 或 预制件.full.yml 直接复制其中的条目到 预制件.yml 或 prefabs_*.yml.

最小覆盖

覆盖文件使用顶级 YAML 列表。你可以只复制想更改的字段：

- 预制体：blackmarble_1x1 已启用：true 类别：BuildingStonecutter 需求：- BlackMarble：2 - 预制体：GoblinTotem 已启用：false

已启用：是 公开一个预制体。公共类别会将其暴露给普通客户端。测试类别仅在调试模式下向管理员暴露。

缺失字段将保留生成的默认值。

完整评价结构

在游戏控制台中运行此命令以写入完整的脚手架：

全套挽具

完整脚手架包含对审查有用的字段：

- 预制体：barrell 已启用：true 类别：家具 显示名称：木桶 描述："" 制作站：工作台 需求： - 细木：2 - 铁：1 标志：false, false, false, true # clipEverything, clipGround, allowedInDungeons, canBeRemoved 组件：[Piece, WearNTear] # 仅供审核元数据

组件 是来自发现项的参考提示，作为编辑字段时会被忽略。

本地化

服务器同步的本地化文件位于：

BepInEx/config/HarnessPrefabs/localization/

英文 会自动创建为模板。添加带有 Valheim 语言名称的语言文件，例如 韩语.yml, 德语.yml，或 土耳其语.yml.

在预制策略条目中使用本地化标记：

- 预制体：barrell 启用：true 类别：家具 显示名称：$ph_piece_barrell 描述：$ph_piece_barrell_desc

$ph_piece_barrell: "木桶" $ph_piece_barrell_desc: "一个装饰用的木桶。"

英语首先作为备用语言应用，然后在此基础上叠加客户端所选语言。

图标与布局

HarnessPrefabs复用已制作的图标，并通过其自有的队列等距渲染器生成缺失的Hammer图标。渲染前会从非活跃预览克隆中移除游戏玩法组件。该渲染器可处理 可拾取物品 随机物品预览，跳过无头服务器，并在离开世界时释放自己的纹理和临时渲染对象。

对于碰撞体别扭或稀疏的预制体，HarnessPrefabs 会根据审核过的 MVBP 默认值应用仅用于放置的幽灵辅助体。这些辅助体只影响 Hammer 预览放置，不会为最终放置的对象添加额外的辅助碰撞体。

预制体调整

这 2 - 预制体调整 配置部分包含可选的同步调整：

• 启用盔甲架装备交换默认开启。左Alt或右Alt+使用键可将玩家的头盔、胸甲、护腿、护肩以及手持或收起的手部套装与玩家自建的 盔甲架, 护甲架_女性或 盔甲架_男性；无创造者的地点和控制台生成的替身保持其原版交互。游戏的 替代位置/Shift输入不再触发交换。只有当该实用物品交换的双方都安全时，才会包含实用物品；可显示物品如 腰带强度 可以交换，而诸如 叉骨 或除雾器保持装备或附着状态，套装其余部分仍会切换。单手配对和双手武器会作为一组手部套装交易进行验证和移动。已收起的手部套装在切换后仍保持收起状态；混合了 drawn 和隐藏手部物品的临时状态必须先结束。基础 盔甲架 始终会将其盾牌与武器互换到背部槽位。女性和男性立架始终会互换其手部槽位，并保持背部槽位不变，无论玩家的手部套装是拔出还是收起。如果玩家没有手部装备，则从所选立架槽位取回的装备会被拔出。女性和男性手部槽位配置必须与Valheim允许每个物品的显示侧一致，包括物品特定的覆盖设置；任意仅用于显示的反向配置都会导致套装互换被拒绝。
• 启用床铺补丁: 默认开启。为支持的 MVBP 风格床铺预制件添加床铺/出生点行为。
• 发酵桶效果持续时间百分比默认为 70. 0 禁用玩家建造的 矮人道具_木桶 发酵罐补丁； 1 到 100 将其启用，并将发酵时长设为原版发酵桶的百分比。该木桶会出现在 制作 默认按标签分类。没有创造者的自然生成实例仍是普通木桶。

床和发酵桶的调整被刻意标记为不安全，因为之后禁用该模组可能会影响已放置的世界状态，例如出生点或发酵中的内容。

飞船 已从公开及管理/调试构建列表中排除。HarnessPrefabs 不再加载、公开或修改该飞船，并忽略试图启用它的 YAML 条目。

回合 启用盔甲架装备交换 当另一个模组关闭时，例如 禅意物品架 或 衣柜，应改为处理盔甲架交互。HarnessPrefabs 不会根据已安装的模组自动启用或禁用此功能。

优势

• 精选默认配置并支持本地控制：以MVBP知识为起点，但最终策略仍由YAML决定。
• 管理员审核界面不显示玩家杂乱信息：HarnessPrefabs 部分仅在调试模式下的管理员可见，且可在客户端隐藏。
• 服务器权威策略：活动覆盖项与本地化内容可同步至客户端。
• 模组包友好发现：在可能的情况下，预制体按所有者分组，使大型参考文件更易于查看。
• 更安全的锤子作用域：运行时效果、生物、物品掉落以及生成器/控制器对象都保留在构建表之外。
• 专注兼容性：将现有策略组与 Valheim 的建造菜单集成，并使用原始游戏引用，通过显式缓存访问所需的私有成员。

建议工作流程

1. 在安装 HarnessPrefabs 的情况下启动服务器或单人世界。
2. 让它生成 prefabs.reference.yml.
3. 将想要的条目复制到 prefabs.yml 或一个 预制件_*.yml 文件。
4. 使用公共分类来归类普通玩家的棋子。
5. 使用“线束”分类来处理仅限管理员查看/构建的部分。
6. 奔跑 完整线束预制件 仅当你需要显示名称、描述、标记或组件元数据以进行更深入审查时。

保持预制体默认值

MvbpPrefabDefaults.generated.cs 是从MoreVanillaBuildPrefabs最初导入的精选快照；其文件头记录了源路径。此仓库中未跟踪任何生成器。该表还包含已审核的HarnessPrefabs更改，包括 矮人道具桶 制作类别，必须能在未来的导入中保留。

在重新生成或替换表格之前，请记录上游来源和修订版本，保留现有的手动更改，并将预制件键、有效访问权限、类别、需求以及放置/移除标志与当前快照进行对比。请明确审查有意的差异；保留来源出处和手写转换规则于 MvbpPrefabDefaults.cs.

GitHub

原始代码来自 https://github.com/searica/MoreVanillaBuildPrefabs
模组的仓库 https://github.com/sighsorry1029/HarnessPrefabs