SuperAPI AI 工具集

godot-export

编程与开发

查看项目

更新于 10-31 12:24

技能介绍

Godot Export 是用于将 Blender 资产导出到 Godot 4 的技能模块,核心目标是让网格、材质与动画以干净、可预测的方式进入 Godot 4.x 项目。资料建议优先使用 GLTF/GLB 格式,保持节点结构简单,并使用 Godot 友好的材质与动画设置。

主要用途与适用场景:把网格或动画交付到 Godot 4.x;导出单文件 GLB 道具与角色;为模型附带简单碰撞体;解决资产导入后显示灰色、动画片段被合并或需要导入碰撞等问题。使用前要求资产优化已通过,应用变换,层级对 Y-up 友好,材质符合 metallic-roughness 规范。

格式与设置:默认选择 GLB;需要可编辑的旁挂纹理时使用 GLTF separate。设置包括格式为 GLB、Y Up、在确定为最终版本时应用修改器、按需包含动画。层级方面,建议使用以场景根命名的根空物体或对象,避免深层无用的空物体;注意不要与 Godot 的导入后缀命名冲突(-col、-colonly、-convcolonly),Godot 会忽略 COL_ / UCX_ 名称。材质方面,Principled BSDF 转换为 GLTF PBR,打包图像或保持相对路径一致,仅在需要处使用自发光。动画方面,NLA 或动作会作为片段导出,动作命名建议为 AN_[Clip],如使用根运动需记录说明。

使用方式:技能附带经过测试的脚本 scripts/export_godot.py,实现 Godot 4 glTF(.glb)导出,并检查 Godot 导入提示命名。Godot 在导入时读取节点名后缀:-col(trimesh 静态体)、-convcolonly / -colonly(仅碰撞)、-rigid、-navmesh、-noimp,脚本会报告存在哪些提示。脚本可在 Blender 5.2 LTS 上通过官方 Blender MCP 用 execute_blender_code 运行,或采用 headless 方式;运行前需阅读脚本头部了解各参数。若用户自行在 Blender 中粘贴代码,应提供指向已安装脚本绝对路径的简短 runpy 调用及 ARGS,不要内联或改写脚本。调用示例:import runpy; result = runpy.run_path("<skill_dir>/scripts/export_godot.py", init_globals={"ARGS": {...}})["result"],ARGS 包含 objects、out_path、animation。导出仅使用活动场景,并会回读文件;导出后检查 verify.ok,处理缺失与泄漏列表不匹配;verify.checked 为 false 表示 NOT_CHECKED,不能视为通过。

验证与参考:导入 Godot 后需验证缩放、材质导入、动画库和碰撞形状。资料还提到可将 Godot 世界截图(通过 Godot MCP 捕获,不属本插件)与参考文件夹比对,使用 blender-mcp-workflow 技能的 ref_board 与 compare_to_refs 脚本进行评分,循环与漂移修正见该技能的 reference-folder-workflow 参考。

约束:应优先使用 GLB(除非项目另有规定),至少测试导入一次,命名与 naming-conventions.md 保持一致。不得为 Blender 5.2 之前的版本编写代码或片段,也不要添加版本回退分支,因为该插件面向 5.2+,旧分支会教用户使用已不存在的 API;同时不要依赖无法导出的 Blender 专用着色器节点。