Розпродаж Black Friday 50% знижка на всі сервери Останній день!
Завершується через: 00D 00H 00M 00S
background image
Game Servers 380 7 Days to Die 4 Abiotic Factor 2 Aloft 2 alt:V 2 Americas Army Proving Grounds 2 Among Us 2 Archean 2 ARK Survival Ascended 6 ARK Survival Evolved 3 Arma 3 3 Arma Reforger 2 Aska 2 AssaultCube 2 Assetto Corsa 3 Astro Colony 2 Astroneer 2 Automobilista 2 2 Avorion 2 Banana Shooter 2 Barotrauma 3 BATTALION Legacy 2 BeamNG.drive (BeamMP) 2 Black Mesa 2 Brickadia 2 Call of Duty 2 Citadel: Forged with Fire 2 ClassiCube 2 Clone Hero 2 Colony Survival 2 Conan Exiles 4 Contagion 2 Core Keeper 2 Counter-Strike 2 3 Craftopia 2 CryoFall 2 CS2D 2 Cube 2: Sauerbraten 2 Cubic Odyssey 2 DayZ 4 DDNet 2 DDRaceNetwork 2 Dead Matter 2 Dont Starve Together 4 Eco 2 Empyrion Galactic Survival 2 Enshrouded 3 Escape from Tarkov 2 Euro Truck Simulator 2 2 Factorio 2 Farming Simulator 25 2 Fistful of Frags 2 FiveM 3 FortressCraft Evolved 2 Foundry 2 Foundry VTT 2 Frozen Flame 2 FTL Tachyon 2 Garrys Mod 3 Ground Branch 2 Half-Life 2 Deathmatch 2 Hogwarp 2 Holdfast: Nations at War 2 HumanitZ 2 Hurtworld 2 Hytale 1 Icarus 2 Insurgency Sandstorm 2 IOSoccer 2 Just Cause 3 Multiplayer 2 Kerbal Space Program 2 Killing Floor 2 3 LeagueSandbox 2 Left 4 Dead 2 Left 4 Dead 2 3 Longvinter 2 Los Angeles Crimes 2 Medal of Honor 2 Midnight Ghost Hunt 2 Mindustry 2 Minecraft 4 Minetest 2 Modiverse 2 Mordhau 3 Mount & Blade II: Bannerlord 2 Myth of Empires 2 Nazi Zombies Portable 2 Necesse 2 NeosVR 2 Neverwinter Nights EE 2 Night of the Dead 2 Nightingale 2 No Love Lost 2 No More Room in Hell 2 No One Survived 2 Nova-Life Amboise 2 Nuclear Option 2 Onset 2 Open Fortress 2 OpenArena 2 OpenRA 2 OpenRCT2 2 OpenTTD 2 Operation Harsh Doorstop 2 Palworld 3 Path of Titans 2 Pavlov VR 3 PixARK 2 Plains of Pain 2 Portal Knights 2 Post Scriptum 2 Project Zomboid 8 Puck 2 Quake Live 2 R5Reloaded 2 RedM 2 Renown 2 Resonite 2 Return to Moria 2 Rimworld Together 2 Rising World 2 Risk of Rain 2 1 Rust 4 Satisfactory 1 SCP Secret Laboratory 3 SCUM 2 Smalland 2 Solace Crafting 2 Soldat 2 Soldat 2 2 Sonic Robo Blast 2 2 Sons of the Forest 2 Soulmask 2 SourceCoop 2 Space Engineers 3 Space Station 14 2 Squad 3 Starbound 3 StarMade 2 Stationeers 2 Stormworks 2 Subnautica Nitrox 2 Sunkenland 2 SuperTuxKart 2 Sven Co-op 2 Swords 'n Magic and Stuff 2 Team Fortress 2 3 Teeworlds 2 Terraria 3 TerraTech Worlds 2 TF2 Classified 2 The Forest 3 The Front 2 The Isle 2 Tower Unite 2 Trackmania 2 Unturned 4 Urban Terror 2 V Rising 3 Valheim 3 VEIN 2 Veloren 2 Vintage Story 3 Voyagers of Nera 2 Wolfenstein: Enemy Territory 2 Wreckfest 2 Wurm Unlimited 2 Xonotic 2 Zandronum 2 Getting Started 2 Network & Connectivity 1 Server Management 2
Категорії

