--- title: "Godogen — Godot·Bevy·Babylon.js용 자율 게임 개발 도구" creative_title: "말로 설명하면 게임이 나온다 — AI가 만들고, 스크린샷 보고 스스로 고친다" source_url: https://github.com/htdt/godogen author: htdt (@alex_erm) license: MIT stars: 3.4k summarized_by: 다비 (davi.kr) date: 2026-08-31 purpose: "GitHub 오픈소스 'Godogen'의 구조와 활용법을 비전문가도 이해할 수 있게 정리한 요약 문서" --- # 🎮 Godogen 요약 🔗 원문: --- ## 📌 쉬운 설명 **Godogen(고도젠)**은 "이런 게임 만들어줘"라고 말로 설명하면 AI가 알아서 게임을 만들어주는 도구 모음입니다. AI 코딩 도구인 **Claude Code**나 **Codex**와 함께 쓰며, AI가 ① 게임을 기획하고 ② 코드를 쓰고 ③ 캐릭터·배경 같은 그림 자료를 만들고 ④ 게임 엔진을 직접 실행해 ⑤ 화면을 캡처해서 보고 ⑥ 이상한 부분을 스스로 고칩니다. 여기서 **게임 엔진**이란 게임을 돌아가게 해주는 프로그램인데, **Godot 4**(무료 엔진), **Bevy**(Rust 언어 기반), **Babylon.js**(웹 브라우저용) 세 가지를 지원합니다. 핵심은 **"화면을 보고 판단한다(Frame-grounded self-repair)"**는 점입니다. 보통 AI는 "코드에 오류가 없으니 잘 됐다"고 착각하는데, Godogen은 실제 게임 화면 스크린샷을 근거로 캐릭터가 벽을 뚫었는지, 크기가 이상한지, 움직임이 멈췄는지를 판단해 다시 고칩니다. 그림 자료는 **Gemini**(참고 이미지·캐릭터), **xAI Grok**(질감·간단한 물체·움직이는 그림), **Tripo3D**(그림 → 3D 모델 변환)가 나눠 담당합니다. 참고로 이 저장소 자체는 게임이 아니라 **"게임을 만드는 공장을 찍어내는 틀"**입니다. `publish.sh`로 새 게임 폴더를 만든 뒤, 그 안에서 AI가 실제 게임을 짓습니다. --- ## 🛠️ 활용 방법 가장 쉬운 시작 순서는 다음과 같습니다. 1. **데모 영상부터 확인하라.** 결과물 수준을 먼저 눈으로 보라 → [demo 영상](https://youtu.be/eUz19GROIpY), [사용된 프롬프트 모음](https://github.com/htdt/godogen/blob/master/docs/demo_prompts.md) 2. **준비물을 갖춰라.** Godot 4(.NET 버전), Python 3, 그리고 API 키 3종(`GOOGLE_API_KEY`, `XAI_API_KEY`, `TRIPO3D_API_KEY`). Claude Code 또는 Codex 필수. Ubuntu·Debian·macOS에서 검증됨. 3. **명령어 한 줄로 게임 저장소를 생성하라.** ```bash ./publish.sh --engine godot --agent claude --out ~/my-game ``` 웹 게임이 목표라면 `--engine babylon`(Node.js 22.12+ 필요)이 진입 장벽이 가장 낮다. 4. **긴 작업은 서버로 돌려라.** 1회 생성에 **수 시간**이 걸린다. `tmux`/`screen`으로 세션을 유지하고, GPU 인스턴스를 쓰면 렌더링·영상 캡처가 훨씬 빠르다. `--video_hook` 옵션을 붙이면 완성 영상이 **텔레그램**으로 자동 전송된다. 5. **끝나면 AI에게 회고를 시켜라.** "이번 세션을 분석하고 지시문 중 빠지거나 오해를 부른 부분을 짚어줘"라고 물어 파이프라인을 계속 개선하라. --- ## 🧠 전문가 의견 (사실 기반) - **화면 검증 루프가 진짜 차별점이다.** 대다수 AI 코딩 도구는 "컴파일 성공 = 완료"로 끝난다. Godogen은 스크린샷을 판단 근거로 삼아 시각적 결함을 다음 반복의 입력으로 되돌린다. 게임처럼 결과가 눈으로만 검증되는 영역에서 이 구조는 필수다. - **GDScript가 아닌 C#/.NET 9을 택했다.** Godot 진영의 관행과 다른 선택이며, 저장소에 [별도 근거 문서](https://github.com/htdt/godogen/blob/master/docs/gdscript-vs-csharp.md)가 있다. 타입 안정성이 높아 AI가 만든 코드의 오류를 잡기 유리하다는 판단으로 보인다. - **비용과 시간을 과소평가하지 마라.** 상용 API 3개(Gemini·Grok·Tripo3D)를 동시에 쓰고 1회 실행이 수 시간이다. "무료로 게임 한 편"이 아니라 **유료 API + 장시간 연산**이 전제다. - **성숙도는 초기 단계다.** 커밋 34개, 스타 3.4k, 포크 301개, 이슈 3건. 관심도는 높지만 검증 이력은 짧다. MIT 라이선스라 상업적 활용·개조는 자유롭다. - **구성 언어는 Python 72.5%, Shell 14.9%, TypeScript 6.5%, JavaScript 5.6%**로, 본체는 게임 코드가 아니라 **자동화 스크립트**임을 보여준다. --- ## ✅ Bottom Line AI 게임 개발의 병목은 "코드 생성"이 아니라 **"결과를 눈으로 검증하고 되먹이는 루프"**였고, Godogen은 그 빈칸을 정면으로 채운다. 데모 영상을 켜고, `publish.sh` 한 줄을 실행하라. **지금 당장 시작하라.** --- *요약·정리: 다비([davi.kr](https://davi.kr))*