Jak czytać raport awarii Minecraft

Raport awarii Minecraft wygląda onieśmielająco, ale za każdym razem ma tę samą strukturę. Gdy już wiesz, które linie naprawdę się liczą, zwykle znajdziesz przyczynę w niecałą minutę. Ten przewodnik pokazuje, gdzie znajduje się raport, jak odczytać stack trace i jak zamienić go w rozwiązanie.

Gdzie znaleźć raport awarii

Minecraft zapisuje raport awarii za każdym razem, gdy gra lub serwer niespodziewanie się zatrzyma. Spójrz tutaj:

  • crash-reports/
    Plik ze znacznikiem czasu, taki jak crash-2026-06-08_14.23.51-server.txt. To jest dedykowany, szczegółowy raport.
  • logs/latest.log
    Pełny dziennik działania. Jeśli nie ma raportu awarii (proces po prostu się zakończył), błąd jest tutaj, na samym dole.
  • logs/debug.log
    Znacznie bardziej szczegółowy dziennik, przydatny, gdy latest.log nie jest wystarczająco szczegółowy.

Na serwerze te foldery znajdują się w katalogu głównym serwera; na kliencie są w folderze instance/.minecraft. Zawsze otwieraj najnowszy plik według znacznika czasu.

Anatomia raportu awarii

Każdy raport ma te same części, od góry do dołu:

  • Nagłówek i opis
    Jednowierszowy wiersz Description podsumowujący, co zawiodło, oraz godzina. To twoja pierwsza wskazówka.
  • Stack trace
    Typ wyjątku, następnie lista wierszy kodu pokazujących, gdzie to się stało, często po nich jeden lub więcej bloków Caused by: .
  • Dotknięty poziom / szczegóły
    W przypadku awarii świata lub bytu: współrzędne, wymiar oraz zaangażowany byt/blok.
  • Szczegóły systemu
    Wersja Minecrafta, wersja Javy, przydzielona pamięć, loader modów oraz pełna lista modów. Bezcenne dla diagnozy.

Jak go faktycznie czytać, krok po kroku

  1. Przeczytaj wiersz Description. To podsumowanie prostym językiem, np. „Exception ticking entity” lub „Unexpected error”. To już wskazuje kategorię.
  2. Znajdź typ wyjątku na górze stack trace (np. java.lang.OutOfMemoryError, NullPointerException, NoClassDefFoundError). Typ często nazywa problem wprost.
  3. Przejdź do ostatniego „Caused by:”. Gdy jest ich kilka połączonych, najgłębszy jest zwykle prawdziwą przyczyną źródłową, a nie pierwszy.
  4. Poszukaj nazwy moda lub pluginu w ścieżce pakietu (np. com.somemod.Thing). To wskazuje bezpośrednio na winowajcę. Czysty net.minecraft.* trace wskazuje natomiast na dane vanilla/świata.
  5. Sprawdź szczegóły systemu. Potwierdź, że wersja Javy odpowiada twojej wersji Minecrafta, zobacz, ile pamięci przydzielono, i przejrzyj listę modów pod kątem duplikatów lub przestarzałych wpisów.
  6. Dopasuj objaw do znanego rozwiązania. Użyj znalezionej przyczyny, aby przejść do odpowiedniego rozwiązania (zobacz przykłady poniżej).

Co mówią Ci typowe ślady stosu

  • OutOfMemoryError: Java heap space
    Za mało pamięci. Zobacz Out of Memory.
  • Exception ticking entity
    Pojedynczy uszkodzony byt. Zobacz Ticking Entity.
  • A single server tick took 60.00 seconds
    Serwer się zawiesił. Zobacz Watchdog Crash.
  • NoClassDefFoundError / ClassNotFoundException
    Brakująca biblioteka. Zobacz NoClassDefFoundError.
  • Exit code -1 with no crash report
    Przeczytaj zamiast tego latest.log. Zobacz Error Code -1.

Przeglądaj je wszystkie na stronie Częste problemy .

Brak raportu awarii? Przeczytaj latest.log

Czasami proces po prostu się kończy (często z kodem wyjścia 1 lub -1) bez zapisania raportu awarii. W takim przypadku prawdziwy błąd znajduje się na dole logs/latest.log. Przewiń od końca w górę do pierwszego wiersza ERROR, FATAL lub Exception: to tam coś poszło nie tak. Aby zrozumieć sam format dziennika, zobacz Zrozumieć logi Minecraft.

Często zadawane pytania

W folderze crash-reports/ w katalogu głównym serwera lub w folderze instance/.minecraft, z nazwą zawierającą datę i godzinę awarii. Otwórz najnowszy plik.

Raport awarii to skoncentrowana migawka zapisywana, gdy gra się zatrzymuje. latest.log to pełny działający log. Jeśli nie ma raportu awarii, błąd znajduje się na dole latest.log.

Spójrz na nazwy pakietów w stack trace oraz najgłębszą linię „Caused by:”. Pakiet inny niż vanilla (nie net.minecraft) zwykle wskazuje odpowiedzialny mod — potwierdź to, sprawdzając listę modów w System Details.

Tak, wklej lub prześlij raport awarii do MCDoctor.ai, a wyjaśni przyczynę i rozwiązanie prostym językiem.