목차

GDA 소개

1.1 GDA가 하는 일

GDA(Game Dev Assistant)는 AI와 채팅하며 게임을 만드는 PC 프로그램입니다. 게임 개발을 몰라도 됩니다. 파트별 채팅에 하고 싶은 일을 적으면, 그 파트를 맡은 AI가 문서·이미지·코드를 만들어 내 PC의 프로젝트 폴더에 저장합니다. 이 도움말에서는 파트에서 일하는 AI를 「에이전트」라고 부릅니다.

만드는 순서는 정해져 있지 않습니다. 필요한 파트로 언제든 돌아가 고치면 됩니다.

1.2 여섯 파트

파트는 게임 만드는 일을 역할별로 나눈 것입니다. 파트마다 채팅이 따로 있고, 필요한 파트만 켜서 사용합니다. 새 프로젝트는 기획·아트·개발이 켜진 채로 시작하며, 나머지는 프로젝트 설정에서 켭니다.

파트끼리는 요청 파일로 일을 주고받습니다. 자세한 내용은 4.3 수신 요청과 미결에 있습니다.

1.3 준비물

GDA 사용을 위해서는 Claude, ChatGPT 등의 AI 서비스 계정이 필요합니다.

현재 개발 엔진은 Godot만 지원하며, 향후 지원 엔진 확대 예정입니다.

시작하기 전에 아래를 준비해 주세요.

시작해보기

2.1 설치하기

GDA는 홈페이지에서 다운로드해 설치합니다. 설치한 뒤의 업데이트는 앱이 알려 줍니다(9.1 자동 업데이트).

  1. https://gda.ai.kr/download/에서 사용하는 컴퓨터에 맞는 설치 파일을 다운로드해 주세요.
  2. Windows : 다운로드한 설치 프로그램(예 : GDA-Setup-1.0.0.exe)을 열고 안내에 따라 설치해 주세요.
  3. 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 서비스」·「기본 모델」·「프로젝트 폴더」·「엔진 연결」·「로그인」)에 지금 위치가 보입니다. 앞 단계로 돌아가려면 「이전」을 눌러 주세요.

  1. 사용하는 AI 서비스 카드(Claude·ChatGPT·Grok)를 고르고 「다음」을 눌러 주세요. 아직 AI 서비스가 없으면 「사용 중인 AI 서비스가 없습니다」를 눌러 마지막 단계로 건너뜁니다.

  2. GDA가 그 서비스에 연결할 도구를 자동으로 설치합니다. 진행 막대가 끝날 때까지 기다려 주세요. 이미 설치되어 있으면 이 단계는 건너뜁니다. 설치에 실패하면 「다시 시도」를 눌러 주세요.

  3. 「인증하기」를 눌러 주세요. 로그인 창이 열리면 AI 서비스 계정으로 로그인해 주세요. 로그인을 마치면 창이 저절로 닫히고 다음 단계로 넘어갑니다.

  4. 기본으로 사용할 모델을 고르고 「선택 완료」를 눌러 주세요. 모델은 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가 답하기 전에 얼마나 깊이 생각할지 정하는 값입니다.
  5. 「폴더 선택」을 눌러 새 프로젝트를 보관할 폴더를 정하고 「다음」을 눌러 주세요. 프로젝트를 만들 때 다른 폴더로 바꿀 수도 있습니다.

  6. 「폴더 선택」을 눌러 Godot 엔진 폴더를 지정하고 「다음」을 눌러 주세요. mac에서는 「선택」을 눌러 Godot 앱을 고릅니다.

    • Godot가 없으면 「Godot 엔진 다운로드」를 눌러 공식 사이트(godotengine.org)에서 다운로드해 주세요.
    • 지금 지정하지 않고 나중에 앱 설정 → 프로젝트의 「Godot 엔진 연결」에서 연결해도 됩니다.

  7. 「준비가 끝났습니다!」 화면에서 「시작하기」를 눌러 주세요. 이 PC가 아직 로그인되지 않았으면 「시작하기」 대신 「Google로 로그인」·「Apple로 로그인」이 보입니다.

오른쪽 위 X로 닫아도 마법사는 다시 열리지 않습니다. 마법사에서 정한 값은 모두 앱 설정에서 바꿀 수 있습니다(7.1 앱 설정).

2.3 로그인

GDA를 사용하려면 이 PC를 GDA 계정에 연결해야 합니다. 처음 실행할 때나 PC 연결이 풀렸을 때 「로그인」 화면이 뜹니다. 계정이 없으면 로그인할 때 자동으로 가입됩니다.

브라우저로 로그인하기(기본)

  1. 「Google로 로그인」 또는 「Apple로 로그인」을 눌러 주세요. 지난번에 사용한 버튼 옆에는 「이전 로그인」이 보입니다.

  2. 기본 브라우저가 열리면 그 계정으로 로그인해 주세요. 브라우저가 보이지 않으면 같은 버튼을 다시 눌러 주세요.

  3. 처음 가입하는 계정이면 「계정 생성을 위해 약관 동의가 필요합니다.」가 보입니다. 「(필수) 이용약관」과 「(필수) 개인정보처리방침」을 읽고 「전체 동의」를 눌러 주세요.

  4. GDA로 돌아오면 「로그인을 확인하는 중입니다.」가 보인 뒤 다음 화면이 저절로 열립니다.

로그인 시간이 지났다는 안내가 보이면 다시 로그인하거나 「모바일 앱으로 로그인」을 눌러 주세요.

mac에서 브라우저에 「페이지를 열 수 없음」이 보였다면 Safari 설정 → 보안의 「HTTP를 통해 웹 사이트에 연결하기 전에 경고」를 끈 뒤 다시 로그인해 주세요.

모바일 앱으로 로그인하기(QR 코드)

플러스를 구독하고 모바일 앱을 사용하고 있다면 QR 코드로도 로그인할 수 있습니다. 무료 계정은 위의 브라우저 로그인을 이용해 주세요.

  1. 로그인 화면 오른쪽 위의 「모바일 앱으로 로그인」을 눌러 주세요. 화면에 QR 코드가 나타납니다.

  2. 휴대폰에 「GDA (Game Dev Assistant)」 앱을 설치하고 Apple 또는 Google 계정으로 로그인해 주세요.

  3. 앱에서 「PC 연결하기」를 누르고 PC 화면의 QR 코드를 스캔해 주세요.

  4. PC에 「확인 번호」가 뜨면 휴대폰에 같은 번호가 보이는지 확인하고 「연결」을 눌러 주세요. 번호가 다르면 「취소」를 누르고 「QR 코드 새로 만들기」로 다시 시작해 주세요.

