project_manage
Manage Godot project runs and settings: stop running projects, read/write project.godot keys, set main scene, apply display presets, and retrieve project metadata.
Instructions
Project run/stop and project.godot settings.
Resource form: godot://project/info and godot://project/settings
— prefer for active-session reads.
Ops:
• stop()
Stop the running project (game). Takes no params — call as
project_manage(op="stop") or with params={}. Idempotent:
succeeds with was_running=false if the project isn't running.
Do NOT pass extra fields like force or reason inside
params — only the registered keys are accepted (here, none).
For multi-editor setups, pass session_id as a sibling of
op/params, not inside params.
• settings_get(key)
Read a ProjectSettings key (e.g. "application/config/name").
• settings_set(key, value)
Write a ProjectSettings key and persist to project.godot.
Refuses the startup-execution keys (autoload/*,
editor_plugins/*, application/run/main_scene,
editor/run/main_run_args, editor/script/templates_search_path);
use set_main_scene / autoload_manage(op="add") for the two
that have a validated route.
• set_main_scene(path)
Set the project's main scene — the scene project_run(mode="main")
boots and the engine loads at startup. Writes
application/run/main_scene and persists to project.godot. path
must be a res:// scene inside the project that already exists and
loads as a PackedScene, so a scaffolded project can be made runnable
without opening the generic startup-execution surface.
• apply_preset(preset="pixel_art_2d", viewport_width=None, viewport_height=None)
Configure project display resolution, stretch modes, and texture filtering
in one atomic operation.
Presets: 'pixel_art_2d' (320x180 viewport stretch, nearest filter),
'hd_2d' (1920x1080 canvas_items stretch, linear filter),
'low_poly_3d' (1280x720 canvas_items expand, FXAA),
'cinematic_3d' (1920x1080 canvas_items expand, 4x MSAA, FXAA, TAA).
get_info() Retrieve comprehensive project metadata: Godot version, project name, project path, display settings, rendering settings, active scenes, and registered autoloads.
get_map(max_files=180) Compact, read-only map of scenes, scripts, assets, resources, autoloads, input actions and open scenes. Results are capped and mark truncation.
Canonical call shape: {"op": "<verb>", "params": {...}}. Flat op parameters are accepted as a compatibility alias when the client transmits them; op and session_id remain top-level.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| op | Yes | ||
| params | No | ||
| session_id | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||