拓冰网站定制 
MCP for Unity 实战Blender→Unity 桥接保真度测试报告 —— FBX 与 GLBglTFast传输矩阵对比【免费下载链接】unity-mcpUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.项目地址: https://gitcode.com/GitHub_Trending/un/unity-mcp本文基于 unity-mcp 仓库中.claude/skills/blender-to-unity/references/bridge-fidelity.md的实测结果整理而成并结合import_model_file工具源码与 Blender→Unity 交接技能 做纵深补充。当 AI Agent 同时连接 BlenderMCP 与 MCP for Unity需要把 Blender 中的模型搬进 Unity 场景时格式选型FBX 还是 GLB直接决定纹理、透明、金属度、自发光、动画能否无损抵达。读完本文你将掌握一份逐特性验证过的格式保真度矩阵、7 个必须自动化规避的坑、节点材质烘焙恢复配方以及 MCP for Unity 中import_model_file的完整参数语义与源码级实现原理。Blender→Unity 的桥本质上是一个文件导出/导入接缝Blender 侧写出 FBX/glTF 文件Unity 侧读取并导入两个服务器从不直接通信。因此保真度 交换格式 Unity 导入器支持能力的总和——这不是 BlenderMCP 的局限而是格式本身的特性差异。本文的所有结论都来自受控实验而非推测。一、测试环境与方法测试在以下环境中进行BlenderBlenderMCP→Unity 6000.4.11f1URP 渲染管线glTFast 已安装MCP for Unity 的可选依赖FBX走 Unity 内置的 Model ImporterGLB走 glTFast方法每个特性用一个受控对象双向导出export_scene.fbx与export_scene.gltf的 GLB 变体分别导入逐一检查得到的网格mesh/材质material/动画animation资源一个关键前提是GLB 导入依赖 glTFast 包。从 ModelImportPipeline.cs 可以看到Unity 侧通过反射探测GLTFast.GltfImport类型来判断 glTFast 是否可用未安装时会直接失败并提示GLB import requires glTFast. Install it from the MCP for Unity → Dependencies tab, or choose FBX output.。FBX 是默认选项的原因就在于此——glTFast 在 MCP for Unity 中是可选项。二、保真度测试矩阵FBX vs GLBglTFast下表是逐特性探针probe的实测结果每个特性用一个受控对象导出、导入、检查探针ProbeFBXGLBglTFast网格几何顶点、法线、UV✅✅对象层级 变换✅✅基础 / 漫反射颜色✅✅数值发生 sRGB↔linear 偏移例如0.20→0.48视觉正确程序化 / 节点材质noise→color❌ → 变为默认灰色❌ → 变为默认白色——但先烘焙成纹理见下文→ ✅ 完好抵达图像纹理base color 上的 checker❌ 已嵌入但未赋给_BaseMap✅baseColorTexture 嵌入图片顶点色——数据✅mesh.colors存在✅ 存在顶点色——显示❌ URP Lit 忽略顶点色✅ glTFast 着色器可显示已确认白色底网格渲染出了顶点色Alpha / 透明度❌ 保持Opaquealpha 留在颜色里表面未切换rq 2000✅TransparentSurface1rq 3000金属度 / 粗糙度❌ URP 转换时金属度被重置为 0✅metal1.0rough0.15修改器未应用的 Subsurf✅ 导出时已烘焙8→384 顶点✅ 已烘焙8→384 顶点动画对象变换⚠️ 数据在文件里但导入器默认animationTypeNone→ 0 个 clip传入animation_typegeneric→ 1 个 clip✅ 自动导入1 个 clip骨骼Armature 蒙皮✅ 蒙皮网格3 个绑定姿势✅ 蒙皮网格3 个绑定姿势骨骼动画✅需传animation_typegeneric/humanoid✅ 自动Animator clip多材质分区submeshes✅ submeshes 各一个材质✅ submeshes 各一个材质base color 原生保留形变键 → Blend Shape✅Bulge、Spike✅Bulge、Spike自定义属性➖ FBX 用户属性默认不暴露➖ glTFextras需export_extras不会自动暴露自发光Emission来自城市场景❌ 丢失✅ 原生emissiveFactorKHR_materials_emissive_strength缩放Scale过大需要归一化过大比 FBX 更大需要归一化图例✅ 成功传输 · ❌ 丢失 · ⚠️ 需要一项导入设置 · ➖ 部分 / 依赖着色器。矩阵要点解读几何与层级是底线能力无论 FBX 还是 GLB顶点/法线/UV、对象层级、变换、修改器烘焙、多材质分区、形变键都能无损抵达——这些属于两种格式都能做对的部分。PBR 材质通道是分水岭金属度/粗糙度、自发光、透明度在 FBX 的内置导入器 → URP 材质转换链路中会丢失金属度归零、保持 Opaque、emission 被丢弃而 glTF 的 PBR 模型metal/rough、emissiveFactorKHR_materials_emissive_strength、Surface1的透明模式让这些通道原生自动抵达。顶点色数据能到、显示不能两种格式都携带顶点色数据FBX 的mesh.colors存在但 URP Lit 默认不消费它需要一个能读取顶点色的着色器才能显示。程序化/节点材质两边都不行node graph节点图不属于交换格式的传输范围必须先在 Blender 中烘焙成图像纹理。三、结论这条管线里 GLBglTFast保真度显著更高实测判定的结论非常明确对这条管线而言GLB via glTFast 的保真度实质性高于 FBX纹理、透明度、金属度/粗糙度、自发光、动画全部自动传输。FBX 只在几何、顶点色数据、修改器烘焙上打平并且仅在以下场景胜出需要内置导入器的骨骼/人形Humanoid管线或想要 URP-Lit 原生材质例如配合 URP 的雾效。换而言之GLB 赢了内容量——PBR 材质体系、动画、透明度是多数 DCC 交接的核心诉求glTFast 一条链路全部自动处理无需任何后处理。FBX 赢了特定管线——Unity 内置导入器的 Humanoid Avatar 系统、URP-Lit 原生材质这些生态能力目前只有 FBX 能接入。同时两种格式存在两个共同的盲区程序化/节点材质必须在 Blender 里先烘焙成图像纹理顶点色都需要能读取顶点色的着色器才能显示。四、发现的坑值得自动化规避的 7 个 Gotcha这一节来自实际探索每一条都是踩过的坑值得在技能skill或自动化流程里显式规避export_scene.gltf默认use_active_sceneFalse。它可能导出错误的场景另一个打开的场景——实测导出了 4.7 MB 而非 65 KB。务必始终传use_active_sceneTrue。FBXembed_texturesTrue只嵌入、不赋值。图片确实进了 FBX但 Unity 的 URP 材质转换后_BaseMap仍是空的。要么把材质/纹理抽取出来手动赋值要么干脆用 GLB。FBX 动画需要非None的骨骼模式。clip 数据在文件里但导入器默认animationType None会产出零个 clip。import_model_file支持在导入时传animation_typegeneric | humanoid | legacy来设置此前只能事后手改ModelImporter——正是这个坑促成了该参数。GLB 不受影响——glTFast 自己导入动画。FBX 在内置→URP 材质转换时丢掉金属度和自发光GLB 两者都保留。两种格式都需要缩放归一化测量世界包围盒 → 设置localScaleGLB 通常比 FBX 落地时更大。骨骼 形变需要不应用no-apply导出。对蒙皮 / 形变键网格跳过bake_space_transformFBX和export_applyglTF——应用修改器会把骨骼形变和 morph target 一并烘焙掉。应使用use_mesh_modifiersFalseFBX/export_applyFalseglTF。静态几何导出则仍然需要 apply它负责烘焙 Subsurf 等。导入的动画不会自动播放。clip 导入正常但放入场景的模型只有带null controller的Animator编辑模式下看起来是冻结的。要看到它为 clip 创建一个AnimatorController并设置 clip 的loopTime以循环播放然后进入Play 模式或通过 Animation 窗口 / Timeline / 旧版Animation驱动。这是 Unity 的播放细节而非传输失败——实测播放中骨骼从 37° 旋转到 6°并循环了 15 次。其中第 3 条是理解import_model_file参数的关键。在 Python 工具定义 import_model_file.py 中animation_type是Literal[none, generic, humanoid, legacy]的联合类型Unity 侧 ParseAnimationType 把它映射为ModelImporterAnimationTypegeneric→Generic、humanoid及别名human→Human、legacy→Legacy未传或none→None即不导入骨骼rigged FBX 导入零 clip 的常见原因就在这里。GLB/glTF 会忽略该参数——glTFast 自己完成动画导入。五、恢复程序化 / 节点材质Blender 烘焙配方两种格式都不携带节点图但可以在 Blender 里把节点材质烘焙成图像纹理之后它就能作为普通纹理导出。实测验证一个Voronoi → ColorRamp材质烘焙到 512px抵达 Unity 后baseColorTexture已赋值、图案可见。烘焙配方Cycles 烘焙给对象做一次真实的 UV 展开——bpy.ops.uv.smart_project(...)。在材质里新增一个空的 Image Image Texture 节点并把它设为激活节点作为烘焙目标nt.nodes.active texnode。scene.render.engineCYCLES把对象设为活动对象然后执行bpy.ops.object.bake(typeDIFFUSE, pass_filter{COLOR}, margin4, use_clearTrue)。把烘焙好的纹理节点重新接入Base Color替换掉程序化链路image.pack()。照常导出 GLB 即可。发光驱动的外观烘焙EMIT要把完整光照烘焙进去则用COMBINED。这与技能文档中的决策逻辑一致SKILL.md 明确指出任何程序化 / 模拟内容节点材质、几何节点、粒子、物理都先在 Blender 烘焙——烘焙到纹理、应用/实体化修改器、把粒子转成网格。六、一次导出捕获更多通道GLB 导出参数在export_scene.gltf(..., export_formatGLB, use_active_sceneTrue, ...)中按需开启额外通道export_applyTrue—— 烘焙修改器Subsurf 等——仅限静态几何蒙皮 / 形变键网格需要export_applyFalse否则骨骼形变和 morph target 会被烘焙掉见坑 6export_animationsTrue——激活的或 NLA-stashed的动作 → clips未关联的动作会被丢弃先把动作 Stash / Push Down 到它动画的对象上export_morphTrue——形变键 → Unity blend shapesexport_skinsTrue——骨骼 / 蒙皮export_tangentsTrue—— 支持法线贴图的网格export_extrasTrue—— Blender自定义属性export_camerasTrue、export_lightsTrue—— 相机/灯光会随模型过来单位不同——只作参考需在 Unity 里重新调参七、实践决策规则把上面的矩阵、结论和坑压缩成可执行的选型规则材质 / 纹理 / PBR / 自发光 / 动画是关键诉求 → 选 GLB需安装 glTFast。骨骼 / Humanoid / URP-Lit 原生材质是关键诉求 → 选 FBX然后抽取材质、设置动画类型。任何程序化 / 模拟内容节点材质、几何节点、粒子、物理→ 先在 Blender 烘焙烘焙成纹理、应用/实体化修改器、粒子转网格。整套交接流程从选型到落地在 SKILL.md 中有完整实现确定 Unity 项目路径 → 按上述规则决定 FBX/GLB → 从 Blender 导出到临时目录 → 用import_model_file导入 → 用manage_gameobject实例化并做测包围盒→设localScale的确定性归一化 → FBX 路径恢复 emission →manage_camera截图验证。对应的验收清单见 manual-verify.md。八、源码级佐证import_model_file如何实现这次交接import_model_file是 MCP for Unity 中承接这次文件交接的工具归属于asset_gen工具组——该组默认关闭默认只加载core需要先用manage_tools启用或通过batch_execute以 camelCase 直调 C# 处理器{tool:import_model_file,params:{sourcePath:...,name:...,outputFolder:...}}按名称分发、不受工具组门控。完整参数与语义参数类型必需说明source_pathstr是磁盘上的模型文件路径.fbx/.obj/.glb/.gltf/.zip支持绝对路径或Assets/相对路径namestr \| None—导入资源的基名缺省取源文件名output_folderstr \| None—Assets/下的目标文件夹target_sizefloat \| None—把最大维度归一化到该尺寸米animation_typenone/generic/humanoid/legacy—仅 FBX/OBJ骨骼/动画导入模式见坑 3GLB 忽略返回{ asset_path, asset_guid }。从源码看实现链路Python 侧是纯透传import_model_file.py 的 docstring 明确写着 Thin pass-through: NO API keys and NO file bytes cross the bridge所有参数经send_with_unity_instance转发给 Unity 的import_model_file命令。C# 处理器ImportModelFile.cs 负责校验扩展名仅.fbx/.obj/.glb/.gltf/.zip、把源文件复制到Assets/下默认输出根为AssetGenPrefs.OutputRoot /Imported命名冲突自动追加_1、_2…、再交给共享的模型导入管线。target_size默认1f。共享导入管线ModelImportPipeline.cs 对非 glTF 资源调用ApplyModelImporterSettings设置useFileScaletrue、materialImportModeImportStandard、按上文映射animationType仅当AssetGenPrefs.AutoNormalize开启且TargetSize0时才计算网格最大维度并改写globalScale做导入级归一化。AutoNormalize偏好默认开启见 AssetGenPrefs.csDefaultOutputRoot为Assets/Generated。多文件导出的处理裸.gltf外部.bin或.obj兄弟.mtl/纹理只会被复制单个文件而丢失 sidecar——文档与源码都要求先打成.zip再传。zip 解包走 SafeZipExtractor只允许模型与纹理类扩展名落盘脚本/程序集一律跳过防止不可信存档编译进编辑器。与保真度报告的呼应target_size在这条 Blender→Unity 管线中只是提示而非保证它仅在 Auto-normalize 偏好开启时于导入阶段缩放且对 Blender FBX 的导入级归一化不可靠实测target_size2的模型落地 200 米可能过度或不足。因此 SKILL.md 中可靠的归一化方案是实例化后测量世界包围盒再按localScale * target / maxDim修正——这套测包围盒→设localScale的例程无论导入比例如何都能确定性命中目标尺寸恰好对应保真度矩阵中缩放需要归一化的最后一行探针。同样矩阵中FBX 丢 emission的结论直接对应技能第 5 步用execute_blender_code从 Blender 倾倒 emissive 材质兼容 4.x 的Emission Color与 3.x 的Emission输入名再在 Unity 侧用execute_code抽取 FBX 材质、按大小写不敏感的名字匹配FBX 会破坏大小写甚至把EdgeCyan拆成EdgeCyanEDGE_CYAN两个变体设置_EmissionColor、EnableKeyword(_EMISSION)、globalIlluminationFlagsRealtimeEmissive并加全局 Bloom 与renderPostProcessing让发光真正亮起来。而 GLB 路径完全不需要这一步——emissiveFactorKHR_materials_emissive_strength原生保留。结语Blender→Unity 的桥接保真度完全由交换格式与导入器决定。这份实测矩阵给出了清晰的分工内容密度纹理/PBR/自发光/动画/透明交给 GLB glTFast管线生态Humanoid/URP-Lit 原生材质交给 FBX程序化内容统一先烘焙、缩放统一后处理。配合 MCP for Unity 的import_model_file参数尤其animation_type与target_size的边界以及技能文档中的全套落地例程AI Agent 可以把这次文件级交接做成确定性、可验收的自动化流程。【免费下载链接】unity-mcpUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.项目地址: https://gitcode.com/GitHub_Trending/un/unity-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 MCP for Unity 实战：Blender→Unity 桥接保真度测试报告 —— FBX 与 GLB（glTFast）传输矩阵对比
MCP for Unity 实战Blender→Unity 桥接保真度测试报告 —— FBX 与 GLBglTFast传输矩阵对比【免费下载链接】unity-mcpUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.项目地址: https://gitcode.com/GitHub_Trending/un/unity-mcp本文基于 unity-mcp 仓库中.claude/skills/blender-to-unity/references/bridge-fidelity.md的实测结果整理而成并结合import_model_file工具源码与 Blender→Unity 交接技能 做纵深补充。当 AI Agent 同时连接 BlenderMCP 与 MCP for Unity需要把 Blender 中的模型搬进 Unity 场景时格式选型FBX 还是 GLB直接决定纹理、透明、金属度、自发光、动画能否无损抵达。读完本文你将掌握一份逐特性验证过的格式保真度矩阵、7 个必须自动化规避的坑、节点材质烘焙恢复配方以及 MCP for Unity 中import_model_file的完整参数语义与源码级实现原理。Blender→Unity 的桥本质上是一个文件导出/导入接缝Blender 侧写出 FBX/glTF 文件Unity 侧读取并导入两个服务器从不直接通信。因此保真度 交换格式 Unity 导入器支持能力的总和——这不是 BlenderMCP 的局限而是格式本身的特性差异。本文的所有结论都来自受控实验而非推测。一、测试环境与方法测试在以下环境中进行BlenderBlenderMCP→Unity 6000.4.11f1URP 渲染管线glTFast 已安装MCP for Unity 的可选依赖FBX走 Unity 内置的 Model ImporterGLB走 glTFast方法每个特性用一个受控对象双向导出export_scene.fbx与export_scene.gltf的 GLB 变体分别导入逐一检查得到的网格mesh/材质material/动画animation资源一个关键前提是GLB 导入依赖 glTFast 包。从 ModelImportPipeline.cs 可以看到Unity 侧通过反射探测GLTFast.GltfImport类型来判断 glTFast 是否可用未安装时会直接失败并提示GLB import requires glTFast. Install it from the MCP for Unity → Dependencies tab, or choose FBX output.。FBX 是默认选项的原因就在于此——glTFast 在 MCP for Unity 中是可选项。二、保真度测试矩阵FBX vs GLBglTFast下表是逐特性探针probe的实测结果每个特性用一个受控对象导出、导入、检查探针ProbeFBXGLBglTFast网格几何顶点、法线、UV✅✅对象层级 变换✅✅基础 / 漫反射颜色✅✅数值发生 sRGB↔linear 偏移例如0.20→0.48视觉正确程序化 / 节点材质noise→color❌ → 变为默认灰色❌ → 变为默认白色——但先烘焙成纹理见下文→ ✅ 完好抵达图像纹理base color 上的 checker❌ 已嵌入但未赋给_BaseMap✅baseColorTexture 嵌入图片顶点色——数据✅mesh.colors存在✅ 存在顶点色——显示❌ URP Lit 忽略顶点色✅ glTFast 着色器可显示已确认白色底网格渲染出了顶点色Alpha / 透明度❌ 保持Opaquealpha 留在颜色里表面未切换rq 2000✅TransparentSurface1rq 3000金属度 / 粗糙度❌ URP 转换时金属度被重置为 0✅metal1.0rough0.15修改器未应用的 Subsurf✅ 导出时已烘焙8→384 顶点✅ 已烘焙8→384 顶点动画对象变换⚠️ 数据在文件里但导入器默认animationTypeNone→ 0 个 clip传入animation_typegeneric→ 1 个 clip✅ 自动导入1 个 clip骨骼Armature 蒙皮✅ 蒙皮网格3 个绑定姿势✅ 蒙皮网格3 个绑定姿势骨骼动画✅需传animation_typegeneric/humanoid✅ 自动Animator clip多材质分区submeshes✅ submeshes 各一个材质✅ submeshes 各一个材质base color 原生保留形变键 → Blend Shape✅Bulge、Spike✅Bulge、Spike自定义属性➖ FBX 用户属性默认不暴露➖ glTFextras需export_extras不会自动暴露自发光Emission来自城市场景❌ 丢失✅ 原生emissiveFactorKHR_materials_emissive_strength缩放Scale过大需要归一化过大比 FBX 更大需要归一化图例✅ 成功传输 · ❌ 丢失 · ⚠️ 需要一项导入设置 · ➖ 部分 / 依赖着色器。矩阵要点解读几何与层级是底线能力无论 FBX 还是 GLB顶点/法线/UV、对象层级、变换、修改器烘焙、多材质分区、形变键都能无损抵达——这些属于两种格式都能做对的部分。PBR 材质通道是分水岭金属度/粗糙度、自发光、透明度在 FBX 的内置导入器 → URP 材质转换链路中会丢失金属度归零、保持 Opaque、emission 被丢弃而 glTF 的 PBR 模型metal/rough、emissiveFactorKHR_materials_emissive_strength、Surface1的透明模式让这些通道原生自动抵达。顶点色数据能到、显示不能两种格式都携带顶点色数据FBX 的mesh.colors存在但 URP Lit 默认不消费它需要一个能读取顶点色的着色器才能显示。程序化/节点材质两边都不行node graph节点图不属于交换格式的传输范围必须先在 Blender 中烘焙成图像纹理。三、结论这条管线里 GLBglTFast保真度显著更高实测判定的结论非常明确对这条管线而言GLB via glTFast 的保真度实质性高于 FBX纹理、透明度、金属度/粗糙度、自发光、动画全部自动传输。FBX 只在几何、顶点色数据、修改器烘焙上打平并且仅在以下场景胜出需要内置导入器的骨骼/人形Humanoid管线或想要 URP-Lit 原生材质例如配合 URP 的雾效。换而言之GLB 赢了内容量——PBR 材质体系、动画、透明度是多数 DCC 交接的核心诉求glTFast 一条链路全部自动处理无需任何后处理。FBX 赢了特定管线——Unity 内置导入器的 Humanoid Avatar 系统、URP-Lit 原生材质这些生态能力目前只有 FBX 能接入。同时两种格式存在两个共同的盲区程序化/节点材质必须在 Blender 里先烘焙成图像纹理顶点色都需要能读取顶点色的着色器才能显示。四、发现的坑值得自动化规避的 7 个 Gotcha这一节来自实际探索每一条都是踩过的坑值得在技能skill或自动化流程里显式规避export_scene.gltf默认use_active_sceneFalse。它可能导出错误的场景另一个打开的场景——实测导出了 4.7 MB 而非 65 KB。务必始终传use_active_sceneTrue。FBXembed_texturesTrue只嵌入、不赋值。图片确实进了 FBX但 Unity 的 URP 材质转换后_BaseMap仍是空的。要么把材质/纹理抽取出来手动赋值要么干脆用 GLB。FBX 动画需要非None的骨骼模式。clip 数据在文件里但导入器默认animationType None会产出零个 clip。import_model_file支持在导入时传animation_typegeneric | humanoid | legacy来设置此前只能事后手改ModelImporter——正是这个坑促成了该参数。GLB 不受影响——glTFast 自己导入动画。FBX 在内置→URP 材质转换时丢掉金属度和自发光GLB 两者都保留。两种格式都需要缩放归一化测量世界包围盒 → 设置localScaleGLB 通常比 FBX 落地时更大。骨骼 形变需要不应用no-apply导出。对蒙皮 / 形变键网格跳过bake_space_transformFBX和export_applyglTF——应用修改器会把骨骼形变和 morph target 一并烘焙掉。应使用use_mesh_modifiersFalseFBX/export_applyFalseglTF。静态几何导出则仍然需要 apply它负责烘焙 Subsurf 等。导入的动画不会自动播放。clip 导入正常但放入场景的模型只有带null controller的Animator编辑模式下看起来是冻结的。要看到它为 clip 创建一个AnimatorController并设置 clip 的loopTime以循环播放然后进入Play 模式或通过 Animation 窗口 / Timeline / 旧版Animation驱动。这是 Unity 的播放细节而非传输失败——实测播放中骨骼从 37° 旋转到 6°并循环了 15 次。其中第 3 条是理解import_model_file参数的关键。在 Python 工具定义 import_model_file.py 中animation_type是Literal[none, generic, humanoid, legacy]的联合类型Unity 侧 ParseAnimationType 把它映射为ModelImporterAnimationTypegeneric→Generic、humanoid及别名human→Human、legacy→Legacy未传或none→None即不导入骨骼rigged FBX 导入零 clip 的常见原因就在这里。GLB/glTF 会忽略该参数——glTFast 自己完成动画导入。五、恢复程序化 / 节点材质Blender 烘焙配方两种格式都不携带节点图但可以在 Blender 里把节点材质烘焙成图像纹理之后它就能作为普通纹理导出。实测验证一个Voronoi → ColorRamp材质烘焙到 512px抵达 Unity 后baseColorTexture已赋值、图案可见。烘焙配方Cycles 烘焙给对象做一次真实的 UV 展开——bpy.ops.uv.smart_project(...)。在材质里新增一个空的 Image Image Texture 节点并把它设为激活节点作为烘焙目标nt.nodes.active texnode。scene.render.engineCYCLES把对象设为活动对象然后执行bpy.ops.object.bake(typeDIFFUSE, pass_filter{COLOR}, margin4, use_clearTrue)。把烘焙好的纹理节点重新接入Base Color替换掉程序化链路image.pack()。照常导出 GLB 即可。发光驱动的外观烘焙EMIT要把完整光照烘焙进去则用COMBINED。这与技能文档中的决策逻辑一致SKILL.md 明确指出任何程序化 / 模拟内容节点材质、几何节点、粒子、物理都先在 Blender 烘焙——烘焙到纹理、应用/实体化修改器、把粒子转成网格。六、一次导出捕获更多通道GLB 导出参数在export_scene.gltf(..., export_formatGLB, use_active_sceneTrue, ...)中按需开启额外通道export_applyTrue—— 烘焙修改器Subsurf 等——仅限静态几何蒙皮 / 形变键网格需要export_applyFalse否则骨骼形变和 morph target 会被烘焙掉见坑 6export_animationsTrue——激活的或 NLA-stashed的动作 → clips未关联的动作会被丢弃先把动作 Stash / Push Down 到它动画的对象上export_morphTrue——形变键 → Unity blend shapesexport_skinsTrue——骨骼 / 蒙皮export_tangentsTrue—— 支持法线贴图的网格export_extrasTrue—— Blender自定义属性export_camerasTrue、export_lightsTrue—— 相机/灯光会随模型过来单位不同——只作参考需在 Unity 里重新调参七、实践决策规则把上面的矩阵、结论和坑压缩成可执行的选型规则材质 / 纹理 / PBR / 自发光 / 动画是关键诉求 → 选 GLB需安装 glTFast。骨骼 / Humanoid / URP-Lit 原生材质是关键诉求 → 选 FBX然后抽取材质、设置动画类型。任何程序化 / 模拟内容节点材质、几何节点、粒子、物理→ 先在 Blender 烘焙烘焙成纹理、应用/实体化修改器、粒子转网格。整套交接流程从选型到落地在 SKILL.md 中有完整实现确定 Unity 项目路径 → 按上述规则决定 FBX/GLB → 从 Blender 导出到临时目录 → 用import_model_file导入 → 用manage_gameobject实例化并做测包围盒→设localScale的确定性归一化 → FBX 路径恢复 emission →manage_camera截图验证。对应的验收清单见 manual-verify.md。八、源码级佐证import_model_file如何实现这次交接import_model_file是 MCP for Unity 中承接这次文件交接的工具归属于asset_gen工具组——该组默认关闭默认只加载core需要先用manage_tools启用或通过batch_execute以 camelCase 直调 C# 处理器{tool:import_model_file,params:{sourcePath:...,name:...,outputFolder:...}}按名称分发、不受工具组门控。完整参数与语义参数类型必需说明source_pathstr是磁盘上的模型文件路径.fbx/.obj/.glb/.gltf/.zip支持绝对路径或Assets/相对路径namestr \| None—导入资源的基名缺省取源文件名output_folderstr \| None—Assets/下的目标文件夹target_sizefloat \| None—把最大维度归一化到该尺寸米animation_typenone/generic/humanoid/legacy—仅 FBX/OBJ骨骼/动画导入模式见坑 3GLB 忽略返回{ asset_path, asset_guid }。从源码看实现链路Python 侧是纯透传import_model_file.py 的 docstring 明确写着 Thin pass-through: NO API keys and NO file bytes cross the bridge所有参数经send_with_unity_instance转发给 Unity 的import_model_file命令。C# 处理器ImportModelFile.cs 负责校验扩展名仅.fbx/.obj/.glb/.gltf/.zip、把源文件复制到Assets/下默认输出根为AssetGenPrefs.OutputRoot /Imported命名冲突自动追加_1、_2…、再交给共享的模型导入管线。target_size默认1f。共享导入管线ModelImportPipeline.cs 对非 glTF 资源调用ApplyModelImporterSettings设置useFileScaletrue、materialImportModeImportStandard、按上文映射animationType仅当AssetGenPrefs.AutoNormalize开启且TargetSize0时才计算网格最大维度并改写globalScale做导入级归一化。AutoNormalize偏好默认开启见 AssetGenPrefs.csDefaultOutputRoot为Assets/Generated。多文件导出的处理裸.gltf外部.bin或.obj兄弟.mtl/纹理只会被复制单个文件而丢失 sidecar——文档与源码都要求先打成.zip再传。zip 解包走 SafeZipExtractor只允许模型与纹理类扩展名落盘脚本/程序集一律跳过防止不可信存档编译进编辑器。与保真度报告的呼应target_size在这条 Blender→Unity 管线中只是提示而非保证它仅在 Auto-normalize 偏好开启时于导入阶段缩放且对 Blender FBX 的导入级归一化不可靠实测target_size2的模型落地 200 米可能过度或不足。因此 SKILL.md 中可靠的归一化方案是实例化后测量世界包围盒再按localScale * target / maxDim修正——这套测包围盒→设localScale的例程无论导入比例如何都能确定性命中目标尺寸恰好对应保真度矩阵中缩放需要归一化的最后一行探针。同样矩阵中FBX 丢 emission的结论直接对应技能第 5 步用execute_blender_code从 Blender 倾倒 emissive 材质兼容 4.x 的Emission Color与 3.x 的Emission输入名再在 Unity 侧用execute_code抽取 FBX 材质、按大小写不敏感的名字匹配FBX 会破坏大小写甚至把EdgeCyan拆成EdgeCyanEDGE_CYAN两个变体设置_EmissionColor、EnableKeyword(_EMISSION)、globalIlluminationFlagsRealtimeEmissive并加全局 Bloom 与renderPostProcessing让发光真正亮起来。而 GLB 路径完全不需要这一步——emissiveFactorKHR_materials_emissive_strength原生保留。结语Blender→Unity 的桥接保真度完全由交换格式与导入器决定。这份实测矩阵给出了清晰的分工内容密度纹理/PBR/自发光/动画/透明交给 GLB glTFast管线生态Humanoid/URP-Lit 原生材质交给 FBX程序化内容统一先烘焙、缩放统一后处理。配合 MCP for Unity 的import_model_file参数尤其animation_type与target_size的边界以及技能文档中的全套落地例程AI Agent 可以把这次文件级交接做成确定性、可验收的自动化流程。【免费下载链接】unity-mcpUnity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.项目地址: https://gitcode.com/GitHub_Trending/un/unity-mcp创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考