브라우저 로그인으로 돌아가려면 「Google·Apple로 로그인」을 눌러 주세요. 연결할 수 있는 PC 수가 차 있으면 8.1 PC 바꾸기를 따라 주세요.

2.4 첫 프로젝트 만들기

프로젝트는 게임 하나를 만드는 폴더입니다. 왼쪽 위 「새 프로젝트」를 누르면 단계별 창이 열립니다. 단계는 「기본 정보」·「플랫폼」·「에이전트」·「참고자료」 넷이며, 아트 파트를 켜 두면 「이미지」 단계가 더해집니다.

  1. 기본 정보 : 「게임 제목」을 적고 「저장 위치」를 확인한 뒤 「다음」을 눌러 주세요.

    • 저장 위치의 기본값은 설정 마법사에서 정한 폴더이며, 「폴더 선택」으로 바꿉니다.
    • 「게임 제목으로 폴더 자동 생성」을 켜 두면 그 안에 게임 제목 폴더가 새로 만들어집니다(예 : D:\GDA Projects\내 게임, mac은 ~/Documents/GDA Projects/내 게임). 실제 위치는 「저장될 폴더」에서 확인합니다.

  2. 플랫폼 : 「PC 전용」·「모바일 전용」·「PC + 모바일」·「웹 (HTML5)」 중 하나를 고르고 「다음」을 눌러 주세요. PC와 모바일 게임은 Godot 엔진을 사용합니다.

  3. 에이전트 : 함께 일할 파트를 체크해 주세요. 기획·아트·개발이 기본으로 켜져 있습니다.

    • 파트마다 AI 서비스·모델·사고 깊이를 고릅니다. 그대로 두면 앱 설정의 값을 사용합니다.
    • 사운드는 앱 설정 → 사운드에서 로컬 모델을 설치한 뒤 사용할 수 있습니다.
    • QA는 개발 파트를 켜고 PC·모바일 플랫폼을 골라야 켤 수 있습니다.

  4. 이미지 : 아트 파트를 켜 두었을 때만 보입니다. 이미지를 만드는 방법을 골라 주세요. 방법은 나중에 프로젝트 설정에서 바꿀 수 있습니다.

    • 「ChatGPT로 생성」(기본) : ChatGPT 계정을 사용합니다. 앱 설정 → 이미지에서 ChatGPT에 로그인하거나 OpenAI API 키를 넣어 주세요.
    • 「내 PC에서 생성」 : 그래픽카드로 직접 만듭니다. 모델 계열(Z-Image·Illustrious·SDXL·Krea2·SD 1.5) 중 하나를 골라 주세요. 설치되지 않은 계열은 「다운로드」를 눌러 모델 파일을 다운로드해 주세요. 다운로드 중에도 다음 단계로 갈 수 있지만, 이미지는 다운로드가 끝난 뒤에 만들 수 있습니다.
  5. 참고자료 : 필요하면 「참고할 게임」에 게임 이름이나 링크를 적고, 참고할 파일을 「문서」·「이미지」·「영상」 칸에 끌어다 놓아 주세요. 없어도 됩니다. 마지막으로 「프로젝트 생성」을 눌러 주세요.

저장 위치에 이미 다른 파일이 있으면 프로젝트를 만들 수 없습니다. 비어 있는 폴더를 골라 주세요. 파트와 플랫폼은 나중에 프로젝트 설정에서 바꿀 수 있습니다(7.2 프로젝트 설정).

2.5 첫 대화와 첫 승인

프로젝트를 만들면 가운데 「홈」에 「상상한 게임, 여기서 시작해요.」와 시작 버튼 네 개가 보입니다. 하나를 골라 기획 채팅을 시작해 주세요.

대화를 하다 보면 에이전트가 내용을 확정해도 되는지 묻는 승인 카드가 채팅에 뜹니다. 카드 제목은 「이렇게 반영하시겠습니까?」입니다.

  1. 카드의 요약과 대상 파일을 읽어 주세요.
  2. 괜찮으면 「승인」, 받아들이지 않으면 「반려」, 고칠 점이 있으면 「수정」을 눌러 주세요.
  3. 결정하면 카드가 한 줄로 접히고 에이전트가 이어서 작업합니다.

결정하지 않은 카드가 있으면 입력창 위에 「승인 대기 N건 : 카드로 이동」이 보이고, 왼쪽 파트 이름 옆에 물음표가 붙습니다. 자세한 내용은 4.2 승인 카드에 있습니다.

화면 둘러보기

GDA 화면은 위쪽 상단 바, 왼쪽 사이드바, 가운데 작업 영역, 오른쪽 패널, 맨 아래 상태 표시줄로 나뉩니다. 프로젝트를 열면 가운데에 「홈」이 먼저 보입니다(3.6 홈).

3.1 상단 바와 프로젝트 메뉴

상단 바에서는 지금 연 프로젝트를 확인하고, 그 프로젝트에서 사용하는 화면을 엽니다.

Godot 실행 승인을 기다리는 작업이 있으면 상단 바에 「실행 승인 N」 버튼이 생깁니다.

「앱 다시 연결 중」이 보이면 화면과 GDA 내부 연결이 잠시 끊긴 상태입니다. 인터넷 연결과는 관계없으며, 잠시 기다리면 다시 연결됩니다.

3.2 사이드바(프로젝트와 파트)

사이드바에서 프로젝트를 만들거나 열고, 작업할 파트를 고릅니다. 위쪽 「새 프로젝트」로 새로 만들고, 「프로젝트 열기」로 PC에 있는 GDA 프로젝트 폴더를 엽니다.

맨 아래에는 AI 서비스 「사용량」과 「앱 설정」 버튼이 있습니다. 「사용량」은 연결한 Claude·ChatGPT 계정의 한도를 얼마나 사용했는지 보여 줍니다.

3.3 가운데 작업 영역

가운데에서는 홈·파트 채팅·문서를 탭으로 열어 작업합니다.

프로젝트를 열지 않았을 때는 「새 프로젝트」와 「프로젝트 열기」 버튼이 있는 시작 화면이 보입니다.

채팅 탭 머리에는 파트 이름, 지금 상태, 사용하는 AI 서비스가 보입니다. 채팅 사용법은 4장 채팅으로 일하기에 있습니다.

3.4 우측 패널

