GDA 소개
1.1 GDA가 하는 일
GDA(Game Dev Assistant)는 AI와 채팅하며 게임을 만드는 PC 프로그램입니다. 게임 개발을 몰라도 됩니다. 파트별 채팅에 하고 싶은 일을 적으면, 그 파트를 맡은 AI가 문서·이미지·코드를 만들어 내 PC의 프로젝트 폴더에 저장합니다. 이 도움말에서는 파트에서 일하는 AI를 「에이전트」라고 부릅니다.
- 왼쪽에서 프로젝트와 파트를 고르고, 가운데 채팅으로 요청합니다.
- 가운데 「홈」에서 게임이 어디까지 만들어졌는지 봅니다.
- 에이전트가 만든 결과는 오른쪽 패널에서 확인합니다.
- 중요한 내용을 확정할 때는 채팅의 승인 카드에서 직접 결정합니다.
만드는 순서는 정해져 있지 않습니다. 필요한 파트로 언제든 돌아가 고치면 됩니다.
1.2 여섯 파트
파트는 게임 만드는 일을 역할별로 나눈 것입니다. 파트마다 채팅이 따로 있고, 필요한 파트만 켜서 사용합니다. 새 프로젝트는 기획·아트·개발이 켜진 채로 시작하며, 나머지는 프로젝트 설정에서 켭니다.
- 기획 : 아이디어를 기획서로 정리합니다.
- 시나리오 : 세계관·인물·대사를 씁니다.
- 아트 : 게임에 사용할 이미지를 만듭니다.
- 개발 : Godot 또는 HTML 프로젝트로 게임을 만듭니다.
- 사운드 : 배경음악·효과음·음성을 만듭니다.
- QA : 만든 게임을 플레이 테스트합니다.
파트끼리는 요청 파일로 일을 주고받습니다. 자세한 내용은 4.3 수신 요청과 미결에 있습니다.
1.3 준비물
GDA 사용을 위해서는 Claude, ChatGPT 등의 AI 서비스 계정이 필요합니다.
현재 개발 엔진은 Godot만 지원하며, 향후 지원 엔진 확대 예정입니다.
시작하기 전에 아래를 준비해 주세요.
- PC : Windows 10/11 64비트 또는 macOS 14 이상(Apple Silicon)
- AI 서비스 계정 : Claude 또는 ChatGPT 계정. Grok(X 계정 로그인 또는 xAI API 키)도 연결할 수 있습니다.
- GDA 로그인 계정 : Google 또는 Apple 계정. 처음 로그인하면 GDA 계정이 만들어집니다.
- Godot 엔진 : PC·모바일 게임을 만들 때 필요합니다. 설정 마법사가 다운로드 링크를 안내합니다.
- (선택) 모바일 앱 : 밖에서 휴대폰으로 PC에 연결해 채팅·승인을 이어 갈 때 사용합니다. 플러스 구독이 필요하며, 구독은 모바일 앱에서 관리합니다.
- (선택) 로컬 엔진 : 내 PC에서 이미지·사운드를 만들려면 그래픽카드 메모리가 최소 12GB 필요하고, 24GB 이상을 권장합니다. mac은 통합 메모리를 사용하므로 16GB 이상을 권장하며, Krea2는 32GB 이상이 필요합니다.
시작해보기
2.1 설치하기
GDA는 홈페이지에서 다운로드해 설치합니다. 설치한 뒤의 업데이트는 앱이 알려 줍니다(9.1 자동 업데이트).
- https://gda.ai.kr/download/에서 사용하는 컴퓨터에 맞는 설치 파일을 다운로드해 주세요.
- Windows : 다운로드한 설치 프로그램(예 :
GDA-Setup-1.0.0.exe)을 열고 안내에 따라 설치해 주세요. - mac : 다운로드한 dmg 파일을 열고 GDA를 Applications 폴더로 옮긴 뒤 실행해 주세요.
지원하는 컴퓨터는 Windows 10/11 64비트와 macOS 14 이상(Apple Silicon)입니다.
mac에서 dmg 안의 GDA를 바로 실행하면 업데이트가 설치되지 않습니다. 이때는 「GDA를 응용 프로그램 폴더로 옮긴 뒤 다시 시작해야 업데이트가 설치됩니다.」가 보입니다. mac의 메뉴 막대(「GDA」·「편집」·「윈도우」)는 앱 언어로 표시됩니다.
처음 실행하면 로그인 창이 먼저 뜹니다(2.3 로그인). 로그인을 마치면 설정 마법사가 열립니다(2.2 설정 마법사).
2.2 설정 마법사
설정 마법사는 처음 실행할 때 한 번 열리고, AI 서비스·기본 모델·프로젝트 폴더·Godot 연결을 차례로 정합니다. 위쪽 단계 표시줄(「AI 서비스」·「기본 모델」·「프로젝트 폴더」·「엔진 연결」·「로그인」)에 지금 위치가 보입니다. 앞 단계로 돌아가려면 「이전」을 눌러 주세요.
-
사용하는 AI 서비스 카드(Claude·ChatGPT·Grok)를 고르고 「다음」을 눌러 주세요. 아직 AI 서비스가 없으면 「사용 중인 AI 서비스가 없습니다」를 눌러 마지막 단계로 건너뜁니다.
-
GDA가 그 서비스에 연결할 도구를 자동으로 설치합니다. 진행 막대가 끝날 때까지 기다려 주세요. 이미 설치되어 있으면 이 단계는 건너뜁니다. 설치에 실패하면 「다시 시도」를 눌러 주세요.
-
「인증하기」를 눌러 주세요. 로그인 창이 열리면 AI 서비스 계정으로 로그인해 주세요. 로그인을 마치면 창이 저절로 닫히고 다음 단계로 넘어갑니다.
-
기본으로 사용할 모델을 고르고 「선택 완료」를 눌러 주세요. 모델은 AI의 종류이며, 「권장」 표시가 붙은 모델을 그대로 사용해도 됩니다.
- Claude를 고르면 Fable 5.2·Opus 5.5·Sonnet 5.5·Haiku 5.5가 보이고, 「권장」은 Sonnet 5.5입니다. ChatGPT의 「권장」은 GPT 6.1 Terra입니다.
- 「이런 작업에 좋아요」는 모델별 특기이고, 「사용량」은 AI 서비스 계정의 한도를 얼마나 사용하는지입니다. 예를 들어 Fable 5.2는 복잡한 문제 해결에 맞지만 사용량이 매우 높습니다.
- 「사고 깊이」는 AI가 답하기 전에 얼마나 깊이 생각할지 정하는 값입니다.
-
「폴더 선택」을 눌러 새 프로젝트를 보관할 폴더를 정하고 「다음」을 눌러 주세요. 프로젝트를 만들 때 다른 폴더로 바꿀 수도 있습니다.
-
「폴더 선택」을 눌러 Godot 엔진 폴더를 지정하고 「다음」을 눌러 주세요. mac에서는 「선택」을 눌러 Godot 앱을 고릅니다.
- Godot가 없으면 「Godot 엔진 다운로드」를 눌러 공식 사이트(godotengine.org)에서 다운로드해 주세요.
- 지금 지정하지 않고 나중에 앱 설정 → 프로젝트의 「Godot 엔진 연결」에서 연결해도 됩니다.
-
「준비가 끝났습니다!」 화면에서 「시작하기」를 눌러 주세요. 이 PC가 아직 로그인되지 않았으면 「시작하기」 대신 「Google로 로그인」·「Apple로 로그인」이 보입니다.
오른쪽 위 X로 닫아도 마법사는 다시 열리지 않습니다. 마법사에서 정한 값은 모두 앱 설정에서 바꿀 수 있습니다(7.1 앱 설정).
2.3 로그인
GDA를 사용하려면 이 PC를 GDA 계정에 연결해야 합니다. 처음 실행할 때나 PC 연결이 풀렸을 때 「로그인」 화면이 뜹니다. 계정이 없으면 로그인할 때 자동으로 가입됩니다.
브라우저로 로그인하기(기본)
-
「Google로 로그인」 또는 「Apple로 로그인」을 눌러 주세요. 지난번에 사용한 버튼 옆에는 「이전 로그인」이 보입니다.
-
기본 브라우저가 열리면 그 계정으로 로그인해 주세요. 브라우저가 보이지 않으면 같은 버튼을 다시 눌러 주세요.
-
처음 가입하는 계정이면 「계정 생성을 위해 약관 동의가 필요합니다.」가 보입니다. 「(필수) 이용약관」과 「(필수) 개인정보처리방침」을 읽고 「전체 동의」를 눌러 주세요.
-
GDA로 돌아오면 「로그인을 확인하는 중입니다.」가 보인 뒤 다음 화면이 저절로 열립니다.
로그인 시간이 지났다는 안내가 보이면 다시 로그인하거나 「모바일 앱으로 로그인」을 눌러 주세요.
mac에서 브라우저에 「페이지를 열 수 없음」이 보였다면 Safari 설정 → 보안의 「HTTP를 통해 웹 사이트에 연결하기 전에 경고」를 끈 뒤 다시 로그인해 주세요.
모바일 앱으로 로그인하기(QR 코드)
플러스를 구독하고 모바일 앱을 사용하고 있다면 QR 코드로도 로그인할 수 있습니다. 무료 계정은 위의 브라우저 로그인을 이용해 주세요.
-
로그인 화면 오른쪽 위의 「모바일 앱으로 로그인」을 눌러 주세요. 화면에 QR 코드가 나타납니다.
-
휴대폰에 「GDA (Game Dev Assistant)」 앱을 설치하고 Apple 또는 Google 계정으로 로그인해 주세요.
-
앱에서 「PC 연결하기」를 누르고 PC 화면의 QR 코드를 스캔해 주세요.
-
PC에 「확인 번호」가 뜨면 휴대폰에 같은 번호가 보이는지 확인하고 「연결」을 눌러 주세요. 번호가 다르면 「취소」를 누르고 「QR 코드 새로 만들기」로 다시 시작해 주세요.
브라우저 로그인으로 돌아가려면 「Google·Apple로 로그인」을 눌러 주세요. 연결할 수 있는 PC 수가 차 있으면 8.1 PC 바꾸기를 따라 주세요.
2.4 첫 프로젝트 만들기
프로젝트는 게임 하나를 만드는 폴더입니다. 왼쪽 위 「새 프로젝트」를 누르면 단계별 창이 열립니다. 단계는 「기본 정보」·「플랫폼」·「에이전트」·「참고자료」 넷이며, 아트 파트를 켜 두면 「이미지」 단계가 더해집니다.
-
기본 정보 : 「게임 제목」을 적고 「저장 위치」를 확인한 뒤 「다음」을 눌러 주세요.
- 저장 위치의 기본값은 설정 마법사에서 정한 폴더이며, 「폴더 선택」으로 바꿉니다.
- 「게임 제목으로 폴더 자동 생성」을 켜 두면 그 안에 게임 제목 폴더가 새로 만들어집니다(예 :
D:\GDA Projects\내 게임, mac은~/Documents/GDA Projects/내 게임). 실제 위치는 「저장될 폴더」에서 확인합니다.
-
플랫폼 : 「PC 전용」·「모바일 전용」·「PC + 모바일」·「웹 (HTML5)」 중 하나를 고르고 「다음」을 눌러 주세요. PC와 모바일 게임은 Godot 엔진을 사용합니다.
-
에이전트 : 함께 일할 파트를 체크해 주세요. 기획·아트·개발이 기본으로 켜져 있습니다.
- 파트마다 AI 서비스·모델·사고 깊이를 고릅니다. 그대로 두면 앱 설정의 값을 사용합니다.
- 사운드는 앱 설정 → 사운드에서 로컬 모델을 설치한 뒤 사용할 수 있습니다.
- QA는 개발 파트를 켜고 PC·모바일 플랫폼을 골라야 켤 수 있습니다.
-
이미지 : 아트 파트를 켜 두었을 때만 보입니다. 이미지를 만드는 방법을 골라 주세요. 방법은 나중에 프로젝트 설정에서 바꿀 수 있습니다.
- 「ChatGPT로 생성」(기본) : ChatGPT 계정을 사용합니다. 앱 설정 → 이미지에서 ChatGPT에 로그인하거나 OpenAI API 키를 넣어 주세요.
- 「내 PC에서 생성」 : 그래픽카드로 직접 만듭니다. 모델 계열(Z-Image·Illustrious·SDXL·Krea2·SD 1.5) 중 하나를 골라 주세요. 설치되지 않은 계열은 「다운로드」를 눌러 모델 파일을 다운로드해 주세요. 다운로드 중에도 다음 단계로 갈 수 있지만, 이미지는 다운로드가 끝난 뒤에 만들 수 있습니다.
-
참고자료 : 필요하면 「참고할 게임」에 게임 이름이나 링크를 적고, 참고할 파일을 「문서」·「이미지」·「영상」 칸에 끌어다 놓아 주세요. 없어도 됩니다. 마지막으로 「프로젝트 생성」을 눌러 주세요.
저장 위치에 이미 다른 파일이 있으면 프로젝트를 만들 수 없습니다. 비어 있는 폴더를 골라 주세요. 파트와 플랫폼은 나중에 프로젝트 설정에서 바꿀 수 있습니다(7.2 프로젝트 설정).
2.5 첫 대화와 첫 승인
프로젝트를 만들면 가운데 「홈」에 「상상한 게임, 여기서 시작해요.」와 시작 버튼 네 개가 보입니다. 하나를 골라 기획 채팅을 시작해 주세요.
- 「시작해보기」 : 기획 에이전트가 프로젝트를 살펴보고 필요한 질문을 하나씩 합니다. 답을 채팅으로 보내 주세요.
- 「만들고 싶은 게임이 있어요」 : 기획 채팅의 입력창에 「만들고 싶은 게임은 」이 채워집니다. 이어서 적고 보내 주세요.
- 「기획·메모로 시작하기」 : 파일 선택 창이 열립니다. 가지고 있는 기획 문서를 골라 보내 주세요.
- 「아이디어 받기」 : 소재 키워드를 골라 아이디어를 받습니다(4.1).
대화를 하다 보면 에이전트가 내용을 확정해도 되는지 묻는 승인 카드가 채팅에 뜹니다. 카드 제목은 「이렇게 반영하시겠습니까?」입니다.
- 카드의 요약과 대상 파일을 읽어 주세요.
- 괜찮으면 「승인」, 받아들이지 않으면 「반려」, 고칠 점이 있으면 「수정」을 눌러 주세요.
- 결정하면 카드가 한 줄로 접히고 에이전트가 이어서 작업합니다.
결정하지 않은 카드가 있으면 입력창 위에 「승인 대기 N건 : 카드로 이동」이 보이고, 왼쪽 파트 이름 옆에 물음표가 붙습니다. 자세한 내용은 4.2 승인 카드에 있습니다.
화면 둘러보기
GDA 화면은 위쪽 상단 바, 왼쪽 사이드바, 가운데 작업 영역, 오른쪽 패널, 맨 아래 상태 표시줄로 나뉩니다. 프로젝트를 열면 가운데에 「홈」이 먼저 보입니다(3.6 홈).
3.1 상단 바와 프로젝트 메뉴
상단 바에서는 지금 연 프로젝트를 확인하고, 그 프로젝트에서 사용하는 화면을 엽니다.
- 왼쪽에는 GDA 버전이, 가운데에는 프로젝트 이름이 보입니다. 이름을 누르면 프로젝트 폴더 위치가 펼쳐집니다.
- 오른쪽 「프로젝트 메뉴」를 누르면 아래 항목이 열립니다.
- 「할 일」·「메모」 : 내가 할 일과 메모를 적습니다(4.5).
- 「개발일지」 : 지금까지의 진행을 날짜별 일지로 정리합니다(4.6).
- 「노드 목록」 : Godot 화면의 버튼 같은 요소에 바라는 점을 적습니다. 웹(HTML5) 프로젝트에는 없습니다.
- 「사운드」 : 내 PC의 음악·효과음·음성 폴더를 연결해 듣습니다.
- 「프로젝트 설정」 : 파트·플랫폼·참고자료 같은 프로젝트 설정을 엽니다(7.2).
- 「도움말」 : 이 도움말을 처음부터 엽니다. 화면 곳곳의 물음표 버튼을 누르면 그 화면의 설명으로 바로 갑니다.
Godot 실행 승인을 기다리는 작업이 있으면 상단 바에 「실행 승인 N」 버튼이 생깁니다.
「앱 다시 연결 중」이 보이면 화면과 GDA 내부 연결이 잠시 끊긴 상태입니다. 인터넷 연결과는 관계없으며, 잠시 기다리면 다시 연결됩니다.
3.2 사이드바(프로젝트와 파트)
사이드바에서 프로젝트를 만들거나 열고, 작업할 파트를 고릅니다. 위쪽 「새 프로젝트」로 새로 만들고, 「프로젝트 열기」로 PC에 있는 GDA 프로젝트 폴더를 엽니다.
- 연 프로젝트 아래에는 「홈」과 켜 둔 파트가 차례로 보입니다. 「홈」을 누르면 홈 탭이, 파트 이름을 누르면 그 파트 채팅이 열립니다.
- 파트 상태(「시작 전」·「대기 중」·「처리 중」 등)는 파트 이름 오른쪽에 늘 보입니다.
- 프로젝트 이름을 다시 누르면 파트 목록을 접거나 펼칩니다. 접힌 동안 새 활동이나 결정 대기가 있으면 프로젝트 이름 옆에 점이 보입니다.
- 파트 이름 옆 종 표시는 새 답변이나 받은 요청이 있다는 뜻입니다. 물음표 표시는 사용자의 결정을 기다린다는 뜻입니다.
- 닫힌 프로젝트에는 「최근 프로젝트 · 눌러서 열기」가 보입니다. 누르면 다시 열립니다.
- 「폴더를 찾지 못했습니다」나 「현재는 폴더를 열 수 없습니다」가 보이면 9.5 자주 묻는 질문을 확인해 주세요.
- 프로젝트 오른쪽 「…」 메뉴에는 「상단 고정」·「프로젝트 설정」·「목록에서 제거」가 있습니다. 「목록에서 제거」는 목록에서만 빼며, 폴더와 파일은 그대로 남습니다.
맨 아래에는 AI 서비스 「사용량」과 「앱 설정」 버튼이 있습니다. 「사용량」은 연결한 Claude·ChatGPT 계정의 한도를 얼마나 사용했는지 보여 줍니다.
3.3 가운데 작업 영역
가운데에서는 홈·파트 채팅·문서를 탭으로 열어 작업합니다.
- 맨 앞 「홈」 탭은 늘 있으며 닫을 수 없습니다(3.6).
- 파트 채팅 탭도 닫히지 않습니다. 파일을 열면 생기는 문서 탭은 탭의 ×로 닫습니다.
- 탭 줄 오른쪽 끝의 「자율 진행」은 승인을 묻지 않고 작업을 이어 가게 하는 버튼입니다(4.7).
- 프로젝트를 바꾸면 그 프로젝트의 탭이 그대로 다시 보입니다.
프로젝트를 열지 않았을 때는 「새 프로젝트」와 「프로젝트 열기」 버튼이 있는 시작 화면이 보입니다.
채팅 탭 머리에는 파트 이름, 지금 상태, 사용하는 AI 서비스가 보입니다. 채팅 사용법은 4장 채팅으로 일하기에 있습니다.
3.4 우측 패널
오른쪽 패널은 지금 고른 파트의 결과물을 보여 줍니다. 「파일」 탭은 모든 파트에 공통이고, 그 뒤 탭은 파트마다 다릅니다.
- 기획 : 「기획서」·「게임 규칙」·「데이터」·「미결」
- 시나리오 : 「본문」·「카드」·「미결」
- 아트 : 「이미지」·「스타일」·「로컬」
- 개발 : 「엔진」(웹(HTML5) 프로젝트는 「미리보기」·「엔진」)
- 사운드 : 「사운드」
- QA : 「결과」
- 홈 : 「게임」·「파일」
다른 파트가 보낸 요청은 「파일」 탭의 requests 폴더 안에 파일로 보입니다(4.3).
패널 오른쪽 위 버튼으로 패널을 접고 펼 수 있습니다. 할 일·메모·노드 목록을 열면 오른쪽 패널은 숨겨집니다.
3.5 상태 표시줄
맨 아래 상태 표시줄은 연결 상태를 한눈에 보여 줍니다.
- 왼쪽 : 연결한 AI 서비스마다 「Claude 사용」·「Claude 미사용」처럼 보입니다. 누르면 앱 설정이 열립니다. 그 옆 「실행 중 N개 파트」는 지금 일하고 있는 파트 수입니다.
- 오른쪽 : 로컬 엔진(이미지·음성·음악·효과음 엔진)의 상태와 Godot 연결 상태(「Godot 준비됨」·「Godot 미지정」 등)가 보입니다. Godot 항목을 누르면 앱 설정 → 프로젝트의 「Godot 엔진 연결」이 열립니다.
- 맨 오른쪽 해·달 아이콘은 어두운 화면과 밝은 화면을 바꿉니다.
로컬 엔진은 처음 요청할 때 저절로 켜지고, 사용하지 않으면 잠시 뒤 스스로 꺼집니다. 켜져 있는 엔진을 누르면 바로 끌 수 있습니다.
Godot 실행 승인을 기다리는 작업이 있으면 「승인 대기 N」이 생깁니다. 누르면 승인 창이 열립니다.
3.6 홈
홈에서는 게임이 지금 어디까지 만들어졌는지 한눈에 보고, 다음에 할 일을 고릅니다. 프로젝트를 열면 가운데 맨 앞 「홈」 탭이 먼저 열립니다.
- 「현재 진행」 : 전체 진행률, 파트별 진행 막대, 체크포인트(「첫 판」·「연결」·「채움」·「빌드」)를 보여 줍니다. 막대는 기획에서 목록을 만들면 표시됩니다.
- 「게임 흐름」 : 게임 화면을 순서대로 이어 보여 줍니다. 칸마다 시안 그림과 상태(「씬 없음」·「씬 있음」·「플레이 가능」·「깨짐」)가 보입니다. 그림을 누르면 크게 봅니다.
- 「빌드 준비」 : 게임을 내보낼 준비가 되면 「내보내기 준비됨」이 보입니다. 아직이면 「아직 아님」과 함께 「빈 화면」·「깨진 참조」·「자리표시자」 개수가 보입니다.
위쪽 버튼으로 바로 작업을 맡깁니다.
- 「갱신」 : 기획 파트가 코어 루프·게임 흐름과 에셋 목록을 지금 상태에 맞게 고칩니다. 확인 창에서 「승인」을 눌러 주세요.
- 「플레이」 : 게임을 실행합니다. 처음 실행할 때는 Godot 실행 승인 창이 뜹니다(5.4). 웹(HTML5) 프로젝트는 개발 파트의 「미리보기」 탭이 열립니다.
- 「이 화면 시안 만들기」 : 「게임 흐름」에서 칸을 고른 뒤 누르면, 그 화면의 UI 시안 2장을 아트 파트에 요청합니다.
꺼진 파트로 가는 버튼은 보이지 않습니다. 홈이 열려 있는 동안 오른쪽 패널에는 「게임」·「파일」 탭이 보이며, 「게임」 탭에는 이 게임의 한 문장 소개와 코어 루프가 있습니다.
채팅으로 일하기
4.1 요청 보내기
파트 채팅에서 에이전트에게 일을 맡깁니다. 입력창에 하고 싶은 일을 평소 말로 적고 Enter를 눌러 주세요. 줄을 바꾸려면 Shift+Enter를 누릅니다.
내가 보낸 메시지는 오른쪽에, 에이전트의 답변은 왼쪽에 이어서 보입니다.
파일·이미지 첨부
-
입력창 위 「파일 첨부」를 누르거나, 파일을 채팅 창에 끌어다 놓아 주세요.
-
복사한 이미지(예 : 화면 캡처)는 입력창에서 Ctrl+V(mac은 Cmd+V)로 붙여 넣습니다. 붙여 넣은 이미지는 「클립보드-날짜-시간.png」 이름으로 첨부됩니다.
-
첨부한 파일은 입력창 위에 칩으로 보입니다. 빼려면 칩의 ×를 눌러 주세요.
-
요청 글을 적고 보내 주세요. 첨부한 파일은 프로젝트 안에 복사되어 에이전트에게 함께 전달됩니다.
- 한 번에 10개, 메시지 하나에 모두 합해 20개까지 첨부할 수 있습니다.
- 파일 하나는 10 MB, 한 번에 올리는 합계는 100 MB까지입니다. 폴더는 첨부할 수 없습니다.
- 아주 큰 문서는 앞부분만 읽습니다. 이때는 문서 끝에 「[… 이후 생략: …]」 안내가 붙어 에이전트가 일부만 읽었다는 것을 압니다. 필요한 부분을 나누어 첨부해 주세요.
- 아트 「이미지」 탭에서 고른 이미지는 「채팅에 첨부」로 넣습니다.
막혔을 때
- 「막혔어요」 : 방향을 다시 잡는 문장 칩이 열립니다. 칩을 고르면 입력창에 채워지고, 확인한 뒤 보내 주세요.
- 「다음 일은?」 : 에이전트에게 진행 상황과 다음에 할 일을 바로 묻습니다.
아이디어 받기
기획·시나리오 채팅의 「아이디어 받기」를 누르면 소재 키워드를 고르는 창이 열립니다. 마음에 드는 칩을 고르거나 「내 키워드」에 쉼표로 적은 뒤 「전송」을 눌러 주세요. 고르기 어렵다면 「아무거나 골라 줘」를 누릅니다.
에이전트에게 맡길 수 있는 일
- 대화가 없는 채팅에는 「지금 할 수 있는 일」 칩이 보입니다. 누르면 그 문장이 바로 전송됩니다.
- 각 파트 에이전트는 자기 파트 폴더의 문서를 형식과 관계없이 고칩니다. Excel·Word·PowerPoint 문서도 고치고, PDF는 새로 만듭니다.
- 파일 옮기기·이름 바꾸기, zip 압축 풀기도 채팅으로 요청할 수 있습니다. 아트·개발 파트는 이미지 크기도 바꿉니다.
4.2 승인 카드
에이전트가 내용을 확정하기 전에 결정이 필요하면 채팅에 승인 카드를 띄웁니다. 카드 제목은 「이렇게 반영하시겠습니까?」입니다. 요약과 대상 파일(「신규」·「수정」·「삭제」)이 보이고, 「초안 열기」로 초안을 먼저 볼 수 있습니다.
- 그대로 받아들이려면 「승인」을 눌러 주세요.
- 받아들이지 않으려면 「반려」를 누르고, 필요하면 사유를 적은 뒤 「반려 보내기」를 눌러 주세요.
- 고칠 점이 있으면 「수정」을 눌러 주세요. 채팅에 「수정할 내용을 입력해 주세요.」가 보이면 입력창에 고칠 내용을 적어 보내 주세요(600자까지). 그만두려면 입력창 위 「수정 내용 입력 중」 칩의 ×를 누릅니다.
- 반영하지 않고 카드만 닫으려면 「폐기」를 눌러 주세요.
카드 위쪽에 「결정 대기 중 : 에이전트가 이 턴에서 이어서 진행합니다」가 보이면 결정 즉시 에이전트가 이어서 작업합니다. 「다음 턴에 반영됩니다」가 보이면 결정이 다음 대화 차례에 전달됩니다. 결정한 카드는 한 줄로 접히며, 누르면 다시 펼쳐집니다.
기획 문서·시나리오 문서·개발 코드처럼 계속 고쳐 가는 결과물은 카드 없이 바로 고칩니다.
그 밖의 카드
아래 카드는 결정할 때까지 그 파트 작업이 멈춥니다. 카드에 「결정 전까지 작업이 일시 중지됩니다」가 보입니다.
- 「이 외부 링크를 열도록 허용하시겠습니까?」 : 에이전트가 외부 링크를 열려고 할 때 뜹니다. 열 사이트를 확인한 뒤 「승인」 또는 「반려」를 눌러 주세요.
- 「서브에이전트 사용을 허용하시겠습니까?」 : 에이전트가 일을 나눠 맡을 서브에이전트를 사용하려고 할 때 뜹니다. 서브에이전트를 사용하면 토큰 사용량이 크게 늘어납니다.
- 「에이전트가 묻습니다」 : 에이전트가 선택지를 보여 주며 묻는 카드입니다. 하나를 고르거나 「직접 입력」에 적고 「답변 보내기」를 눌러 주세요. 답하지 않으려면 「건너뛰기」를 누릅니다.
- 「(파트) 에이전트가 작성한 스크립트를 이 PC에서 실행하시겠습니까?」 : 에이전트가 만든 계산용 스크립트를 처음 실행할 때 뜹니다. 카드에서 실행할 스크립트, 읽는 곳(프로젝트 폴더 전체), 쓰는 곳을 확인해 주세요. 「이 스크립트는 인터넷에 접속할 수 있습니다.」 안내도 함께 보입니다.
- 「이 프로젝트에서 허용」을 누르면 이 프로젝트에서는 다시 묻지 않습니다.
- 허용은 프로젝트 설정 → 고급의 「허용 취소」로 되돌립니다.
4.3 수신 요청과 미결
파트 사이 요청(수신함)
파트끼리는 요청 파일로 일을 주고받습니다. 예를 들어 개발 파트가 기획 변경이 필요하면 기획 파트에 요청을 보냅니다. 다른 파트에 일을 넘기고 싶을 때는 채팅에서 「개발 파트에 전달해 주세요」처럼 요청해 주세요.
받은 요청은 「파일」 탭의 requests/<파트> 폴더(예 : requests/plan)에 파일로 쌓입니다. 이 폴더가 각 파트의 수신함입니다.
- 요청이 오면 GDA가 받는 파트에 자동으로 넘깁니다. 받는 파트 채팅에는 「(파트)의 요청을 받아 처리합니다 · 제목」 줄이 보입니다.
- 자동으로 처리하는 요청에서는 이미지·사운드 생성, 게임·스크립트 실행, 다른 파트로의 전달, 승인 요청을 하지 않습니다. 결과만 보고하고 다음 지시를 기다리니, 필요한 일은 그 파트 채팅에서 요청해 주세요.
- 받는 파트가 꺼져 있거나 로그인 전이면 요청은 파일로 남고, 그 파트를 다시 사용할 때 처리됩니다.
- 요청 문서는 읽기 전용입니다. 필요 없는 요청은 파일을 우클릭해 「삭제」하면 휴지통으로 옮겨집니다.
처리 결과를 확정할 때는 그 파트 채팅에서 승인을 거칩니다(4.2). 「자율 진행」을 켜 두면 문서·코드·표 작업은 승인을 묻지 않고 끝까지 처리합니다(4.7).
미결
기획·시나리오의 「미결」 탭에는 에이전트가 판단을 미루고 사용자에게 맡긴 항목이 「결정할 항목 N개」로 모입니다. 탭 이름 옆 숫자가 남은 개수입니다.
- 「상세 보기」 : 항목의 내용과 출처를 펼쳐 봅니다.
- 「채팅」 : 그 항목을 정하는 대화를 채팅에서 바로 시작합니다. 에이전트가 배경과 선택지를 정리해 보여 줍니다.
- 「제거」 : 확인 창에서 한 번 더 확인한 뒤 목록에서 뺍니다.
4.4 세션
세션은 한 파트 채팅에서 에이전트와 이어지는 대화입니다. 이 절에서는 진행 상태를 보고, 세션을 멈추거나 새로 시작하는 방법을 설명합니다.
파트 상태는 채팅 머리와 사이드바에 「시작 전」·「에이전트 준비 중」·「대기 중」·「처리 중」처럼 보입니다. 에이전트가 일하는 동안에는 에이전트 이름 옆에 「진행 중」이 보이고, 그 아래에 「생각 중」·「작업 N건 실행 중」·「답변 작성 중」과 걸린 시간이 나옵니다.
토큰·컨텍스트 배지
채팅 머리의 「컨텍스트 n% · 입력 N · 출력 N」은 이 세션이 사용한 토큰 양입니다. 비용이나 요금이 아니며, 사이드바의 「사용량」과도 다릅니다.
- 「컨텍스트」 : 에이전트가 한 번에 기억할 수 있는 대화 한도 가운데 마지막 응답 기준으로 찬 비율입니다. 한도를 알 수 없으면 비율 대신 토큰 수로 보입니다.
- 「입력」·「출력」 : 이 세션에서 지금까지 주고받은 토큰의 누계입니다.
- 컨텍스트 비율이 높아지면 에이전트가 앞선 내용을 잊기 쉽습니다. 「새 세션」으로 새로 시작해 주세요.
- 값을 알려 주지 않는 AI 서비스에서는 배지가 보이지 않거나 일부 칸만 보입니다.
채팅 머리 버튼
- 「강제 중지」 : 지금 처리 중인 요청을 멈춥니다.
- 「새 세션」 : 메모리는 그대로 두고 채팅 화면을 비운 뒤, 다음 요청부터 새로 시작합니다.
- 「세션 종료」 : 최근 작업과 다음 시작점만 파트 메모리에 저장하고 이번 세션을 마칩니다.
- 「서브에이전트 N개」 : 지금 일하는 서브에이전트가 있을 때만 보입니다. 누르면 종류와 한 줄 설명이 펼쳐집니다.
대기와 재전송
- 일하는 중에 보낸 메시지는 입력창 위 「대기 N건」에 쌓였다가 차례로 전달됩니다. 「편집」을 누르면 대기에서 빠져 입력창으로 돌아오고, 「삭제」로 지웁니다.
- 오류로 전달되지 못한 메시지는 「재전송」을 눌러 다시 보냅니다.
- 전달 결과가 확실하지 않은 메시지는 「결과 확인 필요」로 남습니다. 「재전송」이나 「삭제」를 눌러 주세요.
- 세션에 문제가 생기면 원인 한 줄과 「새 세션」 버튼이 보입니다. 「새 세션」을 누르면 다음 요청부터 새로 시작합니다.
여러 파트와 앱 종료
여러 파트가 동시에 일할 수 있고, 상태 표시줄의 「실행 중 N개 파트」로 확인합니다.
앱을 닫으면 「앱을 종료하시겠습니까? 열린 대화의 메모리를 정리한 뒤 종료합니다.」가 뜹니다.
- 「종료」를 누르면 「메모리 정리 중…」 창이 보이고, 에이전트가 진행 내용을 기억 파일에 정리한 뒤 앱이 닫힙니다.
- 기다리기 어려우면 「건너뛰고 종료」를 눌러 주세요.
mac에서는 창을 닫거나 Cmd+Q를 눌러도 같은 확인 창을 거쳐 종료됩니다. 대화 기록은 그대로 남아, 다음에 앱을 열어 이어서 요청할 수 있습니다.
4.5 할 일·메모·노드
「프로젝트 메뉴」에서 여는 사용자용 화면입니다. 가운데 탭으로 열립니다.
할 일
- 「할 일 추가」를 눌러 제목·마감일·체크리스트·상세 내용을 적고 「저장」을 눌러 주세요.
- 항목은 「할 일」·「완료」·「보류」로 나뉩니다. 고른 항목에서 「수정」·「완료 처리」·「보류 처리」·「할 일로 복귀」를 누릅니다.
- 항목을 우클릭하거나 「…」를 누르면 「삭제」가 나옵니다.
메모
「항목 추가」를 눌러 제목과 내용을 적고 「저장」을 눌러 주세요. 메모마다 「수정」·「삭제」가 있습니다.
노드 목록
개발 파트가 Godot 화면의 요소(버튼 등)를 확인해 게시하면 「노드 목록」에 보입니다. Godot 프로젝트에서만 사용할 수 있습니다.
-
왼쪽 목록에서 노드를 골라 주세요. 「현재 기능」에 지금 하는 일이 보입니다.
-
「사용자 요청」에 바라는 동작이나 변경을, 「비고」에 참고할 내용을 적어 주세요. 버튼이면 「효과음」도 고를 수 있습니다. 적은 내용은 저절로 저장되고 「저장 완료」가 보입니다.
-
개발 채팅에 「노드 목록의 요청을 반영해 주세요」처럼 보내 주세요.
4.6 개발일지
개발일지는 지금까지의 진행을 날짜별로 정리한 기록입니다. 「프로젝트 메뉴」 → 「개발일지」에서 엽니다.
-
「생성」을 눌러 주세요. 기획 파트가 지난 일지 이후의 진행·결정·할 일·QA 결과를
plan/devlog/오늘 날짜.md에 정리합니다. -
일지가 만들어지면 목록에 날짜별로 나타납니다. 누르면 문서로 열려 고칠 수 있습니다.
-
「복사」를 누르면 일지 내용을 복사해 다른 곳에 붙여 넣을 수 있습니다.
같은 날 다시 「생성」을 누르면 그날 일지에 이어서 씁니다. 기획 파트가 꺼져 있으면 개발일지를 만들 수 없습니다.
4.7 자율 진행
자율 진행을 켜면 에이전트가 승인이나 선택을 묻지 않고 작업을 끝까지 마친 뒤, 결과를 한 번에 보고합니다. 프로젝트마다 따로 켜며, 처음에는 꺼져 있습니다.
-
가운데 탭 줄 오른쪽 끝의 「자율 진행」을 눌러 주세요.
-
창이 열리면 자율 진행 동안 묻지 않고 허용할 항목을 체크해 주세요. 이미 허용한 항목은 목록에 없습니다.
- 「Godot 실행 허용」·「스크립트 실행 허용」 : 처음에 체크되어 있습니다. 웹(HTML5) 프로젝트에는 Godot 항목이 없습니다.
- 「외부 링크 자동 허용」 : 처음에 꺼져 있습니다. 켜면 프로젝트 내용이 외부 사이트로 나갈 수 있습니다.
- 「서브에이전트 자동 허용」 : 처음에 꺼져 있습니다. 켜면 토큰 사용량이 크게 늘어납니다.
-
「승인」을 누르면 자율 진행이 켜집니다.
체크하지 않은 항목은 지금처럼 카드로 묻습니다. 자율 진행 중에 자동으로 승인된 카드에는 「승인 · 자율 진행 자동 승인」이 남습니다.
다른 파트가 넘긴 요청을 처리할 때도 같은 설정이 적용되어, 문서·코드·표 작업을 승인 없이 끝까지 진행합니다. 다만 이미지·사운드 생성, 게임·스크립트 실행, 다른 파트로의 전달은 이때도 하지 않고 보고로 남깁니다. 필요하면 그 파트 채팅에서 요청해 주세요.
자율 진행을 끄려면 같은 버튼을 다시 누릅니다. 끄면 외부 링크·서브에이전트 자동 허용도 함께 풀립니다. 프로젝트 설정 → 기본의 「자율 진행」에서도 켜고 끄거나 항목을 바꿀 수 있습니다(7.2).
파트별 안내
5.1 기획
기획 파트는 아이디어를 게임 기획서로 정리합니다. 기획 채팅에 만들고 싶은 게임을 이야기하면, 에이전트가 컨셉·게임 흐름·시스템 문서를 plan/ 폴더에 쓰고 계속 고쳐 갑니다.
-
기획 채팅에서 원하는 게임을 이야기하고 에이전트의 질문에 답해 주세요.
-
오른쪽 「기획서」 탭에서 문서를 눌러 읽어 주세요. 직접 고칠 수도 있습니다(6.3).
-
기획이 어느 정도 모이면 「게임 규칙」 탭 위의 「규칙 생성」을 눌러 주세요. 확인 창에서 한 번 더 확인하면 기획서 전체로 규칙을 만들도록 기획 파트에 요청합니다. 규칙은 개발 파트가 구현할 때 기준으로 삼는 정리본입니다.
-
「데이터」 탭에서 아이템·레벨 같은 데이터 표를 확인해 주세요. 표를 누르면 가운데에서 표로 열려 고칠 수 있습니다.
- 「밸런스 점검」 : 「데이터」 탭 위의 버튼입니다. 지금 표로 게임 밸런스를 계산해 달라고 기획 채팅에 요청하고, 결과는 채팅에 표로 옵니다. 처음 점검할 때는 스크립트 실행 허용 카드가 뜰 수 있습니다(4.2).
- 「플레이 시안 만들기」 : 「기획서」 탭 위의 버튼입니다. 지금 기획으로 한 장짜리 HTML 플레이 시안을 개발 파트에 요청합니다. 시안은 게임이 아니며
temp/dev/시안/에 만들어집니다. 다 만들어지면 개발 채팅 머리의 「플레이 시안 열기」로 봅니다. - 에이전트가 사용자에게 맡긴 결정은 「미결」 탭에 모입니다(4.3).
5.2 시나리오
시나리오 파트는 세계관·등장인물·본문·대사를 씁니다. 시나리오 채팅에 쓰고 싶은 이야기를 요청해 주세요.
-
「본문」 탭 : 이야기 본문 문서가 모입니다. 위쪽 「대사 추출」을 누르면 본문 전체에서 대사 표(
game/locale/dialogue.csv)를 만들도록 시나리오 채팅에 요청합니다. 대사 표는 이 버튼을 누를 때만 갱신되므로, 본문을 고친 뒤 대사 표가 뒤처져 있어도 정상입니다. -
「카드」 탭 : 등장인물·장소 같은 설정 카드와 「타임라인·복선」이 접힌 카드로 보입니다. 카드를 누르면 펼쳐 읽고, 「상세 보기」를 누르면 문서 탭으로 열립니다.
-
「미결」 탭 : 시나리오 에이전트가 사용자에게 맡긴 결정이 모입니다(4.3).
5.3 아트
아트 파트는 캐릭터·배경·아이템·UI 이미지를 만듭니다. 이미지를 만들려면 GPT 이미지(앱 설정 → 이미지)나 로컬 이미지 엔진 중 하나가 준비되어 있어야 합니다. 준비가 안 되어 있으면 아트 채팅 위에 안내와 「이미지 설정 열기」 버튼이 보입니다.
-
아트 채팅에 필요한 이미지를 요청해 주세요(예 : 「주인공 캐릭터 시안을 만들어 주세요」).
-
새로 만든 이미지는 바로 「사용 중」이 되어 게임 폴더(
game/assets)에 저장되고, 개발 파트가 사용합니다. 여러 장을 만들면 첫 장이 「사용 중」, 나머지는 「대기」가 됩니다. -
「이미지」 탭의 「대상별」 보기에서 대상마다 만든 이미지와 진행 단계(「시안」·「시트」·「프레임」·「저장」)를 확인해 주세요. 사용 중인 이미지에는 별 표시가 붙습니다. 다른 장을 사용하려면 그 장에서 「사용」을 누릅니다.
-
이미지를 두 번 누르면 크게 봅니다. 경로·크기를 확인하고 아래 「수정」·「사용」·「삭제」를 누릅니다. 「수정」은 고칠 내용을 적어 「보내기」를 누르면 아트 채팅에 바로 요청합니다.
이미지 다루기
- 이미지를 우클릭하면 「수정」·「사용」·「삭제」가 나옵니다. 캐릭터 이미지에는 「시트 만들기」·「애니메이션」·「투명 처리」가 더 있고, 배경이 아닌 이미지에는 「투명 처리」가 있습니다.
- 「선택」을 누르면 여러 장을 골라 「전체 선택」·「채팅에 첨부」·「사용」·「삭제」를 한 번에 합니다. 「대상별」·「그리드」 보기 모두에서 사용할 수 있습니다.
- 위쪽 필터로 「전체」·「사용 중」·「대기」를 고르고, 카테고리 칩으로 종류를 좁힙니다.
- 삭제한 이미지는 휴지통으로 옮겨집니다. 사용 중인 이미지는
game/assets의 사본도 함께 옮겨집니다.
탭 위쪽 버튼
- 「에셋 점검」 : 게임에서 사용하지 않는 파일, 깨진 참조(게임이 가리키는 파일이 없음), 남은 자리표시자 등을 찾아 보여 줍니다. 항목을 체크해 「삭제」하거나 「개발에 보내기」로 수정을 요청합니다. 「다시 점검」으로 다시 확인합니다.
- 「UI 시안 제작」 : 기획서를 바탕으로 핵심 화면 하나의 UI 시안 2장을 만듭니다. 사용 중인 시안은 개발 파트가 화면 배치에 참고합니다.
- 「UI 리소스 추출」 : 사용 중인 UI 시안을 바탕으로 여러 화면에 공통으로 사용하는 UI 리소스(버튼·창 틀·아이콘 등)를 만듭니다.
픽셀 아트 게임
그림체를 픽셀 아트(도트)로 정하면 픽셀 아트 게임으로 만듭니다.
- 아트 채팅에 「그림체를 픽셀 아트로 정해 주세요」처럼 요청해 주세요. 스타일 프롬프트에 반영됩니다.
- 폭발·불·마법·타격 같은 이펙트가 필요하면 「폭발 이펙트를 만들어 주세요」처럼 요청해 주세요. 아트 파트가 픽셀 이펙트를 바로 만듭니다.
픽셀 아트 게임의 화면 기준 해상도는 960×540(세로 게임 540×960)입니다. 배경·UI도 이 크기에 맞춰 만듭니다.
스타일과 로컬 이미지 엔진(선택)
「스타일」 탭의 「엔진」에서 「생성 방식」(OpenAI 또는 로컬 엔진)과 모델을 고르고 「저장」을 눌러 주세요. 아래 「스타일 프롬프트」는 모든 이미지에 사용되는 그림체 설명이며 읽기 전용입니다. 바꾸려면 아트 채팅에 요청해 주세요.
로컬 이미지 엔진은 내 PC의 그래픽카드(mac은 Mac 메모리)로 이미지를 만드는 선택 기능입니다.
- 앱 설정 → 이미지의 「로컬 이미지」에서 모델 파일을 다운로드해 주세요(7.1).
- 「스타일」 탭에서 「생성 방식」을 「로컬 엔진」으로 바꾸고 「저장」을 눌러 주세요. 로컬 엔진이 함께 켜지고 아트에 「로컬」 탭이 열립니다. 프로젝트 설정 → 고급의 「로컬 이미지 엔진」에서도 켜고 끌 수 있습니다.
- 「로컬」 탭에서 모델·VAE·단계·LoRA 같은 세부 설정을 고릅니다.
5.4 개발
개발 파트는 Godot 프로젝트에 장면과 코드를 만들어 실제로 움직이는 게임을 만듭니다. 먼저 앱 설정 → 프로젝트의 「Godot 엔진 연결」에서 Godot를 연결해 주세요(7.1).
-
개발 채팅에 만들 기능을 요청해 주세요. 개발 파트는 기획의 규칙과 아트가 저장한 이미지를 바탕으로 작업합니다.
-
오른쪽 「엔진」 탭의 「게임 실행」을 눌러 게임을 실행해 주세요. 특정 장면만 보려면 「장면」에서 .tscn 파일을 고르고 「실행」을 누릅니다. 결과와 로그는 「실행 기록」에 남습니다.
-
처음 실행할 때는 「Godot 실행 승인」 창이 뜹니다. 내용을 확인하고 「이 프로젝트의 Godot 실행 허용」을 눌러 주세요. 한 번 허용하면 이 프로젝트에서는 다시 묻지 않으며, 개발·QA 파트의 게임 실행과 플레이 테스트에 모두 적용됩니다.
- Godot는 내 계정 권한으로 실행되어 파일·인터넷 사용이 제한되지 않습니다.
- 지금 결정하기 어려우면 「나중에 결정」을 눌러 주세요. 상단 바 「실행 승인 N」이나 상태 표시줄 「승인 대기 N」으로 다시 열 수 있습니다. 실행하지 않으려면 「거절」을 누릅니다.
- 허용은 「엔진」 탭의 「허용 취소」로 되돌립니다.
- 「엔진」 탭의 「에셋 점검」은 아트 「이미지」 탭과 같은 점검입니다(5.3).
화면 크기
개발 파트는 게임 화면이 창 크기에 맞춰 늘어나도록 만드는 것이 기본입니다. 기준 해상도는 1920×1080(세로 게임 1080×1920)이고, 픽셀 아트 게임은 절반인 960×540(세로 게임 540×960)입니다. 다른 방식이 필요하면 개발 채팅에 요청해 주세요.
게임 내보내기
완성한 게임을 실행 파일로 만들려면 개발 채팅에 「Windows용으로 내보내 주세요」처럼 요청해 주세요. 내보낼 수 있는 대상은 Windows 실행 파일·웹(HTML5)·안드로이드(APK)·macOS 앱입니다.
-
개발 에이전트가 내보내기를 시작하면 승인 창에 「게임 내보내기(대상) 실행을 허용하시겠습니까?」가 뜹니다. 이 프로젝트에서 Godot 실행을 아직 허용하지 않았다면 「이 프로젝트의 Godot 실행 허용」을 눌러 주세요.
-
내보내기가 끝나면 에이전트가 결과 위치를 채팅으로 알려 줍니다. 결과는 프로젝트의
build폴더에 들어갑니다.
내보내기에는 Godot 내보내기 템플릿이 필요합니다. 없으면 개발 에이전트가 설치 방법을 안내합니다.
macOS 앱은 mac에서 GDA를 실행할 때만 내보낼 수 있습니다.
- 결과는
build/macos폴더의 zip 파일입니다. 압축을 풀고 .app을 열어 확인해 주세요. - 서명·공증이 없어 본인 Mac에서 테스트하는 용도입니다. 다른 Mac에 전달하거나 배포하려면 Apple 서명·공증이 따로 필요합니다.
- Windows에서 macOS 앱을 요청하면 「Windows에서는 Mac용 게임을 만들 수 없습니다. Mac에서 GDA를 실행한 뒤 내보내 주세요.」라는 안내를 개발 에이전트가 전해 줍니다.
- macOS 앱은
project.godot의 텍스처 설정(ETC2 ASTC)이 켜져 있어야 만들어집니다. 설정이 없으면 개발 에이전트가 한 줄을 추가한 뒤 다시 내보냅니다.
웹(HTML5) 프로젝트
웹 플랫폼으로 만든 프로젝트는 엔진 없이 HTML·CSS·JavaScript로 만듭니다.
- 개발 파트 오른쪽 「미리보기」 탭에 게임이 바로 보입니다. 개발 파트가 작업을 마치면 저절로 새로 고쳐지며, 「새로고침」으로 직접 다시 읽을 수도 있습니다.
- 「새 창에서 열기」를 누르면 브라우저 창으로 봅니다.
- 플레이 시안을 보고 있을 때는 「플레이 시안 보는 중」이 보입니다. 게임으로 돌아가려면 「게임으로 전환」을 눌러 주세요.
- 게임 파일이 아직 없으면 「게임 파일이 아직 없습니다」가 보입니다.
- 「엔진」 탭의 「웹 미리보기」에서는 「브라우저에서 열기」·「미리보기 중지」를 사용합니다.
5.5 사운드
사운드 파트는 배경음악·효과음·음성을 만듭니다. 내 PC에서 돌아가는 로컬 모델을 사용하므로 먼저 준비해 주세요.
-
프로젝트 설정 → 사용 파트에서 「사운드」를 켜 주세요(7.2).
-
앱 설정 → 사운드에서 필요한 모델 파일의 「다운로드」를 눌러 주세요(7.1). 그래픽카드 메모리가 12GB(mac은 Mac 메모리 16GB)보다 적으면 느리거나 실패할 수 있습니다.
-
사운드 채팅에 필요한 소리를 요청해 주세요(예 : 「전투 배경음악을 만들어 주세요」).
-
오른쪽 「사운드」 탭에서 만든 소리를 「BGM」·「효과음」·「음성」으로 나눠 보고, 재생해 확인해 주세요.
- 카드를 우클릭하거나 「선택」으로 여러 개를 고르면 「리소스로 저장」(게임 폴더
game/audio에 저장)·「삭제」·「수정 요청」을 할 수 있습니다. - 위쪽 「선택」으로 내 PC의 사운드 폴더를 연결하면 그 파일도 함께 보입니다. 「새로고침」은 폴더를 다시 확인합니다.
- 목소리 기준 클립에서는 「이 목소리로 대사 만들기」로 같은 목소리의 대사를 요청합니다.
- 녹음 파일로 목소리를 만들 때는 본인 목소리이거나 동의를 받은 경우에만 사용해 주세요.
처음 요청할 때는 모델을 불러오느라 오래 걸립니다. 엔진 상태는 상태 표시줄의 「음성 엔진」·「음악 엔진」·「효과음 엔진」에서 확인합니다.
5.6 QA(플레이 테스트)
QA 파트는 개발 파트가 만든 게임을 직접 실행해 확인하고, 문제를 찾으면 개발 파트에 알립니다. 개발 파트를 켜고 플랫폼이 PC·모바일(Godot)인 프로젝트에서만 켤 수 있습니다.
-
프로젝트 설정 → 사용 파트에서 「QA」를 켜 주세요.
-
QA 채팅에 확인하고 싶은 내용을 적어 주세요(예 : 「시작 화면에서 시작 버튼을 누르면 게임이 시작되는지 확인해 주세요」).
-
QA가 테스트 순서를 만들고 게임을 실행합니다. 「자동 테스트 중입니다. 열린 게임 창은 조작하지 말아 주세요.」가 보이면 테스트가 끝날 때까지 게임 창을 건드리지 말아 주세요.
-
오른쪽 「결과」 탭에서 실행 목록을 누르면 스크린샷·「단계별 결과」·「콘솔 로그」를 볼 수 있습니다. 최근 10회까지 보관됩니다.
QA는 키 입력과 대기로 게임을 조작합니다. 마우스 클릭은 아직 재생하지 않습니다.
문제를 찾으면 QA 채팅에서 개발 파트에 버그 보고를 보냅니다. 개발 파트가 고친 뒤 QA에 다시 확인을 요청해 주세요. 게임 실행 승인은 개발 파트와 함께 사용합니다(5.4).
문서 다루기
에이전트가 만든 문서와 파일은 모두 내 PC의 프로젝트 폴더에 저장됩니다. 오른쪽 「파일」 탭에서 찾아 열고, 가운데 문서 탭에서 읽고 고칩니다.
6.1 파일 트리
오른쪽 패널의 「파일」 탭은 프로젝트 폴더 전체를 보여 줍니다. 파트별 폴더(plan·scenario·game 등)와 받은 요청이 모이는 requests 폴더가 있습니다.
- 「파일 검색」 칸에 이름을 적으면 목록을 좁힙니다.
- 파일을 누르면 가운데에 문서 탭으로 열립니다.
- 파일을 우클릭하면 「이름 변경」·「복사」·「삭제」가 나옵니다. 끌어다 놓으면 다른 폴더로 옮겨집니다.
- Ctrl(mac은 Cmd)을 누른 채 누르면 여러 개를, Shift를 누른 채 누르면 범위를 한 번에 고릅니다.
- 패널 위 새로고침 버튼(「파일 새로고침」)으로 목록을 다시 읽습니다.
GDA가 관리하는 일부 폴더와 파일은 바꿀 수 없으며, 메뉴에 「이 항목은 변경할 수 없습니다.」가 보입니다.
휴지통
삭제한 파일은 바로 지워지지 않고 목록 맨 아래 「휴지통 (N)」에 7일 동안 남습니다.
- 「휴지통 (N)」을 눌러 펼치면 지운 항목과 삭제 시각이 보입니다.
- 되살리려면 항목의 「복구」를 눌러 주세요.
- 휴지통을 비우려면 「비우기」를 누르고, 확인 창에서 「완전히 삭제」를 눌러 주세요. 비운 항목은 복구할 수 없습니다.
6.2 미리보기
문서(.md)를 열면 제목·목록·표가 정리된 모습으로 보입니다. 문서 탭 머리에는 파일 이름, 경로, 줄 수, 저장 상태가 보입니다.
- 채팅 속 파일 링크를 눌러도 같은 문서 탭으로 열립니다.
- 데이터 파일(.csv)은 표로 열립니다. 칸을 고친 뒤 「행 추가」나 「N개 변경 저장」을 눌러 저장합니다. 보호된 기준 자료는 보기 전용입니다.
project_memory.md는 「프로젝트 메모리」 화면으로,decision_log.md는 「결정 기록」 화면으로 열립니다.- 이미지 파일을 누르면 이미지 창으로 크게 봅니다. 아트 이미지는 아트 「이미지」 탭에서 다룹니다.
6.3 편집
-
문서 탭 오른쪽 위 「편집」을 눌러 주세요. 아래쪽에 원문 편집 칸이 열리고, 위쪽에서 고친 결과를 바로 볼 수 있습니다.
-
내용을 고친 뒤 「저장」을 눌러 주세요. 고친 내용을 버리려면 「취소」를 누릅니다.
편집하는 사이 에이전트가 같은 파일을 먼저 고치면, 내 내용으로 덮어쓰지 않고 「내 초안」과 「현재 파일」을 나란히 보여 줍니다. 비교한 뒤 필요한 내용을 옮기거나 「최신 내용 불러오기」를 눌러 주세요. 비교를 닫으려면 「비교 닫기」를 누릅니다.
- 편집 중에 다른 곳에서 파일이 바뀌면 「다른 곳에서 파일이 변경되었습니다」가 보입니다. 「다시 불러오기」로 최신 내용을 읽습니다.
- 저장하지 않은 채 탭을 닫으려 하면 확인 창이 뜹니다.
6.4 수신 요청 문서(읽기 전용)
requests 폴더의 요청 문서는 다른 파트가 보낸 요청이라 읽기만 할 수 있습니다. 열면 「요청 문서는 읽기 전용입니다.」가 보입니다.
요청은 GDA가 받는 파트에 자동으로 넘기므로 따로 할 일은 없습니다.
- 처리가 끝난 요청은 문서 위 「완료」를 눌러 완료로 표시합니다.
- 필요 없는 요청을 취소하려면 파일을 우클릭해 「삭제」를 눌러 주세요. 휴지통으로 옮겨집니다.
- 요청 문서는 이름 변경·복사·이동을 할 수 없습니다.
설정
설정은 두 가지입니다. 앱 설정은 이 PC의 GDA 전체에 적용되고, 프로젝트 설정은 프로젝트마다 따로 정합니다.
7.1 앱 설정
사이드바 맨 아래 「앱 설정」을 누르면 전체 화면으로 열립니다. 왼쪽 메뉴에서 「AI 서비스」·「이미지」·「사운드」·「프로젝트」·「화면」·「계정」 중 하나를 골라 주세요. 다 보면 「앱으로 돌아가기」를 누릅니다.
바꾼 값은 바로 저장되며, 페이지 오른쪽 위에 「저장 중」·「저장 완료」 같은 저장 상태가 보입니다. 메뉴의 「도움말」은 이 도움말을 엽니다.
AI 서비스
에이전트로 사용할 AI 서비스(Claude·ChatGPT·Grok)를 연결합니다. 「에이전트 연결」에서 여러 개를 함께 연결할 수 있습니다.
-
사용할 서비스의 체크 상자를 켜 주세요. 「설치되지 않았습니다. 「설치」를 눌러 주세요.」가 보이면 「설치」를 누릅니다.
-
인증 방식을 골라 주세요.
- 「구독」 : 「인증」을 누르고, 열린 로그인 창에서 로그인합니다.
- 「API 키」 : 키를 붙여 넣고 Enter를 누릅니다.
-
주로 사용할 서비스에 「기본 에이전트」를 표시해 주세요.
-
「기본 모델 설정」에서 서비스별 「모델」과 「사고 깊이」를 고릅니다. 잘 모르겠으면 「선택 가이드」를 눌러 비교해 주세요.
- 연결이 끝난 서비스에는 「연결됨」이 보입니다.
- Claude의 모델은 Fable 5.2·Opus 5.5·Sonnet 5.5·Haiku 5.5입니다. 「선택 가이드」에서 모델별 특기·사용량·권장 플랜을 비교할 수 있습니다. Grok에는 선택 가이드가 없습니다.
- 로그인된 서비스에는 「로그아웃」이 보입니다. 다른 계정으로 바꿀 때 사용합니다.
- 「업데이트」는 그 서비스에 연결하는 도구를 새 버전으로 다시 설치합니다.
- 모델 목록이 「첫 요청을 보낸 뒤 선택 가능」으로 보이면 그 서비스로 채팅을 한 번 보낸 뒤 골라 주세요.
- ChatGPT 카드의 「인터넷 차단 없이 ChatGPT 허용」은 이 PC에서 ChatGPT 세션이 열리지 않을 때만 켜 주세요. 켜면 ChatGPT가 프로젝트 내용을 인터넷으로 보낼 수 있습니다.
이미지
이미지 페이지에는 「GPT 이미지」와 「로컬 이미지」 두 묶음이 있습니다.
GPT 이미지
아트 파트에서 GPT 이미지를 사용할지 정합니다. 「GPT 이미지 사용」을 「사용」으로 바꾸고 「인증 방식」을 골라 주세요.
- 「구독 (ChatGPT 로그인)」 : AI 서비스에서 로그인한 ChatGPT 계정을 그대로 사용합니다. 「요청 모델」은 그림을 그리는 모델이 아니라 이미지 도구에 글을 전달하는 모델이며, 기본값이 사용량이 가장 적습니다.
- 「API 키」 : 「OpenAI API 키」를 넣어 사용합니다. 「이미지 모델」에서 「Sunburst(품질)」 또는 「Flare(속도)」를 고릅니다.
로컬 이미지
내 PC의 그래픽카드(mac은 통합 메모리)로 이미지를 만들 때 필요한 설정입니다. 사용하지 않으면 건드리지 않아도 됩니다.
-
「GPU 처리 방식」의 「실행 방식」은 보통 「자동」으로 둡니다. 「자동」은 NVIDIA 그래픽카드가 있으면 CUDA, 없으면 Vulkan을 사용합니다. mac은 Metal로 실행하며 고를 것이 없습니다.
-
「지원 모델」 표에서 사용할 계열을 고르고, 계열의 「다운로드」를 눌러 필요한 파일을 한 번에 다운로드해 주세요. 「요구 VRAM」과 「내 GPU」(mac은 「내 Mac 메모리」)를 비교해 내 PC에 맞는 계열을 고릅니다.
계열마다 다운로드 방식이 조금 다릅니다.
- Krea2 : 내 GPU가 24 GB 이상이면 본체 BF16, 그보다 작으면 FP8을 다운로드합니다.
- Z-Image : 본체와 텍스트 인코더를 행 앞의 동그라미로 하나씩 고른 뒤 「다운로드」를 누릅니다. 처음에는 Q8_0이 골라져 있고, 내 GPU가 12 GB면 본체 Q6_K, 8 GB면 본체 Q4_K와 인코더 Q4_K_M이 골라집니다.
- SDXL : 계열의 「다운로드」는 SDXL만 다운로드합니다. Animagine XL 4.0은 그 행의 「다운로드」로 따로 다운로드합니다.
- 다른 본체는 파일명 옆 「링크 ↗」에서 직접 다운로드합니다.
- 다운로드한 파일을 지우려면 그 행의 「제거」를 누릅니다. 다시 다운로드하려면 지운 뒤 「다운로드」를 다시 눌러 주세요. 모델 폴더는 「폴더 열기」로 엽니다.
표는 품질이 높은 순서입니다. 내 GPU에 맞는 것 가운데 위쪽 모델을 골라 주세요.
| 모델 | 특징 | 필요 GPU |
|---|---|---|
| Z-Image | 캐릭터·배경·글자가 들어간 이미지 본작업에 맞습니다. 1024×1024, 8단계라 빠르고 글자 표현이 좋으며, 문장으로 설명해도 반영됩니다. 부정 프롬프트는 없습니다. 본체 3.9 |
8 GB(Q4) · 16 GB 권장(Q8) |
| Illustrious XL v2.0 | 애니 캐릭터·일러스트에 맞는 SDXL 파생 모델입니다. 1024×1024, 파일 6.9 GB. 설정(단계·CFG·부정 프롬프트)은 SDXL과 같습니다. | 12 GB |
| SDXL | 캐릭터·배경 일러스트 본작업에 맞습니다. 1024×1024, 파일 6.9 GB. 화질·구도가 안정적이며 SD 1.5보다 2~3배 느립니다. 부정 프롬프트를 사용합니다. | 12 GB |
| Animagine XL 4.0 | 애니 스타일 캐릭터·배경에 맞춘 SDXL 파생 모델입니다. 1024×1024, 파일 6.9 GB. SDXL 계열 표의 그 행 「다운로드」로 받으며, 설정은 SDXL과 같습니다. | 12 GB |
| Krea2 | 실사풍·키 비주얼·컨셉아트에 맞습니다. 1024×1024, 본체 26 GB(FP8 13 GB) + 텍스트 인코더 8 GB. 8단계 생성이라 총 시간은 SDXL과 비슷하고, 문장으로 길게 설명해도 반영됩니다. 부정 프롬프트가 없고 LoRA는 거의 없습니다. mac은 FP8을 사용할 수 없어 메모리 32 GB 이상이 필요합니다. 연매출 100만 달러 이상인 회사는 상업 사용 전 Krea와 별도 계약이 필요합니다(계열 머리의 「라이선스 보기 ↗」). | 24 GB(FP8 12 GB) |
| SD 1.5 | 그래픽카드가 작을 때의 빠른 시안·도트·소품에 맞습니다. 512×768, 파일 4.3 GB. 빠르지만 손·글자가 약하고 긴 설명은 반영되지 않으며, 본작업 품질은 낮습니다. 커뮤니티 LoRA가 가장 많습니다. | 8 GB |
계열 머리줄 오른쪽 끝의 배지(「내 PC에 맞음」·「넉넉하지 않음」·「메모리 부족」)는 「내 GPU」와 요구 VRAM을 비교한 결과입니다. mac은 「내 Mac 메모리」의 75%를 요구 VRAM과 비교하며, 배지는 「내 Mac에 맞음」으로 보입니다. 표의 「필요 GPU」를 mac 메모리로 바꾸면 SDXL 16GB, Krea2 32GB 이상, Z-Image 11GB(Q4)·22GB(Q8)입니다.
모델을 다운로드한 뒤 아트 「스타일」 탭에서 「생성 방식」을 「로컬 엔진」으로 바꾸면 아트 파트에서 사용할 수 있습니다(5.3).
추천 LoRA·VAE — 직접 다운로드해 넣기
본체 모델만으로 원하는 그림체나 품질이 나오지 않을 때 LoRA와 VAE를 더합니다. LoRA는 이미지의 그림체·스타일을 바꾸고, VAE는 색감과 세부 묘사를 또렷하게 합니다. 이미지 페이지 아래 「추천 LoRA」·「추천 VAE」 표에 계열별 추천 목록이 있습니다.
GDA가 대신 다운로드하지는 않습니다. 링크에서 직접 다운로드해 모델 폴더에 넣으면 GDA가 알아봅니다.
-
「모델 계열」에서 사용하는 본체 계열을 골라 주세요. LoRA·VAE는 본체와 계열이 맞아야 동작합니다.
- SDXL용 LoRA를 SD 1.5 본체에 켜면 결과가 깨지거나 생성에 실패합니다.
- Illustrious·Animagine은 SDXL 구조라 SDXL용 LoRA도 켜지지만, 그 모델용 LoRA가 결과가 좋습니다.
- Krea2·Z-Image는 사용할 수 있는 LoRA가 거의 없습니다.
-
항목의 「다운로드 페이지 열기」를 누르면 모델 페이지(civitai 또는 Hugging Face)가 브라우저에서 열립니다. 그 페이지에서 파일을 다운로드해 주세요. 사이트에 따라 로그인이 필요할 수 있습니다. 「더 찾기 ↗」는 그 계열에 맞는 civitai 검색 결과를 엽니다.
-
다운로드한 파일을 모델 폴더에 넣어 주세요. 표 제목 줄의 「폴더 열기」를 누르면 넣을 폴더(LoRA는
loras, VAE는vae)가 열립니다. 파일 이름은 바꾸지 않아도 됩니다. -
넣은 파일은 잠시 뒤 표에 「설치 완료」로 보입니다. 이때 GDA가 civitai에서 트리거 워드와 권장 설정(단계·CFG)을 찾아 파일 옆에 저장합니다.
- 아트 「로컬」 탭의 LoRA 슬롯에서 그 파일을 고르면 트리거 워드 칸이 저절로 채워집니다. 칸이 비어 있을 때만 채우며, 직접 적은 값은 바꾸지 않습니다. civitai에 없는 파일은 모델 페이지에서 트리거 워드를 보고 직접 적어 주세요.
- LoRA는 아트 「로컬」 탭의 LoRA 슬롯(3개)에서 켜고, VAE는 같은 탭 「모델」 카드의 VAE에서 고릅니다(5.3). LoRA가 하나라도 켜져 있으면 스타일 프롬프트 대신 트리거 워드가 이미지 프롬프트에 들어갑니다.
- 미리보기에는 전체 이용가 등급의 이미지만 보입니다.
라이선스
- 항목 아래의 「상업 사용 가능」·「상업 사용 불가」·「출처 표기 필요」는 작성자가 civitai에 표시한 라이선스 조건입니다.
- 「라이선스는 다운로드 페이지에서 확인해 주세요.」가 보이면 GDA가 조건을 알지 못하는 항목입니다.
- 게임을 판매할 계획이면 상업 사용이 가능한 항목만 사용해 주세요. 출처 표기가 필요하면 게임 크레딧에 작성자를 적습니다. 정확한 조건은 모델 페이지에서 확인해 주세요.
사운드
사운드 파트가 사용하는 로컬 모델 파일(음성·음악·효과음)을 다운로드합니다. 사운드에는 표의 파일이 모두 필요합니다.
- 묶음의 「다운로드」를 누르면 필요한 파일을 한 번에 다운로드합니다.
- 「용도」 열은 각 파일이 사용되는 곳(목소리 생성·목소리 복제·배경 음악·효과음)입니다.
- 다운로드한 파일을 지우려면 그 행의 「제거」를 누릅니다. 다시 다운로드하려면 지운 뒤 「다운로드」를 눌러 주세요.
- 그래픽카드 메모리가 12GB보다 적으면 느리거나 실패할 수 있습니다.
프로젝트
프로젝트 페이지에서는 새 프로젝트의 저장 위치와 Godot 엔진을 정합니다.
프로젝트 기본 폴더
새 프로젝트를 만들 때 사용하는 저장 위치의 기본값입니다. 「선택」으로 바꾸고, 「비우기」로 지웁니다.
Godot 엔진 연결
「선택」을 눌러 Godot 엔진 폴더를 지정해 주세요(mac은 Godot 앱을 고릅니다). Windows에서 연결을 풀려면 「해제」를 누릅니다. Godot가 없으면 「Godot 다운로드 (브라우저에서 열림) ↗」를 눌러 공식 사이트에서 다운로드해 주세요.
화면
- 「표시 언어」 : 메뉴·버튼·안내 문구의 언어(한국어·English)를 고릅니다. 처음에는 PC 언어가 한국어면 한국어, 그 밖이면 영어로 시작합니다.
- 「화면 모드」 : 「시스템 설정 따름」·「어둡게」·「밝게」 중에서 고릅니다.
계정
이 PC가 연결된 GDA 계정을 확인하고 관리합니다. 「계정 관리」에 「연결된 계정」·「이 PC 이름」·「이용 상태」·「휴대폰 연결」이 보입니다. 「이용 상태」에는 「무료 · PC 1대」나 「플러스 · PC 2대 · 모바일 앱」처럼 지금 사용하는 요금제가 보입니다.
「연결 관리」의 버튼은 아래와 같습니다.
- 「휴대폰 추가」 : 모바일 앱을 이 PC에 연결합니다(8.2).
- 「연결 초기화」 : 휴대폰을 잃어버렸을 때 사용합니다. 연결된 모든 휴대폰이 QR 코드를 다시 스캔해야 합니다.
- 「이용권 코드」 : 받은 코드(GDA-XXXX-XXXX-XXXX)를 입력해 지금 로그인한 계정에 등록합니다. 로그인한 뒤에만 사용할 수 있습니다.
- 「로그아웃」 : 이 PC를 계정에서 뺍니다. 다시 로그인하기 전까지 이 PC에서 GDA를 사용할 수 없습니다.
「계정 탈퇴」는 맨 아래 따로 있습니다(8.3). 플러스 구독은 모바일 앱에서 관리합니다.
7.2 프로젝트 설정
「프로젝트 메뉴」 → 「프로젝트 설정」을 누르거나, 사이드바에서 프로젝트 오른쪽 「…」 → 「프로젝트 설정」을 누르면 열립니다. 「기본」·「사용 파트」·「고급」 탭으로 나뉘며, 바꾼 값은 바로 저장됩니다.
기본
- 「프로젝트 정보」 : 프로젝트 이름을 바꿉니다. 이름을 바꿔도 프로젝트 폴더는 그대로입니다. 「폴더 열기」로 프로젝트 폴더를 엽니다.
- 「대상 플랫폼」 : 「PC 전용」·「모바일 전용」·「PC + 모바일」·「웹 (HTML5)」 중에서 고릅니다. 웹과 PC·모바일 사이를 바꾸면 확인 창이 뜹니다.
- 「지원 언어」 : 게임에 넣을 언어입니다. 개발 파트에 현지화를 요청하면 이 목록의 언어로 번역합니다. 한국어는 원문이라 뺄 수 없습니다.
- 「자율 진행」 : 승인을 묻지 않고 작업을 이어 가는 기능을 켜고 끄며, 미리 허용할 항목을 고릅니다(4.7).
- 「참고자료」 : 문서·이미지·영상 파일을 끌어다 놓아 추가합니다.
사용 파트
파트마다 사용 여부와 「서비스」·「모델」·「사고 깊이」를 고릅니다. 「앱 설정 사용」으로 두면 앱 설정의 값을 따릅니다.
- 파트 버튼을 누르면 「사용 중」과 「사용 안 함」이 바뀝니다. 대화를 시작한 파트는 「사용 안 함」으로 바꿀 수 없습니다.
- 서비스를 바꾸면 그 파트의 대화가 새로 시작되고, 이전 대화는 보관됩니다. 요청을 처리하는 중인 파트는 바꿀 수 없습니다.
- QA는 개발 파트를 켜고 플랫폼을 PC·모바일로 골라야 켤 수 있습니다.
고급
- 「Godot 개발 방식」 : Godot에서 코드를 쓸 언어(GDScript 또는 .NET(C#))입니다. 보통은 그대로 둡니다. 웹(HTML5) 프로젝트에는 없습니다.
- 「Git 원격 연결」 : GitHub 같은 원격 저장소에 프로젝트를 연결합니다. 필요한 경우에만 사용합니다. 저장소 주소를 넣고 「연결 테스트」 → 「연결 저장」 순서로 진행해 주세요. 연결을 저장하거나 해제해도 파일과 커밋은 바뀌지 않습니다.
- 「로컬 이미지 엔진」 : 「엔진 사용」을 「사용」으로 바꾸면 아트에 「로컬」 탭이 열립니다. 모델은 그 탭에서 고릅니다.
- 「스크립트 실행 허용됨」 : 에이전트의 스크립트 실행을 허용한 뒤에 보입니다. 「허용 취소」를 누르면 다음 실행 때 다시 묻습니다.
계정과 PC
이 장에서는 PC를 바꿀 때, 모바일 앱을 연결할 때, 계정을 지울 때 할 일을 안내합니다. GDA 계정에 연결할 수 있는 PC 수는 무료가 1대, 플러스가 2대입니다. 플러스 구독은 모바일 앱에서 관리합니다.
8.1 PC 바꾸기
새 PC에서 로그인했는데 연결할 수 있는 PC 수가 이미 찼다면, 새 PC에서 바로 옛 PC의 연결을 해제할 수 있습니다. 모바일 앱이 없어도 됩니다.
-
새 PC의 로그인 화면에서 「Google로 로그인」 또는 「Apple로 로그인」으로 로그인해 주세요.
-
「연결 가능한 PC 수 초과」 화면이 뜨면 「연결을 해제할 PC」 목록에서 해제할 PC를 하나 골라 주세요. PC마다 이름과 마지막 사용 날짜가 보입니다.
-
「선택한 PC 해제하고 연결」을 누르고, 확인 창에서 「해제하고 연결」을 눌러 주세요.
-
지금 사용하는 PC가 그 자리에 연결되고 GDA가 열립니다.
- 해제한 PC에서는 다시 로그인하기 전까지 GDA를 사용할 수 없습니다.
- 「모바일 앱으로 로그인」(QR 코드)에서 PC 수가 찼다는 안내가 보이면 「PC 변경」을 눌러 같은 순서로 진행해 주세요.
- 지금 PC를 직접 계정에서 빼려면 앱 설정 → 계정의 「로그아웃」을 사용합니다.
8.2 모바일 앱 연결
모바일 앱을 연결하면 밖에서도 휴대폰으로 파트 채팅을 이어 가고, 승인 카드에 답하고, 진행 상태와 이미지를 확인할 수 있습니다. 파일 편집·설정·Godot 실행은 PC에서만 합니다. 모바일 앱 연결에는 플러스 구독이 필요합니다.
-
휴대폰에 「GDA (Game Dev Assistant)」 앱을 설치하고, PC와 같은 계정으로 로그인해 주세요.
-
PC에서 앱 설정 → 계정 → 「휴대폰 추가」를 눌러 주세요. QR 코드가 있는 창이 열립니다.
-
모바일 앱에서 PC 연결을 시작하고 PC의 QR 코드를 스캔해 주세요.
-
휴대폰에서 승인하면 PC에 승인한 휴대폰 이름과 「확인 번호」가 뜹니다. 휴대폰에 같은 번호가 보이면 「연결」을 눌러 주세요. 내 휴대폰이 아니거나 번호가 다르면 「취소」를 누르고 「QR 코드 새로 만들기」로 다시 시작해 주세요.
-
「휴대폰을 연결했습니다.」가 보이면 끝입니다. 앱 설정 → 계정의 「휴대폰 연결」에서 상태를 확인할 수 있습니다.
- 그림은 로그인 화면의 「모바일 앱으로 로그인」에서 연결하는 모습입니다. 「휴대폰 추가」에서도 같은 확인 번호 화면이 나옵니다.
- 무료 계정이면 「휴대폰에서 PC의 GDA를 사용하거나 PC 2대를 연결하려면 플러스가 필요합니다.」가 보입니다.
- 모바일 앱에 「다시 연결 필요」가 보이면 「휴대폰 추가」의 QR 코드를 다시 스캔해 주세요.
- 휴대폰을 잃어버렸다면 「연결 초기화」를 눌러 연결된 모든 휴대폰을 끊어 주세요.
8.3 계정 탈퇴
계정 탈퇴는 GDA 계정과 PC 연결을 지우며 되돌릴 수 없습니다. PC의 프로젝트는 지워지지 않습니다.
-
앱 설정 → 계정 맨 아래의 「계정 탈퇴」를 눌러 주세요.
-
확인 창 「계정을 탈퇴하시겠습니까?」에서 지워질 계정과 안내를 읽어 주세요.
-
「계정 탈퇴」를 누르면 본인 확인을 위해 브라우저가 열립니다. 이 PC의 계정으로 한 번 더 로그인해 주세요. QR 코드로 로그인한 PC에서는 「Google로 확인하고 탈퇴」·「Apple로 확인하고 탈퇴」 중 계정에 맞는 버튼을 누릅니다.
-
로그인이 끝나면 탈퇴가 진행되고, 로그인 화면에 「탈퇴가 완료되었습니다.」가 보입니다. 다시 로그인하면 새 계정으로 시작합니다.
확인 창의 안내도 함께 확인해 주세요.
- 부정 이용을 막고 삭제 처리를 안전하게 마치기 위해 기록을 1년간 보관합니다. 1년 안에 같은 계정으로 다시 가입하면 플러스 구독·이용권이 다시 적용됩니다.
- 스토어에서 구독 중이면 탈퇴해도 결제는 계속됩니다. 모바일 앱이나 스토어에서 구독을 따로 해지해 주세요.
- 실행 중이거나 대기 중인 작업이 있으면 「탈퇴하면 대기 중인 작업은 시작되지 않습니다.」가 보입니다.
다른 계정으로 로그인하면 탈퇴되지 않습니다. 서버 응답이 없어 결과를 알 수 없으면 「다시 확인」을 눌러 주세요.
업데이트와 문제 해결
9.1 자동 업데이트
GDA는 실행할 때 새 버전이 있는지 확인합니다. 새 버전이 있으면 「업데이트가 있습니다」 창에 버전과 바뀐 내용이 줄마다 보입니다.
- 「업데이트」를 눌러 주세요. 「다운로드 중 (N%)」 진행 막대가 보이며, 다운로드하는 동안 창을 닫아도 다운로드는 계속됩니다.
- 다운로드가 끝나면 GDA가 저절로 다시 시작하며 새 버전을 설치합니다. 저장하지 않은 변경이나 실행 중인 작업이 있으면 먼저 확인 창이 뜹니다. 작업을 멈추고 진행하려면 「중단하고 다시 시작」을 누릅니다.
다운로드는 끝났지만 다시 시작을 미뤘다면 「새 버전 (버전) 설치 준비가 끝났습니다. 다시 시작하면 적용됩니다.」와 함께 「다시 시작」·「나중에」가 보입니다.
- 「나중에」를 누르면 이번 실행 동안 창을 숨깁니다. 다음에 앱을 실행하면 업데이트 안내가 다시 보입니다.
- 「업데이트를 설치하지 못했습니다. 「다시 시작」을 눌러 재시도해 주세요.」가 보이면 「다시 시작」을 눌러 주세요.
- 업데이트 창은 X나 「나중에」로만 닫힙니다.
- mac에서 「GDA를 응용 프로그램 폴더로 옮긴 뒤 다시 시작해야 업데이트가 설치됩니다.」가 보이면 dmg 안의 GDA를 바로 실행한 상태입니다. GDA를 Applications 폴더로 옮긴 뒤 다시 실행해 주세요.
9.2 알림
GDA는 알아 둘 일을 화면 위쪽 가운데에 알림 줄로 보여 줍니다. 새 알림은 아래에 쌓이고 최대 네 줄까지 보이며, 같은 알림은 한 번만 뜹니다.
- 알림마다 오른쪽 ×로 닫습니다.
- 「에이전트 규칙서가 업데이트되었습니다. 해당 파트가 다음 메시지를 받을 때 다시 읽습니다.」와 「공통 규칙서가 업데이트되었습니다.」는 에이전트가 따르는 작업 규칙이 앱 업데이트로 바뀌었다는 안내입니다. 따로 할 일은 없습니다.
9.3 AI 서비스 업데이트 안내
GDA를 업데이트한 뒤 AI 서비스에 연결하는 도구를 새 버전으로 다시 설치해야 할 때가 있습니다. 이때 「AI 서비스 업데이트가 있습니다. 앱 설정에서 업데이트해 주세요.」 창이 뜹니다.
- 창의 「앱 설정」을 눌러 주세요. 앱 설정 → AI 서비스가 열립니다.
- 해당 서비스 카드에 「AI 서비스가 GDA에서 확인한 버전(…)과 다릅니다. 「설치」를 눌러 주세요.」가 보이면 「설치」를 눌러 주세요.
다시 설치하기 전까지는 그 서비스로 채팅을 보낼 수 없습니다. 설치 뒤 카드에 「로그인 필요」가 보이면 「인증」을 눌러 다시 로그인해 주세요. 지금 하지 않으려면 「닫기」를 누릅니다.
9.4 서버에 연결할 수 없을 때
GDA는 실행할 때 계정 서버에 연결해 이용 상태를 확인합니다. 인터넷이 끊겨 있으면 「서버에 연결할 수 없습니다. 인터넷 연결을 확인한 뒤 다시 시도해 주세요.」가 뜹니다.
- PC의 인터넷 연결을 확인해 주세요.
- 「다시 시도」를 눌러 주세요. 연결되면 GDA가 바로 열립니다.
아직 연결되지 않으면 「다시 확인했지만 아직 서버에 연결되지 않았습니다. 인터넷 연결을 확인해 주세요.」가 보입니다. 지금 끝내려면 「앱 종료」를 누릅니다.
GDA를 사용하는 도중에 계정 서버 연결이 끊겨도 화면은 막히지 않습니다. 상단 바의 「앱 다시 연결 중」은 GDA 내부 연결 표시로, 계정 서버 연결과는 다릅니다.
9.5 자주 묻는 질문
AI 계정이 필요한 이유
GDA 사용을 위해서는 Claude, ChatGPT 등의 AI 서비스 계정이 필요합니다.
GDA는 사용자의 AI 서비스 계정으로 각 파트의 에이전트를 실행합니다. 에이전트가 일한 만큼 그 계정의 한도를 사용하며, 사이드바의 「사용량」에서 확인할 수 있습니다. 연결은 앱 설정 → AI 서비스에서 합니다(7.1).
Godot만 지원
현재 개발 엔진은 Godot만 지원하며, 향후 지원 엔진 확대 예정입니다.
PC·모바일 게임은 Godot로 만들고, 웹(HTML5) 플랫폼을 고른 프로젝트는 엔진 없이 HTML·CSS·JavaScript로 만듭니다. Godot는 공식 사이트에서 다운로드해 앱 설정 → 프로젝트의 「Godot 엔진 연결」에서 연결해 주세요.
AI 서비스 로그인이 풀렸을 때
채팅에 「(서비스)의 AI 서비스 로그인이 필요합니다. 앱 설정 → AI 서비스에서 로그인한 뒤 다시 보내 주세요.」가 보이면 로그인이 풀린 것입니다.
- 앱 설정 → AI 서비스에서 해당 카드의 「인증」을 눌러 다시 로그인해 주세요.
- 채팅으로 돌아가 메시지를 다시 보내 주세요.
다른 계정으로 바꾸려면 「로그아웃」을 누른 뒤 「인증」을 눌러 주세요. 사이드바 사용량에 「채팅에 메시지를 보내면 사용량이 표시됩니다.」가 보이면 그 서비스로 채팅을 한 번 보내 주세요.
프로젝트를 열 수 없을 때
사이드바에 보이는 안내에 따라 해결해 주세요.
- 「폴더를 찾지 못했습니다」 : 프로젝트 폴더를 옮기거나 이름을 바꾼 경우입니다. 폴더를 원래 위치로 되돌린 뒤 다시 열어 주세요.
- 「현재는 폴더를 열 수 없습니다」 : 폴더를 읽을 권한이 없거나, 외장·네트워크 드라이브가 연결되지 않은 경우입니다. 드라이브 연결과 폴더 권한을 확인해 주세요. mac에서는 시스템 설정 › 개인정보 보호 및 보안 › 파일 및 폴더에서 GDA를 허용해 주세요.
- 「GDA 0.11 이전 버전의 프로젝트는 열 수 없습니다. 새 프로젝트를 만들어 주세요.」 : 옛 버전에서 만든 프로젝트입니다. 새 프로젝트를 만들어 주세요.
「목록에서 제거」한 프로젝트는 사이드바의 「프로젝트 열기」로 그 폴더를 다시 골라 열 수 있습니다.