godogen README

The project's README from github.com/htdt/godogen. As one markdown file: README.md.

Godogen

Autonomous game development for Godot, Bevy, and Babylon.js with Claude Code and Codex.

Watch the video

Watch the demos · Prompts

Describe a game. The agent builds it, generates assets, runs the engine, and proves the result — as a live game you watch and steer, or as a recorded video when you're not there. It reads the situation and decides which, in the run.

This repo is not a game. It is the source for a generator that produces games: godogen -> game repo -> game. You publish into a fresh game repo — choosing engine and host-agent flavor — then the agent runs inside that repo and builds the actual game from a short engine guide.

Source layout

A published repo is intentionally thin: a runtime manifest, a one-page engine guide, and the asset-generation skill. The agent recreates everything else (project scaffold, capture tooling) from the guide.

Engine and host agent (Claude vs Codex) are publish-time render choices, not separate source trees.

What the agent does

Getting started

Prerequisites

Publish a game repo

Pick the engine and host agent:

./publish.sh --engine godot   --agent claude --out ~/my-game       # CLAUDE.md + .claude/skills/
./publish.sh --engine babylon --agent codex  --out ~/my-game       # AGENTS.md + .agents/skills/
./publish.sh --engine bevy    --agent claude --out ~/my-game

Pass --force to wipe existing contents at the target before re-publishing.

Running on a server

A full generation run can take hours, so it's convenient to offload it to a server — ideally a GPU instance, since engine rendering and video capture are much faster with hardware acceleration.

Changelog

See CHANGELOG.md.

Follow progress: @alex_erm

godogen (htdt/godogen)

Searching Database…

7.2K ·GitHub
Что это?Godogen — генератор, публикующий минимальные стартовые репозитории для игр на Godot, Bevy или Babylon.js, которые затем ИИ-агент кодинга (Claude Code или Codex) автономно разворачивает по промпту — пишет код, генерирует ассеты, запускает движок и подтверждает результат живым просмотром или записанным клипом.
Это игра или инструмент для создания игр?Ни игра, ни игровой движок — это исходники генератора. Запуск godogen публикует новый репозиторий (с выбором движка и хост-агента), а затем агент строит саму игру внутри этого свежего репозитория.
Как опубликовать игровой репозиторий?Запустите publish.sh и выберите целевой движок (Godot, Bevy или Babylon.js) и хост-агента (Claude или Codex); он рендерит рантайм-манифест, руководство по движку и скилл генерации ассетов в свежий репозиторий. Передайте --force, чтобы перезаписать существующую цель.
Что должно быть установлено перед запуском сгенерированного репозитория?Godot 4 (сборка .NET) для Godot, Rust/Cargo для Bevy или Node.js 22.12+ с npm и Chrome/Chromium (аппаратный WebGL2) для Babylon.js, плюс Python 3 с pip и установленный Claude Code или Codex.
Проверялась ли его работа на какой-либо ОС?Явно протестировано только на Ubuntu, Debian и macOS; о нативной поддержке Windows не упоминается. Полные прогоны генерации могут занимать часы, поэтому долгие сессии без присмотра обычно требуют сервер с SSH, удерживаемым через tmux или screen.
Для кого это, и нужен ли мощный компьютер?Это для разработчиков, уверенно работающих с агентскими инструментами кодинга и желающих прототипировать игры без участия или с частичным управлением; для долгих прогонов рекомендуется GPU-инстанс, так как с аппаратным ускорением рендеринг движка и запись видео идут гораздо быстрее.
Какие API-ключи нужны для генерации ассетов?GOOGLE_API_KEY для генерации изображений Gemini, XAI_API_KEY для генерации изображений/видео xAI Grok и TRIPO3D_API_KEY для генерации 3D-моделей и анимации со скелетом в Tripo3D.
Как агент доказывает, что игра реально работает?Он оценивает запущенную игру, а не чистую компиляцию — либо живую сессию URL/движка, которую можно наблюдать и направлять, либо прогон без присмотра, завершающийся записанным доказательным клипом на 15-20 секунд, так что видимые баги двигают следующие исправления.
Чем отличается каждый поддерживаемый движок?Проекты Godot 4 используют C#/.NET с генерацией сцен при сборке и физикой Jolt, проекты Bevy — это Rust со сценами в стиле code-first ECS и захватом вне экрана, а проекты Babylon.js — браузерные игры на TypeScript/Vite, раздаваемые по живому URL.
Можно следить за агентом в реальном времени или только получить результат потом?И то, и другое: можно наблюдать за живой игрой и влиять в точках принятия решений, либо оставить прогон без присмотра и по завершении получить короткую доказательную запись — агент считывает, как вы сформулировали задачу, чтобы выбрать режим.
Creator
htdt
Size
0.6 MB
Stars
7.2K
Updated
CommitOct 16
Age
8mo
Commits · 90 Days