오른쪽 패널은 지금 고른 파트의 결과물을 보여 줍니다. 「파일」 탭은 모든 파트에 공통이고, 그 뒤 탭은 파트마다 다릅니다.

다른 파트가 보낸 요청은 「파일」 탭의 requests 폴더 안에 파일로 보입니다(4.3).

패널 오른쪽 위 버튼으로 패널을 접고 펼 수 있습니다. 할 일·메모·노드 목록을 열면 오른쪽 패널은 숨겨집니다.

3.5 상태 표시줄

맨 아래 상태 표시줄은 연결 상태를 한눈에 보여 줍니다.

로컬 엔진은 처음 요청할 때 저절로 켜지고, 사용하지 않으면 잠시 뒤 스스로 꺼집니다. 켜져 있는 엔진을 누르면 바로 끌 수 있습니다.

Godot 실행 승인을 기다리는 작업이 있으면 「승인 대기 N」이 생깁니다. 누르면 승인 창이 열립니다.

3.6 홈

홈에서는 게임이 지금 어디까지 만들어졌는지 한눈에 보고, 다음에 할 일을 고릅니다. 프로젝트를 열면 가운데 맨 앞 「홈」 탭이 먼저 열립니다.

위쪽 버튼으로 바로 작업을 맡깁니다.

  1. 「갱신」 : 기획 파트가 코어 루프·게임 흐름과 에셋 목록을 지금 상태에 맞게 고칩니다. 확인 창에서 「승인」을 눌러 주세요.
  2. 「플레이」 : 게임을 실행합니다. 처음 실행할 때는 Godot 실행 승인 창이 뜹니다(5.4). 웹(HTML5) 프로젝트는 개발 파트의 「미리보기」 탭이 열립니다.
  3. 「이 화면 시안 만들기」 : 「게임 흐름」에서 칸을 고른 뒤 누르면, 그 화면의 UI 시안 2장을 아트 파트에 요청합니다.

꺼진 파트로 가는 버튼은 보이지 않습니다. 홈이 열려 있는 동안 오른쪽 패널에는 「게임」·「파일」 탭이 보이며, 「게임」 탭에는 이 게임의 한 문장 소개와 코어 루프가 있습니다.

채팅으로 일하기

4.1 요청 보내기

파트 채팅에서 에이전트에게 일을 맡깁니다. 입력창에 하고 싶은 일을 평소 말로 적고 Enter를 눌러 주세요. 줄을 바꾸려면 Shift+Enter를 누릅니다.

내가 보낸 메시지는 오른쪽에, 에이전트의 답변은 왼쪽에 이어서 보입니다.

파일·이미지 첨부

  1. 입력창 위 「파일 첨부」를 누르거나, 파일을 채팅 창에 끌어다 놓아 주세요.

  2. 복사한 이미지(예 : 화면 캡처)는 입력창에서 Ctrl+V(mac은 Cmd+V)로 붙여 넣습니다. 붙여 넣은 이미지는 「클립보드-날짜-시간.png」 이름으로 첨부됩니다.

  3. 첨부한 파일은 입력창 위에 칩으로 보입니다. 빼려면 칩의 ×를 눌러 주세요.

  4. 요청 글을 적고 보내 주세요. 첨부한 파일은 프로젝트 안에 복사되어 에이전트에게 함께 전달됩니다.

막혔을 때

아이디어 받기

기획·시나리오 채팅의 「아이디어 받기」를 누르면 소재 키워드를 고르는 창이 열립니다. 마음에 드는 칩을 고르거나 「내 키워드」에 쉼표로 적은 뒤 「전송」을 눌러 주세요. 고르기 어렵다면 「아무거나 골라 줘」를 누릅니다.

에이전트에게 맡길 수 있는 일

4.2 승인 카드

에이전트가 내용을 확정하기 전에 결정이 필요하면 채팅에 승인 카드를 띄웁니다. 카드 제목은 「이렇게 반영하시겠습니까?」입니다. 요약과 대상 파일(「신규」·「수정」·「삭제」)이 보이고, 「초안 열기」로 초안을 먼저 볼 수 있습니다.

  1. 그대로 받아들이려면 「승인」을 눌러 주세요.
  2. 받아들이지 않으려면 「반려」를 누르고, 필요하면 사유를 적은 뒤 「반려 보내기」를 눌러 주세요.
  3. 고칠 점이 있으면 「수정」을 눌러 주세요. 채팅에 「수정할 내용을 입력해 주세요.」가 보이면 입력창에 고칠 내용을 적어 보내 주세요(600자까지). 그만두려면 입력창 위 「수정 내용 입력 중」 칩의 ×를 누릅니다.
  4. 반영하지 않고 카드만 닫으려면 「폐기」를 눌러 주세요.

카드 위쪽에 「결정 대기 중 : 에이전트가 이 턴에서 이어서 진행합니다」가 보이면 결정 즉시 에이전트가 이어서 작업합니다. 「다음 턴에 반영됩니다」가 보이면 결정이 다음 대화 차례에 전달됩니다. 결정한 카드는 한 줄로 접히며, 누르면 다시 펼쳐집니다.

기획 문서·시나리오 문서·개발 코드처럼 계속 고쳐 가는 결과물은 카드 없이 바로 고칩니다.

그 밖의 카드

아래 카드는 결정할 때까지 그 파트 작업이 멈춥니다. 카드에 「결정 전까지 작업이 일시 중지됩니다」가 보입니다.

4.3 수신 요청과 미결

파트 사이 요청(수신함)

파트끼리는 요청 파일로 일을 주고받습니다. 예를 들어 개발 파트가 기획 변경이 필요하면 기획 파트에 요청을 보냅니다. 다른 파트에 일을 넘기고 싶을 때는 채팅에서 「개발 파트에 전달해 주세요」처럼 요청해 주세요.

받은 요청은 「파일」 탭의 requests/<파트> 폴더(예 : requests/plan)에 파일로 쌓입니다. 이 폴더가 각 파트의 수신함입니다.

처리 결과를 확정할 때는 그 파트 채팅에서 승인을 거칩니다(4.2). 「자율 진행」을 켜 두면 문서·코드·표 작업은 승인을 묻지 않고 끝까지 처리합니다(4.7).

미결

기획·시나리오의 「미결」 탭에는 에이전트가 판단을 미루고 사용자에게 맡긴 항목이 「결정할 항목 N개」로 모입니다. 탭 이름 옆 숫자가 남은 개수입니다.

