Godogen: 한 문장으로 Godot 4 게임을 만드는 완전 자율 AI 파이프라인

“눈 덮인 산에서 스노우보드를 타는 게임을 만들어줘” — 이 한 문장이 전부입니다.

아키텍처 설계, 아트 생성, 코드 작성, 시각적 QA까지 모든 것을 AI가 자율적으로 처리합니다. 그리고 결과는 실제 플레이 가능한 Godot 4 프로젝트.

이것은 데모나 목업이 아닙니다. 조직화된 씬, 읽을 수 있는 스크립트, 적절한 게임 아키텍처를 가진 진짜 프로젝트입니다. 열고 플레이하고 개선할 수 있습니다.

Godogen은 이런 것을 가능하게 하는 완전 자율 AI 파이프라인입니다.

왜 Godogen인가

기존 AI 게임 생성의 한계

대부분의 AI 게임 생성 도구는 다음 중 하나입니다:

• 코드 스니펫 생성 — 유용하지만, 전체 게임을 만들지 못함
• 목업/프로토타입 — 보기엔 좋아도 실제로 실행되지 않음
• 수동 조작 필요 — AI가 제안하고 인간이 구현

결국 인간이 “통합 레거러”가 되어 모든 조각을 직접 합쳐야 합니다.

Godogen의 혁신

Godogen은 다릅니다:

단 한 문장의 시나리오 설명만 있으면, Godogen이 나머지 모든 것을 처리합니다.

핵심 기능

1. 두 개의 Claude Code 스킬

Godogen은 두 가지 스킬로 구성됩니다:

• 계획 스킬 — 시나리오를 분석하고 아키텍처 설계
• 실행 스킬 — 실제 Godot 프로젝트 생성 및 에셋 통합

각 작업은 신선한 컨텍스트에서 실행되어, 누적된 “기억 상실” 문제를 방지합니다.

2. 실제 Godot 4 출력

생성되는 것은 진짜 프로젝트입니다:

• 적절한 씬 트리
• 읽을 수 있는 GDScript 스크립트
• 조직화된 에셋 폴더 구조
• 올바른 게임 아키텍처

~/my-game/
├── .claude/skills/          # Godogen 스킬
├── CLAUDE.md                # 프로젝트 컨텍스트
├── .git/                    # Git repo 초기화됨
├── scenes/                  # Godot 씬 파일
├── scripts/                 # GDScript 코드
├── assets/                  # 생성된 에셋
└── project.godot           # Godot 프로젝트 설정

열고 플레이하고 개선할 수 있습니다. 빌드해서 확장할 수도 있습니다.

3. 에셋 생성 — 센트당 최대 시각적 임팩트

게임에 필요한 아트와 텍스처는 AI가 자동으로 생성합니다:

• Gemini — 2D 아트와 텍스처 생성
• Tripo3D — 이미지를 3D 모델로 변환 (3D 게임 전용)

예산 인식 설계: 센트당 최대 시각적 임팩트를 제공합니다.

4. GDScript 전문성 — LLM 학습 데이터 부족 보완

LLM은 GDScript 학습 데이터가 부족합니다. Godogen은 이 문제를 해결합니다:

• 커스텀 빌드 언어 레퍼런스 — Godot 특화 학습 데이터 구축
• 850+ Godot 클래스의 lazy-loaded API 문서 — 필요할 때만 로드하여 컨텍스트 절약

이 두 가지 덕분에 LLM이 GDScript를 더 잘 이해하고 작성할 수 있습니다.

5. 시각적 QA로 루프 닫기 — 실행 중인 게임에서 실제 스크린샷 캡처

가장 혁신적인 기능입니다. Godogen은 생성된 게임을 실제로 실행하고, 스크린샷을 찍어 QA를 수행합니다:

QA 프로세스:

1. Godot 프로젝트를 headless 모드로 실행
2. 실제 게임 화면에서 스크린샷 캡처
3. Gemini Flash Vision으로 스크린샷 분석
4. 텍스트 분석에서는 보이지 않는 버그 감지:
   • Z-fighting (텍스처 깜빡임)
   • 누락된 텍스처
   • 깨진 물리
   • 렌더링 오류
5. 문제 발견 시 자동 수정 루프 실행

텍스트 기반 분석에서는 절대 발견할 수 없는 버그들을 실제 화면에서 잡아냅니다.

