godot-4

name	godot-4
description	Work inside a Godot 4.x project: find the engine, read project.godot, edit scenes and GDScript/C#, verify headless after every change, playtest windowed, export. Use whenever the project has project.godot or the owner mentions Godot, GDScript, .tscn, autoloads, GUT or gdUnit4.
version	1.0.0
author	Remedy
tags	["game","godot","gdscript","engine","headless","export"]
requires	[]
tools	["game_project_info","godot_run","godot_check","godot_export","godot_import","game_playtest","local_discover","bash_exec","file_read","file_write","file_edit","repo_search","list_dir","computer_screenshot","skill_activate"]
triggers	["\\b(godot|gdscript|\\.tscn|\\.gd\\b|autoload|gdunit|gut\\b)\\b","\\b(export templates?|scene tree|project\\.godot|\\.tres|\\.godot/)\\b"]
local	{"binaries":[{"id":"godot","names":"[Truncated]","env":"[Truncated]"}]}

Godot 4 (engine loop)

Godot 4.x only. GDScript 2 syntax. If project.godot says config_version=4 or config/features lacks "4.x", stop and tell the owner it is a Godot 3 project — do not mix idioms.

Decision tree (start here)

1. game_project_info(path) → engine name/version, language, binary, verify command. If it reports no binary: try local_discover, GODOT / GODOT4_BIN env, godot* on PATH, a Godot*.exe in the project root (prefer *_console.exe on Windows). Still nothing → ask: "tell me where Godot is" and move on. Never start a setup wizard.
2. file_read project.godot: main scene (run/main_scene), autoloads, input map, window size/stretch, rendering method, physics layer names.
3. Work in scenes (.tscn, text) + scripts (.gd). Prefer editing .gd over hand-editing .tscn; when you must touch .tscn, keep load_steps, [ext_resource] ids and uid:// values intact.
4. Verify after every change (hard rule):
   • godot_check(paths=[edited .gd/.tscn]) → parse errors, missing refs.
   • Smoke: godot_run(path, script="tools/smoke_boot.gd", headless=True) and require SMOKE OK in stdout. No smoke script yet → create it (below) before the first edit. Fallback: godot_run(headless=True, quit_after=1) — weaker, prints only script/load errors.
5. Playtest: godot_run(path, headless=False) (auto-backgrounded) then game_playtest(pid, seconds, interval, keys, question) or computer_screenshot. Read the engine log for SCRIPT ERROR, E 0:00.
6. Export: godot_export(list=True) → pick preset → godot_export(preset, output, debug=False). Templates missing → tell the owner to install them from Editor → Manage Export Templates; you cannot download them silently.

Read references/INDEX.md and pull what you need with file_read.

Canonical smoke script —