Godot Agent Loop 1.0.0
Godot Agent Loop 1.0.0
Build it. Play it. Prove it.
Godot Agent Loop 1.0 is the first release under the independent product
identity. It turns the inherited Godot MCP server into one tested feedback loop
for agents to author, run, observe, playtest, and independently verify games.
Install
claude mcp add godot-agent-loop -- npx -y @beremaran/godot-agent-loop@1.0.0The npm package remains sufficient by itself. The optional Godot Agent Loop
Bridge AssetLib addon adds a persistent editor dock with authenticated status,
bounded live activity, compatibility diagnostics, setup help, and a human
Pause/Resume control.
Proof
- 167/167 tools exercised through the complete MCP-to-Godot path.
- 358 traced public actions and a zero-gap generated Godot 4.7 engine audit.
- 201 full-path E2E tests on the primary Godot 4.7 candidate.
- Godot 4.4.1 compatibility-floor acceptance for the persistent addon.
- A 39-tool default surface, 81.56% smaller by schema bytes, with specialized
tools available throughgodot_tools. - A real cold Claude Sonnet 5 run built and proved PLAYING/WIN/LOSE from an
empty directory in 391.795 seconds, using 103 MCP calls, zero built-in tool
calls, and zero human corrections.
Watch the 65-second launch proof
or inspect the exact prompt, project, measurements, and replay.
Highlights
- One client-neutral
agent-plugin/bundle carries the MCP configuration and
canonical build, debug, verify, and ship workflows to Claude Code, Codex,
OpenCode, and Pi. - The compact tool surface teaches the author → validate → run → observe →
playtest → assert → refine loop and progressively discloses specialized tools. - Persistent and transient editor addons negotiate an authenticated protocol;
user-managed addons are never overwritten or removed. - Project ownership, crash recovery, stale transient recovery, and exact cleanup
are covered across repetition, partial failure, concurrent edits, graceful
shutdown, and SIGKILL. - Input-map repeated keys and autoload-aware script validation now have direct
engine and full-path regression coverage. - C# project support, script diagnostics, project testing, import/addon
integrity, export readiness, and deterministic verification workflows ship in
the same release.
Security and support boundary
Runtime and editor transports bind to loopback and MCP-owned sessions use fresh
secrets. Reflection, code execution, and networking privilege groups are denied
by default. Payloads and retained logs are bounded and redacted. The human
editor pause refuses mutation before dispatch while leaving inspection
available.
Godot 4.4 is the compatibility floor and 4.7 is the primary target. Headed
editor/rendering depth is verified on Linux; Windows and macOS follow the
documented portable acceptance path. The release does not claim unbounded engine
control, debugger automation, or native-extension build automation.
Identity and lineage
The package is now @beremaran/godot-agent-loop, the binary is
godot-agent-loop, and the MCP Registry name is
io.github.beremaran/godot-agent-loop. This is a new 1.0 product identity, not a
claim that the underlying history began here.
Godot Agent Loop preserves the complete Git history and MIT notices of Solomon
Elias's original Coding-Solo/godot-mcp
and Tugcan Topaloglu's inherited
tugcantopaloglu/godot-mcp.