概要
Godogen は、テキストプロンプトから Godot 4ゲームプロジェクト を自動生成するAIパイプライン。 2D/3D対応、 資産生成・コード記述・ビジュアルQA まで一貫自動化。 Claude Code と Gemini など複数AIの協調動作で工程を分担。 GDScript 特有の課題を独自リファレンスで解決。 誰でもPC一台で動作可能、オープンソースで公開。
Godogen:AIによるGodot 4ゲーム自動生成パイプライン
- テキストプロンプト を入力するだけで、AIがゲームの設計・アート生成・コード記述・動作確認まで自動実行
- Claude Code による2段階AIスキル構成
- オーケストレーター:全体設計と工程分割
- エグゼキューター:各タスクを個別コンテキストで実行
- Godot 4 対応:2D/3D両対応、正規のシーンツリー・スクリプト・アセット構成
- 資産生成 :Geminiで2Dアート・テクスチャ生成、Tripo3Dで画像から3Dモデル変換
- コスト最適化 :予算内で最大のビジュアルインパクトを実現
- GDScript対応 :独自リファレンス・APIドキュメント・クイックDBでLLMの知識不足をカバー
- ビジュアルQA :Gemini Flash visionが実際のゲーム画面を解析し、z-fightingや物理バグなどを検出
- 汎用PCで動作 :GodotとClaude Codeが動く環境ならOK
導入方法・前提条件
- Godot 4 (headlessまたはeditor)をPATHに追加
- Claude Code のインストール
- APIキー の環境変数設定
- GOOGLE_API_KEY:Gemini用(画像生成・QA)
- TRIPO3D_API_KEY:Tripo3D用(3Dモデル変換、3Dゲームのみ)
- Python 3 とpipインストール(アセットツールが依存関係を自動導入)
- Ubuntu/Debian で動作確認済み、macOSは未検証(X11/xvfb/Vulkan依存)
ゲームプロジェクト作成手順
- このリポジトリはスキル開発用ソース
- 新規プロジェクト作成は publish.sh を実行
- 例:
./publish.sh ~/my-game
- 例:
.claude/skills/とCLAUDE.mdが生成され、gitリポジトリ初期化- Claude Codeを起動し、作りたいゲーム内容を指示
/godogenスキルが全工程を自動実行
VM・クラウドでの運用
- 1回の生成に数時間かかる場合あり
- クラウドVM(GCE T4/L4 GPU等)ならローカルPCを占有せず運用可能
- デフォルト
CLAUDE.mdは Teleforge (Telegramブリッジ対応)設定済み - Teleforge不要ならカスタム
CLAUDE.mdをpublish.shで指定、または生成後に編集
Claude Code以外の選択肢
- 他の環境でもスキルテスト済み
- Claude Code Opus 4.6が最良、Sonnet 4.6は追加指示が必要
- OpenCodeも移植容易でおすすめ
ロードマップ
-
画像生成を grok-imagine-image へ移行(コスト削減)
-
スプライトシートを grok-imagine-video へ移行(動画からアニメスプライト生成)
-
ゲームビルド用レシピ追加(Androidエクスポート対応)
-
完全なエンドツーエンド公開デモの制作
- 進捗は @alex_erm で公開
技術的な課題と解決策
- LLMのGDScript知識不足
- 850以上のGodotクラスを網羅した 独自言語リファレンス/クイックDB/APIドキュメント を構築
- 必要なAPIのみ lazy-load で参照し、コンテキストウィンドウ圧迫を回避
- ビルド時とランタイムの状態差異
- シーンはヘッドレススクリプトでノードグラフを生成し、.tscnファイルへシリアライズ
@onreadyやシグナル接続など、ビルド時に利用不可なAPIの扱いをAIに学習させる- 各ノードのowner設定ミスによる消失もプロンプトで防止
- 評価ループのバイアス排除
- コード生成AIとは別に、 Gemini Flash がレンダリング画像のみでビジュアルQAを実施
- テキスト分析で見逃すバグ(z-fighting、物理爆発、グリッド配置ミス等)を画像解析で検出
- アーキテクチャ
- 2つのClaude Codeスキル(プランナー/エグゼキューター)が
context: forkで状態管理 - 各タスク独立実行でエラーや状態の累積を防止
- 2つのClaude Codeスキル(プランナー/エグゼキューター)が
オープンソース・デモ・情報発信
- GitHub :https://github.com/htdt/godogen
- デモ動画 :https://youtu.be/eUz19GROIpY(実際のゲーム生成例)
- ブログ :近日公開予定(開発経緯・失敗談含む)
- 質問歓迎 :開発者が直接回答予定
まとめ
- Godogen はテキスト指示だけで Godot 4ゲーム を一貫自動生成するAIパイプライン
- GDScript特有の課題 を独自技術で克服
- 2D/3D両対応・資産生成・ビジュアルQA まで自動化
- 誰でも導入可能・オープンソース で積極開発中