4.4 세션

세션은 한 파트 채팅에서 에이전트와 이어지는 대화입니다. 이 절에서는 진행 상태를 보고, 세션을 멈추거나 새로 시작하는 방법을 설명합니다.

파트 상태는 채팅 머리와 사이드바에 「시작 전」·「에이전트 준비 중」·「대기 중」·「처리 중」처럼 보입니다. 에이전트가 일하는 동안에는 에이전트 이름 옆에 「진행 중」이 보이고, 그 아래에 「생각 중」·「작업 N건 실행 중」·「답변 작성 중」과 걸린 시간이 나옵니다.

토큰·컨텍스트 배지

채팅 머리의 「컨텍스트 n% · 입력 N · 출력 N」은 이 세션이 사용한 토큰 양입니다. 비용이나 요금이 아니며, 사이드바의 「사용량」과도 다릅니다.

채팅 머리 버튼

대기와 재전송

여러 파트와 앱 종료

여러 파트가 동시에 일할 수 있고, 상태 표시줄의 「실행 중 N개 파트」로 확인합니다.

앱을 닫으면 「앱을 종료하시겠습니까? 열린 대화의 메모리를 정리한 뒤 종료합니다.」가 뜹니다.

  1. 「종료」를 누르면 「메모리 정리 중…」 창이 보이고, 에이전트가 진행 내용을 기억 파일에 정리한 뒤 앱이 닫힙니다.
  2. 기다리기 어려우면 「건너뛰고 종료」를 눌러 주세요.

mac에서는 창을 닫거나 Cmd+Q를 눌러도 같은 확인 창을 거쳐 종료됩니다. 대화 기록은 그대로 남아, 다음에 앱을 열어 이어서 요청할 수 있습니다.

4.5 할 일·메모·노드

「프로젝트 메뉴」에서 여는 사용자용 화면입니다. 가운데 탭으로 열립니다.

할 일

  1. 「할 일 추가」를 눌러 제목·마감일·체크리스트·상세 내용을 적고 「저장」을 눌러 주세요.
  2. 항목은 「할 일」·「완료」·「보류」로 나뉩니다. 고른 항목에서 「수정」·「완료 처리」·「보류 처리」·「할 일로 복귀」를 누릅니다.
  3. 항목을 우클릭하거나 「…」를 누르면 「삭제」가 나옵니다.

메모

「항목 추가」를 눌러 제목과 내용을 적고 「저장」을 눌러 주세요. 메모마다 「수정」·「삭제」가 있습니다.

노드 목록

개발 파트가 Godot 화면의 요소(버튼 등)를 확인해 게시하면 「노드 목록」에 보입니다. Godot 프로젝트에서만 사용할 수 있습니다.

  1. 왼쪽 목록에서 노드를 골라 주세요. 「현재 기능」에 지금 하는 일이 보입니다.

  2. 「사용자 요청」에 바라는 동작이나 변경을, 「비고」에 참고할 내용을 적어 주세요. 버튼이면 「효과음」도 고를 수 있습니다. 적은 내용은 저절로 저장되고 「저장 완료」가 보입니다.

  3. 개발 채팅에 「노드 목록의 요청을 반영해 주세요」처럼 보내 주세요.

4.6 개발일지

개발일지는 지금까지의 진행을 날짜별로 정리한 기록입니다. 「프로젝트 메뉴」 → 「개발일지」에서 엽니다.

  1. 「생성」을 눌러 주세요. 기획 파트가 지난 일지 이후의 진행·결정·할 일·QA 결과를 plan/devlog/오늘 날짜.md에 정리합니다.

  2. 일지가 만들어지면 목록에 날짜별로 나타납니다. 누르면 문서로 열려 고칠 수 있습니다.

  3. 「복사」를 누르면 일지 내용을 복사해 다른 곳에 붙여 넣을 수 있습니다.

같은 날 다시 「생성」을 누르면 그날 일지에 이어서 씁니다. 기획 파트가 꺼져 있으면 개발일지를 만들 수 없습니다.

4.7 자율 진행

자율 진행을 켜면 에이전트가 승인이나 선택을 묻지 않고 작업을 끝까지 마친 뒤, 결과를 한 번에 보고합니다. 프로젝트마다 따로 켜며, 처음에는 꺼져 있습니다.

  1. 가운데 탭 줄 오른쪽 끝의 「자율 진행」을 눌러 주세요.

  2. 창이 열리면 자율 진행 동안 묻지 않고 허용할 항목을 체크해 주세요. 이미 허용한 항목은 목록에 없습니다.

    • 「Godot 실행 허용」·「스크립트 실행 허용」 : 처음에 체크되어 있습니다. 웹(HTML5) 프로젝트에는 Godot 항목이 없습니다.
    • 「외부 링크 자동 허용」 : 처음에 꺼져 있습니다. 켜면 프로젝트 내용이 외부 사이트로 나갈 수 있습니다.
    • 「서브에이전트 자동 허용」 : 처음에 꺼져 있습니다. 켜면 토큰 사용량이 크게 늘어납니다.
  3. 「승인」을 누르면 자율 진행이 켜집니다.

체크하지 않은 항목은 지금처럼 카드로 묻습니다. 자율 진행 중에 자동으로 승인된 카드에는 「승인 · 자율 진행 자동 승인」이 남습니다.

다른 파트가 넘긴 요청을 처리할 때도 같은 설정이 적용되어, 문서·코드·표 작업을 승인 없이 끝까지 진행합니다. 다만 이미지·사운드 생성, 게임·스크립트 실행, 다른 파트로의 전달은 이때도 하지 않고 보고로 남깁니다. 필요하면 그 파트 채팅에서 요청해 주세요.

자율 진행을 끄려면 같은 버튼을 다시 누릅니다. 끄면 외부 링크·서브에이전트 자동 허용도 함께 풀립니다. 프로젝트 설정 → 기본의 「자율 진행」에서도 켜고 끄거나 항목을 바꿀 수 있습니다(7.2).

파트별 안내

5.1 기획

