Конспект: Unreal Engine 5 + Claude Code: Создание игры с нуля через AI-агентов — VibCoderZ - VibeCoderz

Загрузка...

🎯 О чём этот конспект: Пошаговое руководство по интеграции Claude Code в рабочий процесс Unreal Engine 5.7. Автор тестирует связку из двух бесплатных плагинов и MCP-серверов, которые позволяют ИИ-агенту видеть вьюпорт, редактировать блюпринты, писать Python-скрипты и управлять объектами на сцене в реальном времени.

👤 Кому будет полезно: Вайбкодерам, инди-разработчикам игр и тем, кто хочет автоматизировать рутинную работу в UE5 (расстановка ассетов, логика блюпринтов, настройка материалов) без глубокого знания C++ или Python.

✨ Что получите: Готовую среду разработки, где Claude Code выступает в роли технического со-дизайнера, способного создать прототип бесконечного раннера с UI, препятствиями и системой сбора предметов за один сеанс.

1. Настройка окружения и установка плагинов

Контекст: Для того чтобы Claude Code мог взаимодействовать с Unreal Engine, недостаточно просто открыть терминал. Требуется мост (MCP — Model Context Protocol), который свяжет консольный агент с API движка. Автор выделил два ключевых плагина, которые работают в связке и закрывают все потребности: от визуального контроля до изменения логики.

Тайминг: [00:54], [01:18], [02:25]

Выгода: Экономия времени на поиске рабочих решений (автор тестировал платные и нерабочие варианты месяц) и получение бесплатного инструментария для управления UE5 через промпты.

Как применить:

Шаг 1: Подготовка проекта — Откройте проект в Unreal Engine 5.7 и запустите Claude Code в корневой папке этого проекта.
Шаг 2: Установка Unreal Claude — Этот плагин отвечает за скриншоты вьюпорта и перемещение объектов.
Шаг 3: Установка Vibe UE — Open-source плагин для редактирования блюпринтов и запуска Python-скриптов.
Шаг 4: Настройка API — Зарегистрируйтесь на vibe.com, получите бесплатный API-ключ и вставьте его в настройки плагина внутри Unreal Engine (раздел Vibe UE).
Шаг 5: Подключение MCP — Попросите Claude установить зависимости и подключить MCP-серверы:

# Промпт для Claude Code
Install all dependencies for Unreal Claude and Vibe UE. Setup MCP connections to link with the Unreal Engine scene.

Результат: Claude подтверждает соединение с MCP, может делать скриншоты вашего вьюпорта и имеет доступ к файловой структуре проекта.

2. Использование Git как системы безопасности для AI-кодинга

Контекст: AI-агенты могут совершать ошибки или создавать «спагетти-код». Без системы контроля версий одно неверное действие агента может испортить логику всего проекта. Автор настаивает на использовании Git даже для новичков, чтобы иметь возможность мгновенного отката (revert).

Тайминг: [02:50]

Выгода: Безопасность разработки. Вы можете экспериментировать с любыми сложными промптами, зная, что всегда вернетесь к стабильной версии.

Как применить:

Шаг 1: Инициализация — Если Git не установлен, попросите Claude сделать это.
Шаг 2: Фиксация этапов — После каждого успешного шага (например, «создал пол», «настроил камеру») просите Claude сделать коммит.

# Команда для Claude
Commit changes: "Added infinite runner tile logic"

Результат: История проекта прозрачна, а Claude понимает контекст изменений через историю коммитов.

3. Прототипирование логики: Создание бесконечного раннера

Контекст: Вместо ручного создания Actor-классов, автор использует Claude для генерации логики спавна тайлов. Агент сам создает переменные (длина тайла, скорость) и выстраивает цепочку событий.

Тайминг: [03:32], [04:42]

Выгода: Быстрое создание базовой механики игры без открытия редактора блюпринтов.

Как применить:

Шаг 1: Очистка сцены — Попросите Claude удалить лишние объекты, сохранив освещение.
Шаг 2: Создание логики тайлов — Используйте промпт для генерации бесконечного пути:

Create an infinite path that adds tiles as the character moves forward and removes tiles behind. Use BP_RunnerTile for the floor.

Шаг 3: Проверка через скриншот — Claude сам запустит игру, сделает скриншот и подтвердит, что персонаж стоит на платформе.

