March 9

Установка и настройка 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.

  1. Скачай установщик Visual Studio 2022 (версия Community бесплатна) с официального сайта Microsoft.
  2. Запусти Visual Studio Installer.
окно 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 нужно явно указать движку использовать именно её.

  1. Открой свой проект в Unreal Engine.
  2. Перейди в Edit -> Editor Preferences.
  3. В поиске слева введи Source Code.
  4. В поле Source Code Editor выбери Visual Studio 2022.
  5. Перезапусти редактор UE.

Шаг 4: Подготовка проекта и первая сборка

  1. Создай новый проект. Можно использовать готовые пресеты, главное условие — проект должен быть на C++ (а не просто Blueprint).
  2. В редакторе UE нажми Tools -> Refresh Visual Studio Project. Это обновит файлы решения и подтянет зависимости.
  3. Затем нажми Tools -> Open Visual Studio. Проект откроется внутри IDE.
  4. В самой Visual Studio в верхнем меню нажми Build -> Build Solution (или Rebuild Solution).
  5. Дождись окончания процесса. Внизу должно появиться сообщение об удачной сборке.
Пункт 3. Окно редактора после его вызова из UE
Пункт 4. Build Solution или Rebuild Solution
Пункт 5. Сообщение о сборке

Ограничения и варианты решения проблем при компиляции

При работе с кодом (особенно сгенерированным ИИ) или при переносе старых проектов вы почти наверняка столкнетесь с ошибками компиляции. Как действовать:

Проблема: Ошибки при переводе старого 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 будет только мешать. Эту функцию лучше сразу отключить, чтобы избежать постоянных конфликтов при сборке.

Как отключить Live Coding:

  1. В Unreal Engine перейди в Edit -> Editor Preferences.
  2. В строке поиска введи Live Coding.
  3. Сними галочку с пункта Enable Live Coding.

[Место под скриншот: Окно поиска Live Coding со снятой галочкой]

Короткий комментарий по нюансу работы: После отключения Live Coding правило сборки становится максимально строгим. Если ИИ-агент написал код, который меняет архитектуру или заголовочный файл (добавил новые переменные UPROPERTY, новые компоненты или функции UFUNCTION), вам обязательно нужно закрыть редактор Unreal Engine, нажать Build Solution в Visual Studio, дождаться завершения и запустить движок заново.

Если же вы (или агент) просто поменяли логику внутри уже существующей функции (например, изменили цифру урона или скорости), закрывать движок не нужно — можно просто нажать кнопку Compile (иконка кубиков) в самом редакторе UE в правом нижнем углу.

Live Coding

В целом мы подготовили наш проект для работы с кодом и агентами, вы по прежнему можете создавать блюпринты, если кто-то почему-то в этом сомневался.

Текст редактировал и форматировал с помощью нейросети, что бы он был читабельный.