기획 파트는 아이디어를 게임 기획서로 정리합니다. 기획 채팅에 만들고 싶은 게임을 이야기하면, 에이전트가 컨셉·게임 흐름·시스템 문서를 plan/ 폴더에 쓰고 계속 고쳐 갑니다.

  1. 기획 채팅에서 원하는 게임을 이야기하고 에이전트의 질문에 답해 주세요.

  2. 오른쪽 「기획서」 탭에서 문서를 눌러 읽어 주세요. 직접 고칠 수도 있습니다(6.3).

  3. 기획이 어느 정도 모이면 「게임 규칙」 탭 위의 「규칙 생성」을 눌러 주세요. 확인 창에서 한 번 더 확인하면 기획서 전체로 규칙을 만들도록 기획 파트에 요청합니다. 규칙은 개발 파트가 구현할 때 기준으로 삼는 정리본입니다.

  4. 「데이터」 탭에서 아이템·레벨 같은 데이터 표를 확인해 주세요. 표를 누르면 가운데에서 표로 열려 고칠 수 있습니다.

5.2 시나리오

시나리오 파트는 세계관·등장인물·본문·대사를 씁니다. 시나리오 채팅에 쓰고 싶은 이야기를 요청해 주세요.

5.3 아트

아트 파트는 캐릭터·배경·아이템·UI 이미지를 만듭니다. 이미지를 만들려면 GPT 이미지(앱 설정 → 이미지)나 로컬 이미지 엔진 중 하나가 준비되어 있어야 합니다. 준비가 안 되어 있으면 아트 채팅 위에 안내와 「이미지 설정 열기」 버튼이 보입니다.

  1. 아트 채팅에 필요한 이미지를 요청해 주세요(예 : 「주인공 캐릭터 시안을 만들어 주세요」).

  2. 새로 만든 이미지는 바로 「사용 중」이 되어 게임 폴더(game/assets)에 저장되고, 개발 파트가 사용합니다. 여러 장을 만들면 첫 장이 「사용 중」, 나머지는 「대기」가 됩니다.

  3. 「이미지」 탭의 「대상별」 보기에서 대상마다 만든 이미지와 진행 단계(「시안」·「시트」·「프레임」·「저장」)를 확인해 주세요. 사용 중인 이미지에는 별 표시가 붙습니다. 다른 장을 사용하려면 그 장에서 「사용」을 누릅니다.

  4. 이미지를 두 번 누르면 크게 봅니다. 경로·크기를 확인하고 아래 「수정」·「사용」·「삭제」를 누릅니다. 「수정」은 고칠 내용을 적어 「보내기」를 누르면 아트 채팅에 바로 요청합니다.

이미지 다루기

탭 위쪽 버튼

픽셀 아트 게임

그림체를 픽셀 아트(도트)로 정하면 픽셀 아트 게임으로 만듭니다.

  1. 아트 채팅에 「그림체를 픽셀 아트로 정해 주세요」처럼 요청해 주세요. 스타일 프롬프트에 반영됩니다.
  2. 폭발·불·마법·타격 같은 이펙트가 필요하면 「폭발 이펙트를 만들어 주세요」처럼 요청해 주세요. 아트 파트가 픽셀 이펙트를 바로 만듭니다.

픽셀 아트 게임의 화면 기준 해상도는 960×540(세로 게임 540×960)입니다. 배경·UI도 이 크기에 맞춰 만듭니다.

스타일과 로컬 이미지 엔진(선택)

「스타일」 탭의 「엔진」에서 「생성 방식」(OpenAI 또는 로컬 엔진)과 모델을 고르고 「저장」을 눌러 주세요. 아래 「스타일 프롬프트」는 모든 이미지에 사용되는 그림체 설명이며 읽기 전용입니다. 바꾸려면 아트 채팅에 요청해 주세요.

로컬 이미지 엔진은 내 PC의 그래픽카드(mac은 Mac 메모리)로 이미지를 만드는 선택 기능입니다.

  1. 앱 설정 → 이미지의 「로컬 이미지」에서 모델 파일을 다운로드해 주세요(7.1).
  2. 「스타일」 탭에서 「생성 방식」을 「로컬 엔진」으로 바꾸고 「저장」을 눌러 주세요. 로컬 엔진이 함께 켜지고 아트에 「로컬」 탭이 열립니다. 프로젝트 설정 → 고급의 「로컬 이미지 엔진」에서도 켜고 끌 수 있습니다.
  3. 「로컬」 탭에서 모델·VAE·단계·LoRA 같은 세부 설정을 고릅니다.

5.4 개발

개발 파트는 Godot 프로젝트에 장면과 코드를 만들어 실제로 움직이는 게임을 만듭니다. 먼저 앱 설정 → 프로젝트의 「Godot 엔진 연결」에서 Godot를 연결해 주세요(7.1).

  1. 개발 채팅에 만들 기능을 요청해 주세요. 개발 파트는 기획의 규칙과 아트가 저장한 이미지를 바탕으로 작업합니다.

  2. 오른쪽 「엔진」 탭의 「게임 실행」을 눌러 게임을 실행해 주세요. 특정 장면만 보려면 「장면」에서 .tscn 파일을 고르고 「실행」을 누릅니다. 결과와 로그는 「실행 기록」에 남습니다.

  3. 처음 실행할 때는 「Godot 실행 승인」 창이 뜹니다. 내용을 확인하고 「이 프로젝트의 Godot 실행 허용」을 눌러 주세요. 한 번 허용하면 이 프로젝트에서는 다시 묻지 않으며, 개발·QA 파트의 게임 실행과 플레이 테스트에 모두 적용됩니다.

화면 크기

개발 파트는 게임 화면이 창 크기에 맞춰 늘어나도록 만드는 것이 기본입니다. 기준 해상도는 1920×1080(세로 게임 1080×1920)이고, 픽셀 아트 게임은 절반인 960×540(세로 게임 540×960)입니다. 다른 방식이 필요하면 개발 채팅에 요청해 주세요.

게임 내보내기

완성한 게임을 실행 파일로 만들려면 개발 채팅에 「Windows용으로 내보내 주세요」처럼 요청해 주세요. 내보낼 수 있는 대상은 Windows 실행 파일·웹(HTML5)·안드로이드(APK)·macOS 앱입니다.

  1. 개발 에이전트가 내보내기를 시작하면 승인 창에 「게임 내보내기(대상) 실행을 허용하시겠습니까?」가 뜹니다. 이 프로젝트에서 Godot 실행을 아직 허용하지 않았다면 「이 프로젝트의 Godot 실행 허용」을 눌러 주세요.

  2. 내보내기가 끝나면 에이전트가 결과 위치를 채팅으로 알려 줍니다. 결과는 프로젝트의 build 폴더에 들어갑니다.

내보내기에는 Godot 내보내기 템플릿이 필요합니다. 없으면 개발 에이전트가 설치 방법을 안내합니다.

