High-risk tools in Breakpoint

Attach 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 hands...

Resume 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 ...

Start 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...

Restart the current C# debug session. Uses the DAP `restart` request when the adapter advertises `supportsRestartRequest`, otherwise falls back to terminate + relaunch — so it w...

Set (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` m...

Enable (replace) the debugger's exception breakpoint filters so execution halts when a matching .NET exception is thrown (DAP setExceptionBreakpoints). Pass the filter IDs to en...

Change 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 co...

Step execution: 'over' (next), 'in' (stepIn), or 'out' (stepOut), then wait for the step to land. Returns the resulting state and stop reason.

Attach to an already-running Godot debug session.

Resume 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 ...

Set (replace) data breakpoints — 'watchpoints' that halt when a variable's value changes (DAP dataBreakpointInfo + setDataBreakpoints). Pass `watch` as a list of { name, variabl...

Move 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;...

Start the game under the debugger. scene may be 'main', 'current', or a res:// scene path. Any breakpoints set beforehand are applied during the handshake. Refuses if the runtim...

Restart the current debug session. Uses the DAP `restart` request when the adapter advertises `supportsRestartRequest`, otherwise falls back to terminate + relaunch — so it work...

Enable (replace) the debugger's exception breakpoint filters so execution halts when a matching error/exception is thrown (DAP setExceptionBreakpoints). Pass the filter IDs to e...

Change 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 conta...

Step 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 o...

Trigger an editor rescan of the project filesystem so newly added or externally-changed files are picked up. Read-only side effect.

Headless export using an export preset. Runs to completion and returns exit code + logs. Can be slow — exposed as an MCP task, so task-aware clients can poll, await, or cancel i...

Headless (re)import of project assets. Runs to completion and returns exit code + logs. Exposed as an MCP task (poll/await/cancel via tasks/get, tasks/result, tasks/cancel).

Open the Godot editor for the configured project (detached). Needed before any editor_* bridge tool can be used.

Run the project (detached). Optionally start from a specific scene path (res://...). Returns the process id. Refuses if the runtime bridge port is already bound — the new game c...

Terminate a managed process started by godot_run_managed.

Play an animation on a LIVE AnimationPlayer node. DESTRUCTIVE (drives the running game) — gated by confirmation. Omit `animation` to (re)play the currently-assigned one.

Stop (or pause) a LIVE AnimationPlayer node. DESTRUCTIVE (drives the running game) — gated by confirmation. keep_state:true pauses in place; false (default) stops.

Emit a signal from a live node. DESTRUCTIVE — gated by confirmation.

Inject a synthetic input event for automated play-testing. DESTRUCTIVE. event.kind is 'action' | 'key' | 'mouse_button' | 'mouse_motion'. Example: {"kind":"action","action":"jum...

Add 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...

Seed 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 g...

Advance the running game by an exact number of frames while otherwise frozen, for deterministic, frame-accurate playtesting. DESTRUCTIVE — gated by confirmation. `kind` selects ...

Set 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 wi...

Emit 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 conv...

Switch 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...