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 游戏发布精简的起步仓库,然后由 AI 编码代理(Claude Code 或 Codex)根据提示词自主将其构建成型——编写代码、生成素材、运行引擎,并通过实时视图或录制的片段来证明结果。
这是一个游戏,还是制作游戏的工具?它既不是游戏也不是游戏引擎——它是一个生成器的源码。运行 godogen 会发布一个新仓库(需选择引擎和宿主代理),然后代理就在这个新仓库里构建真正的游戏。
怎么发布一个游戏仓库?运行 publish.sh,选择目标引擎(Godot、Bevy 或 Babylon.js)和宿主代理(Claude 或 Codex);它会将运行时清单、引擎指南和素材生成技能渲染到一个全新的仓库中。传入 --force 可覆盖已有的目标。
运行生成的仓库前需要先安装什么?Godot 项目需要 Godot 4(.NET 版),Bevy 项目需要 Rust/Cargo,Babylon.js 项目需要 Node.js 22.12 及以上版本并配备 npm 和 Chrome/Chromium(硬件 WebGL2);此外还需要带 pip 的 Python 3,并安装 Claude Code 或 Codex。
它经过测试能在哪些操作系统上运行?它明确只在 Ubuntu、Debian 和 macOS 上测试过,没有提到对原生 Windows 的支持。完整的生成过程也可能耗时数小时,因此长时间无人值守的会话通常需要一台服务器,并通过 tmux 或 screen 保持 SSH 连接。
它是给谁用的,需要高配置的机器吗?它面向习惯使用智能编码工具、希望以全自动或半引导方式制作游戏原型的开发者;长时间运行建议使用 GPU 实例,因为硬件加速能让引擎渲染和视频录制快得多。
生成素材需要哪些 API 密钥?GOOGLE_API_KEY 用于 Gemini 图像生成,XAI_API_KEY 用于 xAI Grok 图像/视频生成,TRIPO3D_API_KEY 用于 Tripo3D 三维模型生成和骨骼动画。
代理如何证明游戏真的能运行?它评判的是正在运行的游戏,而不是编译是否通过——要么是你可以观看和操控的实时 URL/引擎会话,要么是无人值守运行并最终产出一段 15-20 秒的录制证明片段,让可见的 bug 驱动下一步修复。
各个支持的引擎有什么不同?Godot 4 项目使用 C#/.NET,在构建时生成场景并采用 Jolt 物理;Bevy 项目是 Rust,采用代码优先的 ECS 场景和离屏捕获;Babylon.js 项目则是 TypeScript/Vite 的浏览器游戏,通过实时 URL 提供访问。
我能实时观看代理工作,还是只能稍后拿到结果?两者都可以:你可以观看实时的游戏并在决策点进行引导,也可以让运行无人值守、完成时获得一段简短的证明录像——代理会根据你对任务的表述方式来决定使用哪种模式。
Creator
htdt
Size
0.6 MB
Stars
7.2K
Updated
CommitOct 16
Age
8mo
Commits · 90 Days