godot-ai-builder

AI Game Builder

A Claude Code plugin that generates playable Godot 4 games from natural language prompts.

How It Works

You (natural language prompts)
    |
Claude Code + AI Game Builder plugin
    |                         |
Writes .gd/.tscn          MCP Server (godot-bridge)
directly to disk               |
    |                    Godot Editor Plugin (HTTP on port 6100)
    |                         |
Godot auto-reloads      Run / Stop / Get Errors

Claude Code is the brain. The plugin gives it 14 specialized game development skills, 28 MCP tools for deep editor integration, and a Stop hook that keeps it focused until the build is complete.

Install

Step 1: Install the Claude Code plugin

# Option A — Load directly (for development/testing)
claude --plugin-dir /path/to/godot-ai-builder

# Option B — Install from marketplace
/plugin marketplace add https://github.com/HubDev-AI/godot-ai-builder
/plugin install godot-ai-builder

Step 2: Set up the Godot editor plugin

cd /path/to/godot-ai-builder
./setup.sh /path/to/your/godot/project

This copies the HTTP bridge plugin into your Godot project's addons/ folder and installs MCP dependencies.

Step 3: Enable in Godot

1. Open your project in Godot
2. Project -> Project Settings -> Plugins
3. Enable "AI Game Builder"

Step 4: Build a game

cd /path/to/your/godot/project
claude --plugin-dir /path/to/godot-ai-builder

Then tell Claude what you want:

Make a shooter game

Claude will ask whether you want a full game (6-phase build with PRD, enemies, UI, polish) or a simple game (minimal, fast, playable). Give a detailed prompt to skip the question and go straight to building.

For full games, Claude also asks about your preferred visual tier: procedural (shaders, gradients, glow effects — default), custom art (you provide sprites), AI-generated art (generates prompts for DALL-E/Midjourney), or prototype (basic shapes).

Plugin Contents

14 Skills

Skill	Purpose
godot-builder	Master router — entry point for all requests
godot-director	Game Director — 6-phase build protocol with quality gates
godot-polish	Game juice — screen shake, particles, hit flash, animations
godot-init	Project bootstrapping, folder structure, project.godot
godot-gdscript	GDScript syntax, patterns, common mistakes
godot-scene-arch	Scene building (programmatic vs .tscn)
godot-player	Player controllers for every genre
godot-enemies	Enemy AI, spawn systems, boss patterns
godot-physics	Collision layers, physics bodies, Area2D triggers
godot-ui	UI screens, HUD, menus, transitions
godot-effects	Audio, particles, tweens, visual effects
godot-assets	Visual quality system: procedural visuals, shaders, art pipelines
godot-ops	MCP tool operations: run, stop, errors, reload
godot-templates	Genre-specific templates with file manifests

MCP Tools (28 tools via godot-bridge)

Tool	Purpose
godot_get_project_state	Read project structure and settings
godot_run_scene	Run the game in the editor
godot_stop_scene	Stop the running game
godot_get_errors	Read editor error log
godot_reload_filesystem	Tell Godot to rescan files
godot_generate_asset	Generate polished SVG/PNG sprites for entities
godot_generate_asset_pack	Generate a full coherent asset set for a game genre
godot_parse_scene	Parse .tscn file structure
godot_scan_project_files	List all project files
godot_read_project_setting	Read project.godot values
godot_list_addons	List curated add-ons from the internal compatibility catalog
godot_install_addon	Install curated add-ons into the current project
godot_verify_addon	Verify add-on files and integration health checks
godot_apply_integration_pack	Apply a curated integration pack (PoC: pack_polish) with strict failure mode
godot_log	Send progress messages to the Godot dock panel
godot_save_build_state	Save build checkpoint (phase progress, files, quality gates)
godot_get_build_state	Load build checkpoint (detect interrupted builds)
godot_get_latest_quality_report	Read recent quality reports from .claude/quality_reports (optional phase filter)
godot_evaluate_quality_gates	Run objective quality checks (especially Phase 5/6) and return failed gates
godot_score_poc_quality	Score PoC runs with weighted rubric and enforce max-iteration verdicts (go/needs_iteration/no_go)
godot_update_phase	Update dock phase progress (number, name, status, gates)

Editor Integration (inspect, verify, manipulate — what Ziva charges $20/month for):