Wiki

Путь к движку Unreal

Указать uVersion, где установлен Unreal Engine: автоматическое обнаружение, ручной ввод, какую именно папку выбрать и почему обнаружение никогда не срабатывает в Linux.

uVersion необходимо знать, где установлен Unreal Engine, чтобы компилировать ваш проект, генерировать файлы проекта, открывать редактор, упаковывать build и устанавливать плагин, соответствующий вашей версии движка.

В большинстве случаев делать ничего не нужно

Клиент читает версию движка, объявленную в вашем файле .uproject, и находит установку самостоятельно:

Windows: через реестр, затем через файл инвентаризации лаунчера Epic. Работает как для установки через лаунчер, так и для движка, скомпилированного из исходников.
macOS: через стандартное расположение установок Epic или через файл инвентаризации для скомпилированного движка.
Linux: только для движка, скомпилированного из исходников.

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

Найденный путь сохраняется в папке .uversion/ вашего workspace. Если впоследствии вы переведёте проект на другую версию движка, обнаружение запускается заново; если оно не удаётся, путь стирается, чтобы интерфейс запросил его снова, а не компилировал с неправильным движком.

Ручной ввод

1. Найдите панель инструментов Unreal

Откройте вкладку вашего workspace. Панель инструментов Unreal занимает правую часть ряда вкладок Files / History / Pending: значок состояния плагина, значок папки, затем Open Editor, Compile, Package, Publish Build, Sync, Status и меню-шестерёнка. Она появляется только если найден файл .uproject.

Панель действий Unreal справа от ряда вкладок: значок состояния плагина, значок папки, затем Open Editor, Compile, Package, Publish Build, Sync, Status и меню-шестерёнка.

2. Распознайте состояние «путь отсутствует»

Когда путь неизвестен, значок состояния плагина становится оранжевым и показывает Set engine path вместо номера версии плагина. Это сигнал и одновременно ярлык: щелчок по нему сразу открывает выбор папки, минуя меню. Плагин не может установиться, пока этот путь отсутствует, поскольку он должен соответствовать вашей версии движка.

Панель инструментов Unreal со значком состояния плагина оранжевого цвета, с предупреждающим треугольником и текстом Set engine path там, где обычно стоит номер версии плагина.

3. Откройте меню-шестерёнку

Другой путь, который показывает сохранённый в данный момент путь: щёлкните кнопку-шестерёнку с шевроном справа от Status (её всплывающая подсказка гласит More actions). Выберите Set Engine Path...: строка несёт подзаголовок, показывающий действующий путь, или надпись Not configured, если пути нет. Это единственное место в клиенте, которое сообщает вам, что сохранено.

4. Укажите папку

Тем или иным путём открывается окно выбора папки под названием Select Unreal Engine installation folder. Точная папка, которую нужно указать, описана ниже: именно здесь совершается почти каждая ошибка.

Какую папку выбрать

Выберите корень движка, тот, что содержит папку Engine. Например:

C:\Program Files\Epic Games\UE_5.6
D:\EpicGames\UE_5.7
/Users/Shared/Epic Games/UE_5.6

Ни Engine, ни Engine/Binaries/Win64. Критерий проверяется на глаз, и это ровно то, что показывает снимок ниже: папка, которую вы указываете, должна содержать папку Engine, а та должна содержать Build/BatchFiles и Binaries. Если чего-то из двух не хватает, путь отклоняется сообщением, начинающимся с Invalid Unreal Engine path.

Окно выбора папки под названием Select Unreal Engine installation folder, установленное на допустимый корень движка вида UE_5.6, содержимое которого показывает папку Engine рядом с FeaturePacks, Samples и Templates.

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

Где клиент запрашивает его

Пока путь не указан, несколько команд ведут себя иначе. Это полезно знать, потому что иначе это выглядит как кнопки, которые не отвечают.

Compile, Generate Project Files, Publish Editor Binaries и Open Editor открывают выбор папки вместо того, чтобы действовать. После выбора пути нужно щёлкнуть кнопку ещё раз, чтобы действительно запустить действие.
Package просто отключена, со всплывающей подсказкой Set Engine Path first.
Значок состояния плагина становится оранжевым и показывает Set engine path: см. шаг 2 выше.
При отправке файлов кода C++ баннер напоминает, что путь обязателен: отправка кода компилирует его перед проверкой.
После клонирования сообщение Unreal Engine not set: skipped the build указывает, что автоматическая компиляция была пропущена. Укажите путь, затем щёлкните Compile.

Подводные камни

Путь сохраняется для каждого workspace, а не глобально

Он живёт в папке .uversion/ соответствующего workspace. Второй workspace запросит его снова, даже на той же машине и с тем же движком. Страница настроек не содержит об этом ничего: это нормально, не ищите там.

Панель Unreal вообще не появляется

Клиент ищет файл .uproject максимум на трёх уровнях вложенности под корнем workspace. Глубже он его не находит, и панель остаётся скрытой без какого-либо сообщения. Если ваш проект зарыт глубже, корень workspace, вероятно, выбран неверно.

Кнопки Compile у меня нет

Она появляется только для проекта C++. Чисто Blueprint-проекту нечего компилировать. Точно так же публикация бинарных файлов редактора не предлагается в Linux.

«Invalid Unreal Engine path»

Отказ приходит в небольшом системном окне, сразу после вашего выбора. Сообщение повторяет отклонённый путь и его причину: is not a recognizable engine install (missing Engine/Build/BatchFiles or Engine/Binaries, or path canonicalization failed). Вероятно, вы спустились на один уровень глубже нужного: поднимитесь до папки, которая содержит Engine. То же сообщение охватывает случай, когда путь указывает на ссылку, которая не разрешается.