Serwer Minecraft oblicza świat w tickach, 20 razy na sekundę. Jeśli tick trwa za długo albo zabraknie pamięci RAM, serwer zapisuje ostrzeżenia w logu, a w najgorszym przypadku przerywa działanie. Każda sekcja poniżej wyjaśnia jeden z tych komunikatów: jak go rozpoznać, jak bardzo jest poważny i co możesz zrobić. Najpierw opisane są komunikaty, po których serwer się wysypuje lub zostaje zatrzymany, a potem ostrzeżenia, przy których działa dalej.

Pełny komunikat znajdziesz w Konsola lub w Pliki w logs/latest.log, a raporty awarii w folderze crash-reports/. Zawsze czytaj też wcześniejsze linie: często jest tam napisane, co spowolniło serwer. Zanim zmienisz pliki konfiguracyjne lub pliki świata, utwórz kopię zapasową w Kopie zapasowe.

„A single server tick took … seconds”: Watchdog wyłącza serwer

Tak wygląda komunikat:

The server has not responded for <Sekundy> seconds! Creating thread dump
A single server tick took 60.00 seconds (should be max 0.05)

Co się za tym kryje: Watchdog pilnuje, czy serwer nadal pracuje. Jeśli tick, czyli pojedynczy krok symulacji gry, trwa zbyt długo, Watchdog wyłącza zawieszony serwer, a rozgrywka zostaje przerwana. Wcześniej Paper zapisuje komunikaty pośrednie ze zrzutem wątków (thread dump), czyli migawką aktualnie wykonywanej pracy: jeśli serwer w porę się otrząśnie, działa dalej. Częste przyczyny to brak pamięci lub ciężki plugin albo mod.

Jak to naprawić:

  1. W sekcji Pliki przeczytaj w logs/latest.log linie przed pierwszym komunikatem Watchdoga. Jeśli widnieje tam Stopping server, sprawdź, na czym zawiesza się wyłączanie.
  2. Przejrzyj w zrzucie wątków najwyższe linie pod Server thread. W przypadku Vanilla, Fabric i NeoForge znajdziesz go w raporcie awarii w folderze crash-reports/. Nazwa pluginu lub moda pokazuje, czym serwer był ostatnio zajęty.
  3. Sprawdź pamięć RAM. OutOfMemoryError: Java heap space oznacza, że pamięć Javy się wyczerpała; sprawdź wtedy również, co ją zajmuje.
  4. Zatrzymaj serwer przed zmianami w plikach. Zaktualizuj problematyczny plugin w sekcji Pluginy lub mod w sekcji Mody albo usuń go na próbę, uruchom serwer ponownie i sprawdź jeszcze raz.

Więcej szczegółów: Jak poprawnie naprawić „Can't keep up” i timeout Watchdoga

„The server has not responded for … seconds”: serwer na chwilę się zawiesił, ale działa dalej

Tak wygląda komunikat:

The server has not responded for 10 seconds! Creating thread dump

Co się za tym kryje: Główny wątek, czyli ścieżka wykonywania odpowiedzialna za przebieg gry, przez kilka sekund nie odpowiadał. Dlatego Paper zapisuje wczesne ostrzeżenie wraz z zrzutem wątków (thread dump), czyli migawką aktualnie wykonywanej pracy. Serwer działa dalej; zostanie zatrzymany dopiero wtedy, gdy w logu pojawi się „The server has stopped responding!”. Najczęściej przyczyną jest przeciążony plugin, bardzo duża operacja na świecie albo blokujące zapytanie do bazy danych lub HTTP wykonywane w wątku serwera.

Jak to naprawić:

  1. W sekcji Pliki otwórz logs/latest.log i przeczytaj zrzut wątków bezpośrednio pod komunikatem. Jeśli pojawia się tam nazwa pluginu, to silna wskazówka, że to on jest winowajcą.
  2. Zatrzymaj serwer, zaktualizuj problematyczny plugin w sekcji Pluginy albo usuń go na próbę i uruchom serwer ponownie.
  3. Jeśli zawieszenia się powtarzają, sprawdź pamięć RAM, liczbę graczy oraz zasięg widzenia view-distance w pliku server.properties.
  4. Pojedyncze ostrzeżenia, np. podczas startu lub zapisywania dużego świata, możesz obserwować, zamiast od razu reagować.

