UE4SS - зависимость для модов

[Alex39]

 

UE4SS - зависимость для модов

 

 

Это программа, которая необходима для использования некоторых модов. Если при нажатии ~ не появляется консоль, значит, неправильно скопированы файлы. Нужно вернуться назад и внимательно следовать инструкциям. 

Как запустить:

Распаковать по этому пути \Stalker2\Binaries\Win64.

 

 

Система скриптов Unreal Engine 4/5

Платформа системы скриптов Lua, API моддинга C++, генератор SDK, загрузчик модов Blueprint, редактор свойств в реальном времени и другие утилиты дампа для игр UE4/5.

Основные характеристики

Lua Scripting API : написание lua-модов на основе объектной системы UE

Загрузка модов Blueprint : автоматическое создание модов Blueprint без редактирования/замены файлов игры.

API моддинга C++ : написание модов C++ на основе объектной системы UE

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

UHT Dumper : генерация заголовков C++, совместимых с Unreal Header Tool, для создания зеркального .uproject для вашей игры

C++ Header Dumper : генерация стандартных заголовков C++ из отраженных классов и чертежей со смещениями

Универсальные моды UE : разблокируйте игровую консоль и другие универсальные моды.

Дамперы для анализа файлов : создание .usmapфайлов сопоставления для неверсированных свойств

UMAP Recreation Dumper : выгрузить всех загруженных актеров в файл для создания .umapsв редакторе

Другие функции, включая экспериментальные функции время от времени

Версии UE: от 4.12 до 5.5

Цель UE4SS — не быть решением plug-n-play, которое всегда работает с любой игрой. Цель — иметь базовую систему, которая работает с большинством игр. Возможно, вам придется обновлять AOB самостоятельно, и ниже приведено руководство по этому вопросу.

Базовая установка

Самая простая установка — это загрузка не-dev-версии последней неэкспериментальной сборки с Releases и извлечение содержимого zip-архива в {game directory}/GameName/Binaries/Win64/.

Если ваша игра находится в списке пользовательских конфигураций, извлеките содержимое из соответствующей папки Win64.

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

 

 

Спойлер

Ссылки

Полное руководство по установке

Устранение проблем совместимости

API Lua — Обзор

Создание заголовков, совместимых с UHT

Пользовательские игровые конфигурации

Создание совместимых модов Blueprint

Приглашение на сервер Discord UE4SS

Приглашение на Discord-сервер Unreal Engine Modding

Спойлер

Требования к сборке

• Компьютер под управлением Windows.
  • Поддержка Linux может появиться в какой-то момент, но не скоро.
• Версия MSVC, поддерживающая C++23:
  • Версия набора инструментов MSVC >= 14.39.0
  • Версия MSVC >= 19.39.0
  • Версия Visual Studio >= 17.9
  • Надеемся, что в будущем будет поддерживаться больше компиляторов.
• Набор инструментов Rust >= 1.73.0
• xmake >= 2.9.3

Инструкции по сборке

1. Клонируйте репозиторий.
2. Выполните эту команду: git submodule update --init --recursive Убедитесь, что ваша учетная запись Github связана с учетной записью Epic Games для доступа к исходному коду UE. Не используйте эту --remoteопцию, поскольку это заставит сторонние зависимости обновиться до последнего коммита, а это может все сломать. Вам понадобится, чтобы ваша учетная запись github была связана с учетной записью Epic games для извлечения подмодуля псевдокода Unreal.

Существует несколько различных способов создания UE4SS.

Строительство из кли

Параметры конфигурации

xmakeпозволяет гибко настраивать некоторые параметры сборки в соответствии с вашими конкретными потребностями. Ниже приведен неполный список параметров конфигурации, которые могут оказаться полезными.

Важный

Все изменения конфигурации производятся с помощью xmake configкоманды. Вы также можете использовать xmake fкак псевдоним для con f ig.

После настройки xmakeс помощью любого из следующих параметров вы можете собрать проект с помощью xmakeили xmake build.

Режим

Режимы сборки структурированы следующим образом:<Target>__<Config>__<Platform>

В настоящее время поддерживаются следующие варианты:

• Target

  • Game- для обычных игр на версиях UE выше UE 4.21
  • LessEqual421- для обычных игр на версиях UE ниже или равных UE 4.21
  • CasePreserving- для игр, созданных с включенным сохранением регистра

• Config

  • Dev- разработка сборки
  • Debug- отладочная сборка
  • Shipping- сборка для отправки (релиза)
  • Test- сборка для тестов

• Platform

  • Win64- 64-битная Windows

Кончик

Настройте проект с помощью этой команды: xmake f -m "<BuildMode>". -m— это псевдоним для -- mode =<BuildMode>.

