Моды на сервер Palworld: UE4SS и pak-моды

У Palworld нет официального загрузчика модов, поэтому серверные моды работают на инструментах сообщества. Модов два вида. Pak-моды - это файлы ассетов Unreal, которые кладутся в Pal/Content/Paks/~mods/; они меняют данные и ассеты, и загрузчик им не нужен. Скриптовые моды - это моды на Lua (или C++), которые запускает UE4SS, система скриптов для Unreal Engine, устанавливаемая в Pal/Binaries/Win64/; они меняют поведение во время работы. UE4SS сделан под Windows, так что скриптовые моды на сервере на практике означают Windows-сборку сервера - нативно или под Wine на Linux. Вопрос, от которого зависит всё остальное, - где мод нужно ставить: только на сервер, только на клиенты или и туда, и туда. Ответьте на него правильно - и сервером Palworld с модами вполне можно управлять. Ошибётесь - и игроков будет выкидывать при входе, или они увидят мир, который не совпадает с серверным.

Настройка самого сервера описана в статье настройки сервера Palworld, и удивительно много того, ради чего люди ставят моды, - рейты, вес стаков, лимиты баз - там уже есть в виде настроек. Сначала проверьте это. Каждый мод, который вы не поставили, не может сломаться в день патча.

Два вида модов Palworld#

Pak-моды - самая старая и простая форма. Unreal загружает каждый .pak, который находит в папках pak игры, а pak из ~mods загружается после собственных паков игры, поэтому переопределяет то, что в нём есть. Pak может заменить таблицу данных (характеристики палов, рецепты предметов, шансы дропа) или ассет (модель, текстуру). Pak-моды не выполняют код.

UE4SS - проект сообщества RE-UE4SS - внедряется в процесс игры и даёт модам Lua API для скриптов, перехват игровых функций и загрузчик blueprint-модов. Большинство модов, которые меняют поведение сервера, а не его данные, - это моды UE4SS. Для поддержки Palworld исторически нужна сборка UE4SS, которая знает версию Palworld; на страницах модов указано, какую сборку они ожидают.

Серверные, клиентские или и те, и другие#

Каждый мод попадает в одну из трёх групп, и это нужно знать до установки.

• Только серверные. Сервер решает большую часть игры: спавн, дроп, урон, поведение палов на базах, данные игроков. Мод, который меняет это через скрипт, может работать только на сервере, а игрокам ничего не нужно. Сюда относятся инструменты администратора, логирование, мосты в Discord, серверные средства защиты и многие правки правил.
• Только клиентские. Изменения интерфейса, замена визуала, камера и моды удобства, которые влияют только на то, что видит один игрок. Сервер в этом не участвует; игроки ставят такие моды себе на компьютер, а серверу всё равно.
• И те, и другие. Моды, которые добавляют новый контент - новых палов, предметы, постройки, - или меняют данные, которые читает и клиент. Если у клиента нет мода, он не понимает, о чём ему говорит сервер. В зависимости от мода игрок без него видит пропавшие модели, не может взаимодействовать с новым объектом или вылетает.

Обычно это указано на странице мода. Если нет, считайте любой мод, добавляющий контент, модом «для обеих сторон», а любой мод, который меняет только числа, рассчитываемые сервером, сначала пробуйте только на сервере.

Pak-моды с таблицами данных - серая зона. Если значение решает сервер - шанс дропа, скорость работы, - важна серверная копия таблицы. Если клиент тоже показывает или предсказывает это значение, клиент без мода показывает старое число, а сервер использует новое. Это работает, но сбивает людей с толку. Для всего, что игроки заметят, требуйте одинаковый pak с обеих сторон.

Установка UE4SS на сервер с Windows#

Исполняемый файл выделенного сервера под Windows лежит в Pal/Binaries/Win64/. UE4SS ставится туда же, рядом с ним.

1. Остановите сервер и сделайте резервную копию папки мира.
2. Скачайте релиз UE4SS, который поддерживает вашу версию Palworld. Новые релизы UE4SS поставляются как прокси dwmapi.dll плюс папка ue4ss; старые - как UE4SS.dll с настройками и папкой Mods рядом. Следуйте структуре того релиза, который скачали, и не смешивайте файлы двух версий.
3. Распакуйте его в Pal/Binaries/Win64/.
4. Запустите сервер один раз. UE4SS пишет файл лога (UE4SS.log) в своей папке. Если лог показывает, что UE4SS инициализировался и нашёл функции игры, он работает.
5. Перед добавлением модов снова остановите сервер.

Типичная структура после установки свежего релиза:

