Facegen Diagnostics 是一个针对《上古卷轴5:天际》特别版(Skyrim SE)中 NPC 暗脸/灰脸/黑脸系列问题的调查流程。其核心原理是:一个已烘焙的 NPC 面部由两个预处理文件组成——头部 .nif 和面部着色 .dds。所谓“暗脸”,本质上是赢得 NPC 记录的插件与赢得该 NPC facegen 文件的模组/BSA 之间发生了不同步。该技能会解析 NPC、计算其 facegen 路径、比较两个胜出者,并决定是让正确文件胜出,还是将正确外观转发到记录中,最后进行验证。
用途
该技能用于诊断和修复 Skyrim SE 中 NPC 的暗脸/灰脸/黑脸问题、FaceGen 冲突、facegeom/facetint 优先级问题、颈部接缝,以及缺失或错误的 NPC 头部资源。它适用于需要排查 NPC 外观异常、理解记录与文件优先级冲突的场景。
主要能力
houseCARL 工具可以:
- 报告某个 Data 相对路径的 VFS/文件胜出者(housecarl_asset_status)。
- 将正确副本放置为胜出的松散覆盖文件,包括单条目进程内 BSA 提取(housecarl_place_asset / housecarl_bulk_place_asset)。
- 读取加载顺序胜出的记录,并将外观编辑写入新的覆盖插件(housecarl_read_record、housecarl_set_field、housecarl_create_record、housecarl_cross_plugin_query、housecarl_batch_record_detail)。
- 读取胜出 facegen .nif 中的数据值(housecarl_nif_inspect),包括烘焙形状名称、嵌入的纹理集路径(槽位 6 的 FaceTint .dds 路径,槽位 0/1 的皮肤漫反射/法线)、NiAVObject 标志与缩放、alpha 属性、BSDismember 分区、骨骼、节点树和头部字符串。它通过同一 VFS 解析网格(默认胜出者;可用 mod= 指定提供者),因此可以读取游戏实际使用的副本。
- 将白名单内的 .nif 数据值写回(housecarl_nif_set):重写 BSShaderTextureSet 槽位(set_path——嵌入的 FaceTint 槽位 6 或皮肤槽位 0/1)、重命名烘焙形状或节点(rename_shape / rename_node)、设置 NiAVObject 标志(set_flags——0x80000 头部/头发类位)、alpha(set_alpha——头发 0x12ED / 发际线 0x12EE 类)、BSDismember 分区(set_partition)或缩放(set_scale)。每次写入在落地前都会通过两道偏移免疫验证门(只有操作声称触及的值发生变化;重新加载后重新读取;census + SE-stream 完好)——验证失败则不写入任何内容并说明原因。默认情况下,编辑后的网格会放入新的 houseCARL MO2 模组文件夹中相同路径(原始文件不受影响;启用并将其排序在当前胜出者之上——BSA 打包的源会因此变成胜出的松散覆盖文件);in_place=true 会覆盖胜出的松散文件本身(需选择加入,每文件一次性确认,无备份)。
使用方式
该技能遵循一个结构化的诊断决策树:
- 第 0 步——范围与排除:先排除玩家专属灰脸、棕色脸、紫色/亮白脸、闪亮/油脸、运行时生成或 SPID/SkyPatcher 分发的外观、基于 RaceMenu .jslot 预设的 NPC 等非 facegen 问题。
- 前门——将 NPC 解析为 FormKey:优先使用 EditorID,其次名称,通过 housecarl_cross_plugin_query 查询 NPC_。对于用户已读取的 xEdit 风格 FormID,去掉高位字节,保留 6 位十六进制本地 ID。对于控制台点击的 FormID,应停止并路由到名称/EditorID,因为它是 RefID 且运行时索引 ID 无法机械解析。
- 诊断决策树:
- 第 1 步——记录胜出者:housecarl_read_record 确定哪个插件的 NPC 记录胜出,并确认记录可解析且主文件存在。
- 第 2 步——计算 facegen 路径(两个文件总是一对):
- meshes\actors\character\facegendata\facegeom\<DefiningMaster>\<00…ID>.nif
- textures\actors\character\facegendata\facetint\<DefiningMaster>\<00…ID>.dds
- 第 3 步——文件胜出者:对两个路径运行 housecarl_asset_status,根据结果分支处理(无胜出者、错误来源胜出、正确来源胜出但仍暗脸)。
- 第 4 步——决定哪个副本正确:不变量是胜出记录的外观与胜出 facegen 文件必须来自同一来源。使用 place_asset 放置正确 facegen 作为胜出松散覆盖(修复 B),或将外观字段转发到新覆盖插件(修复 C),或两者兼施。
- 第 5 步——验证:重新运行 housecarl_asset_status 确认放置的副本胜出;在游戏内使用 setnpcweight 50 重新加载头部进行视觉检查;使用 FDF 关闭测试;必要时进行全新游戏或存档清理检查。
- 批量流程:对于“安装 X 后一堆 NPC 变暗”的情况,枚举 → 全部计算 → 全部 asset_status → bulk_place。
适用场景
- 诊断和修复 Skyrim SE 中 NPC 的暗脸/灰脸/黑脸问题。
- 解决 FaceGen 冲突、facegeom/facetint 优先级问题。
- 修复颈部接缝、缺失或错误的 NPC 头部资源。
- 批量处理多个 NPC 变暗的情况。
限制
houseCARL 无法:
- 烘焙/重新生成 facegen 几何体(那是 Creation Kit Ctrl+F4 的功能;nif_set 只编辑数据值,从不编辑顶点/三角形)。
- 读取 .dds 像素内容或格式(它读取 .nif 对 .dds 的引用,从不读取着色/皮肤图像本身)。
- 编辑非纹理字符串引用——材质 / .tri / 物理 XML 路径(这些位于 nif_inspect 的 sections=strings 下;set_path 只交换 BSShaderTextureSet 纹理槽位,因此材质路径交换仍需 NifSkope)。
- 判断几何体或最终渲染的面部是否正确(写入并验证的值是数据层的来源证明,而非渲染结果;名称/路径/标志可能正确而网格看起来仍然错误,因此游戏内检查始终有效)。
- 执行存档编辑(需交给 Fallrim Tools / ReSaver)。
任何需要 CK、纹理工具、材质编辑或运行时 SKSE 模组的操作都只能给出指示。