gda — Godot для ИИ-агентов
gda
CLI, скилл и MCP-сервер gda: агент собирает проект на Godot, проверяет сцены и управляет запущенной игрой.
- 57 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Команды создают и меняют сцены, скрипты и настройки проекта, а экспорт пишет файлы сборки.
- Операции запускают код самого проекта: автозагрузки, скрипты сцен и игру целиком.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/gdaОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Команды создают и меняют сцены, скрипты и настройки проекта, а экспорт пишет файлы сборки.
- Операции запускают код самого проекта: автозагрузки, скрипты сцен и игру целиком.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
gda — консольная программа на Python, которая запускает Godot без редактора и отдает результат в JSON. У нее два режима. В безголовом агент создает сцены, узлы, скрипты, ресурсы и шейдеры, компилирует код, проверяет зависимости, запускает сцену на короткую проверку и экспортирует сборку. Живой режим работает через демон `gda-daemon`: он запускает игру и дает читать дерево узлов, имитировать ввод, снимать кадры, собирать логи и ошибки, замерять производительность. Те же операции доступны тремя путями: прямой командой `gda`, встроенным скиллом и MCP-сервером `gda-mcp`.
Для кого. Разработчикам игр на Godot 4.6 и новее, которые отдают агенту сборку сцен и проверку проекта в CI.
Подходит, если
- Сцену с несколькими узлами надо собрать и проверить без открытия редактора.
- В CI проект экспортируется, а скрипты проходят компиляцию с машинно читаемым отчетом.
- Агент должен увидеть дерево узлов запущенной игры и ее ошибки.
- Нажатия клавиш имитируются, а кадр сохраняется для проверки поведения.
Не подходит, если
- Проект на Godot старше 4.6: инструмент рассчитан на 4.6 и новее.
- Игра написана на другом движке, например Unity.
- Проект получен из недоверенного источника: gda запускает автозагрузки и скрипты самого проекта.
Пример запроса к агенту
Создай сцену `scenes/main.tscn` с корнем Node2D и спрайтом Hero, проверь ее через `gda scene validate` и покажи итог.Ограничения
Нужны Python 3.13 или новее и бинарник Godot 4.6 или новее, путь к нему задают в `GDA_GODOT` или флагом `--godot`. Проект считается доверенным: автозагрузки и `_init` сцен выполняются при многих операциях, а `script run` запускает скрипт целиком. Снимок кадра работает только в оконной сессии, демон запускают с `--windowed`. Скилл из репозитория совпадает с веткой `main`, а версию под установленный `gda` печатает `gda skill`.
Как отключить. Удалите пакет командой `uv tool uninstall gda`, а скилл — папку `gda` из каталога скиллов агента. Запись `gda-mcp` уберите из конфигурации клиента, работающий демон остановит `gda daemon stop`.
Частые вопросы
Как поставить gda для Claude Code?
Установите программу командой `uv tool install gda`, затем скилл командой `npx skills add aigengame/godot-agent --skill gda -g`. Скилл управляет самой программой, поэтому ставят оба.
Как подключить MCP-сервер gda?
Выполните `claude mcp add --scope user gda-mcp -- uvx --from "gda[mcp]" gda-mcp`. Проект задают переменной `GDA_PROJECT`, движок переменной `GDA_GODOT`.
Что выбрать: CLI, скилл или MCP?
Все три пути дают одни и те же операции. CLI подходит оболочке и CI, скилл экономит токены у агентов с поддержкой скиллов, MCP нужен клиентам с обнаружением инструментов. Сравнение лежит на сайте проекта.
Нужен ли плагин для редактора Godot?
Нет. Безголовые операции идут одноразовыми процессами без плагина и демона. Для живого режима демон сам подставляет в игру временную обвязку, которую экспорт убирает.
Как проверить, что Godot найден?
Выполните `gda info --json`. Команда печатает версию движка, в примере README это `4.6.3-stable`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыАддон для .NET-сборки Godot дает агенту править редактор: сцены, узлы, скрипты, скриншоты вьюпорта и запросы на языке RQL
MCP-сервер и плагин для Godot 4.4 и новее: агент правит сцены и скрипты в редакторе, запускает игру и читает ошибки
GodotMaker ведет идею игры до рабочего 2D-прототипа на Godot: проектирует, пишет код, тесты и проверяет результат агентами.
Аддон и MCP-сервер для Godot: агент видит дерево сцены, ошибки и скриншоты запущенной игры и проверяет правки в редакторе
MCP-сервер для движка Godot: запуск редактора, выполнение проектов и правка сцен прямо из агента
MCP-сервер для Godot 4 внутри самого редактора: агент правит сцены, узлы и скрипты, запускает проект и читает отладчик, без Node.js
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| gda — Godot для ИИ-агентов (эта карточка) | да | 57 | ||
| Godot MCP | нет | не нужна | 6 542 | запускает редактор и правит сцены через MCP; gda работает без редактора и добавляет CLI, скилл и живой режим с демоном |
| Godot AI | да | API-ключ | 3 427 | подключает агента к работающему редактору; gda обходится без редактора и плагина |
Коротко о README
Установка идет через PyPI, быстрый старт без проекта и со сценой, три способа подключить агента и справочник команд. Отдельные раскрывающиеся блоки объясняют, какой код проекта выполняется, и формат структурированного вывода с кодами выхода.