Установка и настройка Visual Studio 2022 для Unreal Engine 5
Для чего это нужно? Мы будем использовать ИИ-агентов для написания C++ кода. Любой написанный код необходимо компилировать. Visual Studio (VS) — идеальный инструмент для нашей задачи: у нее есть бесплатная версия, она относительно легко настраивается и содержит всё необходимое для связи между Unreal Build Tool (UBT) и редактором UE.
Шаг 1: Установка Visual Studio
Для Unreal Engine 5 (включая версии 5.2 и, как в нашем случае, 5.7) стандартом является Visual Studio 2022.
- Скачай установщик Visual Studio 2022 (версия Community бесплатна) с официального сайта Microsoft.
- Запусти Visual Studio Installer.
Шаг 2: Выбор рабочих нагрузок (Workloads)
Это самый важный этап установки. В установщике на вкладке «Рабочие нагрузки» отметь следующие пункты:
- Разработка игр на C++ (Game development with C++)
- Разработка классических приложений на C++ (Desktop development with C++) — опционально, но помогает избежать проблем с отсутствующими базовыми библиотеками в дальнейшем.
Нюанс, на который стоит обратить внимание: Выбрав «Разработку игр на C++», обязательно разверни список дополнительных компонентов в панели деталей справа. Проверь наличие галочек на следующих пунктах (если их нет — добавь вручную):
C++ profiling tools
C++ AddressSanitizer
Windows 10 SDK или Windows 11 SDK (выбирай самую последнюю версию из списка)
Unreal Engine installer
MSVC v143 - VS 2022 C++ x64/x86 build tools (Latest)
Шаг 3: Интеграция в Unreal Engine 5
После установки VS 2022 нужно явно указать движку использовать именно её.
- Открой свой проект в Unreal Engine.
- Перейди в
Edit->Editor Preferences. - В поиске слева введи
Source Code. - В поле
Source Code EditorвыбериVisual Studio 2022. - Перезапусти редактор UE.
Шаг 4: Подготовка проекта и первая сборка
- Создай новый проект. Можно использовать готовые пресеты, главное условие — проект должен быть на C++ (а не просто Blueprint).
- В редакторе UE нажми
Tools->Refresh Visual Studio Project. Это обновит файлы решения и подтянет зависимости. - Затем нажми
Tools->Open Visual Studio. Проект откроется внутри IDE. - В самой Visual Studio в верхнем меню нажми
Build->Build Solution(илиRebuild Solution). - Дождись окончания процесса. Внизу должно появиться сообщение об удачной сборке.
Ограничения и варианты решения проблем при компиляции
При работе с кодом (особенно сгенерированным ИИ) или при переносе старых проектов вы почти наверняка столкнетесь с ошибками компиляции. Как действовать:
Проблема: Ошибки при переводе старого Blueprint-проекта на C++ Можно попытаться сгенерировать C++ классы прямо в старом проекте, но часто это приводит к конфликтам модулей и крашам при сборке.
- Самый надежное: Создать чистый новый C++ проект (как описано в Шаге 4) и сделать Migrate (миграцию) всех нужных ассетов из старого проекта в новый. Продолжать работу там.
- Рискнуть и чинить на месте: Если нужно оставить старый проект, и сборка сломалась — закрой UE и VS. Зайди в папку проекта, удали папки
Binaries,Intermediateи файл.sln. Кликни правой кнопкой мыши по файлу.uproject, выбериGenerate Visual Studio project files. Открой появившийся.slnфайл и снова запустиRebuild Solution.
Важное ограничение: Конфликт сборки и Live Coding
При попытке собрать проект (Build Solution) в Visual Studio, когда у вас параллельно открыт редактор Unreal Engine, вы почти гарантированно получите ошибку компиляции (ошибку прав доступа).
Это происходит из-за включенной по умолчанию функции Live Coding в UE5, которая блокирует файлы кода во время работы движка. Поскольку при работе с ИИ-агентами мы часто будем генерировать новые классы и менять заголовочные файлы, Live Coding будет только мешать. Эту функцию лучше сразу отключить, чтобы избежать постоянных конфликтов при сборке.
- В Unreal Engine перейди в
Edit->Editor Preferences. - В строке поиска введи
Live Coding. - Сними галочку с пункта
Enable Live Coding.
[Место под скриншот: Окно поиска Live Coding со снятой галочкой]
Короткий комментарий по нюансу работы: После отключения Live Coding правило сборки становится максимально строгим. Если ИИ-агент написал код, который меняет архитектуру или заголовочный файл (добавил новые переменные UPROPERTY, новые компоненты или функции UFUNCTION), вам обязательно нужно закрыть редактор Unreal Engine, нажать Build Solution в Visual Studio, дождаться завершения и запустить движок заново.
Если же вы (или агент) просто поменяли логику внутри уже существующей функции (например, изменили цифру урона или скорости), закрывать движок не нужно — можно просто нажать кнопку Compile (иконка кубиков) в самом редакторе UE в правом нижнем углу.
В целом мы подготовили наш проект для работы с кодом и агентами, вы по прежнему можете создавать блюпринты, если кто-то почему-то в этом сомневался.
Текст редактировал и форматировал с помощью нейросети, что бы он был читабельный.