SuperAPI AI 工具集

blender-export-pipelines

编程与开发

查看项目

更新于 11-18 17:29

技能介绍

blender-export-pipelines 是一个 Blender 资产导出技能配置,用来把 Blender 中的模型、骨骼、动画和材质,按照目标引擎的要求批量导出。其执行模型定义在 blender-core 中;官方说明建议在导出前先运行 blender-asset-qa,如果涉及预算,还要运行 blender-game-optimization。

用途 该技能主要解决跨引擎导出时的格式选择、尺度换算、轴朝向转换、骨骼和动画处理以及材质衔接问题,避免导出后需要在引擎中反复修正。为此,它提供了按目标平台组织的预设,并通过往返测试验证各预设能够保持尺度,并且不出现骨架 100 倍缩放问题。

主要能力

  • 预设:roblox、roblox_gltf、unity、unity_skeletal、unreal、unreal_skeletal、godot、web、gltf、usd。
  • 单命令导出:通过 scripts/export_asset.py 配合 --preset、--objects、--out 等参数执行;可用 --set key=value 传入任意导出器参数;支持 --batch,以便对多个对象分别输出单个文件到原点。
  • 引擎参考文档:references/roblox.md(MeshParts、R15 角色身体、配件、分层服装 cage、SurfaceAppearance、限制)、references/unity.md(FBX 设置、Humanoid 骨架、URP/HDRP 贴图、动画剪辑)、references/unreal.md(静态与骨骼 FBX、根骨骼、UCX 碰撞、LOD、Nanite、ORM/DirectX)、references/godot-web.md(glTF/GLB、导入后缀、three.js/Babylon、压缩、KHR 扩展)。官方建议每次只加载需要的那一份。
  • 通用预导出清单:场景单位比例 1.0、对象缩放为 1、应用旋转(预设负责单位换算);道具原点位于底部中心,角色原点位于双脚之间的世界原点并朝向 -Y(Blender 前向),预设负责转换为引擎前向;导出求值后的网格(保留镜像、倒角、加权法线,布尔运算转为真实几何体);保留自定义和加权法线,以及平滑着色与标记为锐边的硬边;FBX 预设执行三角化(use_triangles),glTF 始终三角化;材质限定为“图像纹理到 Principled”的链式结构,命名 M_* 和 T_*,程序化节点需要先行烘焙;骨架只保留形变骨骼、不带叶骨骼、静止姿态等于绑定姿态、每顶点最多 4 个权重、根骨骼置于原点;每个剪辑一个动作,命名为 Rig_Clip,约束和 IK 需要烘焙为关键帧(见 blender-animation);命名使用唯一 ASCII 字符且不含空格。

格式选择建议(据资料) Unity、Unreal(骨骼最稳定)用 FBX;Godot、Web、Roblox(受支持)、Unreal 5.x Interchange、Blender 之间用 glTF 2.0(.glb);影视/VFX、Omniverse、Apple AR(.usdz)、布局交换用 USD;打印/CAD 的静态几何用 OBJ/STL(wm.obj_export、wm.stl_export);点缓存/变形模拟用 Alembic(wm.alembic_export)。

校验要求 脚本返回 ok、文件大小;对 .glb 还会返回解析摘要(网格、材质、图像、动画、蒙皮、三角面数、扩展),需要与预期比对。对 FBX/USD,需重新导入空场景(import_scene.fbx / wm.usd_import),核对尺寸、骨架缩放(应为 1 而非 100)和动作数量。在引擎中还需对照参考尺寸(UE 人体模型 180 cm、Unity 胶囊 2 m、Roblox 角色 5 studs),检查法线与平滑、法线贴图绿通道和动画根运动。

批量重导出 在 Blender 4.2+ 中,collection.exporters 会为每个集合保存格式和设置,bpy.ops.wm.collection_export_all() 可一键全部重导出(详见 blender-scene-setup)。

限制与注意事项 FBX 的 use_tspace 在多边形(n-gon)上会静默失败,需要先三角化(预设已处理);bake_space_transform(Apply Transform)是实验性选项,仅用于 Unity 静态网格,绝不可与骨架同用;glTF 只导出通过槽位/NLA 关联的动作,没有在骨架上挂用户(user)的动作会被跳过(export_animation_mode 可选 ACTIONS、ACTIVE_ACTIONS、NLA_TRACKS、SCENE、BROADCAST);glTF 需 PNG/JPEG/WebP 图像纹理,EXR/TIFF 会被转换(export_image_format);Blender 5.3 的 glTF 中,export_image_add_webp/export_image_webp_fallback 改为 export_image_add_compressed_images + export_compressed_images_type(WEBP/KTX2)+ export_compressed_images_fallback,at_collection_center 改为 collection_center_mode,并支持点云导出(export_pointclouds);链接库数据可以导出,但修改前需要本地化或覆盖;形态键在 FBX 中为 blendshape、在 glTF 中为 morph target(export_morph),骨骼修改器之前的修改器可能阻止 FBX 形态键导出,需要先应用。