攻克 FFXIV TexTools 法线黑模难题一次真实排错换来的完整修复手册【免费下载链接】FFXIV_TexTools_UI项目地址: https://gitcode.com/gh_mirrors/ff/FFXIV_TexTools_UI深夜两点你终于把建模三天的护甲导进游戏结果穿上后整件装备黑成一团——没有高光、没有褶皱阴影转个视角还疯狂闪烁。这不是网络问题也不是显卡驱动问题而是 FFXIV TexTools 导入管线里最经典的法线异常。别急着删 mod本文用一次真实排错过程带你从看得见黑模一路走到根因定位、手动修复、防止复发看完就能照着操作。读完你将获得一张表看懂全黑模型、光照闪烁、细节丢失三类法线异常的成因与救急手段三步定位故障根因的可执行流程每一步都有可验证的输出3 个场景的精准修复方案法线图通道反转、切线数据接管、源头烘焙修正一段可直接复制的通道修复代码批量处理时不必反复点界面一份导入后验收清单从根上防止问题复发一、先给你一张对照表黑模、闪面、丢细节各自病在哪异常表现视觉特征最常见的成因一句话救急方案修复难度全黑模型无任何光照反应像贴了黑纸法线图全零值或绿通道(G)完全反转通道编辑器里把 Green 反转一次★光照闪烁转视角时明暗剧烈跳动切线(TBN)数据被引擎重算与法线图不匹配导入时勾选使用导入的切线★★细节丢失高模细节消失表面光滑得可疑法线图被当普通漫反射图导入B 通道丢失用 32 位 TGA/DDS 导出确认压缩格式★★这三类问题的共同根源只有一个你交给引擎的法线语言和它理解的法线语言不一致。翻译错了光照自然全乱。二、复现那个坑为什么我按标准流程导还是黑先别急着修看看我踩过的完整链路你就知道问题通常出在哪一环。我的流程是Blender 3.3 烘焙法线 → 导出 FBX → 用 FFXIV TexTools 的导入模型功能替换装备。结果游戏里不仅黑连 TexTools 的模组预览区也成了下面这样——如果你也见过这张没有图的占位界面说明贴图引用或通道数据多半已经不正常了。为什么标准流程也会翻车因为这里藏着一个几乎被所有 3D 美术忽略的坐标系翻译问题Blender 等软件默认按OpenGL 习惯右手系烘焙法线绿色通道(G)记录的 Y 方向与 DirectX左手系正好相反FFXIV 是 DirectX 系游戏引擎在psCustomMeshBlinnPhong.hlsl的calcNormal函数里会把法线图从[0,1]展开到[-1,1]再参与光照计算对应源码中的mad(2.0f, bumpMap, -1.0f)如果你的 G 通道没翻转展开后的 Y 分量方向就反了浅坑变深坑高光整体错位严重时就表现为全黑。另外FFXIV 的.mdl模型文件里法线并不是直接存一张图这么简单——顶点里还带一份**切线(TANGENT)与副切线(BINORMAL)**数据见FFXIV_TexTools/Custom/CustomEffectsManager.cs的顶点布局定义像素着色器用它们搭出 TBN 矩阵再去读法线图。这份顶点切线如果和你的法线图对不上就会表现为闪面。三、三步定位先确诊再开药修法线最忌讳瞎点一通。按下面三步走每步都有可验证的输出。第 1 步查看器里做光照体检在 FFXIV TexTools 的模型查看器里旋转模型盯着高光变化完全无反应 → 大概率是法线图本身全零或通道反了明暗乱跳 → 大概率是顶点切线数据的问题。验证输出记下无光照 / 闪烁 / 只有漫反射中的一种它决定你走下面哪个分支。第 2 步把法线图导出来验数据用导出原始纹理把法线贴图导出为 TGA再用任意能看通道的软件检查正常法线图应当五颜六色R/G/B 方向各异且 B 通道不该大面积接近 0如果整张图是均匀的蓝色 (0,0,255) 或灰色 (128,128,255)说明它被当成了普通贴图法线信息根本没进去。第 3 步核对导入参数与日志回到导入流程检查导入模型对话框里的使用导入的切线选项源码中对应ModelImportOptions.UseImportedTangents见FFXIV_TexTools/ViewModels/ImportModelViewModel.cs。如果它没被勾选引擎就会用自己的算法重算切线——这一步正是闪面的头号来源。验证输出确认该项当前是勾选还是未勾选与第 1 步的观察交叉比对。四、对症下药三个场景三种修法场景 A全黑 → 反转法线图绿色通道这是最典型的 DirectX/OpenGL 坐标系冲突。不用重新导出FFXIV TexTools 自带的通道编辑器就能修打开贴图 → 纹理工具 → 通道编辑器 → 选择 Green 通道 → 点击反转(Invert) → 保存导入。它的底层实现就在EditChannelsWindow.xaml.cs的InvertChannel方法里核心逻辑只有一句新值 255 - 旧值。如果你需要批量处理多个模型这里给一段等价于只反转绿通道的 C# 逻辑方便你接入自己的批处理脚本// 修复 Y 轴反转只动 Green 通道保留 R/B/A var fixedPixel new byte[4]; fixedPixel[0] original.R; // R 保留X 轴 fixedPixel[1] (byte)(255 - original.G); // G 反转Y 轴关键一步 fixedPixel[2] original.B; // B 保留Z 轴 fixedPixel[3] original.A; // A 保留场景 B闪面 → 让引擎用我的切线如果你确认法线图数据没问题第 2 步通过那问题出在顶点切线。修复分两步重新导入时务必勾选使用导入的切线 / Use Imported Tangents让引擎直接采用 FBX 里带进来的 TANGENT/BINORMAL而不是自己重算如果源模型导出时就丢了切线回 Blender/Maya 勾选导出切线再导一次 FBX建议 FBX 2018 及以上版本。场景 C源头就错了 → 在 3D 软件里修正烘焙参数法线图经手多道工序后往往不可逆最稳妥的是回到源头修正Blender 烘焙法线时勾选翻转绿通道或选择以 DirectX 为目标的导出预设Substance Painter 导出贴图时输出配置选DirectX而不是 OpenGL导出 FBX 前删掉多余的形状键和顶点组避免脏数据被带入。这样产出的法线图在 FFXIV TexTools 里基本一次过这也是社区里公认最省心的组合。如果你想在命令行层面做更细的控制仓库里的 ConsoleTools 工程ConsoleTools/Program.cs提供了/wrap、/extract等命令其中的/tangents标志等价于使用导入的切线适合写进自动化流程。五、防复发把修一次变成一直不坏修好一个不如建一套流程。给你一份可直接抄走的导入后验收清单模型表面无整片纯黑区域旋转 360° 观察旋转视角时高光过渡平滑无剧烈闪烁法线图 B 通道非零G 通道方向与 DirectX 约定一致材质面板中该贴图类型为法线(Normal)而不是漫反射高模细节在近距离观察时清晰可见导入日志中无 tangent / normal 相关警告再补两个习惯一是模型文件用统一命名例如Character_Midlander_F_Top_v1.2_NormFix.fbx出了问题能一眼溯源二是把使用导入的切线这类关键参数写进团队的导入 SOP别让每个人各自为战。收尾法线问题的本质是翻译问题回顾整条排错链路你会发现法线异常几乎都不是随机故障而是坐标系语言不通。理解了 FFXIV 的 DirectX 约定、法线图与顶点切线的分工你就能在黑模 → 定位 → 修复 → 验证之间快速闭环。随着《最终幻想14》持续更新TexTools 未来还可能引入 PBR 与更高精度的法线存储但先诊断、后开药、再预防的思路不会过时——下次再有人深夜对着黑模抓狂把这篇文章转给他就够了。本文基于 FFXIV TexToolsGPL v3 开源项目源码与社区实践整理验证环境为 Windows Blender 3.3 FFXIV 6.x 客户端。不同版本的工具与游戏客户端在选项名称、贴图压缩格式上可能存在差异请以你手头版本的界面为准。修改游戏文件前请知悉 SE 用户协议并务必保留原始文件备份。【免费下载链接】FFXIV_TexTools_UI项目地址: https://gitcode.com/gh_mirrors/ff/FFXIV_TexTools_UI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
