游戏美术与资产 / 系统课时
自动检查哪些资产条件
自动检查哪些资产条件
批量烘焙最怕把错误资产带进后续步骤:命名错、缩放没应用、UV 缺失或贴图路径断开,都会在烘焙或导出阶段放大成本。本课把这些条件变成可重复执行的质检入口,让脚本先拦截问题,再允许资产进入烘焙与导出。
学习目标
- 把命名、变换、UV、材质、贴图和导出文件整理成明确的自动检查项
- 用 Blender Python 生成逐对象的 PASS/FAIL 报告
- 区分“必须阻断流程”的错误与适合人工复核的视觉问题
先把检查项分成机器可判定和人工复核
自动质检只适合判断有明确规则的数据。示例团队约定对象名使用 asset_part_low、asset_part_high 或 asset_part_cage 形式;参与交付的网格应应用旋转与缩放;至少存在一套 UV;材质槽不能空;文件型贴图必须能解析到磁盘。导出文件则属于后置检查,应在导出动作完成后验证存在性。
几何是否“看起来好”、倒角宽度是否合理、接缝是否容易被看到,则仍应人工复核。把主观判断硬塞进脚本,往往会制造大量误报。

用脚本建立最小质检入口
下面脚本可直接在 Blender 的 Scripting 工作区运行。命名规则是团队示例,不是 Blender 的强制要求;如果项目已有规范,只需替换正则表达式与导出路径。
import bpy
import os
import re
NAME_RE = re.compile(r"^[a-z0-9]+(?:_[a-z0-9]+)*_(?:low|high|cage)$")
EPS = 1e-4
STAGE = "delivery" # 改成 "preflight" 时只检查资产本身
EXPORT_PATH = bpy.path.abspath("//exports/asset.fbx")
def nearly(values, target):
return all(abs(float(v) - target) <= EPS for v in values)
def check_object(obj):
issues = []
if not NAME_RE.fullmatch(obj.name):
issues.append("name does not match project convention")
if not nearly(obj.scale, 1.0):
issues.append("scale is not applied")
if not nearly(obj.rotation_euler, 0.0):
issues.append("rotation is not applied")
mesh = obj.data
if len(mesh.uv_layers) == 0:
issues.append("missing UV map")
if len(obj.material_slots) == 0:
issues.append("missing material slot")
for index, slot in enumerate(obj.material_slots):
material = slot.material
if material is None:
issues.append(f"material slot {index} is empty")
continue
if not material.use_nodes:
continue
for node in material.node_tree.nodes:
if node.type != "TEX_IMAGE" or node.image is None:
continue
image = node.image
if image.source == "FILE" and image.packed_file is None:
path = bpy.path.abspath(image.filepath)
if not path or not os.path.isfile(path):
issues.append(f"missing texture file: {image.name}")
return issues
objects = [obj for obj in bpy.context.selected_objects if obj.type == "MESH"]
if not objects:
raise SystemExit("Select at least one mesh object")
failed = False
for obj in objects:
issues = check_object(obj)
if issues:
failed = True
print(f"CHECK {obj.name}: FAIL")
for issue in issues:
print(f" - {issue}")
else:
print(f"CHECK {obj.name}: PASS")
if STAGE == "delivery":
if os.path.isfile(EXPORT_PATH):
print(f"EXPORT: PASS -> {EXPORT_PATH}")
else:
failed = True
print(f"EXPORT: FAIL -> {EXPORT_PATH}")
else:
print("EXPORT: SKIP (preflight stage)")
print("RESULT:", "FAIL" if failed else "PASS")预期输出:当所选网格满足规则且目标导出文件存在时,输出形态如下;对象名和路径取决于当前工程。
CHECK <OBJECT>: PASS
CHECK <OBJECT>: PASS
EXPORT: PASS -> <PATH>
RESULT: PASS如果任一条件失败,脚本会在对应对象下列出原因,并把最终结果置为 FAIL。在 preflight 阶段可据此阻断烘焙;在 delivery 阶段再增加导出文件存在性检查,避免用尚未生成的文件反过来卡住预检。
哪些错误应该直接阻断
命名、变换、UV 缺失、空材质槽和贴图文件丢失适合作为预检阻断错误;预期导出文件不存在则只应在导出完成后的交付检查中阻断,因为它在烘焙前本来就可能不存在。相反,UV 岛布局是否美观、法线过渡是否符合美术目标、烘焙是否出现局部伪影,更适合作为后续视觉质检。
让检查结果真正进入流水线
实际项目中,质检脚本最好只做三件事:读取明确规则、输出机器可解析的结果、失败时阻断下一阶段。规则与执行动作分开后,团队可以逐步增加检查项,而不必重写烘焙脚本本身。
当检查项越来越多时,优先保持“一个失败原因对应一个可修复动作”。这样的报告才能从资产质检入口继续服务批量烘焙、导出和提交前检查,而不是变成只会报红的静态清单。