跳转至

Naming Conventions (命名规范)

  • Owner: @micho
  • Status: Approved
  • Tool Versions: Unreal Engine 5.8, Maya 2024, Substance 3D Painter 12.2.0

1. Description of the Problem (问题定义)

跨软件资产导入、贴图通道混淆与非法字符会导致引擎导入失败、着色器编译崩溃或自动化脚本中断。必须在全流程确立统一的前缀、大小写及后缀命名法。

2. Goals and Non-Goals

  • Goals:
    • 强制规定所有导入引擎的静态网格体、骨骼模型、纹理、材质及粒子系统的前缀;
    • 规定贴图打包通道统一采用 ORM (Occlusion/Roughness/Metallic) 后缀;
    • 严禁任何路径与文件名包含中文字符、特殊符号或非法空格。
  • Non-Goals:
    • 蓝图内部变量命名暂不在本文档约束;
    • 音频音效资产命名见后续专用规范。

3. Deliverables & Handoff Contract

  • Input Deliverable: DCC 软件导出的合法命名 .fbx / .usd 及 .png / .exr 贴图。
  • Output Deliverable: 引擎内规范资产对象。
  • Core Prefix Table (核心前缀表):
资产类型 规范前缀 示例
Static Mesh (静态网格体) SM_ SM_Desk_Wood_01
Skeletal Mesh (骨骼网格体) SK_ SK_Hero_Knight
Texture (基础纹理) T_ T_Desk_Wood_01_BC (BaseColor)
Packed Texture (ORM 贴图) T_ T_Desk_Wood_01_ORM
Normal Map (法线贴图) T_ T_Desk_Wood_01_N
Material (主材质) M_ M_Desk_Wood_01
Material Instance (材质实例) MI_ MI_Desk_Wood_01_Dust
Niagara System (粒子系统) NS_ NS_Fire_Torch

4. Operational Runbook & Checklist

  1. 导出前确认网格体以 SM_ 或 SK_ 开头;
  2. 确认贴图通过 Substance Painter 导出时套用 Unreal Engine Packed (ORM) 预设;
  3. 检查文件路径中仅包含 [A-Za-z0-9_] 字符。