Godot Agent Loop 2.0.0
Godot Agent Loop 2.0.0 is the lean feedback loop: author files, validate,
run, observe, interact, assert. The tool surface drops from 173 tools to 64 —
109 tools are removed and the advertised core is a reviewed 20-tool surface.
BREAKING: lean tool-surface reduction
- The catalog shrinks from 173 to 64 tools; 109 are removed: 70 subsystem
runtime wrappers (UI, audio, physics, terrain, GI, animation, networking,
and similar), 38 project file/authoring/settings/CI tools, and the
deprecatedgodot_toolsalias. - The advertised
coresurface is now 20 tools, grouped by role:
catalog/call (godot_catalog,godot_call), lifecycle (run_project,
stop_project,get_debug_output,get_project_info,get_godot_version),
observation (game_screenshot,game_get_scene_tree,game_get_ui,
game_get_node_info,game_get_errors,game_get_logs), interaction and
verification (game_scenario,game_wait_until,validate_scripts,
run_project_tests,verify_project), and editor session/transaction
(editor_session,editor_transaction). - The remaining 44 tools stay available as hidden tools reachable through
godot_catalog+godot_call: input primitives, privileged generics, node
generics, and ship tooling. GODOT_MCP_AUTHORING_MODEandbenchmark:loopare removed. Clients that
still callgodot_toolsreceive an unknown-tool error and must switch to
godot_catalog/godot_call.
Migration
- Author
.gd/.tscn/.tres/project.godotwith the coding agent's own
file tools; useeditor_transactionin watched mode for editor-native edits. - Reach the 44 hidden tools via
godot_catalog+godot_call. - Opted-in agents use the privileged
reflection/code-executiongenerics in
place of the deleted subsystem runtime wrappers. - The previously prepared but never tagged
1.2.0work (editor-bridge routing
of project.godot mutations) ships in this release; the settings-tools routing
described in the1.2.0notes was removed by the reduction.
Verification
51 unit tests and 23 e2e tests pass on Godot 4.7. Protocol conformance is 5/5
for the 20 advertised tools. The core surface is 32,787 bytes / ~8,197
estimated tokens, a 92.39% reduction against the full 64-tool surface.
Install
npx -y @beremaran/godot-agent-loop@2.0.0Users of 1.1.6 should update their pinned agent adapter or MCP command to
2.0.0.