Цей посібник проведе вас через встановлення модів Steam Workshop на ваш сервер Project Zomboid, розміщений на Legion Hosting. Він охоплює формати модів B42 та B41, інструмент Legion Hosting Mod Organizer, примітки щодо сумісності для великих наборів модів та способи відновлення після поширеного пошкодження світу, пов'язаного з модами.

Передумови

• Активний сервер Project Zomboid з Legion Hosting, доступний за адресою gpanel.legionhosting.net
• Ваш сервер має бути Offline перед редагуванням налаштувань модів — спочатку зупиніть його в GPanel
• ID Steam Workshop та ID моду для кожного моду, який ви хочете встановити (знаходяться на сторінці Steam Workshop кожного моду)
• Резервна копія вашого поточного збереження світу (наполегливо рекомендовано — див. попередження вище)

Крок 1 — Знайдіть ID Workshop та ID моду для кожного моду

Кожен мод, який ви хочете встановити, потребує двох окремих ідентифікаторів:

• ID Workshop — числовий ID в URL-адресі Steam Workshop, наприклад, https://steamcommunity.com/sharedfiles/filedetails/?id=2392987841
• ID моду — внутрішній ID, визначений автором моду, що знаходиться в описі моду на сторінці Workshop, зазвичай зазначений як "Mod ID:" або всередині файлу моду mod.info

Запишіть обидва ID для кожного моду перед продовженням. Один елемент Workshop іноді містить кілька субмодів, кожен зі своїм ID моду.

Крок 2 — Використайте Legion Hosting Mod Organizer (Рекомендовано)

Найпростіший спосіб скласти список модів — це Legion Hosting Zomboid Mod Organizer. Він дозволяє шукати в Workshop, додавати моди за URL-адресою чи ID та автоматично генерує правильно відформатовані рядки конфігурації, які вам потрібно вставити в GPanel.

1. Перейдіть на legionhosting.net/zomboid-mod-organizer.php.
2. Шукайте моди за назвою або вставте URL-адресу Steam Workshop у поле пошуку.
3. Додайте кожен мод до вашого списку за допомогою кнопки Add.
4. Коли ваш список буде завершено, натисніть Generate Config. Інструмент виведе готові до використання рядки WorkshopItems та Mods, відформатовані для версії збірки вашого сервера.
5. Скопіюйте згенеровані рядки та перейдіть до Кроку 4, щоб вставити їх у налаштування вашого сервера.

Якщо ви віддаєте перевагу вводити ID вручну, продовжуйте з Кроком 3, щоб правильно відформатувати їх для версії вашої збірки.

Крок 3 — Правильно відформатуйте список модів

WorkshopItems (однаково для всіх збірок)

Рядок WorkshopItems використовує крапку з комою для розділення ID Workshop. Цей формат однаковий як для B41, так і для B42:

Mods — Формат Build 42 (B42)

B42 використовує префікс зворотної косої риски (\) перед кожним ID моду:

Формат DLMP (B42)

Деякі конфігурації використовують формат DLMP, який поєднує ID Workshop та ID модів зі зворотною косою рискою в одному полі:

Mods — Формат Build 41 (B41)

B41 використовує прості ID модів, розділені крапкою з комою, без префікса зворотної косої риски:

Крок 4 — Застосуйте список модів у файлі налаштувань вашого сервера

1. Увійдіть до GPanel та виберіть ваш сервер Project Zomboid.
2. Переконайтеся, що сервер Offline. Зупиніть його за потреби.
3. Відкрийте File Manager та перейдіть до /.cache/server/.
4. Відкрийте файл налаштувань вашого сервера — він називається <servername>.ini (наприклад, servertest.ini).
5. Знайдіть рядки WorkshopItems= та Mods= у файлі. Вставте значення, які ви згенерували на Кроці 2 або відформатували на Кроці 3.
6. Збережіть файл.
7. Запустіть сервер. Завантаження Steam Workshop почнуться автоматично під час запуску.

Крок 5 — Додавайте моди поступово та тестуйте

Не додавайте весь бажаний список модів одразу, особливо на активному сервері або при роботі з великою колекцією. Натомість:

1. Додавайте не більше 3–5 модів за раз.
2. Запустіть сервер та підтвердіть, що він досягає статусу Running і що ви можете підключитися та грати.
3. Перевірте Console GPanel на наявність будь-яких повідомлень про помилки чи трасування стеку перед додаванням наступної партії.
4. Повторюйте, доки всі моди не будуть завантажені та стабільні.

Цей підхід значно полегшує визначення того, який мод спричиняє проблему, якщо щось піде не так.

Встановлення модів не з Workshop

Якщо у вас є мод, якого немає в Steam Workshop (завантажений як папка або ZIP-файл), завантажте його через SFTP за таким шляхом на вашому сервері:

Розмістіть папку моду (яка має містити файл mod.info) безпосередньо всередині /.cache/mods/. Ви можете отримати доступ до цього каталогу за допомогою облікових даних SFTP, показаних у GPanel на вкладці SFTP. Після завантаження додайте ID моду (з файлу моду mod.info) до рядка Mods= у вашій конфігурації сервера, як описано в Кроці 4. Для модів не з Workshop не потрібен ID Workshop.

Примітка щодо сумісності Authentic Z

