Porozumění protokolům Minecraftu

Protokoly Minecraftu jsou tím nejlepším zdrojem pravdy, když se něco rozbije. Zaznamenávají v pořadí, co hra nebo server dělaly, až do okamžiku selhání. Tento návod vysvětluje, na kterých souborech protokolů záleží, jak číst řádek protokolu a co hledat.

Soubory protokolů, na kterých záleží

Vše je ve složce logs/ (kořen serveru nebo instance/.minecraft na klientovi):

  • latest.log
    Úplný protokol aktuálního běhu. To je soubor, který otevřete jako první; chyba je téměř vždy zde.
  • debug.log
    Mnohem podrobnější verze stejného běhu. Použijte ji, když latest.log neřekne dost.
  • Archivované protokoly
    Starší běhy jsou zazipovány jako 2026-06-08-1.log.gz. Rozbalte jej a přečtěte si minulou relaci.
  • crash-reports/
    Samostatná složka se zaměřenou zprávou, zapsanou pouze tehdy, když hra spadne. Viz Jak číst zprávu o pádu Minecraftu.

Jak číst řádek protokolu

Každý řádek má stejný formát:

[14:23:51] [Server thread/ERROR]: Encountered an unexpected exception
  • [14:23:51]
    Časové razítko: kdy událost nastala.
  • [Server thread/ERROR]
    Vlákno, které to zaznamenalo, a úroveň.
  • Zpráva
    Co se skutečně stalo, často následované stack trace, pokud jde o chybu.

Úroveň protokolu vám na první pohled ukáže závažnost: INFO (normální), WARN (něco není v pořádku, ale není to fatální), ERROR (skutečné selhání), a FATAL (server se vypíná).

Vlákna: kdo mluví

  • Server thread / main
    Hlavní herní smyčka. Chyby zde obvykle přímo ovlivňují hru (a mohou způsobit pád serveru).
  • Worker / IO threads
    Práce na pozadí jako I/O chunků. Užitečné pro problémy s diskem a ukládáním světa.
  • Mod/plugin threads
    Pojmenováno podle modu nebo pluginu: rychlá nápověda, co je zodpovědné.

Co hledat

  1. Posuňte se k prvnímu řádku ERROR/FATAL nebo Exception; pozdější chyby jsou často jen jeho důsledky.
  2. Přečtěte si spouštěcí sekci, zda nejsou selhané mody/pluginy, špatná verze Javy nebo nepřijaté EULA.
  3. Sledujte opakovaný spam WARN jako „Can't keep up!“ (výkon, viz Can't Keep Up) nebo „moved too quickly“.
  4. Zaznamenejte si poslední řádky před zamrznutím nebo vypnutím: ukazují, co server dělal, když padl.
  5. Porovnejte jakoukoli chybu se Časté problémy seznamem pro přesné řešení.

Serverové protokoly vs. klientské protokoly

Sdílejí stejný formát, ale nacházejí se na různých místech. Protokol serveru zaznamenává ukládání světa, připojení hráčů a načítání pluginů/modů; protokol klienta zaznamenává vykreslování, balíčky prostředků a vaše vlastní připojení. Při řešení problému s připojením porovnejte oba: příčina může být jen na jedné straně.

Bezpečné sdílení protokolů

Protokoly mohou obsahovat IP vašeho serveru a občas tokeny, takže je nevkládejte veřejně, aniž byste se na ně nejprve podívali. K sdílení použijte službu paste (například mclo.gs) nebo nahrajte soubor přímo do MCDoctor.ai, který protokol přečte a vysvětlí vám příčinu a řešení, bez ručního hrabání.

Často kladené otázky

Ve složce logs/ v kořeni vašeho serveru nebo ve složce instance/.minecraft. Aktuální běh je latest.log; starší běhy jsou zazipované soubory .log.gz.

Pokrývají stejný běh, ale debug.log je mnohem podrobnější. Začněte s latest.log a přepněte na debug.log pouze tehdy, když potřebujete více detailů.

WARN znamená, že něco není v pořádku, ale není to fatální; ERROR je skutečné selhání; FATAL znamená, že se server vypíná. Zaměřte se na první řádek ERROR/FATAL.

Ano, nahrajte latest.log nebo zprávu o pádu a MCDoctor.ai ji analyzuje a vrátí pravděpodobnou příčinu a doporučenou opravu.