SuperAPI AI 工具集

unity-export

编程与开发

查看项目

更新于 10-31 12:23

技能介绍

用途

Unity Export 是 Blender AI 插件中的一项导出技能,用于把 Blender 资产整理并导出到 Unity。其说明聚焦于避免常见导入问题:模型在 Unity 中旋转 -90 度、缩放为 100 或显示白色(材质丢失),并覆盖 FBX 轴向、缩放、材质与类人骨架等已测试项。

主要能力

  • 提供 Unity 就绪的变换、材质、LOD 与碰撞处理指引。
  • 默认采用脚本化 FBX 导出(export_unity.py),Unity 可原生导入;GLB 方案需 Unity 的 glTFast 包。
  • 列出导出前预检:asset-optimization 通过;如需 LOD 先走 lod-pipeline;如需物理先走 collision-proxy;应用变换并修正枢轴。
  • 给出格式选择建议:静态、动画或类人角色用 FBX;项目使用 glTFast 的静态网格可用 GLB(通过 export-pipeline 技能的 export_asset.py,以 .glb 作为 out_path 选择 glTF、Y-up)。
  • 变换默认值:单位为米(Unity 1 单位 = 1 米),前向为 -Z(Blender),缩放因子 1.0,需在 Unity 中验证。
  • 材质建议:优先使用与 Unity 工作流匹配的单一材质槽;GLB 使用金属-粗糙度;纹理可内嵌或与 FBX 放在一起;材质统一以 MAT_ 命名。
  • 角色:按项目采用 T-pose 或 A-pose;根骨骼位于原点、髋部位置正确;类人骨架需命名清晰并测试 Avatar 映射;动画可按需导出为独立片段。
  • LOD 与碰撞:LOD 组命名如 SM_Name_LOD0..N 或使用 Unity LOD Group 网格;碰撞使用凸网格或由代理生成 Unity 原始碰撞体;若沿用 FBX 约定,可参考 collision-proxy 的 UCX 风格命名。
  • Unity 内验证清单:对照参考立方体检查缩放、枢轴与 Prefab 摆放、法线与切线、材质指派、LOD 过渡、Animator 片段(如有)。

使用方式

脚本经官方 Blender MCP 在 Blender 5.2 LTS 上测试。通过 execute_blender_code 运行(或无头方式,参见 blender-mcp-workflow 技能),运行前阅读脚本头部了解每个参数。当用户要自行把代码粘贴到 Blender 时,提供带本脚本绝对路径与 ARGS 的简短 runpy 调用,不要内联或改写脚本。

示例调用:

import runpy result = runpy.run_path("<skill_dir>/scripts/export_unity.py", init_globals={"ARGS": {...}})["result"]

ARGS 参数:objects、out_path、animation、strict。

scripts/export_unity.py 执行带预检的 Unity FBX 导出:应用变换、检查 UV 与材质槽、进行轴向/缩放转换,使资产以缩放 (1,1,1) 导入且无 -90 度 X 旋转(Apply Scalings = FBX Units Scale + Apply Transform)。

参考资料包括 references/unity-checklist.md 与 references/unity-materials.md,按需加载。

适用场景

  • 向 Unity 交付资产。
  • 导出类人角色。
  • 面向 Prefab 的网格拆分与 LOD。

限制与约束

必须做:导出前验证;记录所用的缩放因子;在宣布完成前至少测试一次导入。

不要做:为 Blender 5.2 之前的版本编写代码或片段,或添加版本回退——该插件面向 5.2+,旧分支会教用户已不存在的 API;不要在没有项目约定时假设 FBX 设置;不要在 Prefab 中保留未使用的高模 LOD。

GLB 依赖 Unity 的 glTFast 包;动画片段、碰撞代理等细节需按项目约定在 Unity 中验证。