scene
Destructive
Create, read, edit, and save Godot node hierarchies. Add, remove, inspect, and instance nodes and resources.
Instructions
场景操作。读取/创建: read_scene, create_scene, quick_scene。节点: add_node, batch_add_nodes, edit_node, remove_node。保存/资源: save_scene, load_sprite。查询: query_scene_tree, inspect_node。实例: instance_scene, set_instance_property, detach_instance。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | create_3d_node: 节点名称 | |
| save | No | commit: 是否保存到文件（默认 true） | |
| type | No | create_3d_node: 节点类型（仅限白名单） | |
| nodes | No | batch_add_nodes: 节点定义数组 | |
| value | No | set_instance_property: 属性值（string/number/bool/null/array） | |
| action | Yes | 操作类型 | |
| parent | No | create_3d_node: 父节点路径（默认 root） | |
| new_path | No | save_scene: 新保存路径（可选）/ merge_scene: theirs 场景路径（必需） | |
| property | No | set_instance_property: 属性名 | |
| max_depth | No | query_scene_tree/inspect_node: 最大遍历深度 | |
| node_name | No | add_node: 节点名称 | |
| node_path | No | inspect_node/edit_node/remove_node/load_sprite/detach_instance/set_instance_property: 节点路径 | |
| node_type | No | add_node: 节点类型（如 Sprite2D, Camera2D） | |
| godot_path | No | 覆盖 Godot 二进制路径（可选，优先于项目配置和环境变量） | |
| operations | No | commit: 批量操作列表（tile_set/tile_fill/tile_erase/tile_clear/tileset_assign/node_property/node_add） | |
| properties | No | add_node/edit_node/instance_scene: 属性对象 | |
| scene_path | No | 场景路径（read_scene 用绝对路径，其余用相对项目路径） | |
| script_path | No | quick_scene: 脚本路径（可选） | |
| project_path | No | Godot 项目目录路径 | |
| summary_only | No | read_scene: 返回摘要而非完整 JSON | |
| texture_path | No | load_sprite: 纹理路径（如 res://assets/player.png） | |
| instance_path | No | instance_scene: 要实例化的场景文件（res://scenes/player.tscn） | |
| stop_on_error | No | commit: 遇错是否停止（默认 true） | |
| load_autoloads | No | 是否加载 Autoload 上下文（默认 true） | |
| root_node_name | No | quick_scene: 根节点名称（默认从文件名推导 PascalCase） | |
| root_node_type | No | create_scene/quick_scene: 根节点类型（默认 Node2D） | |
| script_content | No | quick_scene: 脚本内容（脚本不存在时自动创建） | |
| include_signals | No | inspect_node: 包含信号连接（默认 true） | |
| parent_node_path | No | add_node/instance_scene: 父节点路径（默认 root） | |
| include_properties | No | inspect_node: 包含属性值（默认 true） |