Усунення несправностей модів Project Zomboid

UK zomboid pz mods troubleshooting worlddictionary 0 вважають це корисним

Цей посібник охоплює розширене усунення несправностей модів для серверів Project Zomboid, розміщених на Legion Hosting. Якщо ви ще не встановили моди, спочатку почніть із базового посібника зі встановлення модів. Ця стаття розглядає найпоширеніші проблеми, пов'язані з модами, які зустрічаються у тікетах підтримки Legion Hosting, включно з пошкодженням WorldDictionary, помилками формату модів, конфліктами порядку завантаження та невідповідностями версій між сервером і клієнтом.

Моди — проблема підтримки №1. Приблизно 14% усіх тікетів підтримки 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
Не змішуйте формати. Використання формату B41 на сервері B42 (або навпаки) є єдиною найпоширенішою причиною тікетів про "моди не завантажуються". Якщо ви нещодавно оновилися з B41 до B42, ви повинні переформатувати весь рядок Mods=, щоб включити префікс зворотної косої риски.

Як виправити

  1. Відкрийте /.cache/server/<servername>.ini у Файловому менеджері GPanel.
  2. Знайдіть рядок Mods= і перевірте формат відповідно до прикладів вище.
  3. Якщо формат неправильний для версії вашого білда, виправте його. Використовуйте Legion Hosting Mod Organizer, щоб автоматично згенерувати правильно відформатовані рядки.
  4. Збережіть файл і запустіть сервер.

2. Пошкодження WorldDictionary

WorldDictionary — це файл (WorldDictionary.bin), який зіставляє назви предметів із внутрішніми числовими ID. Коли моди додаються або видаляються, словник може пошкодитися, спричиняючи збій сервера при запуску з помилкою WorldDictionaryException.

Симптоми

  • Консоль або debug.log показує помилки WorldDictionaryException або WorldDictionary.
  • Сервер аварійно завершує роботу одразу під час запуску, зокрема під час завантаження світу.
  • Збій почався після додавання, видалення або оновлення модів.

Розуміння ризику

Видалення WorldDictionary.bin — це крайній захід. WorldDictionary зіставляє кожен предмет та транспортний засіб у вашому світі з внутрішніми ID. Його видалення змушує сервер перегенерувати зіставлення, що може спричинити пошкодження наявних предметів, зникнення транспортних засобів або наявність неправильних предметів в інвентарях. Робіть це, лише якщо сервер абсолютно не запускається і у вас є резервна копія папки збереження.

Кроки відновлення

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

3. Конфлікти моду Authentic Z

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

Правило

Встановлюйте лише ОДИН суб-мод Authentic Z. Одночасний запуск кількох суб-модів Authentic Z спричиняє збої сервера, пошкодження таблиць лута та помилки дублювання предметів. Рекомендований суб-мод для багатокористувацьких серверів — Authentic Z - Current.

Поширені помилки

  • Додавання одночасно Authentic Z - Current і Authentic Z - Litemode.
  • Додавання суб-модів Authentic Z, призначених для однокористувацької гри, поряд із багатокористувацькою версією.
  • Нерозуміння того, що різні суб-моди Authentic Z мають однаковий Workshop ID, але різні Mod ID, тож завантаження з Workshop проходить успішно, але сервер завантажує конфліктуючі файли модів.

Як виправити

  1. Відкрийте /.cache/server/<servername>.ini у Файловому менеджері GPanel.
  2. Знайдіть у рядку Mods= кожен запис, що містить Authentic або AuthenticZ.
  3. Залиште лише один суб-мод Authentic Z (рекомендовано: Authentic Z - Current). Видаліть усі інші записи Authentic Z як із рядків Mods=, так і WorkshopItems=.
  4. Збережіть файл і перезапустіть сервер.

4. Проблеми чутливості до регістру в Linux

