godot-ai

# Godot AI Godot AI подключает MCP-клиенты, такие как Claude Code, Claude Desktop, Codex и Hermes Agent, к работающему редактору Godot. Он предоставляет 46 инструментов и более 120 операций, позволяющих ИИ-ассистентам создавать сцены, редактировать узлы и скрипты, подключать сигналы, а также настраивать интерфейс, материалы, анимацию, частицы, камеры и окружение. ## Быстрый старт ### Требования - Godot 4.7+ (в линейке 4.x) для Godot AI v4 - uv (предоставляет uvx для Python-сервера) - MCP-клиент ### Установка 1. **Новый проект:** Загрузите опубликованную версию из GitHub Releases и установите аддон в `your-project/addons/godot_ai/` с `plugin.cfg` внутри этой директории. 2. **Существующая установка:** Используйте кнопку Update в доке Godot AI. Финальный подписанный релиз v3 поддерживает миграцию в один клик до v4. ### Включение плагина В Godot: **Project → Project Settings → Plugins → Godot AI**. Плагин запускает MCP-сервер и показывает статус подключения в доке Godot AI. ### Подключение MCP-клиента В доке нажмите **Configure** рядом с вашим клиентом или **Configure all** для всех обнаруженных клиентов. Поддерживаемые клиенты: Claude Code, Claude Desktop, Codex, Antigravity, Hermes Agent, DeepSeek Harness, Cursor и VS Code. ### Попробуйте Примеры запросов: - "Покажи текущую иерархию сцен." - "Создай Camera3D с именем MainCamera под /Main." - "Найди в проекте файлы PackedScene в ui/." - "Запусти набор тестов сцены." - "Создай воксельную блочную игру с игроком, блоками для размещения и разрушения и слотами сохранения." ## Как это работает ```text MCP-клиент → godot-ai attach (stdio) → Python-сервер (аутентифицированный HTTP, порт 8000) → плагин редактора Godot (аутентифицированный WebSocket, порт 9500) ``` Оба локальных перехода используют независимые вращающиеся ключи; ни один не переключается на неаутентифицированный доступ. WebSocket редактора остается только на loopback. Для агентов в контейнерах или на других машинах запускайте мост на машине с редактором через SSH. ## Телеметрия и конфиденциальность Телеметрия использования записывает UUID установки, событие, результат, длительность, платформу и версию — не код, содержимое сцен или имена проектов/файлов. Слаги директорий проекта хешируются перед передачей. Отключить можно с помощью `GODOT_AI_DISABLE_TELEMETRY=true` или `DISABLE_TELEMETRY=true`. ## Документация и поддержка ### Проблема Bazzite / Fedora Atomic Desktop На Bazzite и других Fedora Atomic Desktop `/home` обычно является символической ссылкой на `/var/home`. Godot AI 4.0.2 и более ранние версии отклоняют все пути директорий возможностей, проходящие через ссылку. Следующий релиз следует за ссылкой, если она принадлежит root и находится в директории, принадлежащей root, которую другие учетные записи не могут записывать. Для 4.0.2 или более ранних версий установите `GODOT_AI_CAPABILITY_DIR` на канонический путь и запустите и Godot, и ваш MCP-клиент из этого терминала. ### Справочник и поддержка - Инструменты, операции и ресурсы - Написание и запуск тестов для вашей игры - Детали конфигурации клиента - Обновление с v3 и восстановление прерванных миграций - Журнал изменений - Вклад в разработку и настройка окружения - Discord для вопросов и демонстраций; GitHub Issues для сообщений об ошибках **Лицензия:** MIT