Unreal Export 是一个面向 Unreal Engine / UE5 的资产导出技能,目标是把 Blender 中制作的资产以符合 UE 工程习惯的形式导出为 FBX,减少导入后出现的尺度异常、碰撞缺失和命名混乱问题。
用途
当静态网格或骨骼网格需要进入 Unreal,或需要导出 UCX/UCLX 碰撞、导入 LOD 链、为游戏逻辑设置插槽与枢轴时,可使用该技能。
前置准备
资料建议在导出前完成:asset-optimization PASS、lod-pipeline 处理 LOD0–N、collision-proxy 生成 UCX 网格;应用缩放,并把枢轴放在预期的 UE 原点位置。
尺度处理
Unreal 以厘米为单位。资料给出的常见做法是:在 Blender 中按米建模,导出 FBX 时依据项目流程处理单位换算或 0.01 的意识;或者按项目文档规定的尺度工作,并用 100cm 参考物验证。导入后应始终测量一条已知边。
FBX 默认参数(静态)
选择“Selected Objects”;Apply Scalings 设为“FBX All”;Forward 为“-Z Forward”;Up 为“Y Up”;Mesh 开启;Smoothing 为“Face”。
命名规范
静态网格使用 SM_Name;骨骼网格使用 SK_Name;骨架使用 SKEL_Name;LOD 使用 SM_Name_LOD0 等;碰撞使用 UCX_SM_Name_01;插槽空物体使用 SOCKET_Name。
碰撞
优先使用凸形 UCX 分块,而不是复杂网格碰撞体;支持多个 UCX 网格,可参考 collision-proxy。
骨骼网格
在需要时采用面向 UE 人体模型的 proportion;保留根骨骼,不要残留 Blender 变形遗留物;如有需要可导出形态键(morph targets)。
导入后验证
检查尺度(门约 200cm、角色约 180cm)、碰撞线框、LOD 是否被自动识别、材质与纹理采样、插槽变换。
约束
必须做:用已知尺寸测试确认尺度;碰撞前缀使用 UCX_;导入后验证 LOD 与材质。不得做:为 Blender 5.2 之前的版本编写代码或片段,也不要添加版本回退,因为该插件面向 5.2 及以上,旧分支会教用户使用已不存在的 API;不要在没有碰撞规划的情况下为物理资产导出;不要混用未记录的单位体系。
脚本
资料提供 scripts/export_unreal.py,已在 Blender 5.2 LTS 上通过官方 Blender MCP 测试。可通过 execute_blender_code 运行,或以无头方式运行(见 blender-mcp-workflow 技能);使用前阅读脚本头部了解每个参数。若用户将自行粘贴代码到 Blender,应提供指向该已安装脚本绝对路径的简短 runpy 调用及其 ARGS,不要内联或重写脚本。
调用示例:
import runpy result = runpy.run_path("<skill_dir>/scripts/export_unreal.py", init_globals={"ARGS": {...}})["result"]
ARGS 包括 mesh、out_dir、strict。脚本执行导出前的飞行前检查,包括 SM_/SK_ 前缀、与渲染网格匹配的 UCX_ 碰撞命名、LOD 命名、SOCKET_ 空物体、应用变换和场景单位尺度,并导出渲染网格、其 UCX_ 代理与 SOCKET_ 空物体。
参考指南
Unreal 检查清单见 references/unreal-checklist.md;UCX 命名见 references/ucx-naming.md;在需要时加载。