htdt/godogen
GitHub: htdt/godogen
一个基于 AI 的自动化管道,可将游戏描述直接生成为完整的 Godot 4 项目。
Stars: 2832 | Forks: 266
# Godogen: Claude Code 和 Codex 技能,用于构建完整的 Godot 项目
[](https://youtu.be/eUz19GROIpY)
[观看演示](https://youtu.be/eUz19GROIpY) · [提示词](demo_prompts.md)
你描述你想要的功能。一个 AI 管道设计架构、生成美术、编写每一行代码、捕获运行引擎的截图,并修复看起来不正确的内容。输出是一个真实的 Godot 4 项目,包含组织良好的场景、可读的脚本和正确的游戏架构。
这个仓库不是一个 Godot 游戏。它是生成 Godot 游戏的生成器的源代码:**godogen → 游戏仓库 → 游戏**。你将技能发布到一个全新的游戏仓库(Claude Code 或 Codex 风格),然后代理在该仓库内运行以构建实际的游戏。
两个并行的源树存在于这里,每个主机代理一个:
- `claude/` — Claude Code 版本
- `codex/` — Codex 版本
## 技能的作用
- **Godot 4 输出** — 带有正确场景树、脚本和资源组织的真实项目。
- **资源生成** — Gemini 创建精确的参考和角色;xAI Grok 处理纹理和简单物体;Tripo3D 将图像转换为 3D 模型。动画精灵使用 Grok 视频生成并带有循环检测。
- **C# / .NET 9** — 所有生成的代码使用 C#。请参阅[为何选择 C# 而非 GDScript](gdscript-vs-csharp.md)。
- **视觉 QA 闭环** — 捕获游戏运行时的实际截图,并使用多模态审查来捕捉 Z 缓冲冲突、缺失纹理、破坏的物理效果和其他视觉回归。
- **可在普通硬件上运行** — 任何拥有 Godot、Python 和所需 API 密钥的机器都可以运行该管道。
## 快速开始
### 先决条件
- [Godot 4](https://godotengine.org/download/)(.NET 构建版本)在 `PATH` 中
- Python 3 和 pip
- 作为环境变量的 API 密钥:
- `GOOGLE_API_KEY` — [Google AI Studio](https://aistudio.google.com/)
- `XAI_API_KEY` — [xAI Grok](https://console.x.ai/home)
- `TRIPO3D_API_KEY` — [Tripo3D](https://platform.tripo3d.ai/) 用于 3D 生成
- 来自 [setup.md](setup.md) 的系统包:`vulkan-tools`、`xvfb`、`ffmpeg`、`imagemagick`,以及平台特定的额外依赖
- 已在 Ubuntu、Debian 和 macOS 上测试通过
- Claude Code 或 Codex
### 发布游戏仓库
选择与你的主机代理匹配的变体:
```
./claude/publish.sh ~/my-game # writes CLAUDE.md and .claude/skills/
./codex/publish.sh ~/my-game # writes AGENTS.md and .agents/skills/
```
传递 `--force` 标志以在发布前清除目标位置的现有内容——在重新发布时使用此选项。
## 在服务器上运行
完整的生成运行可能需要数小时,因此将其卸载到服务器上会很方便,理想情况下使用 GPU 实例,因为 Godot 在硬件加速下渲染截图和视频的速度要快得多。
- 使用 `tmux` 或 `screen` 保持 SSH 会话在断开后仍然存活。
- 安装 [tg-push](https://github.com/htdt/tg-push),以便代理可以在你不在时向 Telegram 推送进度更新、截图和最终视频。
- 启用远程控制,这样你就可以从任何设备检查并控制运行过程——Claude Code 和 Codex 都提供官方的远程控制接口。
## 改进技能
在完整的生成会话结束后,请要求你使用的代理审查管道的性能表现:
## 路线图
- 将完整的端到端游戏作为公开演示发布
- 探索 Bevy 引擎作为 Godot 的替代方案
## 更新日志
**2026-04-14 — Codex 支持**
- 添加了与现有 Claude Code 树并行的 Codex 源树
- 每个变体发布到其自己的运行时布局(`.claude/skills/` 对比 `.agents/skills/`)
**2026-04-06 — C# 迁移**
- 所有技能和生成代码从 GDScript 迁移到 C# / .NET 9([对比](gdscript-vs-csharp.md))
- 使用 `dotnet build` 替代逐个文件的验证循环
**2026-04-03 — 单上下文架构**
- 将编排器和任务执行合并为一个主管道
- 增加了 Godot API 查找和视觉 QA 支持流程
**2026-03-25 — xAI Grok 视频**
- 为动画精灵工作流添加了 Grok 视频生成
- 背景移除使用 BiRefNet 多信号蒙版重写
**2026-03-09 — 初始发布**
- 初始 Godogen 发布,包含图像生成、3D 转换、截图 QA 和视频捕获
关注进展:[@alex_erm](https://x.com/alex_erm)
标签:3D模型, AI 代码生成, AI 生成, AI 管道, API密钥, Claude Code, Codex, DNS解析, Gemini, Godot, Godot 4, .NET 9, Python, SEO, Tripo3D, xAI Grok, 动画精灵, 商品硬件, 场景组织, 开源项目, 循环检测, 提示词, 无后门, 游戏开发, 游戏开发工具, 游戏架构, 游戏生成器, 演示, 环境变量, 纹理生成, 视觉QA, 视频生成, 角色生成, 资产生成, 逆向工具