Skip to content

Godot Agent Loop 1.0.0

Choose a tag to compare

@beremaran beremaran released this 14 Jul 15:27
· 98 commits to main since this release
v1.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.0

The 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 through godot_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.