Цей посібник охоплює розширене усунення несправностей модів для серверів Project Zomboid, розміщених на Legion Hosting. Якщо ви ще не встановили моди, спочатку почніть із базового посібника зі встановлення модів. Ця стаття розглядає найпоширеніші проблеми, пов'язані з модами, які зустрічаються у тікетах підтримки Legion Hosting, включно з пошкодженням WorldDictionary, помилками формату модів, конфліктами порядку завантаження та невідповідностями версій між сервером і клієнтом.
Перш ніж почати
- Увійдіть до GPanel і виберіть ваш сервер Project Zomboid.
- Зупиніть ваш сервер перед внесенням будь-яких змін у конфігурацію чи файли.
- Зробіть резервну копію папки збереження вашого світу (
/.cache/saves/multiplayer/) через SFTP або GPanel перед спробою будь-якого виправлення. Дивіться посібник із SFTP, якщо ви не знайомі з передачею файлів. - Майте напоготові шлях до файлу
.iniвашого сервера:/.cache/server/<servername>.ini(наприклад,servertest.ini).
1. Помилки формату модів (B42 проти B41)
Найпоширеніша причина, чому моди не завантажуються — це неправильний формат у рядку Mods= файлу .ini вашого сервера. Build 42 та Build 41 використовують різний синтаксис, і їх змішування призведе до тихої невдачі завантаження ваших модів.
Формат B42 (поточний за замовчуванням)
Build 42 вимагає префікса зворотної косої риски перед кожним Mod ID у рядку Mods=:
Mods=\ModID1;\ModID2;\ModID3;
Формат DLMP поєднує Workshop ID та Mod ID з роздільником у вигляді зворотної косої риски:
Mods=2392987841\ModID1;1550458773\ModID2;2786383654\ModID3;
Рядок WorkshopItems= використовує той самий формат із роздільником у вигляді крапки з комою на обох білдах:
WorkshopItems=2392987841;1550458773;2786383654
Формат B41 (застарілий)
Build 41 використовує прості Mod ID, розділені крапкою з комою, без зворотної косої риски:
Mods=ModID1;ModID2;ModID3
Mods=, щоб включити префікс зворотної косої риски.
Як виправити
- Відкрийте
/.cache/server/<servername>.iniу Файловому менеджері GPanel. - Знайдіть рядок
Mods=і перевірте формат відповідно до прикладів вище. - Якщо формат неправильний для версії вашого білда, виправте його. Використовуйте Legion Hosting Mod Organizer, щоб автоматично згенерувати правильно відформатовані рядки.
- Збережіть файл і запустіть сервер.
2. Пошкодження WorldDictionary
WorldDictionary — це файл (WorldDictionary.bin), який зіставляє назви предметів із внутрішніми числовими ID. Коли моди додаються або видаляються, словник може пошкодитися, спричиняючи збій сервера при запуску з помилкою WorldDictionaryException.
Симптоми
- Консоль або
debug.logпоказує помилкиWorldDictionaryExceptionабоWorldDictionary. - Сервер аварійно завершує роботу одразу під час запуску, зокрема під час завантаження світу.
- Збій почався після додавання, видалення або оновлення модів.
Розуміння ризику
Кроки відновлення
- Зупиніть ваш сервер у GPanel.
- Зробіть резервну копію всієї папки збереження через SFTP: завантажте всю директорію
/.cache/saves/multiplayer/<YourWorldName>/на вашу локальну машину. - Спочатку спробуйте просто скасувати зміну моду, яка спричинила помилку. Якщо ви щойно додали мод, видаліть його як із
Mods=, так і зWorkshopItems=у файлі.ini. Якщо ви щойно видалили мод, додайте його назад. Запустіть сервер і подивіться, чи вирішено збій. - Якщо скасування зміни моду не допомагає, підключіться через SFTP і перейдіть до
/.cache/saves/multiplayer/<YourWorldName>/. - Видаліть
WorldDictionary.bin. - Запустіть сервер. Project Zomboid перегенерує словник при запуску.
- Приєднайтеся до сервера та огляньте світ на наявність пошкоджених предметів, відсутніх транспортних засобів або зламаних інвентарів. Якщо світ серйозно пошкоджено, відновіть із резервної копії, яку ви створили на кроці 2.
3. Конфлікти моду Authentic Z
Authentic Z — одна з найпопулярніших колекцій модів Project Zomboid, але вона є частим джерелом тікетів підтримки, оскільки містить кілька суб-модів, які конфліктують один з одним.
Правило
Authentic Z - Current.
Поширені помилки
- Додавання одночасно
Authentic Z - CurrentіAuthentic Z - Litemode. - Додавання суб-модів Authentic Z, призначених для однокористувацької гри, поряд із багатокористувацькою версією.
- Нерозуміння того, що різні суб-моди Authentic Z мають однаковий Workshop ID, але різні Mod ID, тож завантаження з Workshop проходить успішно, але сервер завантажує конфліктуючі файли модів.
Як виправити
- Відкрийте
/.cache/server/<servername>.iniу Файловому менеджері GPanel. - Знайдіть у рядку
Mods=кожен запис, що міститьAuthenticабоAuthenticZ. - Залиште лише один суб-мод Authentic Z (рекомендовано:
Authentic Z - Current). Видаліть усі інші записи Authentic Z як із рядківMods=, так іWorkshopItems=. - Збережіть файл і перезапустіть сервер.
4. Проблеми чутливості до регістру в Linux
Сервери Legion Hosting працюють на Linux, де імена файлів і папок є чутливими до регістру. Файл із назвою MyMod.lua та mymod.lua розглядаються як два абсолютно різні файли. Це спричиняє проблеми, коли автори модів розробляють на Windows (нечутливому до регістру), а їхні моди містять невідповідні посилання на файли.
Симптоми
- Мод чудово працює в однокористувацькій грі на вашому ПК з Windows, але не працює на сервері.
- Консоль або
debug.logпоказує помилкиFileNotFoundExceptionабоcan't find file, що посилаються на скрипт Lua або текстуру всередині моду. - Помилка вказує на файл, який дійсно існує в папці моду, але з іншим регістром (наприклад, код посилається на
Items.txt, але фактичний файл називаєтьсяitems.txt).
Як діагностувати
- Перевірте консоль або файли журналів
/.cache/Logs/на наявність точного шляху до файлу, згаданого в помилці. - Підключіться через SFTP і перейдіть до папки моду за адресою
/steamapps/workshop/content/108600/<WorkshopID>/. - Порівняйте імена файлів на диску з ім'ям файлу, на яке посилається повідомлення про помилку. Шукайте відмінності в регістрі.
Як виправити
- Якщо ви можете перейменувати файл: Підключіться через SFTP і перейменуйте файл відповідно до регістру, очікуваного кодом моду. Зауважте, що це виправлення буде перезаписано, якщо мод оновиться в Steam Workshop.
- Якщо проблема в самому моді: Повідомте про помилку автору моду на сторінці Steam Workshop. Згадайте, що посилання на файл має невідповідність регістру і що воно не працює на серверах Linux. Багато авторів модів не знають про чутливість Linux до регістру.
- Як обхідний шлях: Перевірте коментарі на сторінці моду у Workshop — інші оператори серверів Linux могли опублікувати виправлення або сумісну форку моду.
5. Проблеми порядку завантаження модів
Project Zomboid завантажує моди в порядку їх появи в рядку Mods=. Деякі моди залежать від того, щоб інші моди були завантажені першими. Якщо залежність завантажується після моду, який її потребує, залежний мод може тихо не спрацювати або спричинити помилки.
Симптоми
- Функції моду працюють частково — деякі предмети чи системи з моду присутні, але інших немає.
- Консоль показує помилки
NullPointerExceptionабоattempt to index a nil value, що посилаються на скрипти Lua моду. - Помилки з'являються лише тоді, коли встановлено певну комбінацію модів, але кожен мод працює нормально окремо.
Як виправити
- Перевірте сторінку кожного моду в Steam Workshop на наявність розділу "Required Mods" або "Load Order". Багато авторів модів вказують, які моди повинні бути завантажені перед їхніми.
- Відкрийте
/.cache/server/<servername>.iniі знайдіть рядокMods=. - Перевпорядкуйте записи так, щоб моди-залежності з'являлися перед модами, які їх потребують. Наприклад, якщо Mod B потребує Mod A, рядок має читатися
Mods=\ModA;\ModB;(формат B42). - Фреймворкові та бібліотечні моди (такі як
ModFramework,TsarLibабоShark's Mod Utils) завжди повинні бути вказані першими в рядкуMods=. - Збережіть файл і перезапустіть сервер.
6. Збої сервера після додавання модів
Якщо ваш сервер працював нормально і аварійно завершує роботу після додавання одного або кількох модів, новий мод, ймовірно, є причиною. Цей розділ описує процес ізоляції проблемного моду.
Покрокова ізоляція
- Зупиніть сервер у GPanel.
- Відкрийте
/.cache/server/<servername>.iniу Файловому менеджері. - Занотуйте всі моди, які ви щойно додали. Видаліть усі з них як із рядків
Mods=, так іWorkshopItems=. - Запустіть сервер. Якщо він запускається успішно, проблема в одному з модів, які ви видалили.
- Додавайте моди назад по одному, перезапускаючи сервер після кожного додавання. Коли збій повертається, останній доданий мод і є причиною.
- Після ідентифікації перевірте сторінку моду у Workshop на наявність:
- Примітки про сумісність із B42 — багато модів B41 не оновлено для B42.
- Відомих конфліктів з іншими модами, які ви запускаєте.
- Необхідних модів-залежностей, які ви, можливо, не встановили.
Читання журналу збоїв
Перш ніж виконувати процес ізоляції, перевірте журнал збоїв — він часто вказує безпосередньо на проблемний мод:
- У GPanel відкрийте вкладку Console і прокрутіть до кінця виводу.
- Шукайте рядки
STACK TRACE,ExceptionабоERROR. - Рядки безпосередньо над трасуванням стека зазвичай посилаються на ім'я файлу моду або Mod ID — це говорить вам, який мод спричинив збій.
- Для більш детальної інформації відкрийте повний файл журналу через SFTP за адресою
/.cache/Logs/і перевірте найновіший файлDebugLog-server.txtабоdebug.log.
7. Невідповідності версій модів (сервер проти клієнта)
Project Zomboid вимагає, щоб сервер і всі підключені клієнти мали однакову версію кожного моду. Якщо мод оновлюється в Steam Workshop, і сервер завантажує нову версію, але гравець усе ще має стару версію в кеші (або навпаки), виникнуть помилки підключення або збої.
Симптоми
- Гравці отримують помилку "Mod mismatch" або "Version mismatch" при спробі підключитися.
- Деякі гравці можуть підключитися, а інші — ні; ті, хто не може підключитися, мають іншу версію моду в локальному кеші.
- Сервер працював нормально, потім мод оновився в Steam Workshop, і раптом деякі гравці не можуть приєднатися.
- Гравці бачать відсутні текстури, предмети або зламані елементи інтерфейсу від модів, які нещодавно оновилися.
Виправлення для операторів серверів
- Зупиніть сервер у GPanel.
- Запустіть сервер знову. При запуску сервер повторно завантажує найновіші версії всіх модів Workshop. Це гарантує, що сервер працює з найновішою версією.
- Якщо сервер усе ще має стару версію в кеші, підключіться через SFTP і видаліть конкретну папку кешу Workshop моду за адресою
/steamapps/workshop/content/108600/<WorkshopID>/. Перезапустіть сервер, щоб примусово виконати чисте завантаження.
Виправлення для гравців
Гравці, які не можуть підключитися через невідповідності версій модів, повинні:
- Відкрити Steam і перейти до Library → Project Zomboid.
- Клацнути правою кнопкою миші на Project Zomboid, вибрати Properties → Local Files → Verify Integrity of Game Files.
- Також перейти до папки Steam Workshop для Project Zomboid на їхній локальній машині та видалити кешовані файли модів, щоб примусово виконати повторне завантаження.
- Запустити гру та підключитися до сервера знову.
/.cache/mods/ на сервері замість використання автоматичного оновлення Workshop. Видаліть відповідний Workshop ID з рядка WorkshopItems=, щоб запобігти автоматичним оновленням. Дивіться посібник зі встановлення модів для інструкцій зі встановлення модів не з Workshop.
8. Очищення кешу Steam Workshop
Якщо численні проблеми з модами зберігаються, і ви підозрюєте, що кеш завантаження Workshop пошкоджено, ви можете примусово виконати повне повторне завантаження всіх модів Workshop.
- Зупиніть сервер у GPanel.
- Підключіться через SFTP і перейдіть до
/steamapps/workshop/. - Видаліть всю папку
workshop/(або її вміст). - Запустіть сервер. Steam повторно завантажить усі елементи Workshop з нуля.
- Спостерігайте за Console у GPanel, щоб підтвердити, що всі моди завершили завантаження, перш ніж сервер почне завантаження світу.
Швидкий діагностичний довідник
| Що ви бачите | Найбільш імовірна причина | Розділ |
|---|---|---|
| Моди не завантажуються, помилок у журналі немає | Неправильний формат моду (формат B41 на сервері B42 або навпаки) | 1. Помилки формату модів |
WorldDictionaryException у консолі |
Пошкодження WorldDictionary через додавання/видалення модів | 2. Пошкодження WorldDictionary |
| Збій сервера з кількома суб-модами Authentic Z | Конфліктуючі суб-моди Authentic Z, завантажені одночасно | 3. Конфлікти Authentic Z |
FileNotFoundException для файлу моду, який існує |
Невідповідність чутливості до регістру в Linux | 4. Проблеми чутливості до регістру |
Помилки NullPointerException або nil value від модів |
Неправильний порядок завантаження модів або відсутня залежність | 5. Проблеми порядку завантаження |
STACK TRACE після додавання нових модів |
Несумісний або конфліктуючий мод | 6. Збої після додавання модів |
| "Mod mismatch" або "Version mismatch" при підключенні | Сервер і клієнт мають різні версії модів | 7. Невідповідності версій |
| Численні проблеми з модами, ніщо інше не працює | Пошкоджений кеш Workshop | 8. Кеш Workshop |
Усе ще маєте проблеми з модами?
Якщо ваша проблема з модом не охоплена вище або виправлення не вирішили її, відкрийте тікет підтримки з такою інформацією, щоб допомогти команді підтримки швидко діагностувати проблему:
- Версія білда вашого сервера (B41 або B42), що відображається в консолі при запуску
- Повні рядки
Mods=таWorkshopItems=з вашого файлу.ini - Останні 50 рядків виводу консолі GPanel на момент збою
- Вміст найновішого файлу журналу в
/.cache/Logs/ - Які моди було додано, видалено або оновлено безпосередньо перед тим, як почалася проблема
- Чи виникає проблема при запуску, чи лише коли гравці підключаються
Відкрийте тікет підтримки і вкажіть ID вашого сервера та деталі, перелічені вище.