scene_open
Opens an existing .tscn scene in the Godot editor and confirms the switch before returning. Use force_reload to discard unsaved in-memory changes and re-read from disk.
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 | |||