Więcej szczegółów: Jak poprawnie naprawić „Can't keep up” i timeout watchdoga

„Java heap space”: pamięć serwera jest wyczerpana

Tak wygląda komunikat:

An exception 'java.lang.OutOfMemoryError: Java heap space' … exceptionCaught() …
Failed to save entity data (<x>,<z>) in world '<World>' … java.lang.OutOfMemoryError: Java heap space
An unexpected error while handling a WorldEdit command … java.lang.OutOfMemoryError: Java heap space

Co się za tym kryje: Java zarządza pamięcią serwera w obszarze zwanym heap, który zapełnił się przy obecnym obciążeniu. Duże operacje WorldEdit, wiele wczytanych chunków, czyli fragmentów świata, duże modpacki lub pluginy przetwarzające dużo danych mogą wymagać dużo pamięci. Serwer często zawiesza się lub staje się niestabilny; może też nie udać się zapisanie danych świata lub jednostek, na przykład stworzeń i przedmiotów. Wskazany wątek lub plugin pokazuje, gdzie zabrakło pamięci, ale nie musi być tym, który zużywa jej najwięcej.

Jak to naprawić:

  1. Uruchom serwer ponownie, aby zakończyć przepełniony proces. Przy niezmienionym obciążeniu błąd może wrócić.
  2. Ustal zapotrzebowanie na pamięć: Zaplanuj zapotrzebowanie RAM dla Minecrafta. Jeśli Twój pakiet nie wystarcza, wybierz w Ustawienia i abonament → Plan więcej RAM-u.
  3. Podziel duże operacje WorldEdit na mniejsze i w razie potrzeby zmniejsz view-distance w Pliki w pliku server.properties.
  4. Po ponownym uruchomieniu sprawdź Konsolę oraz obszary świata, które były zmieniane. Przy komunikatach o Failed to save entity data lub chunk data (write) sprawdź szczególnie, czy ostatni stan został zapisany.

Dobrze wiedzieć: Kopia zapasowa wykonana przed kolejną dużą zmianą świata pomoże przywrócić utracone zmiany.

„This crash report has been saved to …”: serwer uległ awarii

Tak wygląda komunikat:

This crash report has been saved to: crash-reports/crash-<Data>_<Godzina>-server.txt

Co się za tym kryje: Serwer został zatrzymany przez poważny błąd i zapisał raport awarii. Sam komunikat mówi tylko, gdzie znajduje się ten raport. Właściwa przyczyna, np. mod, plugin, świat lub brak pamięci RAM, jest zapisana w pliku.

Jak to naprawić:

  1. W sekcji Pliki otwórz folder crash-reports/, a w nim wskazany plik. Jego nazwa zawiera datę i godzinę awarii.
  2. Przeczytaj pierwszą część: po Description: znajduje się krótki opis, a pod nim linia błędu i stacktrace, czyli lista miejsc w programie, które doprowadziły do błędu.
  3. Sprawdź, czy mody lub pluginy wymienione w błędzie mają odpowiednie wersje. Zaktualizuj problematyczny element w sekcji Mody lub Pluginy albo po wykonaniu kopii zapasowej usuń go na próbę.
  4. Przy OutOfMemoryError przeczytaj dopisek do komunikatu. Jeśli wskazuje Java heap space, pamięć Javy jest pełna; jeśli masz wykupione za mało RAM, wybierz więcej w Ustawienia i abonament → Plan.
  5. Uruchom serwer i obserwuj Konsolę, aż w pełni wystartuje.

Warto wiedzieć: Zachowaj raport do diagnozy i porównaj datę oraz godzinę z bieżącą awarią. Dla serwerów z modami: Błędy modów na serwerach Forge, NeoForge i Fabric

