Серверы Project Zomboid могут крашиться или не запускаться по нескольким хорошо известным причинам. Это руководство охватывает наиболее частые причины, встречающиеся в тикетах поддержки Legion Hosting — от бага с памятью в Build 42, требующего дополнительной RAM при запуске, до переполнения резервными копиями, заполняющего /tmp, и повреждённых файлов конфигурации. Прорабатывайте разделы ниже по порядку.

Прежде чем начать — найдите логи крашей

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

Вывод консоли GPanel

1. Войдите в GPanel.
2. Выберите ваш сервер Project Zomboid из списка серверов.
3. Нажмите на вкладку Console.
4. Прокрутите до конца вывода. Ищите строки, помеченные ERROR, FATAL, OutOfMemoryError или Exception. Последние 20–30 строк перед остановкой сервера обычно наиболее значимы.
5. Если консоль пуста, процесс сервера завершился раньше, чем смог что-либо записать — это само по себе подсказка (см. раздел о памяти B42 ниже).

Файл сервера debug.log

Project Zomboid записывает подробный лог в debug.log в каталоге данных сервера. Этот файл часто содержит полный стек-трейс Java, который напрямую указывает на причину краша.

1. В GPanel перейдите на вкладку File Manager.
2. Перейдите в /.cache/Logs/. Вы увидите файлы с именами вроде debug.log, DebugLog-server.txt или файлы логов с датами.
3. Откройте самый свежий файл лога. Используйте Ctrl+End или прокрутите в самый низ и читайте оттуда вверх.
4. Ищите ключевые слова OutOfMemoryError, IOException, NullPointerException или SandboxVars. Скопируйте соответствующие строки — они понадобятся вам, если вы откроете тикет в поддержку.

Исправление 1 — Высокое использование памяти при запуске в Build 42 (известный баг игры)

Если ваш сервер немедленно завершается при запуске без ошибки в консоли, или консоль показывает OutOfMemoryError или ошибку Java heap space, серверу не хватает памяти до того, как мир завершит загрузку.

Симптомы

• Сервер запускается, консоль прокручивается несколько секунд, затем останавливается без ошибки, видимой игроку.
• Консоль показывает java.lang.OutOfMemoryError: Java heap space или GC overhead limit exceeded.
• Сервер работает при одних перезапусках, но не при других (доступность памяти варьируется).
• Сервер работал нормально на B41, но стабильно крашится после обновления до B42.

Шаги

1. В GPanel нажмите на ваш сервер и перейдите на вкладку Console. Запишите текущее выделение RAM вашего сервера, показанное в строке ресурсов или панели информации о сервере.
2. Если ваш план включает менее 10 ГБ RAM, сервер может крашиться во время запуска, потому что B42 требует примерно 9 ГБ для инициализации. Вам потребуется повысить тарифный план или дождаться, пока The Indie Stone выпустит исправление.
3. Если ваш план уже имеет 10 ГБ или больше, а сервер всё равно крашится при запуске, перейдите на вкладку Startup в GPanel.
4. Найдите поле с пометкой Java Memory, Max RAM или Xmx. Убедитесь, что оно установлено не более чем на 80–85% от вашей общей доступной RAM. Например, на плане в 12 ГБ установите это значение в 10240 (10 ГБ в мегабайтах). Не устанавливайте его равным или выше вашей общей RAM — операционной системе и другим процессам также нужна память.
5. Нажмите Save на вкладке Startup, затем перезапустите сервер.
6. Наблюдайте за консолью во время запуска. Если сервер достигает строки SERVER STARTED или LuaManager: Loading lua files... завершается без краша, выделения памяти теперь достаточно.

Исправление 2 — BackupsOnStart переполняет /tmp (краш при запуске)

Project Zomboid можно настроить так, чтобы он создавал полную резервную копию мира при каждом запуске сервера. Когда эта резервная копия записывается в /tmp — размер которого ограничен на большинстве Linux-хостов — сервер крашится в середине запуска с ошибкой записи на диск, как только /tmp заполняется.

Симптомы

• Сервер стабильно крашится при каждом перезапуске, но раньше работал.
• Консоль или debug.log содержит ошибки вроде IOException: No space left on device или упоминания записи в /tmp/.
• Краши имеют тенденцию усугубляться со временем по мере роста сохранения мира.
• Сервер иногда запускается, если попробовать вскоре после чистой перезагрузки хост-ноды (прежде чем /tmp снова заполнится).

Шаги — отключение BackupsOnStart

1. В GPanel перейдите на вкладку File Manager.
2. Перейдите в /.cache/server/. Найдите файл конфигурации вашего сервера — он обычно называется servertest.ini или как ваше имя сервера с последующим .ini (например, MyServer.ini).
3. Откройте файл .ini для редактирования.
4. Используйте функцию поиска вашего браузера (Ctrl+F) для поиска BackupsOnStart.
5. Измените значение с true на false:

   BackupsOnStart=false