Сервери Legion Hosting працюють на Linux, де імена файлів і папок є чутливими до регістру. Файл із назвою MyMod.lua та mymod.lua розглядаються як два абсолютно різні файли. Це спричиняє проблеми, коли автори модів розробляють на Windows (нечутливому до регістру), а їхні моди містять невідповідні посилання на файли.

Симптоми

  • Мод чудово працює в однокористувацькій грі на вашому ПК з Windows, але не працює на сервері.
  • Консоль або debug.log показує помилки FileNotFoundException або can't find file, що посилаються на скрипт Lua або текстуру всередині моду.
  • Помилка вказує на файл, який дійсно існує в папці моду, але з іншим регістром (наприклад, код посилається на Items.txt, але фактичний файл називається items.txt).

Як діагностувати

  1. Перевірте консоль або файли журналів /.cache/Logs/ на наявність точного шляху до файлу, згаданого в помилці.
  2. Підключіться через SFTP і перейдіть до папки моду за адресою /steamapps/workshop/content/108600/<WorkshopID>/.
  3. Порівняйте імена файлів на диску з ім'ям файлу, на яке посилається повідомлення про помилку. Шукайте відмінності в регістрі.

Як виправити

  • Якщо ви можете перейменувати файл: Підключіться через SFTP і перейменуйте файл відповідно до регістру, очікуваного кодом моду. Зауважте, що це виправлення буде перезаписано, якщо мод оновиться в Steam Workshop.
  • Якщо проблема в самому моді: Повідомте про помилку автору моду на сторінці Steam Workshop. Згадайте, що посилання на файл має невідповідність регістру і що воно не працює на серверах Linux. Багато авторів модів не знають про чутливість Linux до регістру.
  • Як обхідний шлях: Перевірте коментарі на сторінці моду у Workshop — інші оператори серверів Linux могли опублікувати виправлення або сумісну форку моду.
Це не проблема конфігурації сервера. Проблеми чутливості до регістру — це помилки в самому моді. Немає нічого, що ви можете змінити в налаштуваннях вашого сервера, щоб обійти мод, який посилається на файли з неправильним регістром. Виправлення має надійти від автора моду або через ручне перейменування файлу.

5. Проблеми порядку завантаження модів

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

Симптоми

  • Функції моду працюють частково — деякі предмети чи системи з моду присутні, але інших немає.
  • Консоль показує помилки NullPointerException або attempt to index a nil value, що посилаються на скрипти Lua моду.
  • Помилки з'являються лише тоді, коли встановлено певну комбінацію модів, але кожен мод працює нормально окремо.