„Exception in server tick loop”: błąd w głównej pętli gry

Tak wygląda komunikat:

Exception in server tick loop
Encountered an unexpected exception
Caused by: java.lang.<Rodzaj błędu>: <Szczegóły>

Co się za tym kryje: Główna pętla oblicza świat tick po ticku. Wyjątek, czyli błąd programu, przedostał się aż do tej pętli i zakłócił jej działanie. Serwer zwykle się wtedy zawiesza i zapisuje raport o awarii. Właściwa przyczyna prawie zawsze znajduje się w bezpośrednio następującej linii Caused by.

Jak to naprawić:

  1. Znajdź komunikat w logs/latest.log lub w najnowszym raporcie w crash-reports/.
  2. Przeczytaj linię Caused by bezpośrednio pod nim. Jeśli jest ich kilka, najniższa zwykle prowadzi do źródła problemu. Jeśli jej brakuje, liczy się linia java.lang.… bezpośrednio pod komunikatem.
  3. Linie z at … poniżej podają nazwy pakietów i plików. Po nich rozpoznasz, którego pluginu lub moda dotyczy problem.
  4. Zaktualizuj go lub usuń w sekcji Pluginy albo Mody i uruchom serwer ponownie. NoSuchMethodError oznacza zwykle, że został zbudowany dla innej wersji Minecraft.

Dobrze wiedzieć: Ten komunikat to nie problem z lagami, tylko konkretny błąd. Więcej pamięci RAM pomoże tylko wtedy, gdy linia Caused by wskazuje OutOfMemoryError.

Więcej szczegółów: Jak prawidłowo naprawić „Can't keep up” i timeout watchdoga

„GC overhead limit exceeded”: pamięć Javy na granicy limitu

Tak wygląda komunikat:

java.lang.OutOfMemoryError: GC overhead limit exceeded

Co się za tym kryje: Java automatycznie zwalnia pamięć, która nie jest już potrzebna. Nazywa się to Garbage Collection, w skrócie GC. Ten komunikat oznacza, że Java spędza prawie cały czas na sprzątaniu i niemal nie odzyskuje przy tym pamięci. Heap, czyli pamięć robocza Javy, jest praktycznie pełny. Serwer prawie nie reaguje albo się zawiesza.

Jak to naprawić:

  1. Zrestartuj serwer.
  2. Sprawdź, ile pamięci RAM potrzebuje Twoja konfiguracja. Szczegóły: Zaplanuj zapotrzebowanie Minecrafta na RAM
  3. Jeśli Twój pakiet nie wystarcza, wybierz więcej RAM w Ustawienia i abonament → Plan.
  4. Zmniejsz obciążenie chunkami i encjami: obniż zasięg widzenia view-distance w pliku server.properties, zmniejsz duże farmy zwierząt i usuń leżące na ziemi przedmioty.

Warto wiedzieć: Restart daje tylko chwilę oddechu. Jeśli zużycie po każdym restarcie stale rośnie aż do limitu, mimo że obciążenie pozostaje takie samo, przyczyną może być też plugin lub mod, który blokuje pamięć.

„unable to create native thread”: Java nie może uruchomić kolejnego wątku

Tak wygląda komunikat:

java.lang.OutOfMemoryError: unable to create native thread: possibly out of memory or process/resource limits reached

Co się za tym kryje: Wątek to równoległa ścieżka wykonywania zadań, a Java nie mogła uruchomić kolejnego. Możliwe wąskie gardła to zbyt wiele jednoczesnych wątków, osiągnięty limit procesów lub brak pamięci natywnej poza heapem Javy, czyli pamięcią na obiekty Javy. Nowe zadania mogą nie zostać wykonane, a serwer może działać niestabilnie. Nazwa pluginu w błędzie pokazuje najpierw, przy którym zadaniu nie udało się uruchomić wątku; ustalenie przyczyny wymaga odpowiednich pomiarów w trakcie działania.

