godot-craft

godot-craft

A Claude Code plugin that autonomously generates playable Godot 4 games from a single text prompt.

"우주 슈팅 게임 만들어줘" → Playable Godot 4 project with assets, scenes, scripts, and visual QA.

How It Works

godot-craft runs a fully automated 6-Phase pipeline — you describe a game in natural language, approve the concept, and the plugin handles the rest:

Phase 0: Concept & Planning ─── Expand idea → PLAN.md → User approval (only interaction)
    ↓
Phase 1: Scaffold & Assets ─── Project structure + asset generation (images, sounds, music)
    ↓
Phase 2: Implementation ─── Task-by-task coding with compile checks
    ↓
Phase 3: Visual QA & Fix ─── Screenshot-based inspection + SSIM comparison (up to 3 rounds)
    ↓
Phase 4: Polish & Present ─── Debug cleanup + gameplay video capture
    ↓
Phase 5: Verification ─── Final integrity checks + DoD completion

Commands

Command	Description
/make-game <description>	Generate a game from a natural language prompt
/godot-resume	Resume an interrupted game project from where it left off

Skills

Skill	Phase	Role
concept-planning	0	Game concept expansion, visual target, planning docs
scaffold-assets	1	Project scaffolding, script stubs, scene/asset generation
implementation	2	DAG-ordered task execution with godot-task sub-skill
visual-qa-fix	3	Screenshot capture, VQA inspection, SSIM diff, fix loop
polish-present	4	Debug code removal, code cleanup, video capture
verification	5	Compile check, asset/scene integrity, DoD checklist
godot-task	—	Per-task execution: GDScript writing, scene generation, coordination

Asset Generation

Built-in providers for AI-generated game assets:

• Images — Flux, Gemini, Worker (sprites, backgrounds, UI)
• 3D Models — Meshy, Tripo
• Music — Suno
• Sound Effects — SFX Engine
• Sprite Processing — Background removal (rembg), spritesheet packing

Requirements

• Claude Code with plugin support
• Godot 4 installed and available in PATH
• Python 3.10+ with dependencies:
• jq for JSON processing in shell scripts

pip install -r tools/requirements.txt

Platform Support

Feature	Linux	macOS	Windows (WSL)
Game generation (Phase 0-2, 5)	Full	Full	Full
Screenshot capture (Phase 3)	Full	Not yet	Via WSL
Video recording (Phase 4)	Full	Not yet	Via WSL

Phase 3 (Visual QA) and Phase 4 (video capture) use Xvfb + ImageMagick/scrot which are Linux-specific. On macOS and Windows, the game is still fully generated and verified — only automated screenshot/video capture is unavailable.

For full Phase 3/4 support on Linux:

sudo apt-get install xvfb imagemagick ffmpeg

Optional: API Keys for Asset Generation

Set as environment variables:

• GEMINI_API_KEY — Google Gemini for image generation
• FAL_KEY — Flux image generation
• WORKER_IMAGE_URL — Worker image proxy endpoint URL
• WORKER_IMAGE_API_KEY — Worker image proxy API key
• MESHY_API_KEY — 3D model generation
• TRIPO_API_KEY — 3D model generation
• SUNO_API_KEY — Music generation

Windows (CMD — 현재 세션만):

set GEMINI_API_KEY=your-key
set WORKER_IMAGE_URL=https://your-worker.workers.dev/generate
set WORKER_IMAGE_API_KEY=your-key

Windows (CMD — 영구 설정):

setx GEMINI_API_KEY your-key
setx WORKER_IMAGE_URL https://your-worker.workers.dev/generate
setx WORKER_IMAGE_API_KEY your-key

Windows (PowerShell):

$env:GEMINI_API_KEY="your-key"
$env:WORKER_IMAGE_URL="https://your-worker.workers.dev/generate"
$env:WORKER_IMAGE_API_KEY="your-key"

macOS / Linux (현재 세션만):

export GEMINI_API_KEY=your-key
export WORKER_IMAGE_URL=https://your-worker.workers.dev/generate
export WORKER_IMAGE_API_KEY=your-key

macOS / Linux (영구 설정):

# zsh (macOS 기본)
echo 'export GEMINI_API_KEY=your-key' >> ~/.zshrc
echo 'export WORKER_IMAGE_URL=https://your-worker.workers.dev/generate' >> ~/.zshrc
echo 'export WORKER_IMAGE_API_KEY=your-key' >> ~/.zshrc

# bash
echo 'export GEMINI_API_KEY=your-key' >> ~/.bashrc
echo 'export WORKER_IMAGE_URL=https://your-worker.workers.dev/generate' >> ~/.bashrc
echo 'export WORKER_IMAGE_API_KEY=your-key' >> ~/.bashrc

Installation

Add godot-craft as a Claude Code plugin:

claude plugin add vp-k/godot-craft

Or clone and link locally:

git clone https://github.com/vp-k/godot-craft.git
claude plugin add ./godot-craft

Quick Start

> /make-game 탑뷰 던전 크롤러 — 검사 캐릭터가 3층 던전을 탐험하며 몬스터와 싸우는 게임