Authentic Z — один із найпопулярніших наборів модів Project Zomboid, але він складається з багатьох субмодів. Встановлюйте лише один субмод за раз, а рекомендованим субмодом для багатокористувацьких серверів є:

Не вмикайте кілька субмодів Authentic Z одночасно на одному сервері. Запуск більше ніж одного субмода з цієї колекції спричиняє конфлікти, які можуть призвести до збою сервера або пошкодження таблиць лута. Якщо ви не впевнені, який субмод активний, перевірте рядок Mods= у вашій конфігурації та переконайтеся, що в списку зазначено лише Authentic Z - Current (або ваш єдиний обраний субмод).

Перевірка

Після запуску сервера з вашими новими модами підтвердіть, що вони успішно завантажилися:

1. У GPanel відкрийте вкладку Console та спостерігайте за журналом запуску. Шукайте рядки, що згадують завантаження кожного моду — ви маєте побачити щось на кшталт [ModLoader] Loading mod: ModID для кожного встановленого моду.
2. Підключіться до сервера у грі та відкрийте меню Mods з головного меню (Esc → Mods). Встановлені моди мають з'явитися у списку.
3. Знайдіть у журналі Console фразу STACK TRACE. Якщо вона не з'являється, сервер запустився чисто. Якщо ви бачите її, зверніть увагу на мод, згаданий близько до верху трасування — цей мод є ймовірною причиною проблеми.
4. Походіть у грі та підтвердіть, що доданий модом контент (предмети, будівлі, зомбі) з'являється, як очікувалося.

Усунення несправностей

Моди не завантажуються / сервер запускається, але моди здаються неактивними

• Переконайтеся, що рядок Mods використовує правильний формат для вашої збірки — префікс зворотної косої риски (\ModID) для B42, прості ID модів для B41. Формат WorkshopItems однаковий для обох збірок.
• Підтвердіть, що ID моду в рядку Mods= точно збігається з ID, показаним в описі Workshop моду або файлі mod.info. ID модів чутливі до регістру.
• Перевірте, що обидва поля WorkshopItems та Mods збережені — перейдіть в інше місце та назад у GPanel, щоб підтвердити, що значення збереглися.

Завантаження Steam Workshop не вдається / моди не завантажуються під час запуску

Якщо сервер запускається, але моди Workshop, схоже, не завантажуються, папка кешу Steam може бути пошкоджена. Щоб це виправити:

1. Зупиніть сервер у GPanel.
2. Підключіться через SFTP та перейдіть до /steamapps/workshop/.
3. Видаліть всю папку workshop/ (або її вміст).
4. Запустіть сервер знову. Steam повторно завантажить усі елементи Workshop з нуля.

WorldDictionaryException / пошкодження словника світу

Якщо журнал Console показує помилку WorldDictionaryException, словник світу був пошкоджений — це може статися при додаванні або видаленні модів, які вводять нові предмети чи тайли.

Якщо ви маєте спробувати відновлення:

1. Зупиніть сервер у GPanel.
2. Зробіть резервну копію всієї вашої папки збереження через SFTP або GPanel Backups.
3. Підключіться через SFTP та перейдіть до /.cache/saves/multiplayer/<YourWorldName>/.
4. Видаліть WorldDictionary.bin.
5. Запустіть сервер. Project Zomboid регенерує словник під час запуску.
6. Перевірте у грі наявність пошкоджених предметів чи транспортних засобів. Якщо світ серйозно пошкоджено, відновіть із резервної копії, яку ви створили на кроці 2.

Сервер аварійно завершує роботу під час запуску з STACK TRACE у журналі консолі

Трасування стеку одразу після запуску зазвичай вказує на конфлікт модів або мод, несумісний із вашою поточною версією збірки. Щоб діагностувати:

1. У GPanel відкрийте журнал Console та знайдіть STACK TRACE.
2. Прочитайте рядки над трасуванням щодо згаданої назви файлу моду або ID моду — це зазвичай проблемний мод.
3. Видаліть цей мод з обох рядків WorkshopItems та Mods, збережіть та перезапустіть сервер.
4. Якщо сервер запускається чисто після видалення, перевірте сторінку Workshop моду на наявність сумісного з B42 оновлення або відомої примітки про конфлікт у коментарях.

Ви також можете відкрити повний файл debug.log через SFTP за адресою /.cache/Logs/<date>_DebugLog-server.txt для отримання більшої деталізації, ніж показує консоль GPanel.

Сервер аварійно завершує роботу, коли підключаються гравці з певними модами

Якщо сервер працює чисто, але аварійно завершує роботу, коли приєднується гравець, гравець може мати клієнтські моди, які конфліктують із сервером. Попросіть гравця вимкнути всі його локальні моди Project Zomboid у внутрішньоігровому меню Mods та спробувати підключитися знову. Якщо збій припиняється, гравець має повторно вмикати моди по одному, щоб знайти конфліктний мод.

Мод видалено, але сервер все ще намагається його завантажити

Якщо ви видалили ID моду з конфігурації, але сервер все ще посилається на нього під час запуску, елемент Workshop може все ще бути в кеші. Видаліть конкретну папку елемента Workshop з /steamapps/workshop/content/108600/<workshopID>/ через SFTP, потім перезапустіть сервер.