Як читати звіт про збій Minecraft

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

Де знайти звіт про збій

Minecraft записує звіт про збій щоразу, коли гра або сервер несподівано зупиняється. Шукайте тут:

  • crash-reports/
    Файл із часовою позначкою, як-от crash-2026-06-08_14.23.51-server.txt. Це спеціальний, докладний звіт.
  • logs/latest.log
    Повний журнал виконання. Якщо звіту про збій немає (процес просто завершився), помилка тут, у самому низу.
  • logs/debug.log
    Набагато докладніший журнал, корисний, коли latest.log недостатньо детальний.

На сервері ці папки розташовані в кореневій теці сервера; на клієнті — у теці instance/.minecraft. Завжди відкривайте найновіший файл за часовою позначкою.

Анатомія звіту про збій

Кожен звіт має однакові частини, згори вниз:

  • Заголовок і опис
    Однорядковий рядок Description, що підсумовує, що пішло не так, плюс час. Це ваша перша підказка.
  • Stack trace
    Тип винятку, потім список рядків коду, що показують, де це сталося, часто за ними один або кілька блоків Caused by: .
  • Уражений рівень / деталі
    Для збоїв світу чи сутності: координати, вимір і задіяна сутність/блок.
  • Деталі системи
    Версія Minecraft, версія Java, виділена пам'ять, завантажувач модів і повний список модів. Золото для діагностики.

Як насправді його читати, крок за кроком

  1. Прочитайте рядок Description. Це підсумок простою мовою, напр. «Exception ticking entity» або «Unexpected error». Це вже підказує категорію.
  2. Знайдіть тип винятку у верхній частині stack trace (напр. java.lang.OutOfMemoryError, NullPointerException, NoClassDefFoundError). Тип часто називає проблему безпосередньо.
  3. Перейдіть до останнього «Caused by:». Коли їх кілька з'єднаних, найглибший зазвичай є справжньою першопричиною, а не перший.
  4. Шукайте назву мода чи плагіна у шляху пакета (напр. com.somemod.Thing). Це вказує прямо на винуватця. Чистий net.minecraft.* trace натомість вказує на дані vanilla/світу.
  5. Перевірте деталі системи. Підтвердьте, що версія Java відповідає вашій версії Minecraft, подивіться, скільки пам'яті було виділено, і перегляньте список модів на наявність дублікатів або застарілих записів.
  6. Зіставте симптом із відомим рішенням. Використайте знайдену причину, щоб перейти до відповідного рішення (див. приклади нижче).

Що вам кажуть поширені stack trace

  • OutOfMemoryError: Java heap space
    Недостатньо пам'яті. Див. Out of Memory.
  • Exception ticking entity
    Одна пошкоджена сутність. Див. Ticking Entity.
  • A single server tick took 60.00 seconds
    Сервер завис. Див. Watchdog Crash.
  • NoClassDefFoundError / ClassNotFoundException
    Відсутня бібліотека. Див. NoClassDefFoundError.
  • Exit code -1 with no crash report
    Прочитайте натомість latest.log. Див. Error Code -1.

Перегляньте їх усі на сторінці Поширені проблеми .

Немає звіту про збій? Прочитайте latest.log

Іноді процес просто завершується (часто з кодом виходу 1 або -1) без запису звіту про збій. У такому разі справжня помилка — у самому низу logs/latest.log. Прокрутіть від кінця вгору до першого рядка ERROR, FATAL або Exception: саме там щось пішло не так. Щоб зрозуміти сам формат журналу, див. Розуміння журналів Minecraft.

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

У папці crash-reports/ у корені вашого сервера або в папці instance/.minecraft, названий датою та часом збою. Відкрийте найновіший файл.

Звіт про збій — це сфокусований знімок, записаний, коли гра зупиняється. latest.log — це повний робочий журнал. Якщо звіту про збій немає, помилка знаходиться в кінці latest.log.

Подивіться на назви пакетів у stack trace та найглибший рядок «Caused by:». Не-vanilla пакет (не net.minecraft) зазвичай називає відповідальний мод — підтвердьте, перевіривши список модів у System Details.

Так, вставте або завантажте звіт про збій у MCDoctor.ai, і він пояснить причину та рішення простою мовою.