游戏美术与资产 / 系统课时

批量导出前怎样避免文件混乱

批量导出前怎样避免文件混乱

LOD 做完以后,真正容易出问题的往往不是导出按钮,而是“哪个文件对应哪个资产、哪一级 LOD”。本节把导出前的整理过程固定为可检查的命名、目录和清单规则,并用一个 Blender Python 预检脚本在导出前发现缺级、重名和非法命名。

学习目标

  • 为资产名、LOD 等级和导出目录建立一一对应的规则。
  • 在批量导出前自动检查缺少 LOD0、重复等级和命名错误。
  • 生成可追踪的清单文件,让后续导出、提交和回查有统一依据。

先固定命名与目录规则

一个稳妥的规则是让“对象名、文件名、目录名”共享同一个资产基名。例如 Rock_A_LOD0 与 Rock_A_LOD1 必须属于同一资产 Rock_A,导出时进入同一目录。不要在文件名里混入“final”“new”“fix2”这类无法机器判断的状态词。

对象名 资产基名 LOD 等级 建议导出文件
Rock_A_LOD0 Rock_A 0 Rock_A/Rock_A_LOD0.fbx
Rock_A_LOD1 Rock_A 1 Rock_A/Rock_A_LOD1.fbx
Crate_LOD0 Crate 0 Crate/Crate_LOD0.fbx

导出目录只承担组织职责,不表达“是否完成”。完成状态应交给版本控制、资产管理系统或清单字段记录,否则目录越维护越容易出现 final/final2/latest 这类无法自动化处理的分支。

LOD资产从对象到导出目录的对应关系

用预检脚本建立资产清单

下面脚本扫描当前场景中的 Mesh 对象,只接受 <资产名>_LOD<数字> 形式。它不会执行导出,而是在批量导出前生成 lod_manifest.json,并把不合规对象一次性列出来。这样可以先修正资产关系,再让真正的导出脚本消费清单。

python
import bpy
import json
import re
from pathlib import Path

NAME_PATTERN = re.compile(
    r"^(?P<base>[A-Za-z0-9][A-Za-z0-9_-]*)_LOD(?P<level>\d+)$"
)

groups = {}
errors = []

for obj in bpy.context.scene.objects:
    if obj.type != "MESH":
        continue

    match = NAME_PATTERN.fullmatch(obj.name)
    if not match:
        errors.append(f"invalid name: {obj.name}")
        continue

    base = match.group("base")
    level = int(match.group("level"))
    levels = groups.setdefault(base, {})

    if level in levels:
        errors.append(
            f"duplicate level: {base} LOD{level} -> "
            f"{levels[level]} / {obj.name}"
        )
    else:
        levels[level] = obj.name

for base, levels in groups.items():
    if 0 not in levels:
        errors.append(f"missing LOD0: {base}")

if errors:
    print("PRECHECK FAILED")
    for item in errors:
        print(item)
    raise RuntimeError("Fix asset naming before export")

export_root = Path(bpy.path.abspath("//exports/game"))
export_root.mkdir(parents=True, exist_ok=True)

manifest = []
for base in sorted(groups):
    for level in sorted(groups[base]):
        object_name = groups[base][level]
        relative_path = f"{base}/{object_name}.fbx"
        manifest.append({
            "asset": base,
            "object": object_name,
            "lod": level,
            "relativePath": relative_path,
        })

manifest_file = export_root / "lod_manifest.json"
manifest_file.write_text(
    json.dumps(manifest, indent=2, ensure_ascii=False),
    encoding="utf-8",
)

print(f"PRECHECK OK: assets={len(groups)}, entries={len(manifest)}")
print(f"MANIFEST={manifest_file}")

预期输出。假设场景包含 Rock_A_LOD0、Rock_A_LOD1、Crate_LOD0 三个合法网格对象:

text
PRECHECK OK: assets=2, entries=3
MANIFEST=<PATH>/exports/game/lod_manifest.json

生成的清单会把对象名与目标相对路径固定下来,例如:

json
[
  {
    "asset": "Crate",
    "object": "Crate_LOD0",
    "lod": 0,
    "relativePath": "Crate/Crate_LOD0.fbx"
  },
  {
    "asset": "Rock_A",
    "object": "Rock_A_LOD0",
    "lod": 0,
    "relativePath": "Rock_A/Rock_A_LOD0.fbx"
  },
  {
    "asset": "Rock_A",
    "object": "Rock_A_LOD1",
    "lod": 1,
    "relativePath": "Rock_A/Rock_A_LOD1.fbx"
  }
]

这里的 JSON 是数据结构示例,不要求有控制台输出。验证方法是打开生成的 lod_manifest.json,确认每个 Mesh 都有唯一 asset + lod 组合,且 relativePath 能唯一映射到计划导出的文件。

导出前按固定顺序做检查

先修命名,再导出,比“导出后整理文件”可靠得多。实际批处理前建议按以下顺序执行:

  1. 确认每个资产至少有一个 LOD0,并检查是否存在重复的 LOD 等级。
  2. 确认对象名与文件名使用同一资产基名,大小写和下划线规则保持一致。
  3. 运行预检脚本生成清单;只有出现 PRECHECK OK 才进入导出步骤。
  4. 导出器按照清单逐项写文件,不再临时拼接另一套命名规则。
  5. 导出结束后对比“清单条数”和“实际文件数”,数量或路径不一致就判定本次批处理失败。

资产整理的核心不是把文件夹摆得整齐,而是让“场景对象、LOD 等级、导出文件”之间存在可验证的一一对应关系。只要这条关系能被脚本检查并写入清单,批量导出就不会再依赖人工记忆。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

批量导出前怎样避免文件混乱

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通