企业官网建设流程全解析

FFXIV TexTools 模型导入法线避坑实录：一次全黑救火与 7 个排查点

【免费下载链接】FFXIV_TexTools_UI项目地址: https://gitcode.com/gh_mirrors/ff/FFXIV_TexTools_UI

FFXIV TexTools 是一款面向《最终幻想14》的模型 Mod 制作与安装框架，它的核心工作是把第三方建模软件导出的模型，转换成游戏.mdl格式并正确接入游戏光照系统。这篇实录围绕一次真实的"模型全黑"事故展开，把法线（Normal）相关的排查路径、底层原理、修复动作一次讲透，配 7 个可以直接照抄的排查点，供新手与普通玩家按图索骥。

1 凌晨三点，我导入的第一件装备全黑了

故事发生得很朴素：从 Blender 里做完一件上衣，导成 FBX，在 TexTools 里选好路径点下 Import，进度条走完，一切顺利。进游戏一看——整件装备像被泼了墨，完全没有光影反应。

更麻烦的是，把视角转了一圈，袖口处偶尔还会闪出几道刺眼的高光，像坏掉的霓虹灯。检查材质、检查 UV、重新导入三遍，问题原样复现。这就是模型制作里最磨人的一类问题：数据层面没报错，渲染层面全崩了。

如果你也遇到过"黑模型"、"光照乱闪"或"高模细节全丢"，下面这套排查与修复流程，就是为你准备的。

2 先分清病情：三步定位是"模型黑"还是"光照乱"

动手修之前，先花两分钟判断异常属于哪一类。病根不同，药方完全不同。

第一步：看模型检查器里的数据在 TexTools 的模型查看器中打开异常模型，切到线框/数据视图（项目源码目录FFXIV_TexTools/Views/Models/ModelInspector.xaml对应此功能）。如果模型本身的网格、UV 都在，说明几何数据是好的，问题大概率出在光照输入侧。

第二步：导出法线图看通道把该模型对应材质的法线贴图用"导出纹理"功能导成 PNG 或 TGA，用任意图像工具打开。正常法线图应该是"蓝紫色为主、带明显方向色块"的图；如果整张图发灰、发黑，或者红绿通道一片死板，就是法线数据本身坏了。

第三步：转视角验证在游戏或查看器里让光源固定、转动模型。全黑→数据级问题；闪烁→切线空间问题；细节丢失→格式或通道问题。记住你观察到的那一种，接着往下对号入座。

3 病根剖析：法线为什么一错，整个模型就废了

法线映射（Normal Mapping），人话解释：用一张贴图里的颜色数据，伪造表面的凹凸方向，让低模也能拥有高模的光影细节。它不改变几何，只"骗"光照计算。

问题在于，这张贴图里的数据是有坐标系约定的。FFXIV 游戏引擎走的是 DirectX（左手系）约定，法线贴图里：

• R 通道管 X 轴（左右方向）
• G 通道管 Y 轴（上下方向）
• B 通道存高度信息

而 Blender、Maya 默认的导出约定往往和 DirectX 相反——最常见的就是 Y 轴（绿色通道）方向反了。这不会报错，但引擎把贴图数据从[0,1]展开到[-1,1]之后，得到的方向向量全部偏转，光照结果自然全面错乱。

这一逻辑在项目源码里有直接体现：FFXIV_TexTools/Resources/Shaders/psCustomMeshBlinnPhong.hlsl中的法线采样函数，就是用bumpMap = mad(2.0f, bumpMap, -1.0f)把贴图值从 (0,+1) 展开到 (-1,+1)，再与切线（t1）、副切线（t2）组合成最终法线。贴图里的通道数据一旦站错队，这一整套组合就全错了。

另一个关键选项是"Use Imported Tangents（使用导入的切线数据）"。切线（Tangent）+ 副切线（Bitangent）+ 法线（Normal）构成所谓的 TBN 矩阵，它决定贴图法线要往哪个方向偏。勾选"使用导入的切线数据"，就是信任源文件里的切线信息；不勾，则由引擎按 UV 重新计算。**如果你的源文件切线本身就来自 OpenGL 约定，这个选项就是放大错误的开关。**该选项在FFXIV_TexTools/Views/Models/ImportModelView.xaml与FFXIV_TexTools/ViewModels/ImportModelViewModel.cs中均有对应实现。