macOS 앱은 mac에서 GDA를 실행할 때만 내보낼 수 있습니다.

웹(HTML5) 프로젝트

웹 플랫폼으로 만든 프로젝트는 엔진 없이 HTML·CSS·JavaScript로 만듭니다.

5.5 사운드

사운드 파트는 배경음악·효과음·음성을 만듭니다. 내 PC에서 돌아가는 로컬 모델을 사용하므로 먼저 준비해 주세요.

  1. 프로젝트 설정 → 사용 파트에서 「사운드」를 켜 주세요(7.2).

  2. 앱 설정 → 사운드에서 필요한 모델 파일의 「다운로드」를 눌러 주세요(7.1). 그래픽카드 메모리가 12GB(mac은 Mac 메모리 16GB)보다 적으면 느리거나 실패할 수 있습니다.

  3. 사운드 채팅에 필요한 소리를 요청해 주세요(예 : 「전투 배경음악을 만들어 주세요」).

  4. 오른쪽 「사운드」 탭에서 만든 소리를 「BGM」·「효과음」·「음성」으로 나눠 보고, 재생해 확인해 주세요.

처음 요청할 때는 모델을 불러오느라 오래 걸립니다. 엔진 상태는 상태 표시줄의 「음성 엔진」·「음악 엔진」·「효과음 엔진」에서 확인합니다.

5.6 QA(플레이 테스트)

QA 파트는 개발 파트가 만든 게임을 직접 실행해 확인하고, 문제를 찾으면 개발 파트에 알립니다. 개발 파트를 켜고 플랫폼이 PC·모바일(Godot)인 프로젝트에서만 켤 수 있습니다.

  1. 프로젝트 설정 → 사용 파트에서 「QA」를 켜 주세요.

  2. QA 채팅에 확인하고 싶은 내용을 적어 주세요(예 : 「시작 화면에서 시작 버튼을 누르면 게임이 시작되는지 확인해 주세요」).

  3. QA가 테스트 순서를 만들고 게임을 실행합니다. 「자동 테스트 중입니다. 열린 게임 창은 조작하지 말아 주세요.」가 보이면 테스트가 끝날 때까지 게임 창을 건드리지 말아 주세요.

  4. 오른쪽 「결과」 탭에서 실행 목록을 누르면 스크린샷·「단계별 결과」·「콘솔 로그」를 볼 수 있습니다. 최근 10회까지 보관됩니다.

QA는 키 입력과 대기로 게임을 조작합니다. 마우스 클릭은 아직 재생하지 않습니다.

문제를 찾으면 QA 채팅에서 개발 파트에 버그 보고를 보냅니다. 개발 파트가 고친 뒤 QA에 다시 확인을 요청해 주세요. 게임 실행 승인은 개발 파트와 함께 사용합니다(5.4).

문서 다루기

에이전트가 만든 문서와 파일은 모두 내 PC의 프로젝트 폴더에 저장됩니다. 오른쪽 「파일」 탭에서 찾아 열고, 가운데 문서 탭에서 읽고 고칩니다.

6.1 파일 트리

오른쪽 패널의 「파일」 탭은 프로젝트 폴더 전체를 보여 줍니다. 파트별 폴더(plan·scenario·game 등)와 받은 요청이 모이는 requests 폴더가 있습니다.

GDA가 관리하는 일부 폴더와 파일은 바꿀 수 없으며, 메뉴에 「이 항목은 변경할 수 없습니다.」가 보입니다.

휴지통

삭제한 파일은 바로 지워지지 않고 목록 맨 아래 「휴지통 (N)」에 7일 동안 남습니다.

  1. 「휴지통 (N)」을 눌러 펼치면 지운 항목과 삭제 시각이 보입니다.
  2. 되살리려면 항목의 「복구」를 눌러 주세요.
  3. 휴지통을 비우려면 「비우기」를 누르고, 확인 창에서 「완전히 삭제」를 눌러 주세요. 비운 항목은 복구할 수 없습니다.

6.2 미리보기

문서(.md)를 열면 제목·목록·표가 정리된 모습으로 보입니다. 문서 탭 머리에는 파일 이름, 경로, 줄 수, 저장 상태가 보입니다.

6.3 편집

  1. 문서 탭 오른쪽 위 「편집」을 눌러 주세요. 아래쪽에 원문 편집 칸이 열리고, 위쪽에서 고친 결과를 바로 볼 수 있습니다.

  2. 내용을 고친 뒤 「저장」을 눌러 주세요. 고친 내용을 버리려면 「취소」를 누릅니다.

편집하는 사이 에이전트가 같은 파일을 먼저 고치면, 내 내용으로 덮어쓰지 않고 「내 초안」과 「현재 파일」을 나란히 보여 줍니다. 비교한 뒤 필요한 내용을 옮기거나 「최신 내용 불러오기」를 눌러 주세요. 비교를 닫으려면 「비교 닫기」를 누릅니다.

6.4 수신 요청 문서(읽기 전용)

requests 폴더의 요청 문서는 다른 파트가 보낸 요청이라 읽기만 할 수 있습니다. 열면 「요청 문서는 읽기 전용입니다.」가 보입니다.

요청은 GDA가 받는 파트에 자동으로 넘기므로 따로 할 일은 없습니다.

설정

설정은 두 가지입니다. 앱 설정은 이 PC의 GDA 전체에 적용되고, 프로젝트 설정은 프로젝트마다 따로 정합니다.

7.1 앱 설정

사이드바 맨 아래 「앱 설정」을 누르면 전체 화면으로 열립니다. 왼쪽 메뉴에서 「AI 서비스」·「이미지」·「사운드」·「프로젝트」·「화면」·「계정」 중 하나를 골라 주세요. 다 보면 「앱으로 돌아가기」를 누릅니다.

바꾼 값은 바로 저장되며, 페이지 오른쪽 위에 「저장 중」·「저장 완료」 같은 저장 상태가 보입니다. 메뉴의 「도움말」은 이 도움말을 엽니다.

AI 서비스