Jak to naprawić:

  1. Zanotuj godzinę i zabezpiecz odpowiednie linie z logs/latest.log w sekcji Pliki, łącznie z komunikatami przed nimi i po nich.
  2. Sprawdź liczbę wątków, limit procesów i pamięć natywną w chwili wystąpienia błędu. Jeśli nie masz dostępu do tych wartości, otwórz zgłoszenie i podaj godzinę komunikatu.
  3. Porównaj zmierzone wartości z uruchomionymi zadaniami. Aktualizuj plugin w sekcji Pluginy lub mod w sekcji Mody dopiero wtedy, gdy pomiary potwierdzają ten związek; sprawdź też ich ustawienia.
  4. Jeśli serwer nie nadaje się już do użytku, uruchom go ponownie po zabezpieczeniu linii z błędem. Sprawdź Konsolę pod kątem ponownych błędów.

Warto wiedzieć: Większy heap Javy nie rozwiąże problemu wyczerpanego limitu wątków lub procesów. O spark: spark: jak znaleźć i zrozumieć lagi.

„Can't keep up”: serwer nie nadąża z przetwarzaniem ticków

Tak wygląda komunikat:

Can't keep up! Is the server overloaded? Running <Czas>ms or <Ticki> ticks behind
Can't keep up! Did the system time change, or is the server overloaded? Running <Czas>ms behind, skipping <Ticki> tick(s)

Co się za tym kryje: Minecraft standardowo przelicza 20 ticków na sekundę, z budżetem czasu 50 milisekund na każdy tick. Jeśli obliczenia trwają dłużej, serwer działa dalej, ale wolniej: bloki pojawiają się z powrotem, a moby się przycinają. Przyczyną jest zwykle obciążenie pamięci lub procesora; pojedyncze komunikaty mogą pojawiać się podczas startu lub generowania nowych obszarów.

Jak to naprawić:

  1. Używaj spark na obsługiwanych serwerach Java. Aktualne wersje Paper mają go wbudowanego; na innych obsługiwanych serwerach zainstaluj odpowiednią wersję w formie pluginu lub moda.
  2. W trakcie lagów zmierz wydajność poleceniem spark tps w Konsoli. MSPT to milisekundy na tick: jeśli czas trwania ticka stale przekracza budżet czasu, spada liczba ticków na sekundę.
  3. Znajdź winowajcę poleceniem spark profiler start --timeout 120 i otwórz link, który zostanie potem wyświetlony.
  4. Na zatrzymanym serwerze Java zmniejsz zasięg widzenia view-distance i zasięg symulacji simulation-distance w pliku server.properties. Ogranicz duże farmy albo wygeneruj świat z wyprzedzeniem.
  5. Sprawdź obciążenie i pamięć RAM, a po zmianach w konfiguracji uruchom serwer ponownie. W Bedrock powyższe polecenia spark i ustawienia Java nie mają zastosowania; skorzystaj z dokumentacji swojego oprogramowania serwerowego.

Więcej szczegółów: Jak poprawnie naprawić „Can't keep up” i timeout watchdoga

„DO NOT REPORT THIS TO PAPER”: diagnoza zawieszenia serwera

Tak wygląda komunikat:

--- DO NOT REPORT THIS TO PAPER - THIS IS NOT A BUG OR A CRASH ---
Server thread dump (Look for plugins here before reporting to Paper!):

Co się za tym kryje: Gdy główny wątek serwera zawiesza się na kilka sekund, Paper zapisuje diagnozę ze zrzutem wątków, czyli migawką tego, nad czym serwer właśnie pracuje. W tym czasie rozgrywka stoi; po zawieszeniu serwer może działać dalej. Jeśli blokada trwa zbyt długo, Watchdog go wyłącza.

