Инструменты UE4SS / RE-UE4SS v3.0.1

Для чего нужен UE4SS
UE4SS нужен прежде всего как обязательная основа для некоторых модификаций. Такие моды не заменяют напрямую игровые файлы, а работают через Lua-скрипты, Blueprint-загрузчик или другие возможности UE4SS.

Если в описании мода указано, что ему требуется UE4SS, значит сначала нужно установить UE4SS в папку игры, а уже потом устанавливать сам мод.

UE4SS может использоваться для:

• запуска Lua-модов;
• загрузки некоторых Blueprint-модов;
• работы модов, которые меняют игровые параметры во время запуска игры;
• отладки и изучения внутренних объектов Unreal Engine;
• создания и тестирования модификаций для игр на UE4/UE5.

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

Важно

• UE4SS не является модом для какой-то одной конкретной игры. Это универсальный инструмент для Unreal Engine, поэтому его используют в разных играх.
• Совместимость зависит от конкретной игры, версии движка, версии UE4SS и самого мода. Если один мод работает через UE4SS, это не означает, что все остальные моды будут работать одинаково.

Установка для Gothic 1 Remake

1. Скачайте архив UE4SS.
2. Откройте папку игры:
   • Gothic 1 Remake\G1R\Binaries\Win64

1. Распакуйте содержимое архива UE4SS в эту папку.
   • После распаковки файлы UE4SS должны лежать рядом с исполняемым файлом игры в папке Win64.
2. Если мод требует отдельную папку в ue4ss\Mods, установите сам мод уже по его инструкции.
3. Обычно путь для таких модов выглядит так:
   • Gothic 1 Remake\G1R\Binaries\Win64\ue4ss\Mods
4. Если в инструкции мода сказано добавить строку в файл mods.txt, откройте:
   • Gothic 1 Remake\G1R\Binaries\Win64\ue4ss\Mods\mods.txt и добавьте нужную строку из описания конкретного мода.

Как понять, что UE4SS установлен правильно
После запуска игры UE4SS обычно создаёт свои папки, файлы настроек и лог-файлы. Если мод не работает, в первую очередь проверьте:

• правильно ли выбран путь установки;
• лежат ли файлы UE4SS именно в G1R\Binaries\Win64;
• не распакован ли архив лишней вложенной папкой;
• добавлена ли нужная строка в mods.txt, если это требуется модом;
• подходит ли версия UE4SS для конкретного мода.

Обновление UE4SS
Если UE4SS уже был установлен, перед обновлением лучше сделать резервную копию файла настроек:
UE4SS-settings.ini

При обновлении с версии 3.0.0 на 3.0.1 обычно достаточно заменить все файлы, кроме UE4SS-settings.ini, если в нём были свои настройки.

Если ранее использовалась старая версия 2.5.2, нужно удалить старый файл:
xinput1_3.dll

В новых версиях UE4SS 3.x он больше не используется и может вызывать вылет игры.

Возможные проблемы
Если после установки игра не запускается или вылетает:

• проверьте, что файлы распакованы в правильную папку;
• попробуйте временно убрать UE4SS и проверить запуск игры без него;
• проверьте файл UE4SS-settings.ini;
• если появляется пустое/белое окно консоли, можно попробовать выставить GraphicsAPI = dx11;
• если игра вылетает при запуске, можно попробовать параметр bUseUObjectArrayCache = false;
• внимательно проверьте инструкцию конкретного мода, потому что разные моды для UE4SS могут устанавливаться по-разному.

Версии
Рекомендуемая стабильная версия: UE4SS v3.0.1.
Это патч-релиз для версии 3.0.0. В нём исправлены ошибки и внесены изменения, связанные с работой Lua API, C++ API и общими механизмами UE4SS.