用途
本技能用于检查与修改 Godot 项目,配合内置的工作流、脚本以及宿主环境可用的 Godot 原生自动化工具,完成游戏开发中的常见任务,包括玩法表现层工作,例如美术生成、帧动画集成,以及将提供或单独生成的音乐与剧情内容整合进项目。
主要能力
- 场景编辑:通过调度器(dispatcher)执行场景批量操作,支持创建场景、添加节点、实例化子场景、配置节点与 Control、挂载脚本、连接与断开信号、删除/重设父级/重排节点、加载精灵、构建 SpriteFrames、保存场景、导出 MeshLibrary、查询 UID、重存资源等。
- 架构设计与重构:按业务能力划分限界上下文,区分 Controller 边缘、Model 状态、System 可复用流程与 Utility 适配层,建议用显式命令处理写入、用查询处理复杂读取,并优先使用类型化信号或可观察状态。
- 美术、音乐与剧情集成:复用项目既有美术管线、调色板、精灵尺寸、字体、音频总线、对话系统与本地化格式;未指定风格且项目无既定方向时,新视觉内容默认采用像素风。
- 运行与调试:使用宿主原生运行工具或直接 CLI 启动项目,在运行中验证改动行为并检查日志中的错误与警告。
- 导出打包:读取 export_presets.cfg,复用既有预设名称与签名流程,通过封装脚本执行 CLI 导出。
使用方式
开始前先确认可用的 Godot 自动化路径,优先使用宿主代理中的原生或映射工具,仅在支持的文件与场景操作中使用内置无头调度器。需要宿主工具时,将 project_path 解析为绝对项目目录;直接使用内置脚本时,将场景与资源路径规范为 res://...。
便携 CLI 回退(适用于具备 shell 的环境,如未暴露专用 Godot 工具时):
godot --headless --path /absolute/path/to/project
--script /absolute/path/to/godot/scripts/core/dispatcher.gd
scene_batch '{"scene_path":"scenes/main.tscn","create_if_missing":true,"root_node_type":"Node2D","actions":[{"type":"add_node","node_type":"Camera2D","node_name":"Camera"}]}'
scene_batch 可替换为任意受支持操作:scene_batch、create_scene、add_node、instantiate_scene、configure_node、configure_control、attach_script、connect_signal、disconnect_signal、remove_node、reparent_node、reorder_node、load_sprite、build_sprite_frames、save_scene、export_mesh_library、get_uid、resave_resources。参数以单个 JSON 对象传入,字段名使用内置 GDScript 期望的 snake_case。调度器不用于运行时生命周期或项目导出操作,它不实现 run_project、get_debug_output、stop_project 或平台构建/导出命令。
项目导出封装:
python3 /absolute/path/to/godot/scripts/export/export_project.py
/absolute/path/to/project
"Windows Desktop"
/absolute/path/to/build/windows/game.exe
封装脚本会解析绝对路径、创建输出目录,并调用 godot --headless --path ... --export-release ...。可用 --mode debug 做冒烟构建,仅在用户明确要求 .pck 风格导出时使用 --mode pack。平台支持来自 export_presets.cfg 中已定义的预设名称,常见预设名为 Android、iOS、Web、Windows Desktop、macOS。
类型化 JSON 值:普通值使用普通 JSON 标量、数组与对象;加载资源使用 {"__resource":"res://path/to/resource"};引擎值类型使用类型化包装,例如 {"__type":"Vector2","x":10,"y":20}、{"__type":"Color","r":1,"g":0.5,"b":0.25,"a":1}、{"__type":"NodePath","value":"root/Button"}。configure_node.properties、configure_node.indexed_properties、attach_script.script_properties、configure_control.theme_overrides 以及 scene_batch.actions[*] 均接受相同的类型化值格式。
适用场景
- 在 Godot 项目中构建或修改场景与 UI。
- 设计或重构 Godot 项目架构,划分模块与职责边界。
- 将生成的美术、帧动画、音乐音效与剧情内容接入可玩的游戏路径。
- 运行项目、验证改动行为并检查日志。
- 为 Android、iOS、Web、Windows 或 macOS 准备与导出构建。
限制
- 使用内置调度器回退或 CLI 导出封装前,需要本地具备带 shell 访问权限的 godot CLI。
- 内置场景编辑 API 依据当前稳定版 Godot 文档设计,并在 Godot 4.6.1 上测试。
- 调度器不实现运行时生命周期与项目导出动作。
- 平台导出支持取决于 export_presets.cfg 中已定义的预设,而非封装脚本本身。
- 剧情内容方面,本技能引导集成而非开放式叙事系统生成;若项目无既有系统,仅添加使请求可玩所需的最小线性对话或事件路径,除非用户明确要求更大系统。
- 音乐与音效优先通过项目既有导入设置、音频总线与播放器节点集成,而非新建音频管线。
- 帧动画交付默认使用独立帧文件而非精灵表。
- 技能应安装在名为 godot 的文件夹中,以匹配 name: godot。
- 关于收费、价格、平台支持范围等未在资料中明确的信息,暂未提供。