约 8 分钟读完;需要你会命令行、知道 glb 是什么;不懂 Three.js 也能跟。
这篇写给拿 AI 生成模型做游戏资产、却被扁平结构卡住的开发者,以及做细节层级(LOD)的同学;下面这张表按角色列出你能带走什么、从哪节开始读。
| 读者 | 带走什么 | 拿它做什么 | 从哪节开始读 |
|---|---|---|---|
| 拿 AI 生成模型做资产的人 | 六步处理管线的判断标准 | 逐档跑一遍自己的模型 | 6 |
| 处理扁平 glb 的人 | 20 行节点树检查脚本 | 先判断自己的模型是不是真的扁平 | 4 |
| 做 LOD 的人 | 每档喂原始导出的原则 | 别再二次减面 | 6 |
不做 3D 资产、只写页面逻辑的读者不必读。
这篇讲:AI 生成的军车模型是一堆平铺零件,怎么把它重做成引擎能驱动的层级结构。读完你会得到一张路线图:从「长什么样、为什么用不了」到环境、脚本、六步管线、坑与验收,最后是裁减与下一步。
先看这张表,决定要不要继续读:
| 小节 | 讲什么 | 读它能得到什么 |
|---|---|---|
| 1–2 | 扁平模型长什么样、为什么引擎用不了 | 判断自己的模型是否此类 |
| 3–4 | 装环境、打印节点树 | 一次跑通、确认问题 |
| 5 | 手工改 vs 写管线怎么选 | 决定值不值得投入 |
| 6 | 六步处理管线 | 可以照着做的判据与顺序 |
| 7–8 | 常见坑、三道自动检查 | 排查与验收标准 |
| 9–10 | 非车辆怎么套用、下一步动作 | 复用到别的模型 |
AI 生成服务(如 Tripo3D,文生/图生 3D)给的模型能看不能动:炮塔不会转、炮管不会抬、子弹没地方出。读完能带走一套六步管线、一个检查脚本、一份验收清单。
这类文件通常是 glb:glTF 的二进制封装格式,节点树、网格、材质、贴图都在一个文件里。打开后最反直觉的是节点层级(hierarchy,父子关系)——AI 导出基本没有层级:190 个零件平铺在同一层,单材质、贴图内嵌,648356 字节。
先把两种形态画出来(左边未处理,右边是处理完的目标):
Tripo 原始(扁平) 处理后(层级)
model.glb model.glb
├─ tripo_part_0 (mesh) └─ ParentNode
├─ tripo_part_1 (mesh) └─ Body (mesh,84 件合并)
├─ … 共 190 个平级节点 └─ Turret (mesh,95 件合并)
└─ tripo_part_189 (mesh) ├─ WeaponPart_1 (mesh)
├─ … 共 11 根炮管
└─ WeaponPart_11 (mesh)
下面这张表对比同一台车在两种形态下 5 个能力能不能做到(表里的 LOD 是按距离切换的细节档位,第 6 节细讲),你可以对着自己模型的症状对号入座:
| 能力 | 扁平模型 | 层级模型 |
|---|---|---|
| 炮塔 yaw(绕竖轴转) | 没有炮塔节点,只能整台车转 | Turret 绕自己原点转 |
| 炮管 pitch(俯仰)/ 后坐 | 两根炮管焊在车体上 | 每根炮管独立节点,各自动 |
| 发射点 | 只能按包围盒猜位置 | 炮管节点原点就是炮口基准 |
| LOD 切档 | 整包替换,节点数对不上 | 同构层级,逐档替换 |
游戏引擎读取并使用层级:顺着父子链找部件,不靠名字猜。典型取法如下(属性名按你的引擎改;示例不带行号便于复制,伪代码带行号便于讨论):
const body = root.children[0];
const turret = body.children[0];
turret.rotateOnAxis(new Vector3(0, 1, 0), yaw); // 炮塔 yaw
const barrels = turret.children.filter((c) => c.geometry); // 每根炮管一个
barrels[0].rotation.x = pitch; // 炮管 pitch
const muzzle = barrels[0].localToWorld(new Vector3(0, 0, 0)); // 发射点
代码第 3 行 turret.rotateOnAxis 是炮塔 yaw,第 4 行拿到每根炮管,第 6 行 localToWorld 给出炮口位置。所以层级必须固定为三级:ParentNode → Body → Turret → WeaponPart;少一层就取不到。
后面第 4、6 节要读 glb、算几何量、合并网格,先装一个能解析 glb 的 Python 库。Python 3 + pygltflib 够用:把第 4 节脚本存成 print_tree.py,执行后打印节点树:
python --version # 需要 Python 3
python -m pip install pygltflib
python print_tree.py model.glb
示例假设文件叫 model.glb,放在当前目录。
动手改之前,先用 20 行代码确认模型是否真的扁平:它打印节点树,顶层节点数≈总节点数(这台 190 对 190)就需要后面这套处理。代码可直接复制:
from pygltflib import GLTF2
gltf = GLTF2().load("model.glb") # 假设场景 0
roots = gltf.scenes[gltf.scene].nodes # 顶层节点
def walk(index, depth):
node = gltf.nodes[index]
kind = "mesh" if node.mesh is not None else "none"
print(f"{' ' * depth}- {node.name or index}: geometry={kind}")
for child in node.children or []:
walk(child, depth + 1)
print(f"总节点数: {len(gltf.nodes)}")
print(f"顶层(平级)节点数: {len(roots)}")
print("节点树:")
for index in roots:
walk(index, 1)
怎么读结果:顶层数接近总数就是扁平形态;已是三级链就跳过前面六步,直接去第 8 节验收。
把 190 个平铺零件改成三级层级、统一朝向尺寸和锚点(旋转中心),有两套干法:
两者代价不同:手工法上手快但改不了几次,管线法投入大但能反复跑。
真要写,管线约 8001200 行 Python(含检查脚本),熟练 23 天;服务到引擎之间没有标准转换器,但 pygltflib + trimesh + Blender bpy 够用。
总目标:把平铺零件变成引擎能驱动的层级。六步顺序:分类(谁属于谁)→ 定向(统一 +Z)→ 定标贴地(真实尺寸、落地)→ 锚点(旋转中心)→ 合并(可驱动网格)→ LOD 与贴图(远处降细节)。第 13 步通用,第 46 步车辆特有(第 10 节裁减)。
这六步要写成脚本。脚本 = 一段读 glb、算几何量、重组层级、写回新 glb 的程序。本文给判据不给完整工具,因为完整工具会绑死目录结构和引擎约定。翻译成脚本的路子统一是「读节点 → 算体积/质心/包围盒 → 筛选分组 → 写回」;第 1~4 步用 pygltflib + numpy,第 5 步合并与重算法线、贴图坐标(UV)用 trimesh 或 bpy。
六步结构同构(读 → 算 → 筛 → 分组 → 写回),后面五步同法,只以第 1 步说明写法(伪代码带行号便于讨论,省略已标注):
1 │ parts = read_parts("model.glb") # 读:体积/质心/包围盒
2 │ hull = max(parts, key=volume) # 算:体积最大件 = 车体
3 │ hull_top = hull.bbox_max[1] # 车体顶面
4 │ band = [p for p in parts if p.centroid[1] > hull_top]
5 │ main = max(band, key=volume) # 主炮塔块
6 │ barrels = [p for p in band if is_thin(p) and near_center(p)]
7 │ turret = [p for p in band if p not in barrels]
8 │ body = [p for p in parts if p not in band]
9 │ write_groups(body, turret, barrels) # 写回
10 │ # 省略:越过炮塔/底面更高的判断、按跨度打分
tripo_part_1 是 Tripo 导出的零件默认名,顶面 0.1880);炮塔带是质心高于车体顶面的件;主炮塔是带内体积最大件(底面 0.1904);炮管候选要同时满足细截面、近中线、沿长轴越过炮塔、底面高于炮塔底,按跨度与截面比取高侧 → 11 件;Turret = 带内去掉炮管 95 件,Body = 其余 84 件。漏掉「底面更高」,4 个车体件会被算成炮管(候选 11→15)。先交代一个领域约定。LOD(level of detail,细节层级)是为远景省显存和带宽——远处模型不需要那么细。Tripo 这类服务按 LOD 各导出一个独立文件:同一台车导出 2~3 个 glb,几何是同一台车,只是面数和贴图分辨率不同:
| 档位 | 面数 | 贴图分辨率 | 用在哪 |
|---|---|---|---|
| lod1 | 最高(4142 三角形) | 1024 | 近景 |
| lod2 | 中等 | 512 | 中景 |
| lod3 | 最低 | 128 | 远景 |
所以处理方式是「逐档各跑一遍六步管线」,产物每档一份。
再讲为什么每档直接吃对应档位的原始导出、不要二次减面:拿 lod1 自己减面生成 lod2,减面会破坏零件边界,分类漂移,同一根炮管在 lod1 能识别、到 lod2 就识别不出;三档都吃同一份导出则面数完全一样,「有 LOD」但没省。服务自己出的每档本就按面数递减设计,直接用最省事。注意导出不一定严格递减:这台 lod1 和 lod2 就是同一份文件(同样 4142 个三角形、md5 一样;md5 是文件指纹),每档都要显式绑定自己的源文件。
贴图也要跟着档位定分辨率:lod1 1024 / lod2 512 / lod3 128(你的模型按屏幕占比定)。远处看不清细节,贴图太浪费显存。源图已是目标尺寸就逐字节保留;要缩的走 Blender,视图变换固定 Standard(默认 AgX 会改颜色)。下面这张表是 JPEG 质量实测(源 1024²):
| 目标尺寸 | q75 | q80 | q85 |
|---|---|---|---|
| 512² | 44554 B | 51027 B | 60056 B |
| 128² | 4967 B | 5596 B | 6437 B |
取 q80:体积与画质的折中。
下面按「是什么 → 为什么是坑 → 怎么解决 → 为什么能解决」排:
| 坑是什么 | 为什么是坑 | 如何解决 | 为什么能解决 |
|---|---|---|---|
| 车体按「触地零件里三角形最多」选 | 履带段三角形最密,被选成车体(顶面 0.0698),炮塔带吞了 173 件 | 改按「体积最大」选(顶面 0.1880) | 体积是车体最稳定的几何特征,履带段体积远小于车体 |
| 拿整个 Turret 组包围盒中心当炮塔锚点 | 天线把中心拉高 0.9641 m,炮塔绕架空位置画圈 | 锚点改取「主炮塔块」的包围盒中心 | 旋转中心只应取决于要旋转的那块,与整组装饰无关 |
| 按 X 轴找炮管首尾 | 炮管沿 Z 轴长,角度只算到 -13.5° | 把长轴作为参数传入,规定离炮塔中心较远的一端是炮口 | 方向由几何决定,不靠对模型朝向的假设 |
| 三档 LOD 都喂同一份 glb 导出 | 面数完全一样,有 LOD 但一个面都没省 | 每档显式绑定对应档位的导出文件 | 服务按档位各导出一份,档位不同面数本就不同 |
| 用 Blender 默认视图变换缩图 | AgX 会改颜色,缩完图发灰/发暗 | 固定 Standard、曝光 0、gamma 1 | 色彩变换固定后,像素才可与原图逐字节比较 |
脚注:写脚本还有两个坑:合并索引把浮点个数当顶点数,Blender 报 IndexError: 1669(改用 len(positions) // 3);临时诊断脚本与管线坐标顺序不同,会差 0.3%。
怎么判断改对了?跑下面三道自动检查,全绿才算处理完:
| 检查 | 内容 | 通过判据 |
|---|---|---|
verify_norm.py |
16 项:层级、材质/贴图各 1、长度 ±5%、贴地、锚点对照参照、偏航 ≤0.5°、三角形 ±5%、法线非零、索引范围、包围盒匹配 | 16/16 |
| jest 场景 | 解析产出的 .glb,检查层级、命名、包围盒、材质 | 6/6 |
regen-check.sh |
重跑整条管线,产物逐字节比对 | REGEN_IDENTICAL |
脚本名是我们项目里的,你不必同名。这份清单可当验收脚本骨架(断言 = 写死的自动判断,不满足就报错):
ParentNode → Body → Turret → WeaponPart;进引擎前用 Blender headless(无界面模式,命令行直接跑)导入一次:父子链正确、输出 IMPORT_OK,面数 1603 / 2135 / 404。第三道最容易被忽略:只读产物的测试改坏了照样绿——它测的是快照,不是管线回归。
不管什么模型,分类、定向、贴地都要做;能跳过的是车辆特有的炮塔 yaw、炮管 pitch、发射口。
建筑、道具只做前三步;角色还要对齐骨骼名与层级——「层级即契约」思路另篇再写。
+Z 定向、贴地,再用第 8 节的断言清单跑一遍;这些内容来自一个真实资产处理流程的反复打磨:同一批模型连续跑了多轮规范化与逐字节比对,才把层级、朝向、尺度与挂点固定成一条可重跑的管线。文中的零件数、体积变化与通过项数都是当时实测的结果。