Установка модов на сервер Project Zomboid в панели Pterodactyl
Инструкция, как поставить моды на сервер 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:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов