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