에이전트로 사용할 AI 서비스(Claude·ChatGPT·Grok)를 연결합니다. 「에이전트 연결」에서 여러 개를 함께 연결할 수 있습니다.

  1. 사용할 서비스의 체크 상자를 켜 주세요. 「설치되지 않았습니다. 「설치」를 눌러 주세요.」가 보이면 「설치」를 누릅니다.

  2. 인증 방식을 골라 주세요.

    • 「구독」 : 「인증」을 누르고, 열린 로그인 창에서 로그인합니다.
    • 「API 키」 : 키를 붙여 넣고 Enter를 누릅니다.
  3. 주로 사용할 서비스에 「기본 에이전트」를 표시해 주세요.

  4. 「기본 모델 설정」에서 서비스별 「모델」과 「사고 깊이」를 고릅니다. 잘 모르겠으면 「선택 가이드」를 눌러 비교해 주세요.

이미지

이미지 페이지에는 「GPT 이미지」와 「로컬 이미지」 두 묶음이 있습니다.

GPT 이미지

아트 파트에서 GPT 이미지를 사용할지 정합니다. 「GPT 이미지 사용」을 「사용」으로 바꾸고 「인증 방식」을 골라 주세요.

로컬 이미지

내 PC의 그래픽카드(mac은 통합 메모리)로 이미지를 만들 때 필요한 설정입니다. 사용하지 않으면 건드리지 않아도 됩니다.

  1. 「GPU 처리 방식」의 「실행 방식」은 보통 「자동」으로 둡니다. 「자동」은 NVIDIA 그래픽카드가 있으면 CUDA, 없으면 Vulkan을 사용합니다. mac은 Metal로 실행하며 고를 것이 없습니다.

  2. 「지원 모델」 표에서 사용할 계열을 고르고, 계열의 「다운로드」를 눌러 필요한 파일을 한 번에 다운로드해 주세요. 「요구 VRAM」과 「내 GPU」(mac은 「내 Mac 메모리」)를 비교해 내 PC에 맞는 계열을 고릅니다.

계열마다 다운로드 방식이 조금 다릅니다.

표는 품질이 높은 순서입니다. 내 GPU에 맞는 것 가운데 위쪽 모델을 골라 주세요.

모델 특징 필요 GPU
Z-Image 캐릭터·배경·글자가 들어간 이미지 본작업에 맞습니다. 1024×1024, 8단계라 빠르고 글자 표현이 좋으며, 문장으로 설명해도 반영됩니다. 부정 프롬프트는 없습니다. 본체 3.912.3 GB(Q4_K·Q6_K·Q8_0·BF16 중 하나) + 텍스트 인코더 2.54.3 GB + VAE 0.3 GB. 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가 알아봅니다.

  1. 「모델 계열」에서 사용하는 본체 계열을 골라 주세요. LoRA·VAE는 본체와 계열이 맞아야 동작합니다.

    • SDXL용 LoRA를 SD 1.5 본체에 켜면 결과가 깨지거나 생성에 실패합니다.
    • Illustrious·Animagine은 SDXL 구조라 SDXL용 LoRA도 켜지지만, 그 모델용 LoRA가 결과가 좋습니다.
    • Krea2·Z-Image는 사용할 수 있는 LoRA가 거의 없습니다.
  2. 항목의 「다운로드 페이지 열기」를 누르면 모델 페이지(civitai 또는 Hugging Face)가 브라우저에서 열립니다. 그 페이지에서 파일을 다운로드해 주세요. 사이트에 따라 로그인이 필요할 수 있습니다. 「더 찾기 ↗」는 그 계열에 맞는 civitai 검색 결과를 엽니다.

  3. 다운로드한 파일을 모델 폴더에 넣어 주세요. 표 제목 줄의 「폴더 열기」를 누르면 넣을 폴더(LoRA는 loras, VAE는 vae)가 열립니다. 파일 이름은 바꾸지 않아도 됩니다.

  4. 넣은 파일은 잠시 뒤 표에 「설치 완료」로 보입니다. 이때 GDA가 civitai에서 트리거 워드와 권장 설정(단계·CFG)을 찾아 파일 옆에 저장합니다.

라이선스

사운드

사운드 파트가 사용하는 로컬 모델 파일(음성·음악·효과음)을 다운로드합니다. 사운드에는 표의 파일이 모두 필요합니다.

프로젝트

프로젝트 페이지에서는 새 프로젝트의 저장 위치와 Godot 엔진을 정합니다.

프로젝트 기본 폴더

새 프로젝트를 만들 때 사용하는 저장 위치의 기본값입니다. 「선택」으로 바꾸고, 「비우기」로 지웁니다.

Godot 엔진 연결

「선택」을 눌러 Godot 엔진 폴더를 지정해 주세요(mac은 Godot 앱을 고릅니다). Windows에서 연결을 풀려면 「해제」를 누릅니다. Godot가 없으면 「Godot 다운로드 (브라우저에서 열림) ↗」를 눌러 공식 사이트에서 다운로드해 주세요.

화면

계정

이 PC가 연결된 GDA 계정을 확인하고 관리합니다. 「계정 관리」에 「연결된 계정」·「이 PC 이름」·「이용 상태」·「휴대폰 연결」이 보입니다. 「이용 상태」에는 「무료 · PC 1대」나 「플러스 · PC 2대 · 모바일 앱」처럼 지금 사용하는 요금제가 보입니다.

「연결 관리」의 버튼은 아래와 같습니다.

「계정 탈퇴」는 맨 아래 따로 있습니다(8.3). 플러스 구독은 모바일 앱에서 관리합니다.

7.2 프로젝트 설정

「프로젝트 메뉴」 → 「프로젝트 설정」을 누르거나, 사이드바에서 프로젝트 오른쪽 「…」 → 「프로젝트 설정」을 누르면 열립니다. 「기본」·「사용 파트」·「고급」 탭으로 나뉘며, 바꾼 값은 바로 저장됩니다.

기본

사용 파트

파트마다 사용 여부와 「서비스」·「모델」·「사고 깊이」를 고릅니다. 「앱 설정 사용」으로 두면 앱 설정의 값을 따릅니다.

고급

계정과 PC

이 장에서는 PC를 바꿀 때, 모바일 앱을 연결할 때, 계정을 지울 때 할 일을 안내합니다. GDA 계정에 연결할 수 있는 PC 수는 무료가 1대, 플러스가 2대입니다. 플러스 구독은 모바일 앱에서 관리합니다.

8.1 PC 바꾸기

