About GDA
1.1 What GDA does
GDA (Game Dev Assistant) is a PC app for making games by chatting with AI. You don't need to know game development. Write what you want in a part's chat, and the AI for that part creates documents, images, and code. Everything is saved in the project folder on your PC. In this guide, the AI working in a part is called an "agent."
- Pick a project and a part on the left, then make requests in the chat in the middle.
- Home in the middle shows how far your game has come.
- Check what the agents made in the right panel.
- When something important is about to be finalized, you decide on an approval card in the chat.
There is no fixed order. You can go back to any part and change things at any time.
1.2 The six parts
Parts split game-making into roles. Each part has its own chat, and you turn on only the parts you need. New projects start with Planning, Art, and Dev turned on. Turn on the others in Project settings.
- Planning: Turns your idea into a planning doc.
- Story: Writes the world, characters, and dialogue.
- Art: Creates the images for your game.
- Dev: Builds the game as a Godot or HTML project.
- Sound: Creates music, sound effects, and voices.
- QA: Playtests the finished game.
Parts pass work to each other as request files. See 4.3 Incoming requests and pending decisions for details.
1.3 What you need
To use GDA, you need an AI service account such as Claude or ChatGPT.
Only the Godot engine is supported for development at the moment; more engines are planned.
Before you start, have the following ready.
- A PC: Windows 10/11 (64-bit) or macOS 14 or later (Apple Silicon)
- An AI service account: A Claude or ChatGPT account. You can also connect Grok (X account sign-in or an xAI API key).
- An account to sign in to GDA: A Google or Apple account. Your GDA account is created the first time you sign in.
- The Godot engine: Needed for PC and mobile games. The setup wizard shows you where to download it.
- (Optional) The mobile app: For chatting and approving from your phone while you're away from your PC. It needs a Plus subscription, which you manage in the mobile app.
- (Optional) Local engines: To make images and sound on your PC, your graphics card needs at least 12 GB of memory, and 24 GB or more is recommended. A Mac uses unified memory, so 16 GB or more is recommended, and Krea2 needs 32 GB or more.
Getting started
2.1 Installing GDA
Download GDA from the website and install it. After that, the app tells you when updates are available (9.1 Automatic updates).
- Go to https://gda.ai.kr/en/download/ and download the installer for your computer.
- Windows: Open the installer you downloaded (for example,
GDA-Setup-1.0.0.exe) and follow the steps. - Mac: Open the dmg file you downloaded, move GDA to the Applications folder, then open it.
GDA runs on Windows 10/11 (64-bit) and macOS 14 or later (Apple Silicon).
On a Mac, updates can't install if you run GDA straight from the dmg. In that case you see "The update installs only after you move GDA to the Applications folder and open it again." The Mac menu bar (GDA, Edit, Window) follows the app language.
The first time you open GDA, the sign-in screen appears (2.3 Signing in). After you sign in, the setup wizard opens (2.2 Setup wizard).
2.2 Setup wizard
The setup wizard opens once, the first time you use GDA. It walks you through the AI service, default model, project folder, and Godot connection. The step bar at the top (AI services, Default model, Project folder, Engine, Sign in) shows where you are. To go back a step, click Back.
-
Pick the card for the AI service you use (Claude, ChatGPT, or Grok), then click Next. If you don't have an AI service yet, click I don't use an AI service yet to skip to the last step.
-
GDA installs the tools needed to connect to that service. Wait until the progress bar finishes. If it's already installed, this step is skipped. If the installation fails, click Try again.
-
Click Sign in. When a sign-in window opens, sign in with your AI service account. The window then closes by itself and the wizard moves on.
-
Choose the model to use by default, then click Confirm. A model is a type of AI, and the one marked Recommended is a good choice.
- For Claude, you see Fable 5.2, Opus 5.5, Sonnet 5.5, and Haiku 5.5, and Sonnet 5.5 is Recommended. For ChatGPT, GPT 6.1 Terra is Recommended.
- Good for is what each model does best. Usage is how fast it uses your AI service limits. For example, Fable 5.2 is for complex problems but its usage is very high.
- Reasoning depth sets how deeply the AI thinks before answering.
-
Click Choose folder to pick where new projects are kept, then click Next. You can pick a different folder when you create a project.
-
Click Choose folder to select your Godot engine folder, then click Next. On a Mac, click Browse and choose the Godot app.
- If you don't have Godot, click Download Godot engine and get it from the official website (godotengine.org).
- You can also skip this and connect it later under Godot engine in App settings > Project.
-
On the You're all set! screen, click Get started. If this PC isn't signed in yet, you see Sign in with Google and Sign in with Apple instead.
If you close the wizard with the X in the top-right corner, it won't open again. You can change everything you set here in App settings (7.1 App settings).
2.3 Signing in
To use GDA, this PC must be connected to your GDA account. The Sign in screen appears the first time you open GDA, and whenever this PC is signed out. If you don't have an account yet, one is created when you sign in.
Sign in with your browser (default)
-
Click Sign in with Google or Sign in with Apple. The button you used last time shows Last sign-in.
-
Your default browser opens. Sign in with that account. If you can't see the browser, click the same button again.
-
For a new account, you see "To create your account, please agree to the terms below." Read (Required) Terms of Service and (Required) Privacy Policy, then click Agree to all.
-
Back in GDA, you see "Checking your sign-in…" and then the next screen opens by itself.
If you see that the sign-in timed out, sign in again or click Sign in with the mobile app.
On a Mac, if Safari said "Safari Can't Open the Page," turn off "Warn before connecting to a website over HTTP" in Safari Settings → Security. Then sign in again.
Sign in with the mobile app (QR code)
If you subscribe to Plus and use the mobile app, you can also sign in with a QR code. Free accounts sign in with the browser as above.
-
Click Sign in with the mobile app at the top of the sign-in screen. A QR code appears.
-
Install the GDA (Game Dev Assistant) app on your phone and sign in with Apple or Google.
-
In the app, tap Connect a PC and scan the QR code on your PC screen.
-
When a Confirmation number appears on your PC, check that your phone shows the same number. Then click Connect. If the number is different, click Cancel and start over with New QR code.
To go back to browser sign-in, click Sign in with Google or Apple. If your account has no free PC slots, follow 8.1 Switching PCs.
2.4 Creating your first project
A project is the folder for one game. Click New project in the top-left corner to open a step-by-step window. The steps are Basics, Platform, Agents, and References. If the Art part is on, an Images step is added.
-
Basics: Enter a Game title, check the Save location, then click Next.
- The save location defaults to the folder you chose in the setup wizard. Change it with Choose folder.
- With Create a folder named after the game checked, a new folder with the game's title is created inside it (for example,
D:\GDA Projects\My Game, or~/Documents/GDA Projects/My Gameon a Mac). Check the actual location under Saved to.
-
Platform: Pick PC only, Mobile only, PC + Mobile, or Web (HTML5), then click Next. PC and Mobile games use the Godot engine.
-
Agents: Check the parts you want to work with. Planning, Art, and Dev are checked by default.
- You can choose the AI service, model, and reasoning depth for each part. If you leave them as they are, the values from App settings are used.
- Sound can be used after you install its local model in App settings > Sound.
- QA can be turned on only when Dev is on and the platform is PC or Mobile.
-
Images: This step appears only when the Art part is on. Choose how images are made. You can change this later in Project settings.
- Generate with ChatGPT (default): Uses your ChatGPT account. Sign in to ChatGPT or enter an OpenAI API key under App settings > Images.
- Generate on this PC: Makes images with your graphics card. Pick one model family (Z-Image, Illustrious, SDXL, Krea2, or SD 1.5). If a family isn't installed, click Download to get its model files. You can go on while it downloads, but images can be made only after it finishes.
-
References: If you like, enter a game name or link under Games to reference. Drop files you want to share into the Documents, Images, or Videos boxes. This step is optional. Finally, click Create project.
You can't create a project in a location that already has other files in it. Choose an empty folder. You can change parts and platforms later in Project settings (7.2 Project settings).
2.5 Your first chat and first approval
After you create a project, Home in the middle shows "Your game starts here." and four start buttons. Pick one to start the Planning chat.
- Get started: The Planning agent looks over the project and asks the questions it needs, one at a time. Reply in the chat.
- I have a game in mind: The Planning chat's message box is filled with "The game I want to make is". Finish the sentence and send it.
- Start from notes or a plan: A file picker opens. Choose the planning documents you already have and send them.
- Get ideas: Pick keywords to get ideas (4.1).
As you chat, the agent may show an approval card asking whether it can finalize something. The card's title is "Apply these changes to the project?"
- Read the summary and the files listed on the card.
- Click Approve if it looks good, Reject if you don't accept it, or Revise if something needs changing.
- Once you decide, the card folds into one line and the agent carries on.
While a card is waiting for your decision, "N approvals waiting — view them" appears above the message box. A question mark also appears next to the part name on the left. See 4.2 Approval cards for details.
Screen tour
The GDA window has a top bar, a left sidebar, a work area in the middle, a right panel, and a status bar at the bottom. When you open a project, Home appears first in the middle (3.6 Home).
3.1 Top bar and Project menu
The top bar shows the project you have open and opens the screens for that project.
- The GDA version is on the left, and the project name is in the middle. Click the name to show the project folder's location.
- Click Project menu on the right to open the items below.
- To-dos and Notes: Write down your tasks and notes (4.5).
- Dev log: Sums up progress so far as dated logs (4.6).
- Nodes: Write what you want for elements such as buttons in your Godot screens. Not available in Web (HTML5) projects.
- Sound: Connect the music, sound effect, and voice folders on your PC and listen to them.
- Project settings: Opens settings such as parts, platforms, and references (7.2).
- Help: Opens this guide from the start. The question-mark buttons around the app open the part of this guide for that screen.
When something is waiting for approval to run Godot, an Approvals N button appears in the top bar.
If you see "Reconnecting app," the window has briefly lost its connection to GDA itself. This has nothing to do with your internet connection. Wait a moment and it reconnects.
3.2 Sidebar (projects and parts)
Use the sidebar to create or open projects and to pick the part you want to work in. Click New project at the top to create one, and Open project to open a GDA project folder on your PC.
- Under an open project, you see Home and then the parts that are on. Click Home to open the Home tab, or a part name to open its chat.
- A part's status ("Not started," "Ready," "Working," and so on) always shows to the right of its name.
- Click the project name again to collapse or expand its parts. While collapsed, a dot next to the project name means there's new activity or a decision waiting.
- A bell next to a part name means there's a new reply or an incoming request. A question mark means it's waiting for your decision.
- Closed projects show "Recent · click to open." Click one to open it again.
- If you see "Folder not found" or "Can't open the folder right now," see 9.5 FAQ.
- The … menu next to a project has Pin to top, Project settings, and Remove from list. Remove from list only takes it off the list. The folder and files stay where they are.
At the bottom are AI service Usage and the App settings button. Usage shows how much of your connected Claude and ChatGPT limits you've used.
3.3 Work area in the middle
Home, part chats, and documents open as tabs in the middle.
- The Home tab is always first and can't be closed (3.6).
- Part chat tabs can't be closed either. Document tabs, which open when you open a file, close with the × on the tab.
- Autonomous mode at the right end of the tab bar lets agents keep working without asking for approvals (4.7).
- When you switch projects, that project's tabs come back as you left them.
When no project is open, you see a start screen with New project and Open project buttons.
The top of a chat tab shows the part name, its current status, and the AI service it uses. See Chapter 4, Working in chat for how to use the chat.
3.4 Right panel
The right panel shows the results for the part you've selected. The Files tab is the same for every part, and the tabs after it differ by part.
- Planning: Docs, Rulebook, Data, Pending
- Story: Script, Cards, Pending
- Art: Images, Style, Local
- Dev: Engine (Web (HTML5) projects: Preview, Engine)
- Sound: Sound
- QA: Results
- Home: Game, Files
Requests sent by other parts show up as files in the requests folder of the Files tab (4.3).
Use the button in the top-right corner of the panel to collapse or expand it. The right panel is hidden while To-dos, Notes, or Nodes is open.
3.5 Status bar
The status bar at the bottom shows connection status at a glance.
- Left: Each connected AI service shows as on or off, such as "Claude On" or "Claude Off." Click it to open App settings. Next to it, "N parts running" is the number of parts working right now.
- Right: The status of the local engines (image, voice, music, and sound effects) and of the Godot connection (such as "Godot ready" or "Godot not set"). Click the Godot item to open Godot engine in App settings > Project.
- The sun/moon icon at the far right switches between dark and light.
A local engine turns on by itself with the first request and turns off by itself after a while if it isn't used. Click a running engine to turn it off right away.
When something is waiting for approval to run Godot, "N awaiting approval" appears. Click it to open the approval window.
3.6 Home
Home shows at a glance how far your game has come, and lets you pick what to do next. When you open a project, the Home tab at the front of the middle area opens first.
- Current progress: Shows the overall percentage, a progress bar for each part, and the checkpoints (First play, Connected, Filled, Build). The bars show up once Planning makes the lists.
- Game flow: Shows your game's screens in order. Each one shows its mockup and its status (No scene, Has scene, Playable, or Broken). Click a mockup to view it larger.
- Build readiness: Shows Ready to export when the game is ready. Otherwise it shows Not yet with the number of Empty screens, Broken links, and Placeholders.
Use the buttons at the top to hand off work right away.
- Update: Planning updates the core loop, the game flow, and the asset list to match where things are now. Click Approve in the confirmation.
- Play: Runs the game. The first time, the Allow Godot to run window appears (5.4). For a Web (HTML5) project, the Dev part's Preview tab opens.
- Mock up this screen: Pick a screen in Game flow first. This asks Art for two UI mockups of that screen.
Buttons for parts that are off don't appear. While Home is open, the right panel shows the Game and Files tabs. The Game tab has your game's one-line pitch and core loop.
Working in chat
4.1 Sending requests
Use a part's chat to hand work to its agent. Type what you want in the message box, in everyday words, and press Enter. To start a new line, press Shift+Enter.
Your messages appear on the right, and the agent's replies follow on the left.
Attaching files and images
-
Click Attach files above the message box, or drag files onto the chat.
-
Paste an image you copied (such as a screenshot) into the message box with Ctrl+V (Cmd+V on a Mac). A pasted image is attached with a name like "클립보드-date-time.png."
-
Attached files appear as chips above the message box. To remove one, click the × on its chip.
-
Write your request and send it. Attached files are copied into the project and passed to the agent with your message.
- You can attach up to 10 files at a time, and up to 20 per message.
- Each file can be up to 10 MB, and one batch can total up to 100 MB. Folders can't be attached.
- For a very large document, only the first part is read. A "[… 이후 생략: …]" note is added at the end, so the agent knows it read only part of it. Attach the parts you need separately.
- Images you pick in the Art Images tab can also be added with Attach to chat.
When you're stuck
- I'm stuck: Opens chips with sentences that help you change direction. Pick one to fill in the message box, check it, then send it.
- What's next?: Asks the agent right away about progress and what to do next.
Get ideas
Click Get ideas in the Planning or Story chat to open a window for picking idea keywords. Pick the chips you like, or type your own in Your keywords separated by commas. Then click Send. If you can't decide, click Surprise me.
What you can ask agents to do
- A chat with no messages shows Things you can do now chips. Click one to send that sentence right away.
- Each part's agent can edit any document in its own part folder, whatever the format. It can edit Excel, Word, and PowerPoint files, and create PDFs.
- You can also ask in chat to move or rename files, or to unzip zip files. The Art and Dev parts can also resize images.
4.2 Approval cards
When an agent needs your decision before finalizing something, it shows an approval card in the chat. The card's title is "Apply these changes to the project?" It shows a summary and the files involved (New, Edited, Deleted). Open draft lets you look at the draft first.
- To accept it as is, click Approve.
- To turn it down, click Reject, add a reason if you like, then click Send rejection.
- If something needs changing, click Revise. When "Enter what you'd like changed." appears in the chat, type your changes in the message box and send them (up to 600 characters). To back out, click the × on the Typing a revision chip above the message box.
- To close the card without applying it, click Discard.
If the top of the card says "Waiting for your decision — the agent will continue in this turn," the agent continues as soon as you decide. If it says "Your decision will be applied in the next turn," your decision is passed on in the next exchange. Once decided, the card folds into one line. Click it to expand it again.
Work that keeps being revised, such as planning docs, story documents, and Dev's code, is changed directly without a card.
Other cards
The cards below pause that part's work until you decide. They show "Work is paused until you decide."
- "Allow opening this external link?": Appears when an agent wants to open an external link. Check the site, then click Approve or Reject.
- "Allow the agent to use a subagent?": Appears when an agent wants a subagent to take on part of the work. Using subagents greatly increases token usage.
- "The agent is asking": The agent shows options and asks you to choose. Pick one, or type in Other (type your own), then click Send answer. To skip it, click Skip.
- "Run the script the (part) agent wrote on this PC?": Appears the first time an agent runs a calculation script it wrote. Check the script to run, where it reads from (the entire project folder), and where it writes to. The card also says "This script can access the internet."
- Click Allow for this project and GDA won't ask again for this project.
- To take it back, click Stop allowing in Project settings > Advanced.
4.3 Incoming requests and pending decisions
Requests between parts (inbox)
Parts pass work to each other as request files. For example, if the Dev part needs a planning change, it sends a request to the Planning part. To hand work to another part yourself, ask in the chat, for example "Please pass this to the Dev part."
Incoming requests collect as files in the requests/<part> folder of the Files tab (for example, requests/plan). This folder is each part's inbox.
- When a request arrives, GDA hands it to the receiving part automatically. The receiving part's chat shows a line like "Working on a request from (part) · (title)."
- When a request is handled automatically, the agent doesn't make images or sound, run the game or scripts, pass work to another part, or ask for approval. It reports the result and waits for your next instruction. Ask in that part's chat for anything else you need.
- If the receiving part is turned off or not signed in, the request stays as a file. It's handled the next time you use that part.
- Request files are read-only. To drop a request you don't need, right-click the file and choose Delete. It moves to the Trash.
Finalizing the result goes through approval in that part's chat (4.2). With Autonomous mode on, document, code, and table work is finished without asking (4.7).
Pending decisions
The Pending tab of Planning and Story collects the items an agent left for you to decide, as "N decisions to make." The number next to the tab name is how many are left.
- Show details: Expands the item's details and source.
- Discuss: Starts a conversation about that item in the chat right away. The agent lays out the background and the options.
- Remove: Takes the item off the list after you confirm.
4.4 Sessions
A session is the ongoing conversation with the agent in one part's chat. This section explains how to follow its progress, and how to stop it or start fresh.
A part's status appears at the top of the chat and in the sidebar, as "Not started," "Starting agent," "Ready," "Working," and so on. While the agent is working, "In progress" appears next to its name. Below it, you see "Thinking," "Running N actions," or "Writing a reply," with the elapsed time.
Token and context badge
The "Context n% · In N · Out N" badge at the top of the chat shows how many tokens this session has used. It isn't a cost or a charge, and it's separate from Usage in the sidebar.
- "Context": How much of the agent's conversation limit is filled, as of the last reply. If the limit is unknown, it shows a token count instead of a percentage.
- "In" and "Out": The running totals of tokens exchanged in this session.
- When the context percentage gets high, the agent is more likely to forget earlier content. Click New session to start fresh.
- The badge doesn't appear, or shows only some fields, for AI services that don't report these values.
Buttons at the top of the chat
- Force stop: Stops the request that's running now.
- New session: Keeps the memory, clears the chat, and starts fresh from your next request.
- End session: Saves only the recent work and next starting point to the part memory, then ends this session.
- N subagents: Appears only while subagents are working. Click it to see each one's type and a one-line description.
Queue and resending
- Messages you send while the agent is working wait in "N queued" above the message box and are passed on in order. Click Edit to take one back into the message box, or Delete to remove it.
- If a message didn't go through because of an error, click Resend to send it again.
- A message whose delivery isn't certain stays as "Needs checking." Click Resend or Delete.
- If something goes wrong with the session, a one-line cause and a New session button appear. Click New session to start fresh from your next request.
Several parts and quitting
Several parts can work at the same time. Check "N parts running" in the status bar.
When you close the app, you see "Quit GDA? Memory for open conversations will be updated before quitting."
- Click Quit. "Organizing memory…" appears while the agents save their progress notes, then the app closes.
- If you can't wait, click Skip and quit.
On a Mac, closing the window or pressing Cmd+Q both quit the app after the same confirmation. The conversation history stays, so you can pick up where you left off next time.
4.5 To-dos, notes, and nodes
These are screens for you, opened from the Project menu. They open as tabs in the middle.
To-dos
- Click Add to-do, enter a title, due date, checklist, and details, then click Save.
- Items are grouped into To do, Done, and On hold. For the selected item, click Edit, Mark as done, Put on hold, or Mark as to do.
- Right-click an item or click … to also choose Delete.
Notes
Click Add note, enter a title and content, then click Save. Each note has Edit and Delete.
Nodes
When the Dev part checks the elements of your Godot screens (such as buttons) and publishes them, they appear in Nodes. This is for Godot projects only.
-
Pick a node from the list on the left. What it does now shows its current behavior.
-
Write the behavior or change you want in Your request, and anything to keep in mind in Note. For a button, you can also pick a Sound effect. What you write is saved automatically, and "Saved" appears.
-
Send a message to the Dev chat such as "Please apply the requests in the node list."
4.6 Dev log
The dev log is a dated record of your progress. Open it from Project menu > Dev log.
-
Click Create. The Planning part sums up progress, decisions, to-dos, and QA results since the last log in
plan/devlog/<today's date>.md. -
When the log is written, it shows up in the list by date. Click it to open it as a document you can edit.
-
Click Copy to copy the log so you can paste it somewhere else.
If you click Create again on the same day, it adds to that day's log. You can't create a dev log while the Planning part is turned off.
4.7 Autonomous mode
With autonomous mode on, the agent finishes the work without asking for approvals or choices, then reports the results all at once. You turn it on per project, and it starts off.
-
Click Autonomous mode at the right end of the tab bar in the middle.
-
In the window that opens, check what to allow without asking while autonomous mode is on. Items you've already allowed aren't listed.
- Allow running Godot and Allow running scripts: Checked at first. Web (HTML5) projects have no Godot item.
- Allow external links automatically: Off at first. If you turn it on, project content may be sent to outside sites.
- Allow subagents automatically: Off at first. If you turn it on, token usage greatly increases.
-
Click Approve to turn autonomous mode on.
Items you leave unchecked are still asked with cards, as before. Cards approved automatically show "Approved · Autonomous mode auto-approval."
The same setting applies to requests passed on by other parts. Document, code, and table work is finished without approvals. Making images or sound, running the game or scripts, and passing work to another part still aren't done; they're left in the report. Ask in that part's chat if you need them.
To turn autonomous mode off, click the same button again. Turning it off also clears the automatic permission for external links and subagents. You can also turn it on or off and change the items under Autonomous mode in Project settings > Basic (7.2).
Guide to the parts
5.1 Planning
The Planning part turns your idea into a game plan. Tell the Planning chat about the game you want to make. The agent writes concept, game flow, and system documents in the plan/ folder and keeps refining them.
-
In the Planning chat, describe the game you want and answer the agent's questions.
-
Click a document in the Docs tab on the right to read it. You can also edit it yourself (6.3).
-
When the plan has taken shape, click Generate rules at the top of the Rulebook tab. After you confirm, GDA asks the Planning part to build rules from all of your planning docs. Rules are the summary the Dev part works from when building the game.
-
Check the data tables, such as items and levels, in the Data tab. Click a table to open it in the middle, where you can edit it.
- Balance check: The button at the top of the Data tab. It asks the Planning chat to calculate game balance from your current tables, and the results arrive in the chat as a table. The first check may show a card asking permission to run a script (4.2).
- Make a play prototype: The button at the top of the Docs tab. It asks the Dev part for a one-page HTML play prototype based on your current plan. The prototype isn't the game, and it's created in
temp/dev/시안/. When it's ready, open it with Open play prototype at the top of the Dev chat. - Decisions the agent leaves for you collect in the Pending tab (4.3).
5.2 Story
The Story part writes the world, characters, script, and dialogue. Ask the Story chat for the story you want.
-
Script tab: The story's script documents collect here. Click Extract dialogue at the top to ask the Story chat to build a dialogue table (
game/locale/dialogue.csv) from the whole script. The table is updated only when you click this button, so it's normal for it to lag behind after you edit the script. -
Cards tab: Setting cards such as characters and places, plus Timeline & foreshadowing, appear as folded cards. Click a card to unfold and read it, or click Show details to open it in a document tab.
-
Pending tab: Decisions the Story agent left for you collect here (4.3).
5.3 Art
The Art part creates character, background, item, and UI images. To make images, you need either GPT Image (App settings > Images) or the local image engine ready. If neither is ready, a notice and an Open image settings button appear above the Art chat.
-
Ask the Art chat for the images you need (for example, "Please make concept art for the main character").
-
A new image is In use right away. It's saved to the game folder (
game/assets) so the Dev part can use it. If several are made, the first is In use and the rest are on Standby. -
In the By subject view of the Images tab, check the images for each subject and its progress (Concept, Sheet, Frames, Saved). Images in use have a star. To use a different one, click Use on it.
-
Double-click an image to view it larger. Check its path and size, then use Request changes, Use, or Delete below. For Request changes, type what to change and click Send to ask the Art chat right away.
Working with images
- Right-click an image for Request changes, Use, and Delete. Character images also have Make sheet, Animation, and Transparent, and images other than backgrounds have Transparent.
- Click Select to pick several images, then use Select all, Attach to chat, Use, or Delete on all of them at once. This works in both the By subject and Grid views.
- Use the filter at the top to show All, In use, or Standby, and the category chips to narrow by kind.
- Deleted images move to the Trash. For an image in use, its copy in
game/assetsmoves too.
Buttons at the top of the tab
- Check assets: Finds files the game doesn't use, broken links (files the game points to that are missing), leftover placeholders, and more. Check items, then click Delete or Send to Dev to ask for a fix. Click Check again to recheck.
- Make UI mockups: Makes two UI mockups of one key screen from your planning docs. The Dev part uses the mockup in use as a guide for screen layout.
- Extract UI resources: Makes UI resources shared across screens (buttons, window frames, icons, and so on) from the UI mockup in use.
Pixel art games
If you set the art style to pixel art, GDA makes a pixel art game.
- Ask the Art chat something like "Please set the art style to pixel art." It's added to the style prompt.
- For effects such as explosions, fire, magic, or hits, ask something like "Please make an explosion effect." The Art part makes the pixel effect right away.
A pixel art game's base resolution is 960×540 (540×960 for portrait games). Backgrounds and UI are made to fit this size.
Style and the local image engine (optional)
In the Engine card of the Style tab, choose the Generator (OpenAI or Local engine) and the model, then click Save. The Style prompt below describes the art style used for every image and is read-only. To change it, ask the Art chat.
The local image engine is an optional feature that makes images with your PC's graphics card (your Mac's memory on a Mac).
- Download model files under Local images in App settings > Images (7.1).
- In the Style tab, set Generator to Local engine and click Save. The local engine turns on too, and the Local tab opens in Art. You can also turn it on or off under Local image engine in Project settings > Advanced.
- In the Local tab, choose detailed settings such as the model, VAE, steps, and LoRAs.
5.4 Dev
The Dev part builds scenes and code in a Godot project to make a game that actually runs. First connect Godot under Godot engine in App settings > Project (7.1).
-
Ask the Dev chat for the features you want. The Dev part works from the Planning rules and the images Art saved.
-
Click Run game in the Engine tab on the right to run the game. To run just one scene, pick a .tscn file under Scene and click Run. Results and logs stay in Run history.
-
The first time you run the game, the Allow Godot to run window appears. Check the details and click Allow for this project. Once allowed, GDA won't ask again for this project. The permission covers game runs and playtests for both the Dev and QA parts.
- Godot runs with your account's permissions, so it can use your files and the internet freely.
- If you can't decide now, click Decide later. You can reopen the window from Approvals N in the top bar or "N awaiting approval" in the status bar. To refuse, click Don't allow.
- To take the permission back, click Stop allowing in the Engine tab.
- Check assets in the Engine tab is the same check as in the Art Images tab (5.3).
Screen size
By default, the Dev part makes the game screen stretch to fit the window. The base resolution is 1920×1080 (1080×1920 for portrait games). Pixel art games use half that, 960×540 (540×960 for portrait games). If you need something different, ask the Dev chat.
Exporting the game
To turn your finished game into a program people can run, ask the Dev chat, for example "Please export it for Windows." You can export a Windows app, Web (HTML5), Android (APK), or a macOS app.
-
When the Dev agent starts the export, the approval window asks "Allow Godot to export the game (target)?" If you haven't allowed Godot for this project yet, click Allow for this project.
-
When the export finishes, the agent tells you in the chat where the result is. Results go into the project's
buildfolder.
Exporting needs Godot's export templates. If they're missing, the Dev agent explains how to get them.
A macOS app can be exported only while GDA is running on a Mac.
- The result is a zip file in the
build/macosfolder. Unzip it and open the .app to check it. - It isn't signed or notarized, so it's for testing on your own Mac. To pass it to another Mac or distribute it, you need Apple signing and notarization.
- If you ask for a macOS app on Windows, the Dev agent passes on "Mac games can't be made on Windows. Run GDA on a Mac, then export."
- A macOS app also needs the ETC2 ASTC texture setting in
project.godot. If it's missing, the Dev agent adds the line and exports again.
Web (HTML5) projects
Projects made for the Web platform are built with HTML, CSS, and JavaScript without an engine.
- The game appears right in the Dev part's Preview tab on the right. It refreshes by itself when the Dev part finishes its work, and you can also click Refresh.
- Click Open in new window to view it in a browser window.
- While you're viewing a play prototype, "Viewing the play prototype" appears. To go back to the game, click Switch to game.
- If there are no game files yet, you see "No game files yet."
- Web preview in the Engine tab has Open in browser and Stop preview.
5.5 Sound
The Sound part creates music, sound effects, and voices. It uses local models that run on your PC, so set them up first.
-
Turn on Sound in Project settings > Parts (7.2).
-
In App settings > Sound, click Download for the model files you need (7.1). With less than 12 GB of VRAM (16 GB of Mac memory on a Mac), sound generation may be slow or fail.
-
Ask the Sound chat for the sounds you need (for example, "Please make battle music").
-
In the Sound tab on the right, browse what was made under Music, Sound effects, and Voice, and play it to check.
- Right-click a card, or pick several with Select, to Save to game (saves to
game/audioin the game folder), Delete, or Request changes. - Click Browse at the top to connect a sound folder on your PC so its files show up too. Refresh checks the folder again.
- On a voice reference clip, use Make lines with this voice to ask for lines in the same voice.
- When you make a voice from a recording, use it only if it's your own voice or you have the speaker's permission.
The first request takes a while because the model has to load. Check the engines' status under Voice engine, Music engine, and Sound effects engine in the status bar.
5.6 QA (playtesting)
The QA part runs the game the Dev part made, checks it, and tells the Dev part when it finds problems. It can be turned on only in projects where Dev is on and the platform is PC or Mobile (Godot).
-
Turn on QA in Project settings > Parts.
-
Tell the QA chat what you want checked (for example, "Please check that pressing the start button on the title screen starts the game").
-
QA writes the test steps and runs the game. When you see "Automated test in progress. Don't touch the open game window.", leave the game window alone until the test is over.
-
Click a run in the Results tab on the right to see screenshots, Step results, and the Console log. The last 10 runs are kept.
QA controls the game with key presses and waits. Mouse clicks aren't played back yet.
When QA finds a problem, it sends a bug report to the Dev part from the QA chat. After Dev fixes it, ask QA to check again. The permission to run the game is shared with the Dev part (5.4).
Working with documents
Every document and file the agents make is saved in the project folder on your PC. Find and open them in the Files tab on the right, and read and edit them in document tabs in the middle.
6.1 File tree
The Files tab in the right panel shows the whole project folder. It has a folder for each part (plan, scenario, game, and so on) and the requests folder, where incoming requests collect.
- Type a name in Search files to narrow the list.
- Click a file to open it in a document tab in the middle.
- Right-click a file for Rename, Copy, and Delete. You can also drag it into another folder to move it.
- Hold Ctrl (Cmd on a Mac) while clicking to pick several items, or hold Shift to pick a range.
- Click the refresh button at the top of the panel (Refresh files) to reload the list.
Some folders and files managed by GDA can't be changed. Their menu shows "This item can't be changed."
Trash
Deleted files aren't erased right away. They stay in Trash (N) at the bottom of the list for 7 days.
- Click Trash (N) to expand it and see the deleted items and when they were deleted.
- To bring one back, click Restore on it.
- To empty the trash, click Empty, then click Delete permanently in the confirmation. Emptied items can't be restored.
6.2 Preview
When you open a document (.md), headings, lists, and tables are shown formatted. The top of the document tab shows the file name, path, line count, and save status.
- Clicking a file link in the chat opens the same kind of document tab.
- Data files (.csv) open as tables. After editing cells, click Add row or Save N changes to save. Protected reference tables are view-only.
project_memory.mdopens in the Project memory screen, anddecision_log.mdopens in the Decision log screen.- Clicking an image file shows it larger in an image window. Art images are managed in the Art Images tab.
6.3 Editing
-
Click Edit in the top-right corner of the document tab. An editing area for the source text opens at the bottom, and the top shows the result as you type.
-
After making changes, click Save. To throw away your changes, click Cancel.
If an agent changes the same file while you're editing, GDA doesn't overwrite it with your version. Instead, it shows Your draft and Current file side by side. Compare them and copy over what you need, or click Load the latest version. To close the comparison, click Close comparison.
- If the file is changed somewhere else while you're editing, you see "This file was changed somewhere else." Click Reload to read the latest version.
- If you try to close the tab without saving, a confirmation appears.
6.4 Incoming request files (read-only)
Request files in the requests folder were sent by other parts, so you can only read them. When you open one, you see "Request files are read-only."
GDA hands requests to the receiving part automatically, so there's nothing you need to do.
- When a request has been handled, you can click Mark as done at the top of the file.
- To cancel a request you don't need, right-click the file and click Delete. It moves to the Trash.
- Request files can't be renamed, copied, or moved.
Settings
There are two kinds of settings. App settings apply to GDA as a whole on this PC, and Project settings are set separately for each project.
7.1 App settings
Click App settings at the bottom of the sidebar to open them full screen. Pick AI services, Images, Sound, Project, Display, or Account from the menu on the left. Click Back to app when you're done.
Changes are saved right away, and the save status (such as "Saving" or "Saved") appears in the top-right corner of the page. Help in the menu opens this guide.
AI services
This is where you connect the AI services (Claude, ChatGPT, Grok) used as agents. Under Agent connections, you can connect several at once.
-
Check the box for each service you want to use. If you see "Not installed. Click “Install”.", click Install.
-
Choose a sign-in method.
- Subscription: Click Sign in, then sign in in the window that opens.
- API key: Paste your key and press Enter.
-
Mark the service you'll use most as Default agent.
-
Under Default model, choose a Model and Reasoning depth for each service. If you're not sure, click Model guide to compare.
- A service that's ready shows Connected.
- Claude's models are Fable 5.2, Opus 5.5, Sonnet 5.5, and Haiku 5.5. Model guide compares what each model is good for, its usage, and the recommended plan. Grok has no model guide.
- A signed-in service shows Sign out, which you use to switch to another account.
- Update reinstalls the tool that connects to that service at the new version.
- If the model list says "After your first message," send one chat message with that service, then choose.
- On the ChatGPT card, turn on Allow ChatGPT without internet blocking only if ChatGPT sessions won't open on this PC. When it's on, ChatGPT can send project content to the internet.
Images
The Images page has two groups: GPT Image and Local images.
GPT Image
Decide whether the Art part uses GPT Image. Set Use GPT Image to On and choose a Sign-in method.
- Subscription (ChatGPT sign-in): Uses the ChatGPT account you signed in to under AI services. The Request model isn't the model that draws. It's a text model that passes your prompt to the image tool, and the default uses the least.
- API key: Uses your OpenAI API key. Under Image model, choose Sunburst (quality) or Flare (speed).
Local images
These settings are needed to make images with your PC's graphics card (unified memory on a Mac). If you don't use this, you can leave it alone.
-
Under GPU processing, leave Runs with set to Automatic in most cases. Automatic uses CUDA if you have an NVIDIA graphics card, and Vulkan if you don't. On a Mac, GDA uses Metal and there's nothing to choose.
-
In the Supported models table, choose a model family and click Download on it to get all the files it needs. Compare VRAM needed with Your GPU (Your Mac's memory on a Mac) to pick a family that fits your PC.
Each family downloads a little differently.
- Krea2: GDA downloads the BF16 main model if your GPU has 24 GB or more, and the FP8 main model otherwise.
- Z-Image: Pick one main model and one text encoder with the circle at the start of each row, then click Download. Q8_0 is picked at first. With a 12 GB GPU, the Q6_K main model is picked; with 8 GB, the Q4_K main model and the Q4_K_M encoder.
- SDXL: Download on the family gets SDXL only. Get Animagine XL 4.0 separately with Download on its row.
- You can get the other main models from Link ↗ next to the file name.
- To delete a downloaded file, click Remove on its row. To download it again, remove it first, then click Download. Open folder opens the model folder.
The table is in order of quality. Among the models that fit your GPU, pick one near the top.
| Model | Features | GPU needed |
|---|---|---|
| Z-Image | For main work on characters, backgrounds, and images with text. 1024×1024. Fast with 8 steps, good at drawing text, and follows sentence-style descriptions. No negative prompts. 3.9–12.3 GB main model (one of Q4_K, Q6_K, Q8_0, or BF16) + 2.5–4.3 GB text encoder + 0.3 GB VAE. | 8 GB (Q4) · 16 GB recommended (Q8) |
| Illustrious XL v2.0 | An SDXL-based model for anime characters and illustrations. 1024×1024, 6.9 GB file. Uses the same settings (steps, CFG, negative prompts) as SDXL. | 12 GB |
| SDXL | For main work on character and background illustrations. 1024×1024, 6.9 GB file. Stable quality and composition, 2–3 times slower than SD 1.5. Uses negative prompts. | 12 GB |
| Animagine XL 4.0 | An SDXL-based model tuned for anime-style characters and backgrounds. 1024×1024, 6.9 GB file. Downloaded with Download on its row in the SDXL family table. Uses the same settings as SDXL. | 12 GB |
| Krea2 | For photo-like images, key visuals, and concept art. 1024×1024, 26 GB main model (13 GB with FP8) + 8 GB text encoder. Creates images in 8 steps, so the total time is close to SDXL, and it follows long descriptions. No negative prompts and very few LoRAs. FP8 doesn't work on a Mac, so a Mac needs 32 GB of memory or more. Companies with annual revenue of US$1 million or more need a separate agreement with Krea before commercial use (View license ↗ in the family header). | 24 GB (12 GB with FP8) |
| SD 1.5 | For quick drafts, pixel art, and props on a small graphics card. 512×768, 4.3 GB file. Fast, but weak at hands and text, doesn't follow long descriptions, and its quality is low for final work. Has the most community LoRAs. | 8 GB |
The badge at the right end of each family's header (Fits your PC, Tight on memory, or Not enough memory) compares Your GPU with the VRAM the family needs. On a Mac, GDA compares 75% of Your Mac's memory with the VRAM needed, and the badge reads Fits your Mac. In Mac memory, the table's GPU needed becomes 16 GB for SDXL, 32 GB or more for Krea2, and 11 GB (Q4) or 22 GB (Q8) for Z-Image.
After downloading a model, set Generator to Local engine in the Art Style tab to use it in the Art part (5.3).
Recommended LoRAs and VAEs — download and add them yourself
When the main model alone doesn't give you the art style or quality you want, add a LoRA or a VAE. A LoRA changes the art style of the images, and a VAE sharpens their colors and fine details. The Recommended LoRAs and Recommended VAEs tables at the bottom of the Images page list recommendations for each model family.
GDA doesn't download them for you. You download them from the link and put them in the model folder, and GDA picks them up.
-
Under Model family, choose the main model family you use. A LoRA or VAE only works with a main model of the same family.
- If you turn on an SDXL LoRA with an SD 1.5 main model, the result breaks or generation fails.
- Illustrious and Animagine share the SDXL architecture, so SDXL LoRAs load, but LoRAs made for that model give better results.
- Krea2 and Z-Image have very few LoRAs.
-
Click Open download page on an item to open its model page (civitai or Hugging Face) in your browser. Download the file there. Some sites may ask you to sign in. Find more ↗ opens civitai search results for that family.
-
Put the downloaded file in the model folder. Open folder in the table's title row opens the right folder (
lorasfor LoRAs,vaefor VAEs). You don't need to rename the file. -
A moment later, the table marks the file Installed. GDA then looks up its trigger words and recommended settings (steps, CFG) on civitai and saves them next to the file.
- When you pick that file in a LoRA slot on the Art Local tab, the trigger words field is filled in automatically. It's filled only when the field is empty, and anything you typed is kept. For a file that isn't on civitai, copy the trigger words from its model page.
- You turn a LoRA on in one of the three LoRA slots on the Art Local tab, and pick a VAE under VAE in the Model card on the same tab (5.3). When at least one LoRA is on, the trigger words go into the image prompt instead of the style prompt.
- Previews show only images rated for all ages.
Licenses
- Commercial use allowed, No commercial use, and Credit required under an item are the license terms the author set on civitai.
- If it says "Check the license on the download page.", GDA doesn't know the terms for that item.
- If you plan to sell your game, use only items that allow commercial use. If credit is required, name the author in your game's credits. Check the model page for the exact terms.
Sound
This is where you download the local model files (voice, music, sound effects) the Sound part uses. Sound needs every file in the table.
- Click Download on a group to get the files it needs at once.
- The Purpose column shows what each file is used for (voice design, voice cloning, background music, or sound effects).
- To delete a downloaded file, click Remove on its row. To download it again, remove it first, then click Download.
- With less than 12 GB of VRAM, sound generation may be slow or fail.
Project
On the Project page, you set where new projects are saved and connect the Godot engine.
Default project folder
This is the default save location when you create a new project. Change it with Browse, or clear it with Clear.
Godot engine
Click Browse to select your Godot engine folder (on a Mac, choose the Godot app). On Windows, click Disconnect to remove the connection. If you don't have Godot, click Download Godot (opens in your browser) ↗ and get it from the official website.
Display
- Language: Choose the language for menus, buttons, and messages (한국어 or English). At first, GDA starts in Korean if your PC's language is Korean, and in English otherwise.
- Appearance: Choose Follow system, Dark, or Light.
Account
Check and manage the GDA account this PC is connected to. Manage account shows Signed-in account, PC name, Plan, and Phone link. Plan shows your current plan, such as "Free · 1 PC" or "Plus · 2 PCs · Mobile app."
The buttons under Manage connection are:
- Add phone: Connects the mobile app to this PC (8.2).
- Reset connection: Use this if you lost your phone. Every connected phone will have to scan the QR code again.
- Redeem code: Enter a code you received (GDA-XXXX-XXXX-XXXX) to add it to the account you're signed in with. Available only after you sign in.
- Sign out: Removes this PC from your account. You can't use GDA on this PC until you sign in again.
Delete account is kept separately at the bottom (8.3). Plus subscriptions are managed in the mobile app.
7.2 Project settings
Open them from Project menu > Project settings, or from the … next to a project in the sidebar > Project settings. They have Basic, Parts, and Advanced tabs, and changes are saved right away.
Basic
- Project info: Rename the project. Renaming doesn't change the project folder. Open folder opens the project folder.
- Target platforms: Choose PC only, Mobile only, PC + Mobile, or Web (HTML5). Switching between Web and PC or Mobile asks you to confirm.
- Game languages: The languages your game will include. When you ask the Dev part to localize the game, it translates into the languages in this list. Korean is the original and can't be removed.
- Autonomous mode: Turns on or off the mode that keeps work going without approvals, and sets what to allow in advance (4.7).
- References: Add document, image, and video files by dropping them in.
Parts
For each part, choose whether it's on, plus its Service, Model, and Reasoning depth. Leave them set to "Use App settings" to follow App settings.
- Click a part's button to switch it between On and Off. A part that has started a conversation can't be turned off.
- Changing a part's service starts a new conversation and keeps the old one. A part with a request in progress can't be changed.
- QA can be turned on only when Dev is on and the platform is PC or Mobile.
Advanced
- Godot scripting language: The language used for code in Godot (GDScript or .NET (C#)). Usually leave it as it is. Web (HTML5) projects don't have it.
- Git remote: Connects the project to a remote repository such as GitHub. Use it only if you need it. Enter the repository URL, then go through Test connection and Save connection. Saving or removing the connection doesn't change your files or commits.
- Local image engine: Set Use the engine to On to add the Local tab to Art. You choose the model in that tab.
- Scripts allowed: Appears after you've allowed an agent to run scripts. Click Stop allowing and GDA asks again the next time one runs.
Your account and PCs
This chapter explains what to do when you switch PCs, connect the mobile app, or delete your account. A GDA account can connect 1 PC on Free and 2 PCs on Plus. Plus subscriptions are managed in the mobile app.
8.1 Switching PCs
If you sign in on a new PC and your account has no free PC slots, you can disconnect an old PC right from the new one. You don't need the mobile app.
-
On the new PC's sign-in screen, sign in with Sign in with Google or Sign in with Apple.
-
When the No free PC slots screen appears, pick one PC from the PC to disconnect list. Each PC shows its name and when it was last used.
-
Click Disconnect selected PC, then click Disconnect and continue in the confirmation.
-
The PC you're using takes its place, and GDA opens.
- GDA can't be used on the disconnected PC until it signs in again.
- If Sign in with the mobile app (QR code) says there are no free PC slots, click Change PC and follow the same steps.
- To remove the current PC from your account yourself, use Sign out in App settings > Account.
8.2 Connecting the mobile app
With the mobile app connected, you can keep chatting with parts, answer approval cards, and check progress and images from your phone while you're out. Editing files, changing settings, and running Godot happen on your PC only. Connecting the mobile app needs a Plus subscription.
-
Install the GDA (Game Dev Assistant) app on your phone and sign in with the same account as your PC.
-
On your PC, go to App settings > Account and click Add phone. A window with a QR code opens.
-
In the mobile app, start connecting a PC and scan the QR code on your PC.
-
When you approve on your phone, your PC shows the phone's name and a Confirmation number. If your phone shows the same number, click Connect. If it isn't your phone or the number is different, click Cancel and start over with New QR code.
-
When you see "Phone connected.", you're done. Check the status under Phone link in App settings > Account.
- The picture shows connecting from Sign in with the mobile app on the sign-in screen. Add phone shows the same confirmation number screen.
- On a Free account, you see "You need Plus to use GDA on your PC from your phone or to connect a second PC."
- If the mobile app says "Reconnect needed," scan the Add phone QR code again.
- If you lost your phone, click Reset connection to disconnect every phone.
8.3 Deleting your account
Deleting your account removes your GDA account and its PC connections, and can't be undone. Projects on your PC are not deleted.
-
Click Delete account at the bottom of App settings > Account.
-
In the "Delete your account?" confirmation, read which account will be deleted and the notes.
-
Click Delete account, and your browser opens to confirm it's you. Sign in once more with this PC's account. On a PC that signed in with a QR code, click Delete with Google or Delete with Apple, whichever matches your account.
-
When sign-in is done, the deletion goes ahead, and the sign-in screen shows "Your account has been deleted." Sign in again to start with a new account.
Please also read the notes in the confirmation:
- To prevent misuse and finish the deletion safely, a record is kept for one year. If you sign up again with the same account within a year, your Plus subscription and redeemed codes apply again.
- If you subscribe through a store, deleting your account doesn't cancel store billing. Cancel your subscription in the mobile app or the store.
- If work is running or queued, you see "After deletion, queued work won't start."
Signing in with a different account doesn't delete anything. If there's no reply from the server and the result is unclear, click Check again.
Updates and troubleshooting
9.1 Automatic updates
GDA checks for a new version when it starts. If there is one, the "An update is available" window shows the version and what changed, one item per line.
- Click Update. A "Downloading (N%)" progress bar appears. The download keeps going even if you close the window.
- When the download finishes, GDA restarts by itself and installs the new version. If you have unsaved changes or work in progress, a confirmation appears first. To stop the work and go ahead, click Stop and restart.
If the download finished but you put off restarting, you see "Update (version) is ready. Restart GDA to install it." along with Restart and Later.
- Click Later to hide the window for now. The update notice shows again the next time you start the app.
- If you see "The update couldn't be installed. Click “Restart” to try again.", click Restart.
- The update window closes only with the X or Later.
- On a Mac, "The update installs only after you move GDA to the Applications folder and open it again." means GDA is running straight from the dmg. Move GDA to the Applications folder and open it again.
9.2 Notices
GDA shows things you should know as notices at the top center of the screen. New notices stack at the bottom, up to four at a time, and the same notice appears only once.
- Close a notice with the × on its right.
- "The agent rules were updated. Each part reads them again with its next message." and "The shared rules were updated." mean the working rules the agents follow changed with an app update. There's nothing you need to do.
9.3 AI service update notice
After a GDA update, the tools that connect to an AI service sometimes need to be reinstalled at a new version. When that happens, a window says "AI service updates are available. Update them in App settings."
- Click App settings in the window. App settings > AI services opens.
- If the service's card says "The AI service isn't the version GDA was tested with (…). Click “Install” to reinstall it.", click Install.
You can't send chats with that service until it's reinstalled. If the card shows "Sign-in required" after installing, click Sign in to sign in again. To do it later, click Close.
9.4 When GDA can't reach the server
When GDA starts, it connects to the account server to check your account. If you're offline, you see "Can't reach the server. Check your internet connection and try again."
- Check your PC's internet connection.
- Click Try again. Once connected, GDA opens right away.
If it still can't connect, you see "Checked again, but the server is still unreachable. Check your internet connection." To stop for now, click Quit GDA.
If the account server connection drops while you're using GDA, the screen isn't blocked. "Reconnecting app" in the top bar is about GDA's internal connection, not the account server.
9.5 FAQ
Why you need an AI service account
To use GDA, you need an AI service account such as Claude or ChatGPT.
GDA runs each part's agent with your own AI service account. The agents use that account's usage limits as they work, and you can check how much you've used under Usage in the sidebar. Connect your account in App settings > AI services (7.1).
Only Godot is supported
Only the Godot engine is supported for development at the moment; more engines are planned.
PC and Mobile games are made with Godot. Projects that use the Web (HTML5) platform are built with HTML, CSS, and JavaScript without an engine. Download Godot from the official website and connect it under Godot engine in App settings > Project.
When your AI service sign-in has expired
If the chat says "(service) needs you to sign in. Sign in under App settings > AI services, then resend the message.", you've been signed out.
- In App settings > AI services, click Sign in on that service's card and sign in again.
- Go back to the chat and send your message again.
To switch to another account, click Sign out, then Sign in. If the sidebar's usage says "Usage appears after you send a message in the chat.", send one chat message with that service.
When a project won't open
Follow the message shown in the sidebar.
- "Folder not found": The project folder was moved or renamed. Move it back to its original location, then open it again.
- "Can't open the folder right now": You don't have permission to read the folder, or an external or network drive isn't connected. Check the drive connection and the folder's permissions. On a Mac, allow GDA in System Settings › Privacy & Security › Files and Folders.
- "Projects made with GDA 0.11 or earlier can't be opened. Create a new project.": The project was made with an old version. Create a new project.
You can bring back a project you removed with Remove from list by clicking Open project in the sidebar and choosing its folder.