将未发现的配方和建造部件显示为遮罩预览，不会提前解锁。逐步揭示已知材料/工作站信息，在学习前阻止制作和放置，并支持同步的发现/黑名单配置和通知控制。

隐晦配方

VeiledRecipes 改变了《英灵神殿》呈现未知配方和建筑部件的方式。它不再让所有未发现的配方完全不可见，而是可以显示可配置的蒙面预览：玩家会得知某样东西存在，但名称、图标、描述、隐藏材料以及隐藏的工作站需求都会保密，直到真正的解锁条件达成。

该模组不会提前解锁配方。未知预览无法制作或放置。

隐蔽配方只有在所有材料和站点要求都满足时才会解锁。
默认情况下，站点只有在玩家与其互动后才会解锁。

默认情况下，未揭示的配方会分组显示在已知配方下方。

默认情况下，即使配方已解锁，制作台等级不足时也不会显示。

InventorySlots模组与VeiledRecipes兼容。快去看看吧！
https://thunderstore.io/c/valheim/p/sighsorry/InventorySlots/

碎片配方也被隐藏了。
默认情况下，玩家无需与制作站互动即可解锁部件配方。

优势

• 显示发现进度，但不剧透完整配方。
• 保持 Valheim 原有的配方和建造解锁规则不变。
• 面具制作配方、建筑部件、物品图标、描述、需求、工作站等级、工具提示以及支持情况下的固定工具提示内容。
• 逐渐揭示已知材料和站点信息。
• 阻止仅为预览的条目的制作和放置。
• 支持严格的站点发现规则以解锁配方。
• 保留其他模组添加的无配方升级、镶嵌和运行时构建工作流。
• 为物品产出、建筑部件和需求材料提供服务器同步的黑名单控制。
• 提供客户端选项，用于配方分组和嘈杂通知。
• 为自定义制作界面模组提供兼容性API。

制作配方预览

当合成配方仅显示为未知预览时：

• 配方列表图标显示为黑色剪影。
• 配方名称已被替换为 未知名称文本.
• 所选配方图标显示为黑色剪影。
• 配方描述已替换为 未知描述文本.
• 未知的需求名称和数量已替换为 未知需求文本.
• 未知空间站等级文本替换为 未知需求文本.
• 玩家已了解的需求会正常显示。
• 制作按钮已禁用，制作功能已被封锁。

配方预览可以归类在已解锁配方下方，这样正常制作时依然方便浏览。

建筑部件预览

未知建筑部件可能以屏蔽条目的形式出现在锤子/建筑部件表中。

在碎片实际解锁之前：

• 棋子图标显示为黑色剪影。
• 名称与描述已隐藏。
• 未知条件已隐藏。
• 放置虚影被阻挡。
• 放置被拒绝，并显示 Valheim 的缺少需求消息。

一旦Valheim认为该部件已被知晓，VeiledRecipes便不再对其进行遮蔽。

无配方模组工作流

有些模组允许玩家升级或镶嵌仅掉落物品，却不提供可解锁的制作配方。当某件物品没有任何已启用或当前赛季的ObjectDB配方可供学习时，VeiledRecipes不会屏蔽这些针对已有物品的操作。而没有配方且不存在目标物品的条目仍被视为制作并保持封锁，因此这一例外不会产生免费的 crafts 路径。

未在常规中注册的运行时片段 PieceTable.m_pieces 列表中的内容，例如生成的蓝图代理，也保持未屏蔽状态。常规注册的建筑部件继续遵循正常的知识和预览规则。

站点发现

Valheim 通常会在玩家走近制作站时发现它们。这种制作站感知会影响配方和建造部件的解锁。

VeiledRecipes将两个概念区分开来：

• 解锁配方需要空间站交互 控制配方是否需要在达到所需工作站等级并直接交互后才能解锁。
• 启用站点邻近发现 控制靠近制作站时是否通过 Valheim 的正常接近行为发现该制作站。

建造部件使用 Valheim 标准的制作站感知机制。如果启用了接近发现，走近制作站即可帮助解锁部件。如果禁用了接近发现，则需要先与制作站交互才能识别该制作站。

服务器同步配置

当启用配置锁定时，这些选项会通过 ServerSync 同步。

• 锁定配置 锁定同步配置，使游戏行为仅由服务器/管理员配置控制。

• 显示未知制作配方 在相关制作站启用遮蔽制作配方预览。默认： 开

• 显示未知建筑部件 在建筑部件表格中启用遮罩建筑部件预览。默认： 开

• 未知配方的制作需要工作站等级 若启用，未知的制作配方预览仅在当前制作站达到所需制作站等级时显示。锻造炉2级配方不会在1级锻造炉处显示，除非该配方已真正解锁。默认： 开

• 制作配方解锁需要站点交互 若启用，需工作台等级的制作配方只有在玩家与所需制作台等级互动后才会解锁。若禁用，配方工作台知识遵循瓦尔海姆默认的已知工作台行为。默认： 开

• 启用空间站邻近发现 如果启用，走近制作站时会正常发现它。如果禁用，则阻止临近发现，必须通过交互才能获得制作站知识。默认值： 开

• 配方预览预制件黑名单 未知制作配方预览中永远不应出现的物品预制体名称。这仅影响预览可见性；已解锁的配方仍会正常显示。默认：空

• 片段预览预制体黑名单 未知建筑部件预览不应出现的部件预制体名称。这仅影响预览可见性；已解锁的部件仍会正常显示。默认：空