Jak to naprawić:

  1. Przeczytaj w zrzucie najwyższe linie pod Server thread dump. Jeśli widnieje tam nazwa pluginu lub moda, to mocna wskazówka, co jest przyczyną.
  2. Zatrzymaj serwer, zaktualizuj dany plugin w Pluginy lub mod w Mody albo usuń go na próbę i uruchom serwer ponownie.
  3. Jeśli zrzuty się powtarzają, sprawdź pamięć RAM, swoje pluginy oraz zasięg widzenia view-distance w server.properties.
  4. Pojedyncze zrzuty, np. przy starcie lub zapisywaniu dużego świata, możesz obserwować, zamiast od razu reagować.

Więcej szczegółów: Jak prawidłowo naprawić „Can't keep up” i timeout Watchdoga

„ChunkTaskScheduler”: Paper czeka na wczytanie lub wygenerowanie chunka

Tak wygląda komunikat:

[ChunkTaskScheduler] Chunk wait task info below:
[ChunkTaskScheduler] Chunk holder: NewChunkHolder{world=<Świat>, chunkX=<x>, chunkZ=<z>, …, currentGenStatus=minecraft:initialize_light, requestedGenStatus=minecraft:full, …}
[ChunkTaskScheduler] Chunk holder: NewChunkHolder{world=<Świat>, chunkX=<x>, chunkZ=<z>, …, currentGenStatus=minecraft:full, requestedGenStatus=null, …, currentChunkStatus=FULL, …}

Co się za tym kryje: Paper dłużej czekał na wczytanie lub wygenerowanie chunka, czyli fragmentu świata o wymiarach 16 × 16 bloków, i zapisał diagnozę; serwer w tym czasie się przycina. currentGenStatus pokazuje osiągnięty etap, a requestedGenStatus docelowy; przy null nie ma ustawionego celu generowania, a w raporcie mogą pojawić się też gotowe chunki. Zwykle stoi za tym przeciążenie: generowanie świata, wielu graczy daleko od siebie lub wolne pluginy. Rzadziej uszkodzony jest region.

Jak to naprawić:

  1. W Pliki zmniejsz zasięg widzenia view-distance w server.properties i uruchom serwer ponownie.
  2. Wygeneruj świat z wyprzedzeniem: Chunky: jak wstępnie wygenerować świat Minecraft.
  3. Jeśli spark jest dostępny, zbadaj obciążenie w trakcie problemu poleceniem spark profiler start --timeout 120 w Konsola. Raport pokaże, które procesy zajmują czas.
  4. Jeśli problem wielokrotnie dotyczy tego samego świata i tych samych współrzędnych chunka, sprawdź sąsiednie linie logu pod kątem błędów wczytywania tego regionu. Przy potwierdzonym uszkodzeniu zatrzymaj serwer, zabezpiecz aktualny stan i przywróć sprawną kopię w Kopie zapasowe. Zmiany wprowadzone od czasu tej kopii zostaną utracone.

Dobrze wiedzieć: Bardzo duże współrzędne wskazują na podróże daleko od środka świata. Odpowiednia granica świata ogranicza dalszą eksplorację.

„The server has stopped responding”: Watchdog Paper zgłasza zawieszenie

Tak wygląda komunikat:

The server has stopped responding! This is (probably) not a Paper bug.
If you see a world save or edit, then it means you did far more than your server can handle at once
If this is the case, consider increasing timeout-time in spigot.yml but note that this will replace the crash with LARGE lag spikes

Co się za tym kryje: Te linie należą do bloku ostrzeżeń Watchdoga w Paper, który wykrywa dłużej zablokowany wątek główny, czyli wątek odpowiedzialny za przebieg gry. Podczas zawieszenia rozgrywka stoi; jeśli blokada trwa dalej, Watchdog wyłącza serwer. Typowe przyczyny to przeciążone pluginy, duże operacje na świecie lub blokujące zapytania HTTP i do bazy danych. Zrzut wątków poniżej pokazuje aktualnie wykonywane wywołania programu.

