All servers / Gaming / Breakpoint MCP server
Breakpoint MCP server
MCP server exposing Godot to AI coding assistants over the Model Context Protocol — developed and tested with Claude — across four planes (CLI, live editor, LSP
Tested by ConnectATDScore 86 out of 100. Tested 2026-11-19 on package version 1.95.0. Package: breakpoint-mcp · source
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 20 / 20 | |
| Package safety | 20 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 8 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (3.6 seconds including download)
- Tools offered: 285
- Last published: 2026-11-16
- Weekly downloads (npm): 740
- License: MIT · Direct dependencies: 2
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
godot_versionno parametersReturn the version string of the configured Godot binary.
godot_launch_editorno parametersOpen the Godot editor for the configured project (detached). Needed before any editor_* bridge tool can be used.
godot_run_project3 of 3 parameters describedRun the project (detached). Optionally start from a specific scene path (res://...). WAITS until the game's runtime bridge answers ping and reports bridge_ready — the game takes roughly half a second to three seconds to bind it, and no runtime_* tool is reachable before it does. Refuses if the runtime bridge port is already bound — the new game could not host the bridge, and every runtime_* call would address the process already holding the port. Use runtime_spawn_peers to drive more than one game at once.
godot_export4 of 4 parameters describedHeadless export using an export preset. Runs to completion and returns exit code + logs. Can be slow — exposed as an MCP task, so a task-aware client can poll it or cancel it while it runs.
godot_import1 of 1 parameter describedHeadless (re)import of project assets. Runs to completion and returns exit code + logs. Exposed as an MCP task, so a task-aware client can poll it or cancel it while it runs.
breakpoint_doctor4 of 4 parameters describedCheck this Breakpoint MCP setup end to end: the Godot binary, the editor addon's install and enable state, the capability groups in force, and the editor/runtime/LSP/DAP bridges. Returns a per-check status with a hint for anything wrong. Read-only — run it first when an editor_*, runtime_*, gd_* or dbg_* tool fails to connect.
breakpoint_portsno parametersWho holds each port this server dials — editor and runtime bridges, GDScript LSP and DAP, live peers: held or free, each holder's pid and program, and whether this server started it. Read-only. Use it when a launch is refused over a held port or a bridge will not answer.
editor_pingno parametersCheck that the editor is running with the Breakpoint MCP plugin enabled.
editor_get_stateno parametersReturn the currently edited scene, its root type/path, and the current node selection.
editor_undo1 of 1 parameter describedUndo the most recent edit in the editor's undo history (like Ctrl-Z). Defaults to the edited scene's history; pass scope='global' for the editor-wide history. Returns whether an action was undone, its name, and the remaining undo/redo depth.
editor_redo1 of 1 parameter describedRe-apply the most recently undone edit in the editor's undo history (like Ctrl-Shift-Z). Defaults to the edited scene's history; pass scope='global' for the editor-wide history.
project_get_infono parametersReturn project name, main scene, project root path, Godot version, and feature tags.
project_get_setting1 of 1 parameter describedRead a single ProjectSettings value by dotted key (e.g. application/config/name).
project_set_setting4 of 4 parameters describedWrite a ProjectSettings value. Set save=true to persist to project.godot. DESTRUCTIVE — gated by confirmation.
scene_get_tree1 of 1 parameter describedReturn the node tree of the currently edited scene (name, type, path, script, children).
scene_open1 of 1 parameter describedOpen an existing scene in the editor by res:// path.
scene_saveno parametersSave the currently edited scene to its existing path.
scene_new5 of 5 parameters describedCreate a new scene with the given root class, save it to a path, and open it. DESTRUCTIVE (writes a file) — gated by confirmation.
scene_list_openno parametersList the res:// paths of all scenes open in the editor, which one is current, and which have unsaved changes. Read-only.
scene_reload2 of 2 parameters describedReload a scene from disk, discarding unsaved changes to it. DESTRUCTIVE — gated by confirmation. Defaults to the current scene.
scene_close2 of 2 parameters describedClose the current scene tab, discarding unsaved changes. DESTRUCTIVE — gated by confirmation. Only the current scene can be closed; pass its path to assert which one.
scene_pack4 of 4 parameters describedSave a node branch (the node and its subtree) as a new PackedScene file. DESTRUCTIVE (writes a file) — gated by confirmation. Does not modify the edited scene.
scene_get_dependencies1 of 1 parameter describedList the external resource dependencies of a scene file. Read-only. Defaults to the current scene. `dependencies` are loadable res:// paths; `dependencies_raw` carries the engine's own `uid://…::::res://…` encoding and `dependency_uids` the UID alone ("" when the dependency has none) — all three index-aligned.
scene_save_as2 of 2 parameters describedSave the current scene to a new res:// path (Save As). DESTRUCTIVE (writes a file) — gated by confirmation.
node_add3 of 3 parameters describedInstance a node of the given class under a parent path (undoable). Returns the new node's path.
node_delete2 of 2 parameters describedDelete a node (undoable). DESTRUCTIVE — gated by confirmation. Refuses to delete the scene root.
node_rename2 of 2 parameters describedRename a node (undoable).
node_reparent3 of 3 parameters describedMove a node under a new parent (undoable).
node_set_property3 of 3 parameters describedSet a property on a node (undoable). Rich types use the {"__type__":"Vector3","x":..} convention. Example value for position: {"__type__":"Vector3","x":1,"y":0,"z":2}.
node_get_property2 of 2 parameters describedRead a single property from a node. Rich types come back __type__-tagged.
node_duplicate2 of 2 parameters describedDuplicate a node and its children under the same parent (undoable). Returns the new node's path.
node_get_children1 of 1 parameter describedList the direct children of a node (name, type, path). Read-only.
node_find4 of 4 parameters describedSearch a node's descendants by class and/or name substring (case-insensitive). Read-only.
node_list_groups1 of 1 parameter describedList the groups a node belongs to. Read-only.
node_add_to_group2 of 2 parameters describedAdd a node to a group (persistent, undoable). No-op if already a member.
node_remove_from_group3 of 3 parameters describedRemove a node from a group (undoable). No-op if not a member.
node_instantiate_scene3 of 3 parameters describedInstance an external PackedScene (res:// path) as an editable child of a parent node (undoable). Returns the new node's path.
node_move_child2 of 2 parameters describedReorder a node among its siblings by index (undoable). Negative indices count from the end (-1 = last).
node_change_type3 of 3 parameters describedReplace a node with a new node of a different class, carrying over compatible properties, children, and groups (undoable). Refuses the scene root.
node_set_owner2 of 2 parameters describedSet a node's owner (undoable). Owner must be an ancestor; "." or omitted sets the scene root. Ownership determines which scene a node is saved into.
node_set_editable_instance2 of 2 parameters describedToggle "Editable Children" on an instanced sub-scene (undoable). When enabled, property overrides on the instance's internal nodes serialize into the saved scene; without it the sub-scene is sealed and its internals revert on reload. This is what lets author-time edits (e.g. card_instance slot data) be baked into the .tscn.
node_get_path1 of 1 parameter describedReturn a node's scene-relative path, class, sibling index, parent path, and child count. Read-only.
node_list_properties1 of 1 parameter describedList a node's inspector-visible properties (name, Variant type, class_name, usage flags). Read-only. Use node_get_property to read a value.
signal_list1 of 1 parameter describedList the signals a node declares (name and argument names), including user signals. Read-only.
signal_list_connections2 of 2 parameters describedList a node's outgoing signal connections (signal, target node path, method, flags). Optionally filter to one signal. Read-only.
signal_connect5 of 5 parameters describedConnect a source node's signal to a target node's method (undoable). Persistent by default (flags=2, CONNECT_PERSIST) so it saves into the scene. No-op if already connected.
signal_disconnect5 of 5 parameters describedDisconnect a source node's signal from a target node's method (undoable). No-op if not connected.
signal_add_user_signal3 of 3 parameters describedDeclare a new user signal on a node (undoable). Optional typed arguments. Errors if the signal already exists.
signal_emit4 of 4 parameters describedEmit a signal from a node in the EDITED scene, firing its connected callables now. DESTRUCTIVE (edit-time side effects) — gated by confirmation. Args use the tagged-Variant convention.
selection_getno parametersReturn the paths of the nodes currently selected in the editor.
selection_set1 of 1 parameter describedReplace the editor's node selection with the given node paths.
main_screen_getno parametersReport which main-screen editor tab is active (2D / 3D / Script / …) and which are available. Read-only. The active tab decides which viewport screenshot_editor can actually capture: Godot collapses the inactive tab's viewport to a few pixels.
main_screen_set1 of 1 parameter describedSwitch the editor's main-screen tab (2D / 3D / Script / …), matching the name case-insensitively. Use this before screenshot_editor to make the viewport you want to capture the active one — opening a scene does NOT switch the tab. Returns the resulting state, read back from the editor rather than echoed. An unknown name comes back with the live list of available tabs.
classdb_get_class2 of 2 parameters describedReturn the parent class, methods, properties, and signals of an engine class via ClassDB.
class_reference3 of 3 parameters describedFull engine-class reference via ClassDB: method SIGNATURES (return type + typed args), signal signatures, and typed properties — the detailed view classdb_get_class summarises as bare names. Read-only. Includes the canonical online docs URL. Pass member to filter to a single method/property/signal.
docs_search5 of 5 parameters describedSearch the Godot class reference (ClassDB) by keyword — matching class names and, unless a scope narrows it, their methods/properties/signals — and return each hit with its canonical docs URL. Read-only. Use kind to restrict to one member type, class_name to scope to a single class, and limit to bound results.
screenshot_editor1 of 1 parameter describedCapture the 2D or 3D editor viewport as a PNG as image content so the assistant can see the scene. The requested viewport's tab must be the ACTIVE main-screen tab, and this tool refuses with viewport_not_active when it is not: a hidden tab's viewport is either a few pixels or a full-size stale frame that looks exactly like a good capture. It also refuses with window_not_drawing when the editor window is off screen or headless: Godot draws nothing then. A fresh editor is on the 3D tab and opening a scene does NOT switch it, so to capture 2d call main_screen_set {"name":"2D"} first AND pass {"viewport":"2d"} — the default is 3d, so switching the tab alone captures the tab you just left. main_screen_get reports which tab is active.
resource_create5 of 5 parameters describedInstantiate a Resource subclass and save it as a new file. DESTRUCTIVE (writes a file) — gated by confirmation. Optional initial properties use the tagged-Variant convention.
resource_load1 of 1 parameter describedLoad a resource file and return its class, resource_name, and inspector-visible property list. Read-only.
resource_save5 of 5 parameters describedLoad a resource and (re-)save it, optionally to a new path and with ResourceSaver flags. DESTRUCTIVE (writes a file) — gated by confirmation. Shares subresources by reference; use resource_duplicate for an independent copy.
resource_duplicate5 of 5 parameters describedLoad a resource, duplicate it (optionally deep, cloning subresources), and save the copy to a new path. DESTRUCTIVE (writes a file) — gated by confirmation.
resource_get_property2 of 2 parameters describedRead a single property of a resource file by name. Read-only. The value comes back tagged (Variant convention).
resource_set_property4 of 4 parameters describedSet a single property on a resource file and save it. DESTRUCTIVE (writes a file) — gated by confirmation. The value uses the tagged-Variant convention.
resource_get_import_settings1 of 1 parameter describedRead an asset's import metadata (.import): the importer and its parameters. Read-only. Returns imported=false when the file exists but has no .import sidecar; errors not_found when the path is not a file (matching resource_load).
resource_set_import_settings4 of 4 parameters describedUpdate import parameters in an asset's .import metadata and trigger a reimport. DESTRUCTIVE (rewrites metadata + reimports) — gated by confirmation. Errors not_found when the path is not a file, not_imported when the file has no .import sidecar. `settings` echoes every key set; `changed` lists only those whose stored value actually moved, so a no-op is distinguishable from a real edit.
filesystem_list1 of 1 parameter describedList the subdirectories and files of a directory in the project filesystem (hidden entries like .godot are skipped). Read-only.
filesystem_scanno parametersTrigger an editor rescan of the project filesystem so newly added or externally-changed files are picked up. Read-only side effect.
filesystem_move3 of 3 parameters describedMove or rename a file or directory within the project (carrying its .import sidecar), then rescan. DESTRUCTIVE (moves on disk; does NOT remap references in other resources) — gated by confirmation.
filesystem_create_dir1 of 1 parameter describedCreate a directory (recursively) in the project filesystem, then rescan. No-op if it already exists.
anim_player_create2 of 2 parameters describedAdd an AnimationPlayer node under a parent (undoable). Seeds an empty default animation library so anim_create works immediately.
anim_create3 of 3 parameters describedCreate an empty Animation in an AnimationPlayer's library (undoable). Creates the library if it does not exist yet.
anim_delete4 of 4 parameters describedDelete an Animation from an AnimationPlayer's library (undoable). DESTRUCTIVE — gated by confirmation.
anim_add_track5 of 5 parameters describedAdd a track to an Animation and set its target path (undoable). Returns the new track index.
anim_insert_key7 of 7 parameters describedInsert a keyframe on a track at a given time (undoable). A key already at that exact time is overwritten.
anim_remove_key6 of 6 parameters describedRemove a keyframe by index from a track (undoable).
anim_set_length4 of 4 parameters describedSet an Animation's length in seconds (undoable).
anim_set_loop4 of 4 parameters describedSet an Animation's loop mode (undoable).
anim_get_track_keys4 of 4 parameters describedList all keyframes on a track (index, time, value, transition). Read-only.
anim_list1 of 1 parameter describedList all animations in an AnimationPlayer across its libraries, with length, loop mode, and track count. Read-only.
anim_tree_create5 of 5 parameters describedAdd an AnimationTree node under a parent (undoable) with a fresh tree_root graph. root_type "blend_tree" (AnimationNodeBlendTree) or "state_machine" (AnimationNodeStateMachine). Created inactive by default; set anim_player_path to the AnimationPlayer it should drive.
anim_tree_add_node5 of 5 parameters describedAdd a node to an AnimationTree's tree_root graph (AnimationNodeBlendTree or AnimationNodeStateMachine), undoable. node_type is any AnimationNode subclass (e.g. AnimationNodeAnimation, AnimationNodeBlend2, AnimationNodeStateMachine). For AnimationNodeAnimation, pass animation to bind a clip.
anim_statemachine_add_state6 of 6 parameters describedAdd a state to an AnimationNodeStateMachine (undoable). Targets the AnimationTree's tree_root when it is a state machine, or a nested state-machine node via state_machine. Defaults the state to an AnimationNodeAnimation; pass animation to bind a clip.
anim_statemachine_add_transition9 of 9 parameters describedAdd a transition between two states in an AnimationNodeStateMachine (undoable). from_state/to_state must exist (or be the built-in "Start"/"End"). switch_mode: immediate|sync|at_end; advance_mode: disabled|enabled|auto.
tileset_create4 of 4 parameters describedInstantiate a TileSet resource and save it as a new .tres file. DESTRUCTIVE (writes a file) — gated by confirmation. tile_size is the base grid cell size in pixels (default 16×16).
tileset_add_source7 of 7 parameters describedAdd a TileSetAtlasSource (backed by a Texture2D) to a TileSet .tres and re-save. DESTRUCTIVE (writes a file) — gated by confirmation. texture_region_size defaults to the TileSet's tile_size; source_id -1 auto-assigns.
tileset_add_tile5 of 5 parameters describedCreate a tile at atlas_coords in an atlas source of a TileSet .tres and re-save. DESTRUCTIVE (writes a file) — gated by confirmation. size is measured in atlas cells (default [1, 1]).
tileset_set_tile_collision7 of 7 parameters describedAdd a collision polygon to a tile on a TileSet physics layer and re-save. DESTRUCTIVE (writes a file) — gated by confirmation. Physics layers are created as needed. polygon is an array of [x, y] points (>= 3), tile-local pixels.
tilemaplayer_create3 of 3 parameters describedAdd a TileMapLayer node under a parent in the edited scene (undoable), optionally binding a TileSet .tres so cells can be painted. In-scene and undoable — not gated.
tilemap_set_cell6 of 6 parameters describedPaint a single cell on a TileMapLayer (undoable). source_id -1 erases the cell (default). atlas_coords defaults to [0, 0]; alternative defaults to 0.
tilemap_set_cells_rect6 of 6 parameters describedPaint every cell in a rectangular region of a TileMapLayer with one tile (undoable, one action). source_id -1 clears the region. Capped at 65536 cells; split larger fills across calls.
tilemap_get_cell2 of 2 parameters describedRead one cell of a TileMapLayer. An empty cell reads back as source_id -1, atlas_coords [-1, -1], alternative 0 (empty = true).
tilemap_clear2 of 2 parameters describedRemove every painted cell from a TileMapLayer (undoable — prior cells are restored on undo). Returns the number of cells cleared.
body_create4 of 4 parameters describedAdd a physics body node under a parent in the edited scene (undoable): a StaticBody, RigidBody, CharacterBody, or Area, in 2D or 3D. In-scene and undoable — not gated. Attach collision shapes with collisionshape_add.
collisionshape_add8 of 8 parameters describedAdd a CollisionShape2D/3D node carrying a shape resource under a parent (usually a body) in the edited scene (undoable). shape is rect | circle | capsule | polygon; dim selects 2D (Rectangle/Circle/Capsule/ConvexPolygon 2D) or 3D (Box/Sphere/Capsule/ConvexPolygon 3D). In-scene and undoable — not gated.
body_set_collision_layer2 of 2 parameters describedSet the collision_layer bitmask on a physics body or area (CollisionObject2D/3D) in the edited scene (undoable). layer is the integer bitmask of layers this object occupies.
body_set_collision_mask2 of 2 parameters describedSet the collision_mask bitmask on a physics body or area (CollisionObject2D/3D) in the edited scene (undoable). mask is the integer bitmask of layers this object scans for collisions.
area_set_monitoring3 of 3 parameters describedSet monitoring and/or monitorable on an Area2D/3D in the edited scene (undoable). monitoring = the area detects overlapping bodies/areas; monitorable = other areas can detect it. In-scene and undoable — not gated.
area_set_gravity5 of 5 parameters describedSet the local gravity override of an Area2D/3D in the edited scene (undoable): space_override mode, gravity magnitude, direction, and whether gravity points toward a center (point). In-scene and undoable — not gated.
joint_create6 of 6 parameters describedAdd a physics joint node under a parent in the edited scene (undoable). 2D types: pin | groove | spring (PinJoint2D/GrooveJoint2D/DampedSpringJoint2D); 3D types: pin | hinge | slider | cone_twist | generic6dof (PinJoint3D/HingeJoint3D/SliderJoint3D/ConeTwistJoint3D/Generic6DOFJoint3D). Optionally wire node_a/node_b to the two bodies. In-scene and undoable — not gated.
joint_set_bodies3 of 3 parameters describedSet node_a and/or node_b on an existing Joint2D/3D in the edited scene (undoable) — the NodePaths of the two bodies the joint connects, relative to the joint node. In-scene and undoable — not gated.
collisionpolygon_add6 of 6 parameters describedAdd a CollisionPolygon2D/3D node carrying a polygon under a parent (usually a body) in the edited scene (undoable). points is a 2D outline [[x, y], …] (≥3); for 3D it is extruded along Z by depth. 2D build_mode is solids | segments. In-scene and undoable — not gated.
rigidbody_set_properties5 of 5 parameters describedTune a RigidBody2D/3D in the edited scene (undoable): mass (> 0), gravity_scale, linear_damp, angular_damp. Only the provided properties change. In-scene and undoable — not gated.
body_set_physics_material5 of 5 parameters describedCreate a PhysicsMaterial and assign it as physics_material_override on a StaticBody/RigidBody (2D or 3D) in the edited scene (undoable): friction (default 1), bounce (default 0), rough, absorbent. In-scene and undoable — not gated.
physics_set_gravity5 of 5 parameters describedWrite the project's default gravity for 2D or 3D (ProjectSettings physics/{2d,3d}/default_gravity + default_gravity_vector). Set save=true to persist to project.godot. DESTRUCTIVE (project-wide setting) — gated by confirmation.
particles_create6 of 6 parameters describedAdd a GPUParticles2D/3D node under a parent in the edited scene (undoable). Optional initial amount (> 0), lifetime (> 0), emitting. In-scene and undoable — not gated.
particles_set_process_material9 of 9 parameters describedCreate a ParticleProcessMaterial and assign it as process_material on a GPUParticles2D/3D in the edited scene (undoable). Optional knobs: gravity [x, y, z], direction [x, y, z], spread, initial_velocity_min/max, scale_min/max, color [r, g, b, a]. GPU particles need a process material to emit. In-scene and undoable — not gated.
particles_set_amount2 of 2 parameters describedSet the number of particles (amount, > 0) on a GPUParticles2D/3D in the edited scene (undoable). In-scene and undoable — not gated.
particles_set_lifetime2 of 2 parameters describedSet the particle lifetime in seconds (> 0) on a GPUParticles2D/3D in the edited scene (undoable). In-scene and undoable — not gated.
particles_set_emitting2 of 2 parameters describedToggle whether a GPUParticles2D/3D is emitting in the edited scene (undoable). In-scene and undoable — not gated.
particles_set_texture2 of 2 parameters describedLoad a Texture2D from a res:// path and assign it as texture on a GPUParticles2D in the edited scene (undoable). GPUParticles2D only — GPUParticles3D draws meshes and has no texture (returns unsupported). In-scene and undoable — not gated.
shader_create4 of 4 parameters describedCreate a Shader resource with optional initial code and save it as a .gdshader file. DESTRUCTIVE (writes a file) — gated by confirmation.
shader_set_code3 of 3 parameters describedReplace the source code of an existing .gdshader resource and save it. DESTRUCTIVE (writes a file) — gated by confirmation.
shadermaterial_create3 of 3 parameters describedCreate a ShaderMaterial and assign it to a node's material slot in the edited scene (undoable). Targets CanvasItem.material (2D / Control) or GeometryInstance3D.material_override (3D); other node types return unsupported. Optionally assign a Shader loaded from a res:// path. In-scene and undoable — not gated.
shadermaterial_set_shader3 of 3 parameters describedLoad a Shader from a res:// path and assign it to the ShaderMaterial on a node's material slot in the edited scene (undoable). The node must already have a ShaderMaterial. In-scene and undoable — not gated.
shadermaterial_set_param4 of 4 parameters describedSet a shader uniform parameter on the ShaderMaterial of a node's material slot in the edited scene (undoable). The node must already have a ShaderMaterial. The value uses the tagged-Variant convention. In-scene and undoable — not gated.
audio_player_create7 of 7 parameters describedAdd an AudioStreamPlayer / AudioStreamPlayer2D / AudioStreamPlayer3D node under a parent in the edited scene (undoable). `dim` selects "none" (default, non-positional AudioStreamPlayer), "2d", or "3d". Optional initial stream_path (res:// AudioStream), autoplay, volume_db, bus. In-scene and undoable — not gated.
audio_set_stream2 of 2 parameters describedLoad an AudioStream from a res:// path and assign it as stream on an AudioStreamPlayer/2D/3D in the edited scene (undoable). In-scene and undoable — not gated.
audio_bus_add4 of 4 parameters describedAdd a bus to the project's global AudioServer layout, optionally naming it, positioning it (at_position), and setting its send bus. DESTRUCTIVE (project-wide audio state) — gated by confirmation.
audio_bus_add_effect4 of 4 parameters describedInstantiate an AudioEffect subclass (by class name, e.g. "AudioEffectReverb") and add it to a named bus on the global AudioServer, optionally at a position in the bus's effect chain. DESTRUCTIVE (project-wide audio state) — gated by confirmation.
audio_bus_set_volume3 of 3 parameters describedSet the volume (in dB) of a named bus on the global AudioServer. DESTRUCTIVE (project-wide audio state) — gated by confirmation.
audio_set_bus_layout3 of 3 parameters describedSave the current AudioServer bus layout (buses, effects, volumes) to a .tres resource on disk (default res://default_bus_layout.tres) via generate_bus_layout + ResourceSaver.save. DESTRUCTIVE (writes a file) — gated by confirmation.
control_create4 of 4 parameters describedInstance a Control-derived UI node (Button, Label, Panel, VBoxContainer, TextureRect, …) under a parent (undoable). Refuses non-Control classes. Optional 'text' is applied only to controls that expose a 'text' property. Returns the new node's path.
container_add_child3 of 3 parameters describedInstance a Control-derived child under a Container node (VBoxContainer, GridContainer, MarginContainer, …) so it participates in the container's layout (undoable). Refuses a non-Container parent or a non-Control child. Returns the new node's path.
control_set_anchors5 of 5 parameters describedSet one or more of a Control's anchors (left/top/right/bottom, each 0..1) directly (undoable). Only the sides you pass are changed; offsets are left as-is. Provide at least one side.
control_set_layout_preset4 of 4 parameters describedApply a LayoutPreset to a Control via set_anchors_and_offsets_preset (undoable). 'preset' is a name (full_rect, center, top_left, center_top, left_wide, hcenter_wide, …) or the integer enum value. Optional resize_mode (0=min_size,1=keep_width,2=keep_height,3=keep_size) and margin.
control_set_size_flags4 of 4 parameters describedSet a Control's container size flags and/or stretch ratio (undoable). 'horizontal'/'vertical' are SizeFlags bitmasks (1=fill, 2=expand, 3=expand_fill, 4=shrink_center, 8=shrink_end). Provide at least one of horizontal/vertical/stretch_ratio.
control_set_theme2 of 2 parameters describedAssign a Theme resource (res:// path) to a Control's 'theme' property so it and its children inherit it (undoable). Pass an empty theme_path to clear the override.
theme_create3 of 3 parameters describedCreate a new empty Theme resource and save it to a res:// path. DESTRUCTIVE (writes a file) — gated by confirmation.
theme_set_color5 of 5 parameters describedSet a color entry on a Theme resource file and save it (e.g. font_color for the Button type). DESTRUCTIVE (writes a file) — gated by confirmation. 'color' is [r,g,b] or [r,g,b,a] with components 0..1.
theme_set_font5 of 5 parameters describedSet a font entry on a Theme resource file (loading a Font from a res:// path) and save it. DESTRUCTIVE (writes a file) — gated by confirmation.
theme_set_stylebox5 of 5 parameters describedSet a StyleBox entry on a Theme resource file (loading a StyleBox from a res:// path) and save it. DESTRUCTIVE (writes a file) — gated by confirmation.
theme_set_constant5 of 5 parameters describedSet an integer constant entry on a Theme resource file and save it (e.g. h_separation for a BoxContainer). DESTRUCTIVE (writes a file) — gated by confirmation.
meshinstance_create3 of 3 parameters describedAdd a MeshInstance3D under a parent (undoable). Optional 'mesh_path' loads a Mesh resource (e.g. a primitive_mesh_create output) and assigns it. Returns the new node's path.
mesh_set_surface_material3 of 3 parameters describedAssign a Material (res:// path) to a MeshInstance3D (undoable). Default surface -1 sets 'material_override' (whole instance); a surface index >= 0 sets that surface's override material (must be within the mesh's surface count). Refuses a non-MeshInstance3D node or a non-Material resource.
primitive_mesh_create4 of 4 parameters describedCreate a PrimitiveMesh resource (box/sphere/cylinder/plane/capsule/prism/torus/quad) and save it to a res:// path. DESTRUCTIVE (writes a file) — gated by confirmation. Assign it with meshinstance_create's 'mesh_path'.
light_create3 of 3 parameters describedAdd a 3D light under a parent (undoable). 'kind' selects DirectionalLight3D (dir), OmniLight3D (omni), or SpotLight3D (spot). Returns the new node's path.
camera_create3 of 3 parameters describedAdd a Camera3D under a parent (undoable). Optional 'current' makes it the active camera. Returns the new node's path.
csg_create3 of 3 parameters describedAdd a CSG node under a parent (undoable). 'shape' selects CSGBox3D (box), CSGSphere3D (sphere), CSGCylinder3D (cylinder), CSGTorus3D (torus), CSGPolygon3D (polygon), CSGMesh3D (mesh), or CSGCombiner3D (combiner). Returns the new node's path.
navregion_create3 of 3 parameters describedAdd a NavigationRegion3D under a parent (undoable). By default seeds a fresh empty NavigationMesh (set with_navmesh=false to skip). Returns the new node's path and whether a navmesh was attached.
navagent_configure8 of 8 parameters describedAdd a NavigationAgent3D under a parent (undoable) and set any of its steering/avoidance properties. Returns the new node's path and the resulting config (radius, height, max_speed, path/target desired distances, avoidance_enabled).
environment_create5 of 5 parameters describedCreate an Environment resource and save it to a res:// path. 'background' sets the mode (clear_color/color/sky/canvas, default clear_color); optional 'ambient_color' ([r,g,b(,a)], 0..1) sets the ambient light color. DESTRUCTIVE (writes a file) — gated by confirmation.
environment_set_sky3 of 3 parameters describedAttach a Sky to an existing Environment resource file (setting a ProceduralSkyMaterial, PhysicalSkyMaterial, or PanoramaSkyMaterial) and switch its background to SKY, then re-save. DESTRUCTIVE (writes a file) — gated by confirmation. Refuses a path that is not an Environment.
inputmap_add_action4 of 4 parameters describedDefine a project input action (ProjectSettings input/<name>) with an empty event list and a deadzone. Set save=true to persist to project.godot. DESTRUCTIVE (project-wide input map) — gated by confirmation.
inputmap_add_event4 of 4 parameters describedAppend an input event to an existing project input action. 'event' is { type: key|mouse_button|joy_button|joy_motion, ... } — key: keycode or physical_keycode as a name like "A"/"Space" or an int; mouse_button/joy_button: button_index; joy_motion: axis + axis_value. Set save=true to persist. DESTRUCTIVE — gated by confirmation.
inputmap_listno parametersList all project-defined input actions (ProjectSettings input/*) with their deadzone and events (class + human-readable text). Read-only.
inputmap_erase_action3 of 3 parameters describedRemove a project input action (ProjectSettings input/<name>). Set save=true to persist to project.godot. DESTRUCTIVE — gated by confirmation.
project_add_autoload5 of 5 parameters describedRegister an autoload (ProjectSettings autoload/<name>) pointing at a res:// script or scene, enabled as a global singleton by default. Set save=true to persist to project.godot. DESTRUCTIVE — gated by confirmation.
project_remove_autoload3 of 3 parameters describedRemove an autoload (ProjectSettings autoload/<name>). Set save=true to persist to project.godot. DESTRUCTIVE — gated by confirmation.
project_add_export_preset5 of 5 parameters describedAppend an export preset to res://export_presets.cfg for a platform (e.g. "Windows Desktop", "Web", "Linux/X11", "macOS"). Returns the preset's index. DESTRUCTIVE (writes export_presets.cfg) — gated by confirmation.
project_set_main_scene3 of 3 parameters describedSet the project's main scene (ProjectSettings application/run/main_scene) to an existing res:// .tscn/.scn. Set save=true to persist to project.godot. DESTRUCTIVE — gated by confirmation.
project_list_settings1 of 1 parameter describedList ProjectSettings keys and values, optionally filtered by a dotted-key prefix (e.g. "input/", "autoload/", "application/"). Read-only.
editorsettings_get_set3 of 3 parameters describedRead an EditorSettings value by name; if 'value' is provided, write it instead (persists to the editor's global config). Reading is read-only; writing is DESTRUCTIVE (mutates the editor config) — gated by confirmation.
test_detectno parametersDetect an installed GDScript test framework (GUT or GdUnit4) in the project. Returns { framework: gut|gdunit4|none, path, version }. Read-only.
test_list1 of 1 parameter describedList GDScript test scripts (files named test_*.gd or *_test.gd) under a directory (default res://test), searched recursively. Read-only.
gd_completion4 of 4 parameters describedType-aware code completion at a position via the Godot language server. Returns at most max_results items (default 200) and sets truncated when the language server offered more.
gd_hover3 of 3 parameters describedHover documentation/type info at a position.
gd_definition3 of 3 parameters describedResolve the definition location(s) of the symbol at a position.
gd_references4 of 4 parameters describedFind all references to the symbol at a position.
gd_rename6 of 6 parameters describedRename a symbol project-wide. Returns the planned edit; pass apply=true to WRITE the changes to disk (DESTRUCTIVE — confirm with the user). new_name must be a valid GDScript identifier and not a reserved word: the language server plans a rename to any string, including one that would write a file GDScript cannot parse, so an illegal name is refused here before the rename is planned.
gd_document_symbols1 of 1 parameter describedList the symbols (classes, functions, variables, signals) declared in a script.
gd_workspace_symbols1 of 1 parameter describedSearch symbols across the whole project by name. Note: Godot's GDScript language server does not implement LSP 'workspace/symbol' (observed through 4.7), so on those builds this returns a clear 'unsupported' error rather than results — use gd_document_symbols for per-file symbols.
gd_diagnostics2 of 2 parameters describedReturn compile/lint diagnostics (errors, warnings) for a script. Opens the file and waits briefly for the server to publish.
gd_signature_help3 of 3 parameters describedShow the call signature(s) and active parameter at a position (the parameter hints an IDE pops up inside a call). Godot's GDScript language server advertises signatureHelpProvider.
gd_code_action6 of 6 parameters describedList the code actions (quick fixes / refactors) the language server offers for a range — the lightbulb menu. Read-only: returns the available actions (title, kind, whether each carries a WorkspaceEdit or a Command) without applying any. end_line/end_character default to the start position (a caret, not a selection).
gd_document_highlight3 of 3 parameters describedHighlight every occurrence of the symbol at a position WITHIN the same file, tagged read / write / text (the shading an editor shows for a variable's uses when the caret is on it). Read-only. Godot's GDScript language server advertises documentHighlightProvider; feature-detected.
gd_type_definition3 of 3 parameters describedResolve the location of the TYPE of the symbol at a position (jump to the class of a typed variable), as opposed to the symbol's own definition. Godot's GDScript language server advertises typeDefinitionProvider; feature-detected.
gd_implementation3 of 3 parameters describedResolve the implementation location(s) of the symbol at a position (e.g. the concrete override of a method). Godot's GDScript language server advertises implementationProvider; feature-detected.
gd_declaration3 of 3 parameters describedResolve the declaration location(s) of the symbol at a position. (For many symbols this coincides with the definition; the two differ for forward-declared or re-exported names.) Godot's GDScript language server advertises declarationProvider; feature-detected.
gd_folding_ranges1 of 1 parameter describedList the foldable regions of a script (functions, blocks, comment/region markers) — the ranges an editor's fold gutter offers. Read-only. Godot's GDScript language server advertises foldingRangeProvider; feature-detected.
gd_document_link1 of 1 parameter describedList the links embedded in a script (res:// paths or URLs the language server recognizes) with their source ranges and targets. Read-only. Godot's GDScript language server advertises documentLinkProvider; feature-detected.
gd_formatting3 of 3 parameters describedCompute how the language server would reformat a whole script and return the formatted TEXT — WITHOUT writing anything to disk (read-only preview; apply it yourself with a file write if you want it). Godot's GDScript language server advertises documentFormattingProvider; feature-detected.
gd_document_color1 of 1 parameter describedList the color literals the language server recognizes in a script — the Color(...) values an editor draws an inline swatch for — with each one's source range, its RGBA components (floats 0..1) and a convenience #RRGGBBAA hex. Read-only. Godot's GDScript language server advertises colorProvider; feature-detected with a -32601 belt-and-suspenders (advertised ≠ implemented — the D7 lesson).
gd_call_hierarchy4 of 4 parameters describedFind the callers or callees of the function at a position. Resolves the symbol with textDocument/prepareCallHierarchy, then callHierarchy/incomingCalls or outgoingCalls, and returns each related function with the call-site ranges. Read-only. Godot's GDScript language server does not advertise callHierarchyProvider through 4.7; feature-detected.
gd_semantic_tokens1 of 1 parameter describedReturn the semantic-highlighting tokens for a whole script — each token's position, length, type (e.g. function, variable, keyword) and modifiers — decoded from the LSP packed-integer form through the server's advertised legend. Read-only. Godot's GDScript language server does not advertise semanticTokensProvider through 4.7; feature-detected.
cs_completion4 of 4 parameters describedType-aware C# code completion at a position via OmniSharp. Returns at most max_results items (default 200) and sets truncated when the language server offered more — `gd_completion`'s twin, capped for the reason measured on that one.
cs_hover3 of 3 parameters describedHover documentation/type info at a position (e.g. the `Counter : int` type).
cs_definition3 of 3 parameters describedResolve the definition location(s) of the C# symbol at a position.
cs_references4 of 4 parameters describedFind all references to the C# symbol at a position.
cs_rename6 of 6 parameters describedRename a C# symbol project-wide via OmniSharp. Returns the planned edit; pass apply=true to WRITE the changes to disk (DESTRUCTIVE — confirm with the user). new_name must be a valid C# identifier and not a reserved keyword: the language server plans a rename to any string, including one that would write a file the C# compiler rejects, so an illegal name is refused here before the rename is planned. Verbatim identifiers (@class) and contextual keywords (var, value, async) are legal and accepted.
cs_document_symbols1 of 1 parameter describedList the symbols (classes, methods, properties, fields) declared in a C# script.
cs_workspace_symbols1 of 1 parameter describedSearch C# symbols across the whole project by name. Unlike Godot's GDScript server, OmniSharp implements LSP 'workspace/symbol', so this returns real results; it stays feature-detected (with a -32601 belt-and-suspenders) so a server that lacks it degrades gracefully rather than erroring opaquely.
cs_signature_help3 of 3 parameters describedShow the call signature(s) and active parameter at a position (the parameter hints an IDE pops up inside a call).
cs_diagnostics2 of 2 parameters describedReturn compile/analyzer diagnostics (errors, warnings) for a C# script. Opens the file and waits briefly for OmniSharp to publish.
cs_code_action6 of 6 parameters describedList the code actions (quick fixes / refactors) OmniSharp offers for a range — the lightbulb menu. Read-only: returns the available actions (title, kind, whether each carries a WorkspaceEdit or a Command) without applying any. Unlike Godot's GDScript server, OmniSharp implements code actions, so this returns real results; it stays feature-detected (with a -32601 belt-and-suspenders) so a server that lacks it degrades gracefully. end_line/end_character default to the start position (a caret, not a selection).
dbg_launch3 of 3 parameters describedStart the game under the debugger; breakpoints set beforehand are applied during the handshake. Refuses rather than report a session that never started: a scene outside the project root, a missing scene or an empty one (measured on 4.7, the adapter accepts all three and nothing runs; an out-of-project scene leaves a sceneless game reported 'running' forever); a launch the adapter rejects (e.g. 'wrong_path' when the configured project is not the one the editor has open); and a bound runtime bridge port, since runtime_* would address the process holding it. Clear the holder (godot_stop, or quit it), dbg_attach onto it if it is already under the debugger, or pass allow_port_conflict (dbg_* is unaffected either way; only runtime_* is). Not caught: a uid:// the project does not know, which Godot silently replaces with the main scene. With stop_on_entry the result carries stop_on_entry_honored: Godot's adapter does not implement stopOnEntry, so it reports false plus a warning.
dbg_attach2 of 2 parameters describedAttach to an already-running Godot debug session. Refuses if the adapter rejects the attach — Godot answers 'not_running' when nothing is running — instead of reporting state 'running' for a session that never started.
dbg_set_breakpoints5 of 5 parameters describedSet (replace) the breakpoints for a source file: applied now if a session is running, else buffered until launch. Refuses a source that can never bind: a missing file, a directory, an empty path (the project root), or a path outside the Godot project root, absolute ones included (unlike cs_dbg_set_breakpoints), since Godot binds breakpoints only to scripts in the project it runs. The per-line conditions / hit_conditions / log_messages modifiers are sent only when the adapter advertises supportsConditionalBreakpoints / supportsHitConditionalBreakpoints / supportsLogPoints. Measured: no Godot build this project tests advertises it; 4.3-stable and 4.7-stable advertise none of the three and IGNORE the modifiers, so such a breakpoint would halt unconditionally (docs/dap_capability_ledger.json). They are dropped and reported as `unsupported_modifiers` plus a `warning`; set before a session exists, the result says `modifier_detection: "deferred"` and dbg_launch reports what the handshake actually dropped.
dbg_continueno parametersResume execution and wait for the program to settle again (next breakpoint or termination). Returns the resulting state; if it runs on with no further breakpoint, reports state 'running'. Requires a stop; a running program is refused (`not_stopped`).
dbg_step1 of 1 parameter describedStep execution: 'over' (next), 'in' (stepIn), or 'out' (stepOut), then wait for the step to land. Returns the resulting state and stop reason. Note: stepOut may be unsupported on older Godot builds. Requires a stop; a running program is refused (`not_stopped`).
dbg_stack_trace1 of 1 parameter describedReturn the current call stack. Requires a stop; a running program is refused (`not_stopped`) rather than answered with the empty frame list it used to return.
dbg_scopes1 of 1 parameter describedReturn the variable scopes (Locals, Members, Globals) for a stack frame. Requires a stop; a running program is refused (`not_stopped`) rather than answered with an empty list.
dbg_variables1 of 1 parameter describedList variables under a scope or a complex value (via its variables_ref). Requires a stop (`not_stopped`) — a reference is only valid within the stop that issued it.
dbg_watch4 of 4 parameters describedManage a persistent set of watch expressions and evaluate them in the current stopped frame. Pass `add`/`remove`/`clear` to mutate the set (all optional), then every current watch is re-evaluated and returned. Call with no mutation args to just re-read the watches after a step/continue. Expressions are evaluated in DAP `watch` context (intended to be side-effect-free), so this is not gated; the results are only meaningful while the program is stopped at a breakpoint.
dbg_set_exception_breakpoints1 of 1 parameter describedEnable (replace) the debugger's exception breakpoint filters so execution halts when a matching error/exception is thrown (DAP setExceptionBreakpoints). Pass the filter IDs to enable; call with no filters (or []) to clear them. The result echoes the active filters and lists `available_filters` — the exception filters the connected adapter actually advertises. Requires a running debug session. Not gated (it only configures the debugger). Feature-detected: on an adapter that advertises no exceptionBreakpointFilters (which also does not answer the request — it would otherwise time out) it returns a clear "unsupported" message WITHOUT sending anything. Measured: no Godot build this project tests advertises it — 4.3-stable AND 4.7-stable both advertise no filters, so on a shipped engine it is unsupported surface today rather than a feature you can reach; see docs/dap_capability_ledger.json. This sentence used to name 4.3 alone as the example, which read as though a newer build had filters. None does.
dbg_set_variable4 of 4 parameters describedChange a variable's value in a stopped frame (DAP setVariable). DESTRUCTIVE: mutates live program state — confirm with the user and keep this gated. `variables_ref` is the container's variablesReference (from dbg_scopes, or a complex entry in dbg_variables), `name` is the variable's name within it, and `value` is the new value as a GDScript literal/expression. Only meaningful while stopped at a breakpoint.
dbg_restart2 of 2 parameters describedRestart the current debug session. Uses the DAP `restart` request when the adapter advertises `supportsRestartRequest`, otherwise falls back to terminate + relaunch — so it works on every adapter. Reuses the last dbg_launch/dbg_attach parameters; pass `scene` / `stop_on_entry` to override them for a launched session. `method` in the result reports which path ran ('restart' = native DAP restart, 'relaunch' = terminate + fresh handshake). Requires a session started with dbg_launch/dbg_attach. `scene` is held to the same rule as dbg_launch's — inside the project root, existing, non-empty.
dbg_goto4 of 4 parameters describedMove the program counter within the current stopped frame — 'set next statement' (DAP gotoTargets + goto). Call with `path` + `line` to list the valid goto targets on that line; when the line has exactly one target (or you pass `target_id`) it jumps there. DESTRUCTIVE: skips or repeats code by moving execution — confirm with the user and keep this gated. Feature-detected: on an adapter that does not advertise `supportsGotoTargetsRequest` it returns a clear "unsupported" message WITHOUT prompting. Measured: no Godot build this project tests advertises it — 4.3-stable and 4.7-stable both refuse this tool, so on a shipped engine it is unsupported surface today rather than a feature you can reach; see docs/dap_capability_ledger.json. It is kept, and kept guarded, because a capability is not a boundary and a build can start advertising it. Refuses a source that can never carry a target — a missing file, a directory, an empty path (which resolves to the project root), or a path resolving outside the Godot project root — the same guard dbg_set_breakpoints applies. Only meaningful while stopped at a breakpoint.
dbg_data_breakpoints1 of 1 parameter describedSet (replace) data breakpoints — 'watchpoints' that halt when a variable's value changes (DAP dataBreakpointInfo + setDataBreakpoints). Pass `watch` as a list of { name, variables_ref?, access_type? }: each name is resolved to a dataId via dataBreakpointInfo, then every resolvable id is armed in one setDataBreakpoints call. The result reports the armed `breakpoints` (each with its resolved data_id and verified flag) and any `unresolved` variables the adapter cannot watch. Requires a running session; NOT gated (it only configures the debugger). Feature-detected: on an adapter that does not advertise `supportsDataBreakpoints` it returns a clear "unsupported" message without sending any request. Measured: no Godot build this project tests advertises it — 4.3-stable and 4.7-stable both refuse this tool, so on a shipped engine it is unsupported surface today rather than a feature you can reach; see docs/dap_capability_ledger.json.
cs_dbg_launch5 of 5 parameters describedStart a C# Godot game under netcoredbg. `program` defaults to the configured Mono/.NET Godot binary (GODOT_CSHARP_BIN) and `args` to ['--path', <C# project>]; override either to debug a different .NET program. Any breakpoints set beforehand are applied during the handshake. Requires netcoredbg (GODOT_CSDAP_CMD) — absent, the lazy spawn fails with an actionable hint rather than hanging. A launch the adapter rejects (a program that does not exist, or is not a .NET assembly) is reported as an error: it previously answered state 'running' for a session that never started. With `stop_on_entry` the call waits for the entry stop, so it returns state 'stopped' with a usable thread — not 'running'.
cs_dbg_attach1 of 1 parameter describedAttach netcoredbg to an already-running .NET process (e.g. a C# Godot game launched separately) by its OS process id. Any breakpoints set beforehand are applied during the handshake. A process id nothing is running under is refused rather than reported as an attached session; a process owned by another user is a legitimate target and is not refused.
cs_dbg_set_breakpoints3 of 3 parameters describedSet (replace) the breakpoints for a C# source file. Applied immediately if a session is running, else buffered until launch/attach. Feature-detected: the per-line `conditions` modifier is only sent when the connected adapter advertises supportsConditionalBreakpoints (netcoredbg does); on an adapter that advertises it unsupported the modifier is dropped and the result carries `unsupported_modifiers` plus a `warning`. Detection needs a live session, so set conditions after cs_dbg_launch/cs_dbg_attach. A path that names nothing, or names a directory, is refused: it previously answered exactly like a real file. A res:// or relative path that resolves outside the C# project root is refused too; an absolute path elsewhere is legal, because debugging a different .NET program is supported.
cs_dbg_continueno parametersResume execution and wait for the program to settle again (next breakpoint or termination). Returns the resulting state; if it runs on with no further breakpoint, reports state 'running'.
cs_dbg_step1 of 1 parameter describedStep execution: 'over' (next), 'in' (stepIn), or 'out' (stepOut), then wait for the step to land. Returns the resulting state and stop reason.
cs_dbg_stack_trace1 of 1 parameter describedReturn the current C# call stack (only meaningful while stopped at a breakpoint).
cs_dbg_scopes1 of 1 parameter describedReturn the variable scopes (Locals, etc.) for a C# stack frame.
cs_dbg_variables1 of 1 parameter describedList variables under a scope or a complex value (via its variables_ref).
cs_dbg_set_variable4 of 4 parameters describedChange a variable's value in a stopped C# frame (DAP setVariable). DESTRUCTIVE: mutates live program state — confirm with the user and keep this gated. `variables_ref` is the container's variablesReference (from cs_dbg_scopes, or a complex cs_dbg_variables entry), `name` is the variable within it, `value` is the new value as a C# literal/expression. Feature-detected: on an adapter that advertises supportsSetVariable:false it returns a clear "unsupported" message WITHOUT prompting; otherwise a bounded deadline turns a non-answering adapter into a clear message rather than a hang.
cs_dbg_watch4 of 4 parameters describedManage a persistent set of C# watch expressions and evaluate them in the current stopped frame. Pass `add`/`remove`/`clear` to mutate the set (all optional), then every current watch is re-evaluated and returned. Call with no mutation args to just re-read the watches after a step/continue. Expressions are evaluated in DAP `watch` context (intended to be side-effect-free), so this is not gated; the results are only meaningful while the program is stopped at a breakpoint.
cs_dbg_set_exception_breakpoints1 of 1 parameter describedEnable (replace) the debugger's exception breakpoint filters so execution halts when a matching .NET exception is thrown (DAP setExceptionBreakpoints). Pass the filter IDs to enable; call with no filters (or []) to clear them. The result echoes the active filters and lists `available_filters` — the exception filters the connected adapter advertises (netcoredbg exposes `all` for every thrown exception and `user-unhandled`). A filter id the adapter does not advertise is refused by name, listing the real ones, rather than forwarded to the adapter as an opaque failure. Requires a running debug session. Not gated (it only configures the debugger). Feature-detected: on an adapter that advertises no exceptionBreakpointFilters it returns a clear "unsupported" message WITHOUT sending anything.
cs_dbg_restart3 of 3 parameters describedRestart the current C# debug session. Uses the DAP `restart` request when the adapter advertises `supportsRestartRequest`, otherwise falls back to terminate + relaunch — so it works on every adapter (netcoredbg advertises none, so the relaunch path runs). Reuses the last cs_dbg_launch/cs_dbg_attach parameters; pass `stop_on_entry` / `program` / `args` to override them for a launched session. `method` in the result reports which path ran ('restart' = native DAP restart, 'relaunch' = terminate + fresh handshake). Requires a session started with cs_dbg_launch/cs_dbg_attach.
runtime_get_tree2 of 2 parameters describedTraverse the LIVE SceneTree of the running game (name, type, path, visibility, children).
runtime_get_property1 of 3 parameters describedRead a property from a live node (path relative to the current scene; '/root/...' absolute allowed).
runtime_set_property2 of 5 parameters describedSet a property on a live node. DESTRUCTIVE (mutates running game state) — gated by confirmation. Rich types use the {"__type__":...} convention.
runtime_emit_signal2 of 5 parameters describedEmit a signal from a live node. DESTRUCTIVE — gated by confirmation. args must match the arity of the signal's CONNECTED callables, or the emission fails with emit_failed and no handler runs. Argument types are not checked, and a signal with no listeners always succeeds — so emitted:true does not mean a handler ran.
runtime_inject_input2 of 3 parameters describedInject a synthetic input event for automated play-testing. DESTRUCTIVE. event.kind is 'action' | 'key' | 'mouse_button' | 'mouse_motion' | 'joypad_button' | 'joypad_motion' | 'pointer' | 'midi'. key: keycode, physical_keycode and key_label left out are filled from the one given. pointer: action press|move|release|tap|drag at x,y (to_x,to_y) in runtime_screenshot frame pixels. midi: an InputEventMIDI; a pitch_bend's 14-bit value goes in pitch, where Godot stores it. Example: {"kind":"action","action":"jump","pressed":true}.
runtime_get_monitors1 of 2 parameters describedRead live Performance monitors (FPS, draw calls, node count, physics, audio output latency, ...), and the game's own, by the id it registered (Performance.add_custom_monitor). Pass specific keys or omit for all. Keys include time/fps, render/total_draw_calls, audio/output_latency.
runtime_read_state3 of 3 parameters describedRead state the game exposes as JSON: call a function it registered in Engine metadata "breakpoint_state" (name -> Callable, set in its own debug code). Read-only, no confirmation.
runtime_screenshot1 of 1 parameter describedCapture the current game frame as a PNG and return it as image content so the assistant can see the running game.
runtime_screenshot_save2 of 2 parameters describedSave the current game frame as a PNG at a new project path; returns no image, never overwrites. Makes runtime_screenshot_diff's reference.
runtime_audio_capture4 of 4 parameters describedListen to the running game for a few seconds of real time: a capture effect at the end of an audio bus collects what it plays, then it is measured like godot_record's recording (LUFS, peaks, clipping, octave bands, spectrogram).
runtime_get_log3 of 3 parameters describedRead the runtime log ring buffer (entries game code pushed via BreakpointRuntimeBridge.push_log). Use since_seq for incremental reads.
runtime_assert_node_state4 of 4 parameters describedAssert that properties of a LIVE node equal expected values (read-only verification). Reports per-property mismatches; supports an optional absolute numeric tolerance.
runtime_assert_scene_structure2 of 2 parameters describedAssert the LIVE SceneTree matches structural expectations (read-only). Each entry asserts a node exists at a path (and, if given, is of a class via is_class); set absent:true to assert it is NOT present.
runtime_assert_perf4 of 4 parameters describedAssert that live Performance monitors meet a caller-supplied baseline within tolerance (read-only). Capture the baseline earlier with runtime_get_monitors and pass it back inline.
runtime_assert_screen_text6 of 6 parameters describedAssert that on-screen text is present (or absent) by scanning visible Control text in the LIVE scene tree (read-only; no OCR). Sees text on Label / RichTextLabel / Button / LineEdit / TextEdit / CheckBox / LinkButton and similar; does NOT see text drawn directly to the canvas or baked into textures.
runtime_screenshot_diff5 of 5 parameters describedCapture the current frame and compare it to a reference PNG at a project path, returning diff stats and a pass/fail vs tolerance (read-only; the diff is computed engine-side so the host stays dependency-free). Establish the reference first with runtime_screenshot_save.
runtime_await_condition7 of 7 parameters describedPoll a property on a LIVE node until it satisfies a comparison, or a timeout elapses (read-only verification). op is eq | ne | gt | ge | lt | le (the ordered operators require numeric values). Use this to wait for the running game to reach a state before asserting on it — e.g. wait for hp le 0, then runtime_assert_screen_text. An unreachable runtime bridge is retried until the timeout rather than failing on the first poll, so this tool can also be used to wait for a game that is still booting.
runtime_anim_play6 of 6 parameters describedPlay an animation on a LIVE AnimationPlayer node. DESTRUCTIVE (drives the running game) — gated by confirmation. Omit `animation` to (re)play the currently-assigned one.
runtime_anim_stop4 of 4 parameters describedStop (or pause) a LIVE AnimationPlayer node. DESTRUCTIVE (drives the running game) — gated by confirmation. keep_state:true pauses in place; false (default) stops.
runtime_anim_get_state2 of 2 parameters describedRead the playback state of a LIVE AnimationPlayer (read-only): current animation, whether it is playing, position, length, speed scale, and the list of available animations.
runtime_node_add6 of 6 parameters describedAdd a node to the LIVE running game as a child of `parent`. DESTRUCTIVE — gated by confirmation. Provide `scene` (a res:// PackedScene to instantiate) OR `type` (a ClassDB class to instantiate); `name` renames it.
runtime_node_remove3 of 3 parameters describedRemove (queue_free) a node from the LIVE running game. DESTRUCTIVE — gated by confirmation. Refuses to remove the current scene root.
runtime_time_scale3 of 3 parameters describedSet Engine.time_scale on the running game: 0 freezes time, 1 is normal, >1 fast, <1 slow-motion. DESTRUCTIVE (alters the running game's clock) — gated by confirmation. Freeze with scale 0, then runtime_step_frames to advance deterministically before asserting.
runtime_step_frames4 of 4 parameters describedAdvance the running game by an exact number of frames while otherwise frozen, for deterministic, frame-accurate playtesting. DESTRUCTIVE — gated by confirmation. `kind` selects which loop to tick each step: idle (default), physics, or both. Pair with runtime_time_scale{scale:0} to freeze, then assert.
runtime_state_digest4 of 4 parameters describedCapture a compact, stable-ordered JSON snapshot of a live subtree's salient state (read-only) — position, rotation, scale, visibility, and modulate by default, or a caller-supplied field list. Deterministic ordering makes it ideal for frame-by-frame comparison alongside runtime_step_frames.
runtime_seed_rng3 of 3 parameters describedSeed the running game's GLOBAL random number generator (GDScript seed()) so a playtest is reproducible. DESTRUCTIVE (changes RNG state) — gated by confirmation. Seeds only the global RNG (randi/randf), not per-instance RandomNumberGenerators or physics determinism. IMPORTANT when comparing peers: this is ONE stream shared by every caller in the project, and FREEZING DOES NOT STOP IT BEING CONSUMED — time_scale 0 makes delta 0 but _process/_physics_process still fire, so code that draws unconditionally burns draws at wall-clock rate even while frozen, including in the gap between this call and runtime_step_frames. For peers to converge the global stream must be consumed ONLY on frames you are actually stepping: guard draws on delta > 0, and give idle-frame code its own RandomNumberGenerator. Measured on real Godot 4.3 — with both, three peers converge byte-equal even with a deliberate stagger between each peer's seed and step; with either violated, they diverge every time.
runtime_peer_stop3 of 3 parameters describedTerminate a headless peer started by runtime_spawn_peers, or every one with all:true. DESTRUCTIVE (kills a child process). Stopping an already-stopped peer is a no-op, so this is safe to repeat; peers are also killed automatically when the server shuts down.
runtime_peers_digest4 of 4 parameters describedCompare runtime_state_digest across two or more peers over the SAME root and field set (read-only): converged when every peer's digest is byte-equal, otherwise diverged_at names the node paths that disagree. The sequence that converges: runtime_spawn_peers, then per peer runtime_time_scale{scale:0} to FREEZE FIRST, runtime_set_property{peer} to equalise the starting state, runtime_seed_rng{seed} with one seed, runtime_step_frames{frames:K,kind:"physics"}, then this. FOUR PRECONDITIONS, measured on Godot 4.3 (convergence re-measured on 4.7); skip any one and the peers diverge. (1) Step the fixed physics timestep, kind:"physics": idle-frame delta is each process's own wall-clock time and never converges. (2) Draw from the global RNG only on frames you step: runtime_seed_rng seeds one stream shared by the whole project, and freezing does not stop it being drawn (time_scale 0 zeroes delta but callbacks still fire), so unguarded draws burn it while frozen and idle-frame draws burn it during the step. Guard draws on delta > 0 and give idle-frame code its own RandomNumberGenerator. (3) Peers free-run for different times before the freeze, so freeze first, then equalise with runtime_set_property{peer}. (4) Same machine only: nothing is claimed across machines.
godot_output3 of 3 parameters describedRead captured console output for a managed process (from godot_run_managed). Use since_seq for incremental reads.
godot_stop2 of 2 parameters describedTerminate a game started by godot_run_managed or godot_run_project.
project_search6 of 6 parameters describedFull-text (or regex) search across the project's source files (ripgrep-style). Read-only. Returns one match per line with its res:// path, 1-based line and column, and the matching text. Binary and oversized files are skipped; caches (.git/.godot/.import/node_modules) are never searched.
find_symbol4 of 4 parameters describedLocate where GDScript symbols are DECLARED across the project — class_name, inner class, func, signal, enum, const and var. Read-only project index. This is the workspace-symbol answer Godot's language server does not implement (gd_workspace_symbols returns 'unsupported'); for the semantic, position-based lookup on a single build use gd_definition instead.
find_usages4 of 4 parameters describedFind every word-boundary occurrence of an identifier across the project's source files. Read-only. The project-wide, build-independent complement to gd_references (which needs the live language server and a cursor position). Returns res:// path, 1-based line/column and the line text for each hit.
example_snippet2 of 2 parameters describedReturn curated, ready-to-adapt GDScript snippets for common Godot tasks (signals, autoload singletons, input, tweens, timers, scene changes, saving, RNG, groups, state machines, HTTP, @onready). Read-only. Omit the query to list every available topic id.
godot_record6 of 6 parameters describedRun the project (or one scene) under Godot's Movie Maker: frames and sound advance in exact lockstep at a fixed frame rate, so a recording does not depend on the machine's speed. Then measure the sound — loudness (LUFS), sample and true peak, clipping, octave bands — and return a spectrogram picture. Opens a game window for the run. The WAV stays in the project for audio_analyze.
audio_analyze2 of 2 parameters describedMeasure a WAV file in the project: loudness (LUFS), sample and true peak, clipping, octave bands, and a spectrogram picture. With compare_to, also report this file minus that one, metric by metric and band by band.
vcs_statusno parametersWorking-tree status of the project's git repository, every path project-relative. Changes elsewhere in the repository are listed separately in `outside_project`. Read-only; errors clearly if the project path is not a git work tree.
vcs_log2 of 2 parameters describedRecent commits, newest first: full and short hash, author, ISO author date, and subject. Recent commits, newest first. Optionally limit to commits touching a path (res:// or project-relative); a path matching nothing is refused, not answered empty. Read-only.
vcs_diff2 of 2 parameters describedUnified diff of the working tree (default) or the staged index (staged=true), optionally scoped to a single path (res:// or project-relative). Returns the patch (tail-truncated) plus the changed-file list, both project-relative. A path matching nothing is refused, not answered empty. Read-only.
vcs_show2 of 2 parameters describedInspect a commit or a file at a revision. With no path: commit metadata (hash, author, date, subject, body) plus its patch (tail-truncated). With a path: the file's full content at that ref. `ref` defaults to HEAD and accepts any revision (branch, tag, sha, HEAD~2). Read-only.
vcs_branch_list1 of 1 parameter describedList branches with their short object name and a flag for the current branch. Local only by default; set remotes=true to include remote-tracking branches (flagged remote=true). On a detached HEAD, `current` is null and `detached` is true — matching vcs_status — and no pseudo-branch is listed. Read-only.
vcs_blame3 of 3 parameters describedPer-line last-change attribution for a file: for each line, the short commit, author, ISO date, and the line text. Optionally restrict to a [start,end] line range (1-based, inclusive); either bound may be given alone (start alone runs to end-of-file). Read-only.
vcs_add1 of 1 parameter describedStage changes for the next commit. With `paths`, stages exactly those (res:// or project-relative); omit `paths` to stage everything (git add -A). Returns the resulting staged file list. Reversible with vcs_restore-staged / `git restore --staged`, so not gated.
vcs_commit1 of 1 parameter describedCommit the currently staged changes with a message. Reversible (`git reset --soft HEAD~1`) and loses nothing, so not gated. Errors clearly if nothing is staged. Commit signing is disabled for this call so it can never block on a passphrase prompt.
vcs_restore2 of 2 parameters describedDiscard uncommitted working-tree changes to the given paths, restoring them from the index/HEAD (`git restore -- <paths>`). DESTRUCTIVE — the discarded edits are unrecoverable — so it is elicitation-gated: pass confirm:true to bypass the prompt on clients that can't elicit. `restored` is MEASURED, not echoed: it lists only the paths git actually changed, so a path with nothing to discard is absent from it rather than reported as discarded work. `requested` carries what you asked for, and `stranded` names any path still dirty afterwards (a partial, not an error).
vcs_stash4 of 4 parameters describedManage stashes: op='push' saves and reverts your working changes (optional message); 'pop' re-applies the latest stash; 'list' returns the stash entries; 'drop' deletes a stash entry. 'push' and 'drop' are destructive and elicitation-gated (confirm:true bypasses) — push reverts every uncommitted change in the working tree, and drop deletes an entry unrecoverably; pop and list are not gated. op='push' ERRORS when nothing was stashed (no tracked file has uncommitted changes) rather than reporting success — a success there would tell you work is parked when it is not. Untracked files are never stashed.
vcs_branch_create3 of 3 parameters describedCreate a new branch, optionally starting from a given ref (default HEAD), and optionally switch to it. Reversible (`git branch -d`), so not gated. Errors clearly if the branch already exists. If switch=true and the switch is refused (e.g. local changes would be overwritten), the error SAYS the branch was still created — create and switch are two git calls and only the second can fail.
vcs_switch1 of 1 parameter describedSwitch to an existing branch (`git switch <branch>`). No --force: if local changes would be overwritten, git refuses and its message is returned unchanged — nothing is clobbered — so this is not gated.
asset_gen_placeholder9 of 9 parameters describedWrite a deterministic, in-engine PROCEDURAL placeholder asset to a res:// path — no model, fully reproducible (colour/frequency/size derive from a hash of the prompt). Always available regardless of the configured backend. kind picks the asset (all native .tres resources that load synchronously): sprite/texture/icon → an ImageTexture; audio_sfx → an AudioStreamWAV; model → a BoxMesh/primitive mesh. DESTRUCTIVE (writes a file) — gated by confirmation.
mp_add_spawner4 of 4 parameters describedAdd a MultiplayerSpawner node under a parent (undoable). Godot 4 high-level multiplayer replicates server-spawned nodes to clients: set spawn_path to the node whose children are auto-replicated, and register the scenes it may spawn. Pure node authoring — no service is started.
mp_add_synchronizer5 of 5 parameters describedAdd a MultiplayerSynchronizer node under a parent (undoable) and, if properties are given, build a SceneReplicationConfig that replicates them. root_path is the node the property NodePaths are relative to (default "..", the synchronizer's parent). Property paths look like ".:position" or "Sprite2D:rotation". Pure node authoring — no service is started.
mp_set_authority3 of 3 parameters describedSet a node's multiplayer authority (set_multiplayer_authority) to a peer id (undoable). The authority peer is the one allowed to push "authority"-mode RPCs and MultiplayerSynchronizer state for that node. peer_id 1 is the server. Pure node authoring.
mp_setup_enet_peer6 of 6 parameters describedGenerate a GDScript helper that sets up an ENetMultiplayerPeer (host_game / join_game / close) and assigns multiplayer.multiplayer_peer. Godot's default, always-available transport. DESTRUCTIVE (writes a .gd file) — gated by confirmation. No service is started; you call host_game()/join_game() at runtime.
mp_setup_webrtc_peer4 of 4 parameters describedGenerate a GDScript helper that sets up a WebRTCMultiplayerPeer mesh and assigns multiplayer.multiplayer_peer. FEATURE-DETECTED: if the WebRTC module/extension is absent from this Godot build, the tool degrades to a clear "unsupported" result and writes nothing (never a dead call). DESTRUCTIVE (writes a .gd file) — gated by confirmation.
mp_wire_rpc7 of 7 parameters describedInsert (or replace) an `@rpc(...)` annotation above a function in an existing GDScript, so it can be called across the network. If the function does not exist, a stub is appended carrying the annotation. Operates on the on-disk file (save the script in the editor first if it has unsaved changes). DESTRUCTIVE (rewrites the .gd file) — gated.
mp_scaffold_lobby6 of 6 parameters describedGenerate a lobby controller GDScript: host/join over ENet plus peer_connected/peer_disconnected tracking with player_joined / player_left / server_started / join_succeeded / join_failed signals. Attach it to your lobby scene root. DESTRUCTIVE (writes a .gd file) — gated by confirmation. No service is started.
backend_detect1 of 1 parameter describedReport which of the known game-backend SDKs (SilentWolf, Nakama, PlayFab, Photon) are installed in this project and how each was found (an enabled autoload, an addon directory under res://addons, or a global class_name). Read-only — nothing is written. Use it before backend_configure / *_scaffold to see what you can generate against.
backend_configure12 of 12 parameters describedGenerate a config/bootstrap GDScript for a game-backend SDK (SilentWolf / Nakama / PlayFab / Photon): a Node whose configure() wires the API key / game id / host / title id from constants you fill in. Register it as an autoload so it runs at startup. FEATURE-DETECTED: if the SDK is not installed, degrades to a clear 'install <SDK> first' result and writes nothing. DESTRUCTIVE (writes a .gd file) — gated by confirmation.
leaderboard_scaffold5 of 5 parameters describedGenerate submit/fetch leaderboard helpers against an installed backend SDK. FEATURE-DETECTED both ways: if the SDK provides no leaderboard API (Photon is realtime transport), degrades to 'unsupported_feature'; if the SDK is not installed, degrades to 'install <SDK> first'. Neither writes anything. DESTRUCTIVE (writes a .gd) — gated.
cloudsave_scaffold4 of 4 parameters describedGenerate save/load cloud-save helpers against an installed backend SDK. FEATURE-DETECTED both ways: if the SDK provides no cloud-save API (Photon is realtime transport), degrades to 'unsupported_feature'; if the SDK is not installed, degrades to 'install <SDK> first'. Neither writes anything. DESTRUCTIVE (writes a .gd) — gated.
auth_scaffold4 of 4 parameters describedGenerate login/register/logout helpers against an installed backend SDK. FEATURE-DETECTED both ways: if the SDK provides no auth API (Photon is realtime transport), degrades to 'unsupported_feature'; if the SDK is not installed, degrades to 'install <SDK> first'. Neither writes anything. DESTRUCTIVE (writes a .gd) — gated.
card_template_create11 of 11 parameters describedBuild a reusable card scene (a PackedScene) from a slot spec, with a generated script-backed set_data() / set_face(). Named slots (label / rich_text / texture / panel / badge) become the card's regions; card_instance and card_deck_from_table bind data to them by slot name. Optional inline theme and a two-sided card back. DESTRUCTIVE (writes a scene + script) — gated by confirmation. Puts the editor back on the scene you had open; `edited_scene` names where it landed.
card_instance7 of 7 parameters describedInstance a card template into the open scene and bind data to its slots via the template's set_data(). Undoable node authoring. Slot values are strings/numbers/booleans; any texture slot (e.g. art) takes a res:// texture path. Reports which data keys bound and which had no matching slot.
card_hand_layout11 of 11 parameters describedInstance N cards under a container and arrange them as a row, fan, stack, or grid. Undoable node authoring. Each card carries its own data (bound via the template's set_data) and face state.
card_deck_from_table11 of 11 parameters describedRead a CSV or JSON table and stamp one card per row, binding columns to slots via a column map. Undoable node authoring. column_map values are bare {column} references or composed templates like "{name} · {role}"; a filter selects rows and an optional layout arranges them. Table columns no slot referenced are surfaced (not silently dropped).
card_set_face4 of 4 parameters describedFlip an instanced card (or any node exposing set_face(bool) — the generated card and piece scripts both do) between its face and back. Instant by default: calls the setter now, so the visible side changes immediately. With `animate`, instead authors a reusable flip clip under the node from Group C anim primitives — a scale pinch (1 → edge-on → 1) plus a method key that calls the setter at the edge-on midpoint — played on demand; purely additive (only existing node.* / anim.* ops, never a new engine call). Undoable node authoring. Returns the target state and any authored player / anim.
board_create8 of 8 parameters describedBuild a board scene whose children are addressable cells (each a cell_<id> node in the board_cells group) from a ring, grid, or explicit-cells layout. Cells are Marker2D (or Control) anchors positioned by pure layout math; an optional background (color or res:// art) sits behind them. General-purpose — cells carry only caller-supplied ids. DESTRUCTIVE (writes a scene) — gated by confirmation. Puts the editor back on the scene you had open; `edited_scene` names where it landed.
board_place4 of 4 parameters describedReparent an existing node (a card or piece instance) onto a board cell by id and snap it to the cell anchor. Undoable node authoring. The target cell is <board>/cell_<cell>; `align` offsets the node from the cell origin (default centred). Returns the node's new path.
board_tile_create9 of 9 parameters describedBuild a tile-backed board scene: a TileMapLayer grid whose cells are addressable by integer [x, y] tile coordinates (cols wide × rows tall). The layer binds a TileSet — a supplied `tileset` .tres, or a fresh empty one created at <scene>_tiles.tres — so it has a real tile_size (the coordinate frame placement uses); `paint` optionally fills the whole grid with one tile from the bound tileset. General-purpose — cells carry only coordinates. DESTRUCTIVE (writes a scene, and a TileSet .tres unless `tileset` is supplied) — gated by confirmation. Puts the editor back on the scene you had open; `edited_scene` names where it landed.
board_tile_place7 of 7 parameters describedSnap an existing node (a card or piece instance) onto a TileMapLayer cell by integer [x, y] tile coordinate. Undoable node authoring. The cell's local position is computed from `tile_size` — centre `(coord + 0.5) × tile_size` (default) or corner `coord × tile_size` — matching Godot's TileMapLayer.map_to_local, plus an optional `align` offset. Decomposes onto node.reparent + node.set_property. Returns the node's new path and local position.
piece_template_create12 of 12 parameters describedBuild a reusable piece (token) scene from a spec: an Art node (Sprite2D under a Node2D root, TextureRect under a Control root), an optional Label, an optional hit area (Area2D + CollisionShape2D), and an optional two-sided Back, plus a generated script-backed set_data() / set_face(). set_data binds art / color / label; set_face flips face/back visibility. DESTRUCTIVE (writes a scene + script) — gated by confirmation. Puts the editor back on the scene you had open; `edited_scene` names where it landed.
piece_instance8 of 8 parameters describedInstance a piece template into the open scene and bind data (art / color / label) via the template's set_data(). Undoable node authoring. Optionally place_on a board cell in the same call (reparent + snap via board_place). Reports which data keys bound and which had no matching slot.
piece_move6 of 6 parameters describedMove a piece onto a board cell by id (reparent + snap via board_place), optionally with a short scale "pop" animation authored from Group C anim primitives. Undoable node authoring; purely additive — it emits only existing node / anim ops, never a new engine call. Returns the piece's new path.
interact_make_draggable9 of 9 parameters describedWire an existing node for drag-and-drop by attaching a generated reusable drag script (and, for node2d, a drag input action + a hit-area input_event connection). COMPOSES with the node's existing script: if it already has one, the drag script `extends` it, so an authored card keeps its set_data/set_face and merely gains drag (never overwritten). control mode uses Godot's built-in Control drag-and-drop (_get_drag_data hands off {payload, source}, with an optional translucent preview); node2d mode carries the payload and follows the pointer from a button-driven handler. General-purpose — the drag carries a caller-supplied neutral payload Dictionary, written as a per-node @export so one script serves many draggables. Decomposes onto node.get_property → resource.create → node.set_property (script + payload) (+ inputmap.add_action / add_event / signal.connect for node2d). DESTRUCTIVE (writes a script) — gated by confirmation.
interact_add_drop_zone9 of 9 parameters describedMark a node as a drop target that validates an incoming payload and emits a signal on a valid drop. Attaches a generated validator/acceptor script that DECLARES the on_drop signal (so it survives a scene reload), and (for node2d) builds an Area2D + CollisionShape2D hit region; optionally connects on_drop to a handler with a persisted connection. accepts is the neutral predicate {key, values} — accept any payload when omitted, else accept when payload[key] is one of values. control mode overrides _can_drop_data / _drop_data; node2d exposes a try_drop(payload) seam. General-purpose — no domain vocabulary. Decomposes onto (node.add + resource.create + node.set_property for node2d) → resource.create → node.set_property (+ a persisted signal.connect). DESTRUCTIVE (writes a script) — gated by confirmation.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.