Як виправити

  1. Перевірте сторінку кожного моду в Steam Workshop на наявність розділу "Required Mods" або "Load Order". Багато авторів модів вказують, які моди повинні бути завантажені перед їхніми.
  2. Відкрийте /.cache/server/<servername>.ini і знайдіть рядок Mods=.
  3. Перевпорядкуйте записи так, щоб моди-залежності з'являлися перед модами, які їх потребують. Наприклад, якщо Mod B потребує Mod A, рядок має читатися Mods=\ModA;\ModB; (формат B42).
  4. Фреймворкові та бібліотечні моди (такі як ModFramework, TsarLib або Shark's Mod Utils) завжди повинні бути вказані першими в рядку Mods=.
  5. Збережіть файл і перезапустіть сервер.
Порада: Legion Hosting Mod Organizer може допомогти вам керувати та організовувати ваш список модів. Використовуйте його для генерації чистих, правильно відформатованих рядків конфігурації.

6. Збої сервера після додавання модів

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

Покрокова ізоляція

  1. Зупиніть сервер у GPanel.
  2. Відкрийте /.cache/server/<servername>.ini у Файловому менеджері.
  3. Занотуйте всі моди, які ви щойно додали. Видаліть усі з них як із рядків Mods=, так і WorkshopItems=.
  4. Запустіть сервер. Якщо він запускається успішно, проблема в одному з модів, які ви видалили.
  5. Додавайте моди назад по одному, перезапускаючи сервер після кожного додавання. Коли збій повертається, останній доданий мод і є причиною.
  6. Після ідентифікації перевірте сторінку моду у Workshop на наявність:
    • Примітки про сумісність із B42 — багато модів B41 не оновлено для B42.
    • Відомих конфліктів з іншими модами, які ви запускаєте.
    • Необхідних модів-залежностей, які ви, можливо, не встановили.

Читання журналу збоїв

Перш ніж виконувати процес ізоляції, перевірте журнал збоїв — він часто вказує безпосередньо на проблемний мод:

  1. У GPanel відкрийте вкладку Console і прокрутіть до кінця виводу.
  2. Шукайте рядки STACK TRACE, Exception або ERROR.
  3. Рядки безпосередньо над трасуванням стека зазвичай посилаються на ім'я файлу моду або Mod ID — це говорить вам, який мод спричинив збій.
  4. Для більш детальної інформації відкрийте повний файл журналу через SFTP за адресою /.cache/Logs/ і перевірте найновіший файл DebugLog-server.txt або debug.log.
Додавайте моди невеликими партіями. Додавання 3-5 модів за раз і тестування між партіями робить ізоляцію збоїв значно легшою, ніж додавання 20+ модів одночасно та спроба знайти винуватця.

7. Невідповідності версій модів (сервер проти клієнта)

Project Zomboid вимагає, щоб сервер і всі підключені клієнти мали однакову версію кожного моду. Якщо мод оновлюється в Steam Workshop, і сервер завантажує нову версію, але гравець усе ще має стару версію в кеші (або навпаки), виникнуть помилки підключення або збої.

Симптоми

  • Гравці отримують помилку "Mod mismatch" або "Version mismatch" при спробі підключитися.
  • Деякі гравці можуть підключитися, а інші — ні; ті, хто не може підключитися, мають іншу версію моду в локальному кеші.
  • Сервер працював нормально, потім мод оновився в Steam Workshop, і раптом деякі гравці не можуть приєднатися.
  • Гравці бачать відсутні текстури, предмети або зламані елементи інтерфейсу від модів, які нещодавно оновилися.

Виправлення для операторів серверів

  1. Зупиніть сервер у GPanel.
  2. Запустіть сервер знову. При запуску сервер повторно завантажує найновіші версії всіх модів Workshop. Це гарантує, що сервер працює з найновішою версією.
  3. Якщо сервер усе ще має стару версію в кеші, підключіться через SFTP і видаліть конкретну папку кешу Workshop моду за адресою /steamapps/workshop/content/108600/<WorkshopID>/. Перезапустіть сервер, щоб примусово виконати чисте завантаження.

Виправлення для гравців

Гравці, які не можуть підключитися через невідповідності версій модів, повинні:

  1. Відкрити Steam і перейти до Library → Project Zomboid.
  2. Клацнути правою кнопкою миші на Project Zomboid, вибрати Properties → Local Files → Verify Integrity of Game Files.
  3. Також перейти до папки Steam Workshop для Project Zomboid на їхній локальній машині та видалити кешовані файли модів, щоб примусово виконати повторне завантаження.
  4. Запустити гру та підключитися до сервера знову.
Фіксуйте версії модів, коли це можливо. Якщо критичний мод часто оновлюється і спричиняє повторювані проблеми невідповідності, розгляньте можливість завантаження конкретної версії моду вручну та її завантаження до /.cache/mods/ на сервері замість використання автоматичного оновлення Workshop. Видаліть відповідний Workshop ID з рядка WorkshopItems=, щоб запобігти автоматичним оновленням. Дивіться посібник зі встановлення модів для інструкцій зі встановлення модів не з Workshop.

8. Очищення кешу Steam Workshop

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

Це видаляє всі кешовані файли Workshop. Сервер повторно завантажить кожен підписаний елемент Workshop при наступному запуску. Для великих списків модів це може додати кілька хвилин до часу запуску.
  1. Зупиніть сервер у GPanel.
  2. Підключіться через SFTP і перейдіть до /steamapps/workshop/.
  3. Видаліть всю папку workshop/ (або її вміст).
  4. Запустіть сервер. Steam повторно завантажить усі елементи Workshop з нуля.
  5. Спостерігайте за 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 вашого сервера та деталі, перелічені вище.


Чи була ця стаття корисною?

Готові почати?

Сервери вже запущені — оберіть тариф і станьте нашим наступним задоволеним клієнтом.