SuperAPI AI 工具集

godot-builder

编程与开发

查看项目

更新于 10-15 23:24

技能介绍

用途:godot-builder 是用于 Godot 4.7-stable CLI 的程序化游戏开发与无头自动化技能,覆盖资产导入、场景构建、关卡优化与 CI/CD 导出。可通过环境变量 GODOT_PATH、GODOT_CONSOLE_PATH 覆盖路径。

主要能力:提供三条专家工作流。其一为硬化 3D 资产管线,顺序为 gltf_processor.py → collision_generator.py → save_scene.py → 最后执行 godot -e --headless --import;节点必须显式设置 owner,否则序列化时会被丢弃。其二为程序化关卡优化与 4.4+ 缩放假制,顺序为 csg_optimizer.py → duplicate_deep(Resource.DEEP_DUPLICATE_ALL) → navmesh_baker.py,CSG 需先烘焙为静态几何再烘焙 NavMesh。其三为生产 CI/CD 与强制导入校验,顺序为 rm -rf .godot/imported → test_runner.py → profile_generator.py → ci_exporter.py,通过 XDG 变量隔离并行实例。另有按需加载脚本集,如 tilemap_generator.py、ui_assembler.py、orphan_asset_scanner.gd、ci_export_prepper.gd、update_project_uids.py 等。

必要用法与限制:无头脚本结尾必须调用 quit(),否则 CI 会挂起;GPU 调用必须留在主线程,可用 RenderingServer.call_on_render_thread();并行运行需覆盖 XDG_DATA_HOME 与 XDG_CONFIG_HOME。明确禁止的行为包括:无头模式不序列化 UID,需事后运行 godot -e --headless --import;Godot 4.4+ 不得使用 Resource.duplicate(true);不得硬编码 .tscn/.tres 扩展名;专用服务器构建不得启用 Shader Baker;调用 ResourceUID.set_id() 前必须先用 has_id()。参考资料未提供具体版本兼容范围与安装命令细节,相关细节暂未提供。