Jak to naprawić:

  1. Przeczytaj zrzut wątków w logs/latest.log w Pliki. Sprawdź, czy wymienione pluginy mają aktualizacje; dostosuj ich konfigurację lub usuń je na próbę przy zatrzymanym serwerze.
  2. Jeśli zrzut pokazuje edycję lub zapisywanie świata, podziel duże operacje, np. w WorldEdit, na mniejsze kroki.
  3. Jeśli pokazuje zapytania HTTP lub MySQL, sprawdź w danym pluginie połączenie i dostępność usługi.
  4. Większa wartość timeout-time w spigot.yml wydłuża czas oczekiwania, ale nie usuwa blokady.
  5. Przy powtarzających się zawieszeniach zmniejsz obciążenie pluginami i sprawdź pamięć RAM.

Więcej szczegółów: Jak prawidłowo naprawić „Can't keep up” i timeout Watchdoga

BootstrapMethodError: zadanie Paper dla fragmentów świata nie powiodło się

Tak wygląda komunikat:

[ca.spottedleaf.concurrentutil.executor.thread.BalancedPrioritisedThreadPool] Exception thrown from thread <Wątek>
java.lang.BootstrapMethodError: bootstrap method initialization exception

Co się za tym kryje: Paper wczytuje, generuje i zapisuje chunki, czyli fragmenty świata, także w osobnych wątkach obok głównej gry. W jednym z takich wątków Java nie mogła przygotować miejsca wywołania w programie; dane zadanie się nie powiodło. Jeśli w stacktrace, czyli liście wywołań pod błędem, widnieje saveChunk, dotyczy to zapisywania fragmentu świata. Możliwe przyczyny to błąd w Paper, niekompatybilne rozszerzenie lub nieobsługiwana wersja Javy.

Jak to naprawić:

  1. Zaktualizuj Paper w Wersja do aktualnego stabilnego buildu dla twojej wersji Minecraft.
  2. Używaj wersji Javy obsługiwanej przez ten build: Jakiej wersji Javy potrzebuje twój serwer Minecraft?
  3. Przeczytaj pełny stacktrace w logs/latest.log. Jeśli linia Caused by wskazuje plugin, zaktualizuj go w Pluginy.
  4. Nie podmieniaj ręcznie bibliotek serwera. To raczej spowoduje nowe błędy.
  5. Jeśli po aktualizacji błąd nadal się powtarza, zgłoś pełny stacktrace projektowi Paper.

Minecraft nie może zapisać raportu awarii

Tak wygląda komunikat:

We were unable to save this crash report to disk.

Co się za tym kryje: Komunikat dotyczy zapisu raportu awarii. Po wystąpieniu błędu Minecraft próbował zapisać diagnozę na dysku i nie mógł zapisać pliku raportu. Przyczyna pierwotnego błędu znajduje się wcześniej w Konsola; brak raportu utrudnia późniejsze szukanie problemu.

Jak to naprawić:

  1. Najpierw zabezpiecz cały blok błędu z Konsola, łącznie z liniami przed tym komunikatem.
  2. W Pliki sprawdź istniejące pliki w crash-reports/ oraz logs/latest.log. Przeczytaj konkretny komunikat o błędzie zapisu i sprawdź dostępne miejsce na dysku.
  3. Usuń wskazaną tam przyczynę. Jeśli ścieżka nadal nie jest zapisywalna, otwórz zgłoszenie i podaj godzinę oraz błąd zapisu.

Nie ma tu Twojego komunikatu?

Przeczytaj cały komunikat w logs/latest.log, a przede wszystkim linie przed nim: przeciążenie prawie zawsze ma jakiś wyzwalacz, który pojawia się przed pierwszym ostrzeżeniem. W stacktrace lub zrzucie wątków nazwy pakietów, czyli oddzielone kropkami nazwy folderów, takie jak com.<Developer>.<Plugin>, oraz nazwy plików, takie jak <Plugin>.jar, zdradzają, który plugin lub mod jest zaangażowany. Zanim zmienisz pliki konfiguracyjne, utwórz kopię zapasową w Kopie zapasowe. Jeśli utkniesz, otwórz zgłoszenie i podaj godzinę wystąpienia komunikatu.