Patternsleuth (Экспериментальный)

По умолчанию patternsleuth tool устанавливается как пакет xmake. Если вы не собираетесь изменять исходный код patternsleuth, вам не нужно ничего специально настраивать. Если вы хотите иметь возможность изменять исходный код patternsleuth, вам нужно указать опцию --patternsleuth=localдля xmake configперекомпиляции patternsleuth как части сборки UE4SS.

Путь прокси

По умолчанию UE4SS генерирует прокси на основе C:\Windows\System32\dwmapi.dll. Если вы хотите изменить это по какой-либо причине, вы можете указать --ue4ssProxyPath=<path proxy dll>в xmake configкоманде ..

Профайлер Flavor

По умолчанию UE4SS использует Tracy для профилирования. Вы можете передать --profilerFlavor=<profiler>команду, xmake configчтобы задать разновидность профилировщика. В настоящее время поддерживаются разновидности Tracy, Superluminalи None.

Проверка версии

По умолчанию xmake проверит, установлена ли у вас минимальная требуемая версия Rust или MSVC (если вы используете MSVC toolchain). Если нет, на этапе настройки возникнет ошибка. Если вы хотите проигнорировать эту проверку, вы можете передать ее --versionCheck=nкоманде xmake config.

После установки флага значение параметра будет установлено, пока вы не укажете иное.

Поэтому, чтобы не проверять версии при запуске xmake project -k vsxmake2022, необходимо сначала выполнить xmake config --versionCheck=nкоманду, а затем выполнить xmake project -k vsxmake2022команду.

Полезные xmakeкоманды

Вы можете столкнуться с использованием некоторых более продвинутых xmakeкоманд. Ниже приведен неполный список некоторых полезных команд.

Синтаксис	Псевдонимы	Использует
xmake <command> --yes	xmake <command> -y	Автоматически подтверждать любые запросы пользователя.
xmake --verbose <command>	xmake -v <command>	Включить подробное ведение журнала.
xmake --Diagnostic <command>	xmake -D <command>	Включить ведение журнала на уровне диагностики.
xmake --verbose --Diagnostic --yes <command>	xmake -vDy <command>	Вы можете объединить большинство флагов в один файл -flagCombo.
xmake config	xmake f	Настройте xmake с помощью любого из этих параметров .
xmake clean --all	xmake c --all	Очищает двоичные файлы и промежуточные выходные данные всех целей.
xmake clean <target>	xmake c <target>	Очищает двоичные и промежуточные файлы определенной цели.
xmake build	xmake b	Поэтапно собирает UE4SS, используя обнаружение входного файла.
xmake build --rebuild	xmake b -r	Принудительно выполняет полную перестройку UE4SS.
xmake build <target>	xmake b <target>	Постепенно выстраивает конкретную цель.
xmake show		Показывает информацию xmake и информацию о текущем проекте.
xmake show --target=<target>	xmake show -t <target>	Выводит много информации о цели. Полезно для отладки скриптов, флагов компилятора, дерева зависимостей и т. д.
xmake require --clean	xmake q -c	Очищает все кэши пакетов и удаляет все неиспользуемые пакеты.
xmake require --force	xmake q -f	Принудительно переустанавливает все пакеты зависимостей.
xmake require --list	xmake q -l	Перечисляет все пакеты, необходимые для проекта.
xmake project --kind=vsxmake2022 --modes="Game__Shipping__Win64"	xmake project -k vsxmake2022 -m "Game__Shipping__Win64"	Генерирует проект Visual Studio на основе текущей xmake configuration. Вы можете указать несколько режимов для генерации, указав -m "Comma,Separated,Modes". Если вы не укажете ни одного режима, проект VS сгенерирует все перестановки режимов .

Открытие в IDE

Visual Studio / Райдер

Чтобы создать файлы проекта Visual Studio, выполните xmake project -k vsxmake2022 -m "Game__Shipping__Win64"команду.

После этого откройте сгенерированный .slnфайл внутри каталога vsxmake2022.

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

Предупреждение

Плагин vs. build выполняет операцию компиляции, напрямую вызывая команду xmake в vs, а также поддерживает intellisense и переходы определений, а также отладку точек останова. Это означает, что изменение свойств проекта в Visual Studio не повлияет на то, какие флаги передаются в сборку при выполнении VS. xmakeXMake предоставляет некоторые настраиваемые параметры проекта, которые можно найти в VS в Project Properties -> Configuration Properties -> Xmakeменю.

Осторожность

Если у вас установлено несколько версий Visual Studio, запустите xmake f --vs=2022, в противном случае могут возникнуть проблемы с генерацией проекта.

Настройка дополнительных режимов

Кончик