6. 일반 하드웨어에서 실행

GPU 클러스터가 필요 없습니다:

• Godot와 Claude Code만 있으면 됨
• 로컬 PC에서 실행 가능
• 클라우드 VM에서 실행하면:
  • 로컬 머신이 자유로워짐
  • 스크린샷 캡처를 위한 GPU 제공

테스트된 환경:

• Ubuntu 및 Debian ✅
• macOS (미테스트 — 스크린샷 캡처가 X11/xvfb/Vulkan 의존)

지원하는 게임 유형

• 2D 게임 — 플랫포머, 아케이드, 퍼즐
• 3D 게임 — FPS, TPS, 액션 어드벤처
• 자연 씬 — 스노우보딩, 하이킹 등

데모 영상: https://youtu.be/4_2Pl07Z7Ac

사용법

요구사항

소프트웨어:

• Godot 4 (headless 또는 에디터)
• Claude Code

API 키:

• GOOGLE_API_KEY — Gemini (이미지 생성 및 시각적 QA)
• TRIPO3D_API_KEY — Tripo3D (이미지를 3D 모델로 변환, 3D 게임만 필요)

기타:

• Python 3 with pip
• 에셋 툴이 자체 종속성 설치

새 게임 프로젝트 설정

# 기본 사용 — teleforge.md를 CLAUDE.md로 사용
./publish.sh ~/my-game

# 커스텀 CLAUDE.md 사용
./publish.sh ~/my-game local.md

생성되는 것:

• 대상 디렉토리에 .claude/skills/
• CLAUDE.md
• Git repo 초기화
• 해당 폴더에서 Claude Code 열기
• /godogen 스킬이 모든 것을 처리

실행 시간

단일 생성 실행은 몇 시간이 걸릴 수 있습니다:

• 아키텍처 설계
• 코드 작성
• 에셋 생성
• 시각적 QA
• 버그 수정 루프

클라우드 추천:

• T4 또는 L4 GPU가 있는 기본 GCE 인스턴스
• 로컬 머신이 자유로워짐
• 스크린샷 캡처를 위한 GPU 제공

Teleforge 통합

기본 CLAUDE.md (teleforge.md)는 Teleforge용으로 설정됩니다:

• 진행 상황을 모니터링하는 가벼운 Telegram 브릿지
• 휴대폰에서 메시지 보내기

Teleforge를 사용하지 않는다면 publish.sh에 자신의 CLAUDE.md를 전달하세요.

모델 테스트 결과

개발자 htdt가 여러 모델에서 테스트한 결과:

추천: Claude Code Opus 4.6 또는 OpenCode

로드맵

개선 사항:

• Grok-image-to-image로 마이그레이션 — 더 저렴
• Grok-image-to-video로 스프라이트시트 마이그레이션 — 애니메이션 스프라이트
• 게임 빌드 레시피 추가 — Android 내보내기
• 엔드 투 엔드 공개 데모로 전체 게임 게시

기술 스택

• 언어: Python
• 게임 엔진: Godot 4
• AI: Claude Code (계획 & 실행)
• 이미지 생성: Gemini
• 3D 모델링: Tripo3D
• 시각적 QA: Gemini Flash Vision

개발자

• htdt (@alex_erm)
• GitHub: htdt/godogen

마치며: 완전 자율 AI 파이프라인의 실현

Godogen은 AI 게임 생성의 새로운 표준을 설정합니다.

단 한 문장의 시나리오 설명에서 시작해서, 실제 플레이 가능한 Godot 4 프로젝트까지 — 모든 것이 AI에 의해 자율적으로 처리됩니다.

특히 시각적 QA 기능이 독창적입니다. 생성된 게임을 실제로 실행하고, 스크린샷을 찍어 버그를 찾아냅니다. 텍스트 기반 분석에서는 절대 발견할 수 없는 버그들을 실제 화면에서 잡아냅니다.

이것은 데모나 목업이 아닙니다. 열고 플레이하고 개선할 수 있는 진짜 프로젝트입니다.

115+ 스타가 이미 이것의 가치를 증명했습니다. 당신도 한 문장으로 게임을 만들어보세요.

🔗 관련 정보

• GitHub: https://github.com/htdt/godogen
• 개발자: @alex_erm
• 데모 영상: https://youtu.be/4_2Pl07Z7Ac
• Teleforge: https://github.com/htdt/teleforge