Pal/Binaries/Win64/    PalServer-Win64-Shipping-Cmd.exe    dwmapi.dll    ue4ss/        UE4SS.dll        UE4SS-settings.ini        UE4SS.log        Mods/            mods.txt            BPModLoaderMod/            SomeLuaMod/                Scripts/main.lua                enabled.txt

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

Установка модов#

Lua-моды - это папки. Каждая кладётся в папку Mods/ UE4SS, а внутри у неё Scripts/main.lua. Мод включается файлом enabled.txt в его папке или строкой в Mods/mods.txt:

BPModLoaderMod : 1SomeLuaMod : 1AnotherMod : 0

1 загружает мод, 0 пропускает. Встроенные моды, которые идут с UE4SS, например BPModLoaderMod, должны оставаться включёнными, если вы используете blueprint-моды: именно он их загружает.

Blueprint-моды - это паки, которые кладутся в Pal/Content/Paks/LogicMods/ (создайте папку, если её нет). Их загружает blueprint-загрузчик UE4SS, так что без UE4SS они ничего не делают.

Pak-моды кладутся в Pal/Content/Paks/~mods/ (создайте, если её нет). Тильда заставляет папку сортироваться после собственных паков игры, и именно это даёт модам приоритет. Когда два pak-мода меняют один и тот же ассет, побеждает тот, что загрузился последним; некоторые авторы модов добавляют к именам файлов числовой или буквенный префикс, чтобы управлять порядком. Общая идея разобрана в статье порядок загрузки модов.

Загружайте всё это через файловый менеджер или по SFTP - подробности в статье SFTP и файловый менеджер - и добавляйте по одному моду за раз. После каждого запускайте сервер, проверяйте лог, немного играйте, а потом добавляйте следующий. Когда что-то сломается, причиной будет последнее добавленное.

Моды для Palworld в основном публикуются на Nexus Mods, с инструкциями по установке на каждой странице. Читайте раздел требований: многие моды зависят от конкретной версии UE4SS или от другого мода, например общей библиотеки или фреймворка для правки данных.

Серверы на Linux#

Официальный выделенный сервер под Linux - эффективный способ держать ванильный Palworld, и он плохо подходит для скриптовых модов. UE4SS разрабатывается под Windows. Экспериментальные попытки сделать его для Linux были, но на практике:

• Pak-моды могут загружаться на сервере под Linux - зависит от того, как они собраны. Проверяйте каждый.
• UE4SS, Lua- и blueprint-моды обычно означают, что вместо этого нужно запускать Windows-сборку сервера. На машине с Linux это значит запускать Windows-сборку под Wine или Proton, что у многих работает, но стоит дополнительной памяти и части стабильности. Компромиссы разобраны в статье Wine и Proton для серверов только под Windows.
• Нативные DLL-моды работают только под Windows.

Если сервер будет модифицирован больше чем парой pak-файлов, выберите Windows-сборку с самого начала, а не переезжайте потом. Формат сохранения мира в обоих случаях одинаковый, так что переезд возможен; просто это ещё одна задача в день, когда хотелось бы играть.

Чего стоят моды#

Большинство модов Palworld дешёвые. Lua-скрипт, который меняет значение при поимке пала, не стоит ничего измеримого. Дорого обходятся те, что меняют количество того, что держит мир:

• Повышение лимитов баз и палов сверх того, что позволяет PalWorldSettings.ini. Больше работающих палов - больше симуляции и больше памяти; в статье производительность Palworld и лимиты баз объясняется, почему стоимость определяют палы, а не игроки.
• Моды, которые добавляют много спавнов или новых палов, бродящих по миру.
• Моды, которые хранят дополнительные данные по каждому игроку и записывают их при каждом сохранении.
• Сам UE4SS под Wine, который добавляет накладные расходы ещё до того, как запустится хоть один мод.

После нового контентного мода несколько дней следите за графиком памяти. Мод, который даёт медленный рост, проявляется за дни, а не за минуты.

Обновления игры ломают моды#

Это та часть работы с сервером Palworld на модах, которая отнимает больше всего времени. UE4SS находит функции игры, ища шаблоны в исполняемом файле. Обновление игры их сдвигает, и пока UE4SS (и каждый мод) не обновят, сервер может не запуститься, запуститься без модов или упасть, когда мод вызовет что-то, чего больше нет на прежнем месте. Pak-моды, заменяющие таблицы данных, ломаются, когда игра меняет структуру таблицы.

Оборонительный порядок действий:

