Разбиране на логовете на 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 го анализира и връща вероятната причина и препоръчаното решение.