godot-gamestudio-22d18f— plugin

<p align="center"> <img src="docs/assets/brand/godot-gamestudio-hero.png" alt="Godot Gamestudio: a supervised AI production room for Godot games" width="100%"> </p>

<h1 align="center">Godot Gamestudio</h1>

<p align="center"><strong>Give your coding agent a game studio, not a longer prompt.</strong></p>

<p align="center"> Build Godot milestones with automatically selected specialists, independent reviewers,<br> runtime QA, resumable state, and evidence-gated approval. </p>

<p align="center"> <a href="https://github.com/schmoenraad/godot-gamestudio/actions/workflows/ci.yml"><img src="https://github.com/schmoenraad/godot-gamestudio/actions/workflows/ci.yml/badge.svg" alt="CI"></a> <a href="https://github.com/schmoenraad/godot-gamestudio/releases/latest"><img src="https://img.shields.io/github/v/release/schmoenraad/godot-gamestudio?color=5ac8fa" alt="Latest release"></a> <a href="LICENSE"><img src="https://img.shields.io/github/license/schmoenraad/godot-gamestudio" alt="Apache-2.0 license"></a> <img src="https://img.shields.io/badge/Godot-4.x-478CBF?logo=godot-engine&logoColor=white" alt="Godot 4.x"> <img src="https://img.shields.io/badge/skills-19-8b5cf6" alt="19 agent skills"> </p>

<p align="center"> <a href="#install">Install</a> · <a href="#see-the-loop">See the loop</a> · <a href="#pilot-evidence">Pilot evidence</a> · <a href="https://github.com/schmoenraad/godot-gamestudio/discussions">Discussions</a> · <a href="https://github.com/schmoenraad/godot-gamestudio/issues/new?template=benchmark_submission.yml">Submit a benchmark</a> </p>

Why It Exists

Coding agents are good at making Godot changes. They are less reliable at knowing whether those changes actually work.

Godot Gamestudio adds a production loop around the agent:

• A Supervisor turns your request into one measurable milestone.
• The smallest useful set of specialists owns non-overlapping deliverables.
• An independent reviewer challenges each artifact without seeing maker reasoning.
• QA runs Godot and records fresh project-relative evidence.
• The milestone cannot pass with stale screenshots, missing files, inconclusive checks, or approvals for an older revision.

It works with ordinary Godot commands and optionally uses GodotIQ when available.

Try It

$godot-gamestudio build Create a playable top-down quest with one NPC,
one branching choice, a small tilemap, and a verified completion state.

The studio can select Narrative Designer, World Builder, Gameplay Engineer, their independent reviewers, a Creative Director for cross-discipline coherence, and QA. Simple requests use a smaller team.

See The Loop

flowchart LR
    U["Your milestone"] --> S["Studio Supervisor"]
    S --> I["Inspect project"]
    I --> T["Select smallest team"]
    T --> M["Specialist maker"]
    M --> R["Independent reviewer"]
    R -->|changes| M
    R -->|approved revision| Q["Godot QA"]
    Q -->|fresh evidence| G{"Acceptance gate"}
    G -->|pass| P["Verified milestone"]
    G -->|fail or inconclusive| M

Install

Codex

codex plugin marketplace add schmoenraad/godot-gamestudio
codex plugin add godot-gamestudio@godot-gamestudio

Claude Code

/plugin marketplace add schmoenraad/godot-gamestudio
/plugin install godot-gamestudio@godot-gamestudio

Gemini CLI

gemini extensions install https://github.com/schmoenraad/godot-gamestudio

Kimi Code CLI

/plugins install https://github.com/schmoenraad/godot-gamestudio
/reload

Then invoke godot-gamestudio using the syntax supported by your harness. Claude skills are namespaced, for example /godot-gamestudio:godot-gamestudio build ....

Studio Modes

Included Roles

Makers: Game Designer, Narrative Designer, World Builder, Sprite Studio, Gameplay Engineer, Technical Artist, UI/UX Designer, and Audio Designer.

Reviewers: Systems Critic, Narrative Editor, Level Design Reviewer, Animation Reviewer, Code Reviewer, Art Consistency Reviewer, UI Accessibility Reviewer, and Performance Reviewer.

Coordination and proof: Studio Supervisor, Creative Director, and QA Playtester.

Pilot Evidence

The first executable pilot tested clean-workspace routing and a visual Godot creation fixture. It is an engineering pilot with n=1, not a statistically significant quality claim.

The important result is the last row: both Gemini runs claimed successful screenshots, but the external grader deleted the expected image, reran Godot, and found no fresh PNG. Gamestudio records that as a failure instead of accepting a confident completion message.

<table> <tr> <th>No-skill Codex fixture</th> <th>Godot Gamestudio fixture</th> </tr> <tr> <td><img src="docs/assets/benchmarks/2026-06-14/codex-baseline-visual-hud.png" alt="No-skill Codex visual fixture" width="480"></td> <td><img src="docs/assets/benchmarks/2026-06-14/codex-community-visual-hud.png" alt="Godot Gamestudio Codex visual fixture" width="480"></td> </tr> </table>

Read the full pilot report, its machine-readable results, and the evaluation plan.

Help Make It Better

This project should improve through public evidence, not leaderboard theater.

• Star the repository if you want a reliable open Godot agent workflow to keep growing.
• Submit a reproducible benchmark from a 2D or 3D Godot project.
• Open a discussion with a workflow, role, or Pro automation idea.
• Pick up a good first issue or read CONTRIBUTING.md.

The complete correctness loop remains open source. A future Pro edition may automate visual regression, videos, CI reports, dashboards, and supported integrations without withholding the Community safety gates. See product direction.

Honest Limitations

• The published benchmark is still small and does not prove universal model-quality gains.
• Agent dispatch capabilities differ by harness; Kimi maps roles onto its built-in subagents.
• Visual QA still depends on available rendering and capture tools. Missing verification is inconclusive, never a pass.
• GodotIQ is optional and not bundled. Community operation works without MCP integrations.

Development

python3 scripts/generate_adapters.py --check
python3 -m unittest discover -s tests -v
python3 scripts/validate_repo.py
python3 scripts/build_release.py

Godot Gamestudio is Apache-2.0 licensed. The repository consolidates compatible lessons and workflows from several public Godot and agent projects into one supervised toolkit; SOURCES.md and NOTICE record what was bundled, independently adapted, or used as an integration reference.