godogen
Claude Code skills that build complete Godot 4 projects from a game description
Godogen: Claude Code skills that build complete Godot 4 projects
You describe what you want. An AI pipeline designs the architecture, generates the art, writes every line of code, captures screenshots from the running engine, and fixes what doesn't look right. The output is a real Godot 4 project with organized scenes, readable scripts, and proper game architecture. Handles 2D and 3D, runs on commodity hardware.
How it works
- Two Claude Code skills orchestrate the entire pipeline — one plans, one executes. Each task runs in a fresh context to stay focused.
- Godot 4 output — real projects with proper scene trees, scripts, and asset organization.
- Asset generation — xAI Grok creates 2D art and textures; Tripo3D converts selected images to 3D models. Budget-aware: maximizes visual impact per cent spent.
- GDScript expertise — custom-built language reference and lazy-loaded API docs for all 850+ Godot classes compensate for LLMs' thin training data on GDScript.
- Visual QA closes the loop — captures actual screenshots from the running game and analyzes them with Gemini Flash vision. Catches z-fighting, missing textures, broken physics.
- Runs on commodity hardware — any PC with Godot and Claude Code works.
Getting started
Prerequisites
- Godot 4 (headless or editor) on
PATH - Claude Code installed
- API keys as environment variables:
- Python 3 with pip (asset tools install their own deps)
- System packages:
mesa-utils,ffmpeg(see setup.md for full details including macOS) - Tested on Ubuntu, Debian, and macOS.
Create a game project
This repo is the skill development source. To start making a game, run publish.sh to set up a new project folder with all skills installed:
./publish.sh ~/my-game # uses game.md as CLAUDE.md
./publish.sh ~/my-game local.md # uses a custom CLAUDE.md instead
This creates the target directory with .claude/skills/ and a CLAUDE.md, then initializes a git repo. Open Claude Code in that folder and tell it what game to make — the /godogen skill handles everything from there.
Running on a VM
A single generation run can take several hours. Running on a cloud VM keeps your local machine free and gives the pipeline a GPU for Godot's screenshot capture. A basic GCE instance with a T4 or L4 GPU works well.
You don't need to keep a terminal open for the entire run. Connect a channel (Telegram, Slack, etc.) to send prompts and receive progress updates from your phone, or use remote control to manage sessions from any browser.
Is Claude Code the only option?
The skills were tested across different setups. Claude Code with Opus 4.6 delivers the best outcome. Sonnet 4.6 works but requires more guidance from the user. OpenCode was quite nice and porting the skills is straightforward — I'd recommend it if you're looking for an alternative.
Roadmap
- Explore C# as GDScript alternative
- Publish a full game end-to-end as a public demo
- Explore Bevy Engine as Godot alternative
Follow progress: @alex_erm
Yorumlar (0)
Yorum birakmak icin giris yap.
Yorum birakSonuc bulunamadi