1. Отключите автоматические обновления на сервере с модами, если ваша конфигурация это позволяет. Обновляйтесь осознанно.
2. Перед обновлением игры проверьте страницы UE4SS и модов на наличие версий, поддерживающих новую сборку.
3. Сделайте копию мира и всей папки `Pal/Binaries/Win64/` перед обновлением, чтобы можно было вернуть старую конфигурацию модов.
4. После обновления запустите сервер один раз с отключёнными модами (поставьте записям в Mods/mods.txt значение 0 или уберите ~mods в сторону), чтобы убедиться, что ванильный сервер и мир загружаются. Затем включайте моды по одному.
5. Игрокам тоже нужно обновить клиентские моды - для каждого мода, который стоит с обеих сторон. Скажите им, какая версия нужна.

Общий порядок действий на утро после ломающего обновления - в статье что делать, когда обновление мода всё сломало.

Как обезопасить сервер с модами#

Моды - это код, работающий в процессе вашего сервера. Мод UE4SS или DLL может делать всё, что может сервер: читать файлы, менять сохранения, открывать сетевые соединения. Скачивайте с настоящей страницы мода, предпочитайте моды с открытым исходным кодом или долгой историей и с подозрением относитесь к «исправленной» или «разблокированной» версии мода, перезалитой кем-то другим. Чек-лист - в статье как держать сервер с модами в чистоте.

Серверные средства защиты и администрирования - одни из самых полезных серверных модов для публичного сервера. Самый известный - PalDefender (раньше назывался PalGuard); он работает на Windows-сервере и добавляет проверки против распространённых читов плюс функции для администратора. Сверьтесь с его документацией, какую версию игры он поддерживает.

Моды в RE:NODE#

В RE:NODE моды загружаете вы сами - через встроенный в браузер файловый менеджер, который распаковывает архивы на месте, так что zip с релизом UE4SS можно просто перетащить и распаковать, - или по SFTP. Списка разрешённых модов и установщика модов в один щелчок нет; моды и их версии выбираете вы. Чего панель изменить не может, так это того, на какой сборке сервера работает установка, и ограничения Linux, описанные выше, относятся к любой установке на Linux: если ваши планы зависят от скриптовых модов UE4SS, проверьте, на какой сборке работает ваш сервер, прежде чем составлять вокруг него список модов, и спросите поддержку, если по файлам это неочевидно. Тарифы Palworld начинаются с 8 GB, а слоты резервных копий в каждом тарифе покрывают шаг «сделать копию перед днём патча». Если мод раз за разом роняет сервер, наблюдатель за падениями выдаёт предупреждение и после трёх перезапусков за час открывает тикет - обычно это первый признак того, что мод не пережил обновление.

Если что-то не работает#

Сервер запускается, но ни один Lua-мод не работает. UE4SS не загрузился. Проверьте, что его файлы лежат в Pal/Binaries/Win64/ рядом с исполняемым файлом сервера и что UE4SS.log существует и показывает инициализацию. На Linux-сборке UE4SS не загрузится вовсе.

UE4SS загружается, а потом сервер падает. Сборка UE4SS, которая не поддерживает эту версию игры. Обновите UE4SS или уберите его, пока не появится поддерживающая сборка.

Blueprint-моды ничего не делают. BPModLoaderMod отключён, или паки лежат в ~mods вместо LogicMods.

Игроки вылетают или видят пропавшие модели. У них нет мода, который должен стоять с обеих сторон, или у них другая версия.

Изменения pak-мода не применяются. Другой pak, загруженный позже, переопределяет тот же ассет, или игра изменила таблицу данных и мод устарел.

После обновления игры сломалось всё. Ожидаемо. Запустите ванильный сервер, а затем возвращайте моды по одному по мере их обновления.

FAQ#

Поддерживает ли выделенный сервер Palworld моды официально?

Нет. Моды работают на инструментах сообщества: pak-файлах, которые загружает движок, и UE4SS для скриптов и blueprint-модов. Следите за патчноутами игры: официальную поддержку обсуждали, но сегодня серверы полагаются не на неё.

Нужны ли игрокам те же моды, что и на сервере?

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

Можно ли запустить UE4SS на сервере Palworld под Linux?

Надёжно - нет. UE4SS сделан под Windows. Серверы с модами обычно работают на Windows-сборке сервера - под Windows или под Wine на Linux.

Могут ли игроки на Xbox и PlayStation заходить на сервер с модами?

Только если все моды серверные. Игроки на консолях не могут ставить моды, поэтому любой мод, требующий установки на клиент, их исключает.

Почему мои моды перестали работать после обновления?

UE4SS и многие моды зависят от точной версии игры. После обновления их тоже нужно обновить. Храните копии рабочей конфигурации модов и обновляйтесь осознанно.