scene_open
Open a .tscn scene file in the Godot editor. Reload from disk to discard unsaved edits, with confirmation after the scene switch.
Instructions
Open an existing scene file (.tscn) in the editor.
If path is already the currently edited scene this is a no-op
— the in-memory state (including any unsaved MCP mutations) is
preserved. Pass force_reload=True when the file on disk is the
authority and the editor should discard the open in-memory copy and
re-read the scene from disk.
The reply is sent only after the editor has actually switched to the
requested scene (switched: true), so follow-up writes are safe
immediately. switched: false with settle: "timeout" means the
switch had not landed within the wait window. In synchronous contexts
(e.g. inside batch_execute) the reply returns immediately with
switched: false and settle: "not_waited". In both of those
cases, re-check editor_state before issuing follow-up writes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | File path of the scene to open (e.g. "res://main.tscn"). | |
| session_id | No | Optional Godot session to target. Empty = active session. | |
| force_reload | No | Re-read the scene from disk even when it is already open. This discards unsaved in-memory edits to that scene. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||