• 需求预览预制体黑名单 原料/资源预制体名称，用于防止任何需要它们的配方或物品出现未知预览。这对于作弊、管理员或隐藏资源预制体很有用。默认值： 剑作弊，大锤作弊

• 未知名称文本 当配方、部件、材料或工作站名称被隐藏时显示的文本。默认： ？？？

• 未知描述文本 当配方或物品描述被隐藏时显示的文本。默认： 信息不足

• 未知需求文本 当数量或车站等级被隐藏时显示的文本。默认： ?

客户端配置

这些选项不会同步。每位玩家都可以选择自己的客户端行为。

• 将未知配方预览分组到已知配方下方 下方被遮罩的组制作配方预览，实际上解锁了制作站配方列表中的配方。默认： 真

• 显示配方解锁通知 显示或隐藏瓦尔海姆的配方解锁弹窗。默认： 真

• 显示棋子解锁通知 显示或隐藏英灵神殿的建筑部件和菜肴解锁弹窗。默认： 假

• 显示技能升级通知/效果 显示或隐藏技能升级提示及视觉／音效，包括技能首次达到1级时。默认： 真

黑名单格式

所有预制体黑名单条目均不区分大小写。空白字符会被去除，且末尾 （克隆） 后缀被忽略。

条目可用逗号、分号、竖线或换行符分隔。

输出黑名单与正在预览的物品或部件匹配：

铁护腿，铁剑

工作台扩展1 箱子

需求黑名单会匹配配方或建筑所使用的材料/资源预制件：

剑作弊，大锤作弊

AAA制作兼容性

已内置对AzuAntiArthriticCrafting的支持，安装该模组后会自动激活。无需修改AAA DLL或进行额外配置。

• 未解锁的配方在AAA的列表和网格布局中始终处于隐藏状态，包括名称、图标、产出数量和悬停提示。
• 当配方已学习或原版全局/免费解锁生效时，悬停提示框会恢复为正常内容。
• 未知配方无法添加到AAA的配方追踪器中。在需要配方知识时，已追踪的配方会暂时隐藏，但不会移除已追踪的条目。
• 已知配方和无配方升级/插槽目标保持其现有行为。随着 将未知配方预览分组显示在已知配方下方 已启用，预览会在整个筛选列表中已知配方之后分组，然后 AAA 再将其分页，制作和升级视图中均是如此。每组内保留 AAA 的原始顺序。
• 分组在每次生成页面时都会使用当前配方知识，包括缓存的页面变更。禁用该选项会恢复 AAA 的原始顺序，而不改变其缓存或过滤规则。不受支持的 AAA 分页变更会回退到页面局部分组，并记录一条日志警告。

此集成不会更改 AAA 的搜索/过滤规则，也不会为 ZenUI 的自定义面板添加内置支持。

兼容性API

VeiledRecipes 修改了 Valheim 原版的制作和建筑部件界面。自行绘制配方界面的模组可能需要调用公开 API 并屏蔽自身的控件。

使用 不遮罩* 显示和行动决策的方法。 是否已知配方 和 是否实际已知 举报玩家知晓，同时 应遮罩配方对 同时还考虑该配对的目标物品，以便正确处理无配方升级和镶嵌操作。

API 类型：

隐秘配方.隐秘配方兼容

有用的成员包括：

• 插件标识
• 插件名称
• 插件版本
• 作者
• 未知名称文本
• 未知描述文本
• 未知需求文本
• 将未知配方预览分组到已知配方下方
• 管理员绕过已激活 （旧版兼容成员；始终 假)
• 获取配方可见状态(recipe)
• 获取配方可见状态(player, recipe)
• 未知配方预览(配方)
• IsUnknownRecipePreview(player, recipe)
• 是否应屏蔽配方(recipe)
• 隐藏配方(player, recipe)
• 应掩码配方对(pair)
• 应为(玩家, 配方对)启用蒙版
• 配方是否确实已知(player, recipe)
• 是否应遮罩拼块(piece)
• 是否应遮挡部件(玩家, 部件)
• IsPieceActuallyKnown(player, piece)
• 材料是否已知(需求)
• IsMaterialKnown(player, requirement)
• 了解配方工作站需求(配方, 品质)
• 识别玩家的配方站点需求（玩家、配方、品质）
• 了解棋子站位需求（棋子）
• 了解棋子站位要求(player, piece)
• 注册已知棋子覆盖(predicate) / 取消注册已知棋子覆盖(predicate)
• 注册已知棋子预制体覆盖(prefabName) / 注销已知拼图预制体覆盖(prefabName)
• 注册已知棋子类型覆盖(typeName) / 取消注册已知棋子类型覆盖(typeName)

软依赖GUID：

叹气抱歉.隐藏配方

Git

https://github.com/sighsorry1029/VeiledRecipes

建筑

普通的调试版和发布版构建不会将DLL复制到正在运行的Valheim安装目录中。如需启用本地部署，请传入 部署到游戏 MSBuild 属性：

dotnet build .\VeiledRecipes.csproj -c Debug -p:DeployToGame=true

发行版本仍会正常创建 Thunderstore 和 Nexus 的 zip 包。

该解决方案还会构建兼容性测试运行器。请显式运行其托管回归检查：

dotnet build Tests/AaaCompatibility.Tests.csproj -c Release -t:Check

查看 测试/README.md 用于可选的 AAA DLL 合约检查和单独的游戏中验证清单。