4 一套能照抄的修复流程

4.1 全黑模型：先查数据，再决定是否重烘焙

全黑通常意味着法线向量无效或方向整体反转，按这个顺序处理：

1. 导出当前法线图，逐像素检查是否存在 R、G、B 同时为 0 的像素（那等于"没有方向"）；
2. 用图像工具的"通道查看"看绿色通道，确认是否需要反转；
3. 若确认是 Y 轴反转，用 TexTools 的通道编辑器（源码对应FFXIV_TexTools/Views/Textures/EditChannelsWindow.xaml）勾选反转绿色通道后重新保存；
4. 若整图数据就是坏的，回到 3D 软件重烘焙，烘焙时按 DirectX 规范设置（Blender 中对应"翻转绿通道/绿色为 -Y"的选项）。

4.2 光照闪烁：切线空间重建

视角一动就闪，往往是 TBN 矩阵计算错误。处理顺序：

1. 导入时取消勾选"Use Imported Tangents"，让引擎按 UV 重算切线；
2. 若仍闪烁，检查模型是否有非流形几何（重叠顶点、破面），焊接距离阈值从 0.001 起试；
3. 最后一步：回到建模软件检查顶点法线是否被手动编辑过，重置为"平均法线"再导出。

4.3 细节丢失：查格式与通道归属

高模细节完全看不到，多数情况是法线图被当成了普通 RGB 贴图处理。检查：

1. 确认导入时该贴图的用途被识别为"法线"，而不是漫反射；
2. 确认源图不是"扁平化后"的产物——比如从 Substance Painter 导出时选错 DirectX/OpenGL 预设，整个通道会被压平；
3. 确认图片分辨率与低模 UV 密度匹配，法线图过小会直接丢细节。

4.4 导入时的七项检查清单

5 三类异常的对照速查

6 进阶：把修复变成一条命令，并提前防住它

6.1 一条命令反转绿色通道

如果你手头有 ImageMagick，反转 Y 通道不用打开软件：

# 先看绿色通道的平均亮度，越接近 255 越可能是"平"的 magick normal.dds -channel G -separate -format "G通道平均亮度:%[fx:mean*255]\n" info: # 确认方向反了之后，只反转绿色通道，其余通道保持不动 magick normal.dds -channel G -negate normal_dx_fixed.dds

6.2 用命名与提交规范防患于未然

把修复动作沉淀进命名，团队协作时不靠嘴传：

Character_[种族]_[部位]_v1.2_DXNorm.fbx

提交说明建议固定结构：问题现象 → 修复手段（通道反转/切线重建/格式转换）→ 验证结果（通过/部分通过）。一套模板用熟之后，同样的坑不会再踩第二遍。

6.3 排查决策图

7 收个尾：法线数据是你的"光影地基"

一句话总结：FFXIV TexTools 导入模型时，90% 的光照问题都出在法线数据的坐标系与切线来源上，而不是模型本身。先分清症状，再对号入座查数据、查通道、查切线，最后用命令把修复标准化——这套流程走熟之后，全黑、闪烁、丢细节都不再是拦路虎。

下一步建议：把本文收藏成你的排障手册；想深入验证文中提到的选项与着色器逻辑，可以克隆https://gitcode.com/gh_mirrors/ff/FFXIV_TexTools_UI看源码（重点看FFXIV_TexTools/Views/Models/ImportModelView.xaml与FFXIV_TexTools/Resources/Shaders/psCustomMeshBlinnPhong.hlsl）；也欢迎去项目官方 Issue 与社区反馈工具链兼容问题。

免责声明：本文基于 FFXIV TexTools 仓库当前公开源码结构与通用 FFXIV 模型制作实践撰写，具体菜单与版本行为以官方 Release 为准（涉及具体版本处以 [vX.X.X] 标注）；文中命令适用于 Windows 环境的 DX11 客户端。使用第三方工具修改游戏文件，请务必遵守 SQUARE ENIX 的用户协议与相关法律法规，风险自负。

【免费下载链接】FFXIV_TexTools_UI项目地址: https://gitcode.com/gh_mirrors/ff/FFXIV_TexTools_UI