Дополнительные режимы могут быть сгенерированы запуском xmake project -k vsxmake2022 -m "Game__Shipping__Win64,Game__Debug__Win64". Дальнейшие пояснения можно найти в xmakeтаблице команд .

Регенерация лучших практик решения

Осторожность

Если вы измените конфигурацию с помощью xmake config, вам может потребоваться повторно сгенерировать решение Visual Studio, чтобы отразить изменения в конфигурации. Вы можете просто повторно запустить xmake project -k vsxmake2022 -m "<modes>"команду, чтобы повторно сгенерировать решение.

Сборка двоичных файлов Windows на Linux

Мы официально поддерживаем только msvc-wine для кросс-компиляции.
Убедитесь, что у вас установлен winbind (libwbclient и samba на Arch).

Осторожность

Вам необходимо использовать xmake v2.9.7 или более позднюю версию, и по состоянию на начало декабря 2024 года эта версия еще не выпущена, что означает, что вам необходимо установить dev-версию xmake.

Вам необходимо установить x86_64-pc-windows-msvcцель (не windows-gnutarget) с rustup.
При вызове xmake fнеобходимо установить --plat, --arch, и --sdk.
Также необходимо использовать --ue4ssCross=msvc-wine, и отключить проверку версии.
Следующие проекты не поддерживаются при кросс-компиляции и автоматически отключаются:

proxy
proxy_generator
UVTD

 

При вызове xmakeкоманды сборки patternsleuth будет автоматически собран без xmake.
Двоичные файлы доступны в deps/first/patternsleuth_bind/target/x86_64-pc-windows-msvc.
Они автоматически используются xmake, когда --ue4ssCrossустановлено значение msvc-wine.
Вот пример полной команды, которая соберет двоичные файлы Windows на машине Linux:

xmake f -m "Game__Shipping__Win64" -p windows -a x64 --sdk=/home/<username>/my_msvc/opt/msvc --versionCheck=n --ue4ssCross=msvc-wine

 

Отладка под Wine

Отладку можно выполнить с помощью winedbg.
Также можно отлаживать минидампы:

winedbg crash_2024_12_26_07_39_15.dmp

 

Помните, что отладочные символы не хранятся в файле dmp, и у вас должен быть точно такой же файл символов (PDB), с которым был собран ваш UE4SS.dll.
Самый простой способ убедиться, что у вас есть правильные символы, — это собрать точный коммит, из которого был сгенерирован файл dmp.

Обновление подмодулей git

Если вы хотите обновить подмодули git, это можно сделать одним из трех способов:

1. Вы можете выполнить git submodule update --init --recursiveобновление всех подмодулей.
2. Вы также можете обновить подмодули по одному, выполнив git submodule update --init --recursive deps/<first-or-third>/<Repo>. Не используйте эту --remoteопцию, если вы действительно не хотите обновиться до последнего коммита.
3. Если вы предпочитаете выбрать определенный коммит или ветку для обновления подмодуля, то cdв каталог подмодуля для этой зависимости и выполните git checkout <branch name or commit>. Основная зависимость, которую вы, возможно, захотите обновлять время от времени, это deps/first/Unreal.

Кредиты

Все участники проекта с момента открытия исходного кода: https://github.com/UE4SS-RE/RE-UE4SS/graphs/contributors

• Оригинальный создатель Оригинальный создатель больше не желает быть вовлеченным или связанным с этим проектом. Пожалуйста, уважайте их желания и избегайте использования их прошлых имен пользователей в связи с этим проектом.
• Архенгий
  • Генератор заголовков, совместимый с UHT
• CasualGamer
  • Код инжектора и сканер aob во многом основаны на его работе, 90% этого кода принадлежит ему.
• Солнечный луч
  • Дополнительная сигнатура для функции «GetFullName» для UE4.25.
  • Регулярное выражение для проверки правильности формата подписи при загрузке из INI.
  • Много-много работы над подписями
• томса
  • преобразователь const char* в vector<int>
    • tomsa: Идея и большая часть кода
    • Оригинальный создатель: Поддержка Nibblet
• буп / размер использования
  • Новый метод-хук UFunction
• РасселДж.
  • Вдохновение для Blueprint Modloader
• Наркнон
  • Определенные функции и обслуживание/переразмещение проекта
• DeadMor0z
  • Некоторые функции и обновления/обслуживание Lua
• OutTheShade
  • Генератор Unreal Mappings (USMAP)
• DmgVol
  • Вдохновение для создания карты-дампера
• Бакминстерфуллерен
  • Переписывание документации, различные исправления
• трумэнк
  • Генератор привязок Lua, различные исправления, автоматизация и улучшения
• локальныйcc
  • API-интерфейс C++

ue4ss-zavisimost-dlja-modov_1737626074_452881.zip