本页目录

Godogen:用 Claude Code / Codex 自动生成游戏的生成器(支持 Godot、Bevy、three.js)

godogen · htdt/godogen

Godogen 是一个基于 Claude Code 与 Codex 的自主游戏开发生成器源码库,使用 Python 编写。它本身不是游戏,而是先发布出一个游戏仓库,再由代理在该仓库内按一页引擎指南搭建工程、生成素材并运行引擎验证结果;支持 Godot(C#/GDScrip...

卡牌 桌面游戏 多人对战 Cocos Creator TypeScript 游戏状态管理 网络联机 UI 系统 高级
★ Stars 7,364 Forks 689 License MIT 更新 2026-11-17

国内开发环境适配

Windows
未知
Linux
官方声明支持
macOS
官方声明支持
引擎 / 框架:Cocos Creator 暂无中文教程标记 未标记站长实测
依赖较多:Godot 4/.NET SDK、Node.js 22.12+、Rust/Cargo、Chrome WebGL2、Python 3、Blender 及 vulkan-tools/xvfb/ffmpeg/imagemagick 等系统包;本地素材生成 godogen_assets 需要 NVIDIA GPU。可选付费 API(Google AI Studio、xAI、Tripo)在国内访问与密钥获取可能受限,具体可用性待核验。

中文项目介绍

Godogen 是一个「生成游戏生成器」的源码仓库:它自身并不是一款游戏,而是一套让 Claude Code 或 Codex 这类编码代理自主完成游戏开发流程的运行时脚手架。整体链路被作者概括为 godogen → game repo → game:先在本地渲染出一个全新的游戏仓库(可选择引擎与宿主代理形态),然后由代理进入该仓库,按照一页纸的引擎指南搭建工程、生成素材、运行引擎,并以实际运行结果作为验收依据,而不是以「编译通过」作为成功标准。

README 给出的能力范围覆盖 Godot(C# 或 GDScript)、Bevy、Babylon.js 与 three.js 四条技术路线。代理会读取任务情境自行决定交付形态:要么是一场可以边看边干预的实时游戏,要么在无人值守时输出一段 15–20 秒的证明录像。仓库同时提供演示视频与提示词文档链接,便于了解代理实际被驱动的方式。

补充说明

源码结构与发布机制

作者刻意把「发布出来的仓库」做得非常薄,只保留三类内容:运行时清单、一页引擎指南、素材生成技能。其余一切(工程脚手架、录制工具链)都由代理依据指南重新生成。

  • prompts/runtime.md:运行时清单,定义代理的工作约定
  • asset-gen/:跨引擎的素材生成技能
  • engines/godot.md、engines/godot-gdscript.md、engines/bevy.md、engines/babylon.md、engines/threejs.md:每个引擎一份指南
  • publish.sh:按所选的引擎与宿主代理渲染出运行时目录结构

值得注意的是,引擎与宿主代理(Claude 还是 Codex)属于发布期的渲染选项,而不是各自独立的源码树;这意味着同一份技能与清单会被复用到不同组合上。

代理会做什么

README 把代理的职责按引擎/能力分条列出:

  • Godot 4:C# 或静态类型 GDScript 工程,采用构建期场景生成、运行时脚本,并使用 Jolt 物理。
  • Bevy:Rust/Bevy 工程,代码优先的 ECS 场景,配合离屏截取。
  • Babylon.js 与 three.js:TypeScript + Vite 的浏览器游戏,通过一个可访问的在线 URL 提供服务。
  • 素材生成:默认走本地且免费方案(依赖 godogen_assets),可产出带真实透明通道的图片、带贴图的 3D 模型、带动作与口型同步的骨骼人形角色、音效与配音。本地做不出来的部分由付费 API 补齐:Gemini 或 xAI Grok 出图、Grok 视频转动画精灵、Tripo3D 出 3D、Gemini TTS 配音、Lyria 出音乐。
  • 以证据代替声明:代理从运行中的游戏(在线 URL 或录制片段)判断结果,因此可见缺陷会驱动下一轮迭代。
  • 参与度自选:可以盯着实时游戏在关键决策点干预,也可以完全放手,结束时拿到一段证明录像。代理会根据你描述任务的方式判断该走哪条路。

引擎选择建议

所有引擎共享同一套循环——构建、生成素材、运行、举证——因此选择依据是「最终想拿到什么东西」以及「想以什么方式围观」。README 给了对照表:

--engine 语言 观看方式 适合场景
godot C# 工程本身,可运行或在 Godot 编辑器中打开 桌面 2D/3D 游戏;长时间无人值守时运行时意外最少
godot-gdscript GDScript 同上 之后自己继续在编辑器里开发的 Godot 工程
bevy Rust cargo run Rust 代码库:ECS、无编辑器、大量实体
babylon TypeScript 在线 URL 依赖引擎系统(物理、GUI、粒子、动画)的浏览器游戏
threejs TypeScript 在线 URL 依赖视觉表现(自定义着色器、风格化渲染、轻量页面)的浏览器游戏

补充判断要点:

  • 远程或手机旁观时浏览器引擎更占优,dev server 给出的 URL 刷新即可;Godot 与 Bevy 是桌面应用,在无头服务器上只能看证明录像或把仓库拉到本地跑。
  • 2D 优先 Godot,它拥有专门的 2D 体系(像素空间节点、瓦片地图、2D 物理);网页引擎是 3D 优先,2D 以精灵与平面形式存在于 3D 场景中。
  • C# 与 GDScript:同一引擎、同一场景与截取方式,差别只在语言。C# 可编译,dotnet build 会在运行前对整个工程做类型检查,错误暴露更早,但需要 .NET 版 Godot 与 .NET SDK;GDScript 是原生语言、生态教程与插件更多,但解析器查不出的问题只能在运行时暴露。若计划 Web 导出,需先核查 Godot 对 C# 的当前平台支持。
  • Babylon.js 与 three.js:前者是完整引擎,Havok 物理、GUI、粒子、动画组与 inspector 开箱即用,拼装更少但包体更大;后者是渲染器,物理(Rapier)、UI(HTML 覆盖画布)与音频都要自行接线,换来对画面最强的控制力与更小的包体。
  • Bevy 适合想要纯 Rust、纯代码、强编译期保证与大量实体余量的场景,但编译最慢,且 API 在版本间变动快于模型训练数据,因此指南要求代理去读已安装的源码而不是凭记忆写。

环境准备

README 的 Prerequisites 一节列出了较为完整的依赖:

  • Godot 4(Godot 工程需要,放在 PATH;C# 需 .NET 版构建)
  • Rust/Cargo(Bevy 工程)
  • Node.js 22.12+ 与 npm(Babylon.js、three.js)
  • 支持硬件 WebGL2 的 Chrome/Chromium(浏览器截取)
  • Python 3 与 pip
  • Blender(推荐,放在 PATH,代理会脚本化它来做生成器不擅长的 3D 模型与动画)
  • godogen_assets(本地素材生成,需要 NVIDIA GPU,按自身 README 配置并记录在 .godogen_assets)
  • 可选环境变量形式的 API Key:GOOGLE_API_KEY(Gemini 图像、TTS、Lyria 音乐)、XAI_API_KEY(Grok 图像与动画精灵视频)、TRIPO_API_KEY(Tripo 3D 生成,配合 tripo CLI,需 Node.js 20+)
  • 系统包(见 setup.md):vulkan-tools、xvfb、ffmpeg、imagemagick 及平台相关的额外包
  • 已在 Ubuntu、Debian 与 macOS 上测试;需要 Claude Code 或 Codex

发布游戏仓库

选定引擎与宿主代理后,用 publish.sh 渲染目标仓库,例如:

./publish.sh --engine godot          --agent claude --out ~/my-game
./publish.sh --engine godot-gdscript --agent claude --out ~/my-game
./publish.sh --engine bevy           --agent claude --out ~/my-game
./publish.sh --engine babylon        --agent codex  --out ~/my-game
./publish.sh --engine threejs        --agent codex  --out ~/my-game

Claude 形态会产出 CLAUDE.md 与 .claude/skills/,Codex 形态则产出 AGENTS.md 与 .agents/skills/。重新发布时若目标目录已有内容,可加 --force 先清空。后续改动记录在 CHANGELOG.md,作者也在社交账号上同步进展。

使用建议

Godogen 更像是「代理工作流的模板 + 素材生成能力」的组合,适合想尝试用编码代理从零产出可运行游戏、并希望对过程保留干预点的开发者。由于它把验收标准放在「看得见的运行结果」上,使用前建议先把引擎、GPU、浏览器与可选 API Key 的依赖打点齐全,否则代理很可能卡在环境而非创意上。

开源许可证与版权说明

许可证标识:MIT。源码、资源与依赖许可可能不同,请以官方仓库为准。本站仅做索引,不托管源码。

相似项目