Результат: Рабочая механика генерации уровня, где тайлы появляются перед игроком и удаляются сзади для оптимизации памяти.

4. Автоматизация камеры и управления

Контекст: Для раннера нужно, чтобы персонаж бежал сам, а камера находилась в фиксированной точке (Top-Down или 3rd Person). Claude может изменять параметры компонентов внутри существующих блюпринтов через Python API движка.

Тайминг: [04:57], [05:16]

Выгода: Точная настройка углов обзора и механики движения без ручного подбора координат в деталях компонента.

Как применить:

Шаг 1: Настройка авто-бега — Попросите Claude изменить логику ввода, чтобы персонаж двигался вперед по тику.
Шаг 2: Позиционирование камеры — Укажите желаемый ракурс:

Change the camera position to be slightly from the top. Execute a python script to update the SpringArm component in my character blueprint.

Результат: Персонаж автоматически бежит вперед, игрок управляет только смещением влево/вправо, камера настроена под жанр Runner.

5. Интеграция AI-ассетов и отладка (Debugging)

Контекст: После настройки логики на «кубиках», нужно заменить их на реальные модели. Автор использует ассеты, сгенерированные в ChatGPT/DALL-E и конвертированные в 3D. Claude помогает массово заменить заглушки на финальные меши и исправить баги коллизий.

Тайминг: [07:41], [08:20], [08:50]

Выгода: Быстрая визуальная полировка проекта. Claude понимает названия файлов и автоматически назначает их нужным классам.

Как применить:

Шаг 1: Импорт ассетов — Закиньте ZIP с FBX моделями в папку проекта.
Шаг 2: Массовая замена — Дайте команду Claude:

Replace all placeholder obstacles with 'SM_Obstacle_Rock' and coins with 'SM_Coin_Gold'. Ensure the collision boxes match the new mesh sizes.

Шаг 3: Отладка багов — Если персонаж умирает, просто коснувшись моста (ошибка коллизии), сделайте скриншот и опишите проблему:

The game triggers 'Game Over' when the character touches the bridge. Fix the collision logic in BP_Bridge to ignore the Pawn channel.

Результат: Полностью визуализированная игра с исправленными багами коллизий и настроенными материалами.

FAQ

В: Нужно ли платить за использование этих плагинов? О: Сами плагины (Unreal Claude и Vibe UE) полностью бесплатны и имеют открытый исходный код. Вы платите только за использование API Claude (токены), если используете Claude Code.

В: Можно ли использовать другие модели, например GPT-4o? О: Да, Vibe UE позволяет подключать разные модели, но автор рекомендует Claude 3.5 Sonnet или Opus через Claude Code, так как они лучше справляются с написанием кода для Unreal и пониманием структуры папок.

В: Что делать, если Claude создает «спагетти» в блюпринтах? О: Это известное ограничение. Claude пока не умеет идеально выравнивать ноды эстетически. Автор рекомендует просить его «сделать логику менее запутанной», но финальную чистку (Layout) лучше делать вручную или использовать плагины для авто-выравнивания нод.

В: Обязательно ли использовать версию 5.7? О: Автор использовал 5.7, но методы MCP и Python API работают в большинстве версий 5.x. Главное — убедиться, что в настройках проекта включен плагин Python Editor Script Plugin.

В: Как Claude «видит» мою игру? О: Через плагин Unreal Claude, который делает скриншот активного вьюпорта и отправляет его в мультимодальное окно Claude. Это позволяет агенту понимать, где находятся объекты и как выглядит UI.

Ресурсы и ссылки

Claude Code — Консольный AI-агент от Anthropic — https://claude.ai/code
Unreal Claude Plugin — Плагин для скриншотов и манипуляции объектами — упомянут в видео
Vibe UE (Vibe.com) — Плагин для редактирования блюпринтов и Python-скриптов — https://vibe.com
ChatGPT — Использовался автором для генерации концепт-артов и текстур — https://chatgpt.com
Toon Shader — Бесплатный шейдер для стилизации графики — упомянут в видео (доступен на GitHub)
3D AI Course — Авторский курс по созданию 3D персонажей с помощью AI — ссылка в описании видео

Конспект создан на основе видео «I spent a month to make Claude Code work in Unreal Engine 5» канала [Название канала не указано в транскрипте, автор упоминает свой курс]. Все права на оригинальный материал принадлежат авторам. Источник: https://youtu.be/iRcrZjOt5H8