Установка модов на сервер Project Zomboid в панели Pterodactyl

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску

Инструкция, как поставить моды на сервер Project Zomboid в панели управления Pterodactyl. Сервер уже должен быть установлен — это описано в статье Установка сервера Project Zomboid в панели Pterodactyl. Все снимки экрана сняты с настоящей панели: инструкция проверена 21 ноября 2026 года на Pterodactyl 1.15.2 с сервером Project Zomboid 42.22.2.

Моды Project Zomboid берут из Мастерской Steam. Загружать файлы на сервер не нужно: достаточно вписать номера модов в файл настроек, и сервер сам скачает их при запуске. Игрокам ставить моды вручную тоже не нужно — игра скачивает их из Мастерской при входе на сервер.

1. Узнайте два идентификатора мода

У каждого мода их два, и серверу нужны оба:

Идентификатор Что это Где взять
Workshop ID Номер страницы мода в Мастерской. По нему сервер скачивает файлы Число в конце адреса страницы мода: …/filedetails/?id=2544353492. Оно же стоит внизу описания, строкой «Workshop ID: …»
Mod ID Внутреннее имя мода. По нему сервер включает мод Указан внизу описания мода в Мастерской, строкой «Mod ID: …»

Для примера взят мод Has Been Read — он помечает уже прочитанные книги. Его Workshop ID — 2544353492, Mod ID — P4HasBeenRead.

На странице мода посмотрите метки версии игры: мод должен подходить к сборке вашего сервера (Build 41 или Build 42). В одном моде Мастерской бывает несколько Mod ID — отдельные части или варианты; автор пишет в описании, какие из них включать.

2. Впишите мод в файл настроек

Остановите сервер кнопкой Stop. На вкладке Files откройте папку .cache/Server и в ней файл ИМЯ.ini — его имя совпадает с полем «Server Name» на вкладке Startup, на снимках это arkhoster.ini:

В файле нужны две строки. В строку Mods= впишите Mod ID:

В строку WorkshopItems= — Workshop ID:

Нажмите Save Content. Несколько модов перечисляют через точку с запятой, без пробелов:

Mods=P4HasBeenRead;ВторойМод;ТретийМод
WorkshopItems=2544353492;1111111111;2222222222

Порядок в строке Mods= — это порядок загрузки модов: если мод зависит от другого, тот должен стоять раньше.

Для мода с картой заполняют ещё и строку Map=: имя папки карты из мода ставят перед Muldraugh, KY, через точку с запятой.

3. Запустите сервер и проверьте мод

Запустите сервер кнопкой Start. В консоли видно, как он скачивает мод и включает его:

Workshop: onItemDownloaded itemID=2544353492
Workshop: 2544353492 installed to /home/container/steamapps/workshop/content/108600/2544353492
LOG  : Mod … loading P4HasBeenRead

Дождитесь строки «*** SERVER STARTED ****». Скачанные моды лежат в папке steamapps/workshop/content/108600 — по папке на каждый Workshop ID:

При проверке сервер с модом ответил на запрос снаружи, с другого компьютера: в сведениях о сервере значилось «modCount = 1, mods = P4HasBeenRead». Игроки видят список модов сервера в игре, в окне сведений о сервере.

Обновление и удаление модов

Сервер проверяет Мастерскую при каждом запуске и скачивает свежие версии модов. Когда автор обновил мод, игроки с новой версией не смогут войти на сервер со старой — перезапустите сервер кнопкой Restart.

Узнать, вышло ли обновление, можно не останавливая сервер: введите в строку под консолью панели команду checkModsNeedUpdate. Ответ «CheckModsNeedUpdate: Mods updated» означает, что все моды свежие:

Что нужно Как сделать
Добавить ещё один мод Остановите сервер, допишите Mod ID в Mods= и Workshop ID в WorkshopItems= через точку с запятой, запустите сервер
Выключить мод Остановите сервер и уберите мод из обеих строк. При проверке после этого сервер запустился без мода: в сведениях о сервере стало «modCount = 0»
Удалить файлы мода Выключенный мод остаётся на диске. Удалите его папку с номером Workshop ID из steamapps/workshop/content/108600
Скачать мод заново Остановите сервер, удалите папку мода из steamapps/workshop/content/108600 и запустите сервер — он скачает мод снова

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

Если что-то пошло не так

Что видите Причина и решение
Мод скачался, но строки «loading …» с его именем в консоли нет В строке Mods= вписан не Mod ID, а номер или название мода, либо в имени ошибка. Точное имя — в описании мода и в файле mod.info внутри его папки, строка id=.
Строки «Workshop: … installed» нет, папка мода не появилась В строке WorkshopItems= неверный номер, либо правку сделали при работающем сервере и он записал файл поверх. Остановите сервер и проверьте обе строки.
При загрузке мода в консоли строки «NoSuchFileException … media/AnimSets» Сервер ищет в моде папки, которых в нём нет. Это не ошибка мода: при проверке сервер с такими строками запустился и мод работал.
Сервер с модом не доходит до «SERVER STARTED» Мод не подходит к версии игры или ему нужен другой мод — он указан на странице мода в Мастерской, в блоке зависимостей справа. Добавьте его в обе строки, либо уберите мод.
Игрока не пускает на сервер после обновления мода У сервера осталась старая версия. Перезапустите его кнопкой Restart.

Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU: