Розуміння журналів Minecraft

Журнали Minecraft — це ваше найкраще джерело істини, коли щось ламається. Вони записують, що робила гра чи сервер, по порядку, аж до моменту збою. Цей посібник пояснює, які файли журналів важливі, як читати рядок журналу та що шукати.

Файли журналів, що мають значення

Усе знаходиться в теці logs/ (корінь сервера або instance/.minecraft на клієнті):

  • latest.log
    Повний журнал поточного запуску. Це файл, який ви відкриваєте першим; помилка майже завжди тут.
  • debug.log
    Набагато докладніша версія того ж запуску. Використовуйте її, коли latest.log говорить недостатньо.
  • Архівовані журнали
    Старіші запуски стиснуті як 2026-06-08-1.log.gz. Розпакуйте його, щоб прочитати минулу сесію.
  • crash-reports/
    Окрема тека з цілеспрямованим звітом, що записується лише тоді, коли гра аварійно завершується. Див. Як читати звіт про збій Minecraft.

Як читати рядок журналу

Кожен рядок має той самий формат:

[14:23:51] [Server thread/ERROR]: Encountered an unexpected exception
  • [14:23:51]
    Часова позначка: коли сталася подія.
  • [Server thread/ERROR]
    Потік, який це записав, і рівень.
  • Повідомлення
    Що насправді сталося, часто за цим stack trace, якщо це помилка.

Рівень журналу показує серйозність з одного погляду: INFO (нормально), WARN (щось не так, але не критично), ERROR (справжній збій), та FATAL (сервер вимикається).

Потоки: хто говорить

  • Server thread / main
    Основний ігровий цикл. Помилки тут зазвичай безпосередньо впливають на ігровий процес (і можуть аварійно завершити сервер).
  • Worker / IO threads
    Фонова робота, як-от I/O чанків. Корисно для проблем з диском і збереженням світу.
  • Mod/plugin threads
    Названо за модом чи плагіном: швидка підказка, що є відповідальним.

Що шукати

  1. Прокрутіть до першого рядка ERROR/FATAL або Exception; пізніші помилки часто є лише його наслідками.
  2. Прочитайте розділ запуску на предмет невдалих модів/плагінів, неправильної версії Java або неприйнятого EULA.
  3. Слідкуйте за повторюваним спамом WARN, як-от «Can't keep up!» (продуктивність, див. Can't Keep Up) або «moved too quickly».
  4. Занотуйте останні рядки перед зависанням або вимкненням: вони показують, що робив сервер, коли впав.
  5. Звірте будь-яку помилку зі Поширені проблеми списком, щоб знайти точне рішення.

Журнали сервера проти журналів клієнта

Вони мають однаковий формат, але розташовані в різних місцях. Журнал сервера записує збереження світу, з'єднання гравців і завантаження плагінів/модів; журнал клієнта записує рендеринг, пакети ресурсів і ваше власне з'єднання. Розв'язуючи проблему з приєднанням, порівняйте обидва: причина може бути лише з одного боку.

Безпечне надсилання журналів

Журнали можуть містити IP вашого сервера та подеколи токени, тож не вставляйте їх публічно, не глянувши спершу. Використовуйте сервіс paste (наприклад mclo.gs) для надсилання або завантажте файл безпосередньо в MCDoctor.ai, який прочитає журнал і пояснить вам причину та рішення, без ручного копирсання.

Часті запитання

У папці logs/ у корені вашого сервера або в папці instance/.minecraft. Поточний запуск — latest.log; старіші запуски — це стиснуті файли .log.gz.

Вони охоплюють той самий запуск, але debug.log набагато детальніший. Почніть з latest.log і переходьте до debug.log лише тоді, коли потрібно більше деталей.

WARN означає, що щось не так, але не фатально; ERROR — це реальний збій; FATAL означає, що сервер вимикається. Зосередьтеся на першому рядку ERROR/FATAL.

Так, завантажте latest.log або звіт про збій, і MCDoctor.ai проаналізує його та поверне ймовірну причину та рекомендоване рішення.