새 PC에서 로그인했는데 연결할 수 있는 PC 수가 이미 찼다면, 새 PC에서 바로 옛 PC의 연결을 해제할 수 있습니다. 모바일 앱이 없어도 됩니다.

  1. 새 PC의 로그인 화면에서 「Google로 로그인」 또는 「Apple로 로그인」으로 로그인해 주세요.

  2. 「연결 가능한 PC 수 초과」 화면이 뜨면 「연결을 해제할 PC」 목록에서 해제할 PC를 하나 골라 주세요. PC마다 이름과 마지막 사용 날짜가 보입니다.

  3. 「선택한 PC 해제하고 연결」을 누르고, 확인 창에서 「해제하고 연결」을 눌러 주세요.

  4. 지금 사용하는 PC가 그 자리에 연결되고 GDA가 열립니다.

8.2 모바일 앱 연결

모바일 앱을 연결하면 밖에서도 휴대폰으로 파트 채팅을 이어 가고, 승인 카드에 답하고, 진행 상태와 이미지를 확인할 수 있습니다. 파일 편집·설정·Godot 실행은 PC에서만 합니다. 모바일 앱 연결에는 플러스 구독이 필요합니다.

  1. 휴대폰에 「GDA (Game Dev Assistant)」 앱을 설치하고, PC와 같은 계정으로 로그인해 주세요.

  2. PC에서 앱 설정 → 계정 → 「휴대폰 추가」를 눌러 주세요. QR 코드가 있는 창이 열립니다.

  3. 모바일 앱에서 PC 연결을 시작하고 PC의 QR 코드를 스캔해 주세요.

  4. 휴대폰에서 승인하면 PC에 승인한 휴대폰 이름과 「확인 번호」가 뜹니다. 휴대폰에 같은 번호가 보이면 「연결」을 눌러 주세요. 내 휴대폰이 아니거나 번호가 다르면 「취소」를 누르고 「QR 코드 새로 만들기」로 다시 시작해 주세요.

  5. 「휴대폰을 연결했습니다.」가 보이면 끝입니다. 앱 설정 → 계정의 「휴대폰 연결」에서 상태를 확인할 수 있습니다.

8.3 계정 탈퇴

계정 탈퇴는 GDA 계정과 PC 연결을 지우며 되돌릴 수 없습니다. PC의 프로젝트는 지워지지 않습니다.

  1. 앱 설정 → 계정 맨 아래의 「계정 탈퇴」를 눌러 주세요.

  2. 확인 창 「계정을 탈퇴하시겠습니까?」에서 지워질 계정과 안내를 읽어 주세요.

  3. 「계정 탈퇴」를 누르면 본인 확인을 위해 브라우저가 열립니다. 이 PC의 계정으로 한 번 더 로그인해 주세요. QR 코드로 로그인한 PC에서는 「Google로 확인하고 탈퇴」·「Apple로 확인하고 탈퇴」 중 계정에 맞는 버튼을 누릅니다.

  4. 로그인이 끝나면 탈퇴가 진행되고, 로그인 화면에 「탈퇴가 완료되었습니다.」가 보입니다. 다시 로그인하면 새 계정으로 시작합니다.

확인 창의 안내도 함께 확인해 주세요.

다른 계정으로 로그인하면 탈퇴되지 않습니다. 서버 응답이 없어 결과를 알 수 없으면 「다시 확인」을 눌러 주세요.

업데이트와 문제 해결

9.1 자동 업데이트

GDA는 실행할 때 새 버전이 있는지 확인합니다. 새 버전이 있으면 「업데이트가 있습니다」 창에 버전과 바뀐 내용이 줄마다 보입니다.

  1. 「업데이트」를 눌러 주세요. 「다운로드 중 (N%)」 진행 막대가 보이며, 다운로드하는 동안 창을 닫아도 다운로드는 계속됩니다.
  2. 다운로드가 끝나면 GDA가 저절로 다시 시작하며 새 버전을 설치합니다. 저장하지 않은 변경이나 실행 중인 작업이 있으면 먼저 확인 창이 뜹니다. 작업을 멈추고 진행하려면 「중단하고 다시 시작」을 누릅니다.

다운로드는 끝났지만 다시 시작을 미뤘다면 「새 버전 (버전) 설치 준비가 끝났습니다. 다시 시작하면 적용됩니다.」와 함께 「다시 시작」·「나중에」가 보입니다.

9.2 알림

GDA는 알아 둘 일을 화면 위쪽 가운데에 알림 줄로 보여 줍니다. 새 알림은 아래에 쌓이고 최대 네 줄까지 보이며, 같은 알림은 한 번만 뜹니다.

9.3 AI 서비스 업데이트 안내

GDA를 업데이트한 뒤 AI 서비스에 연결하는 도구를 새 버전으로 다시 설치해야 할 때가 있습니다. 이때 「AI 서비스 업데이트가 있습니다. 앱 설정에서 업데이트해 주세요.」 창이 뜹니다.

  1. 창의 「앱 설정」을 눌러 주세요. 앱 설정 → AI 서비스가 열립니다.
  2. 해당 서비스 카드에 「AI 서비스가 GDA에서 확인한 버전(…)과 다릅니다. 「설치」를 눌러 주세요.」가 보이면 「설치」를 눌러 주세요.

다시 설치하기 전까지는 그 서비스로 채팅을 보낼 수 없습니다. 설치 뒤 카드에 「로그인 필요」가 보이면 「인증」을 눌러 다시 로그인해 주세요. 지금 하지 않으려면 「닫기」를 누릅니다.

9.4 서버에 연결할 수 없을 때

GDA는 실행할 때 계정 서버에 연결해 이용 상태를 확인합니다. 인터넷이 끊겨 있으면 「서버에 연결할 수 없습니다. 인터넷 연결을 확인한 뒤 다시 시도해 주세요.」가 뜹니다.

  1. PC의 인터넷 연결을 확인해 주세요.
  2. 「다시 시도」를 눌러 주세요. 연결되면 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 서비스에서 로그인한 뒤 다시 보내 주세요.」가 보이면 로그인이 풀린 것입니다.

  1. 앱 설정 → AI 서비스에서 해당 카드의 「인증」을 눌러 다시 로그인해 주세요.
  2. 채팅으로 돌아가 메시지를 다시 보내 주세요.

다른 계정으로 바꾸려면 「로그아웃」을 누른 뒤 「인증」을 눌러 주세요. 사이드바 사용량에 「채팅에 메시지를 보내면 사용량이 표시됩니다.」가 보이면 그 서비스로 채팅을 한 번 보내 주세요.

프로젝트를 열 수 없을 때

사이드바에 보이는 안내에 따라 해결해 주세요.

「목록에서 제거」한 프로젝트는 사이드바의 「프로젝트 열기」로 그 폴더를 다시 골라 열 수 있습니다.