6. Находясь в файле, также проверьте настройку BackupsOnVersionChange и установите её в false, если место на диске вызывает беспокойство:

   BackupsOnVersionChange=false

7. Сохраните файл и перезапустите сервер. Следите за консолью, чтобы убедиться, что сервер достигает строки SERVER STARTED.

Исправление 3 — Повреждённый SandboxVars.lua или конфигурация сервера

Project Zomboid хранит настройки мира в Lua-файле под названием SandboxVars.lua. Если этот файл редактируется вручную и сохраняется с синтаксической ошибкой, или если передача файла была прервана, сервер немедленно крашится при запуске, когда пытается разобрать файл.

Симптомы

• Консоль показывает ERROR: SandboxVars, LuaManager error или ошибку разбора Lua с номером строки.
• Краш начался сразу после того, как вы отредактировали настройки в файле .ini или напрямую в SandboxVars.lua.
• Сервер может показывать Bad argument #1 to или похожие ошибки времени выполнения Lua.

Шаги — проверка и восстановление SandboxVars.lua

1. В GPanel перейдите в File Manager и перейдите в /.cache/saves/multiplayer/<YourServerName>/.
2. Откройте SandboxVars.lua для редактирования.
3. Проверьте, что файл начинается с VERSION = 1, (или подобного) внутри блока SandboxVars = { и заканчивается закрывающей }. Любая отсутствующая запятая, незакрытая фигурная скобка или посторонний символ вызовут сбой разбора.
4. Если вы не можете определить ошибку, самое безопасное исправление — полностью удалить SandboxVars.lua. Сервер заново сгенерирует его со значениями по умолчанию при следующем запуске. Примечание: это сбросит ваши настройки песочницы (лут, количество зомби и т. д.) к значениям по умолчанию — данные карты и данные игроков не затрагиваются.
5. Также проверьте файл .ini в /.cache/server/ на наличие похожих проблем, если вы недавно редактировали его вручную. Убедитесь, что каждая строка следует формату Key=Value без пустых строк внутри значения.
6. Сохраните изменения и перезапустите сервер.

Исправление 4 — Пустой пароль администратора, вызывающий краш

Project Zomboid требует непустой пароль администратора для запуска мультиплеерного сервера. Если поле пароля пустое, процесс сервера немедленно завершается после попытки инициализировать учётную запись администратора.

Симптомы

• Совершенно новый сервер или недавно сброшенный сервер падает при каждой попытке запуска.
• Вывод консоли очень короткий — сервер печатает несколько строк инициализации и затем останавливается.
• debug.log может содержать ссылку на учётную запись администратора или проверку пароля.

Шаги

1. В GPanel нажмите на ваш сервер и перейдите на вкладку Startup.
2. Найдите поле с пометкой Admin Password или RCON Password. Убедитесь, что оно содержит значение — оно не должно быть пустым.
3. Если поле пустое, введите пароль. Используйте не менее 8 символов. Избегайте специальных символов вроде !, #, $ или @ в пароле администратора, так как некоторые версии PZ некорректно разбирают их в аргументах запуска.
4. Нажмите Save и перезапустите сервер.
5. В качестве дополнительной проверки откройте файл .ini в /.cache/server/ и убедитесь, что строка AdminPassword= имеет значение после знака равенства.

Исправление 5 — Сброс мира (крайняя мера при постоянных крашах)

Если сохранение мира становится повреждённым — например, после жёсткого краша сервера, неудачного обновления или ошибок файловой системы — сами данные сохранения могут быть невосстановимыми. В этом случае удаление мира и начало с нуля — единственный вариант.

Шаги

1. Остановите ваш сервер в GPanel, прежде чем вносить какие-либо изменения в файлы сохранений. Редактирование файлов на работающем сервере может вызвать дальнейшее повреждение.
2. В GPanel перейдите на вкладку File Manager.
3. Перейдите в /.cache/saves/multiplayer/.
4. Вы увидите одну или несколько папок с именем вашего сервера (например, servertest). Перед удалением при желании скачайте папку в качестве резервной копии, выбрав её и используя опцию скачивания — даже повреждённое сохранение может быть частично восстановлено позже.
5. Удалите папку, соответствующую имени вашего сервера, внутри Multiplayer/. Не удаляйте саму папку Multiplayer.
6. Также перейдите в /.cache/db/ и удалите файл <YourServerName>.db. Эта база данных хранит статистику игроков и может ссылаться на старый мир — её повторная генерация избегает несоответствий.
7. Запустите ваш сервер. Он сгенерирует свежий мир, используя настройки в вашем файле .ini.

Краткий диагностический справочник

Всё ещё крашится после всех шагов?