Najczęstsze błędy serwera Minecraft i jak je naprawić

Ta strona zbiera najczęstsze komunikaty błędów serwerów Minecraft i samej gry, z wyjaśnieniem, co oznaczają i jak je naprawić. Komunikaty są przytoczone dokładnie tak, jak je zobaczysz, więc możesz je po prostu wyszukać (Ctrl+F albo wyszukiwarka poradników).

Jak czytać log#

Serwer zapisuje wszystko, co robi, do konsoli i do plików:

Jak znaleźć przyczynę w logu:

1. Znajdź pierwszą linię z ERROR lub Exception – błędy po niej są często tylko skutkami.
2. Pod błędem jest stack trace (linie zaczynające się od at …). Szukaj w nim nazwy pluginu lub moda – często widać ją w nazwie pakietu, na przykład at com.example.mujplugin.….
3. Jeśli w śladzie są linie Caused by:, prawdziwa przyczyna jest zwykle w ostatniej z nich.
4. Linie WARN to ostrzeżenia. Serwer zwykle działa dalej i nie musisz się nimi zajmować, dopóki coś nie przestanie działać.

Plik logs/latest.log pobierzesz w zakładce Pliki przyciskiem Pobierz albo otworzysz go od razu w edytorze.

You need to agree to the EULA in order to run the server. Go to eula.txt for more info.#

Przyczyna: Nie zaakceptowano warunków licencji Minecrafta (EULA). Serwer wyłącza się zaraz po starcie.

Rozwiązanie:

1. Otwórz zakładkę Oprogramowanie.
2. W bloku Minecraft EULA kliknij Zaakceptuj i uruchom.

Na własnym VPS otwórz plik eula.txt w folderze serwera i zmień eula=false na eula=true. Szczegóły znajdziesz w poradniku Pierwsze uruchomienie i EULA.

**** FAILED TO BIND TO PORT!#

Pełny komunikat:

**** FAILED TO BIND TO PORT!
The exception was: java.net.BindException: Address already in use
Perhaps a server is already running on that port?

Przyczyna: Port, na którym serwer ma nasłuchiwać, jest już zajęty przez inny program.

Rozwiązanie w StormHost: adres i port serwera ustawiamy automatycznie, więc przyczyną jest zwykle jedno z poniższych:

• poprzednie uruchomienie serwera jeszcze się nie zakończyło – kliknij Stop, odczekaj pół minuty, a potem kliknij Start,
• plugin lub mod (mapa w przeglądarce, czat głosowy, Geyser) ma ustawiony port serwera – w jego konfiguracji ustaw inny port z zakładki Sieć (Dodaj port).

Jeśli błąd nie znika, skontaktuj się z pomocą techniczną.

Rozwiązanie na własnym VPS: sprawdź, co używa portu:

ss -tulpn | grep 25565

• ss -tulpn – wypisuje nasłuchujące porty TCP i UDP razem z programami, które ich używają.
• grep 25565 – zostawia tylko linie z portem 25565 (wpisz swój port).

Zatrzymaj drugi program (często zapomniany, wciąż działający serwer) albo użyj innego portu.

Podobny błąd Address already in use z Geysera oznacza, że na tym samym porcie UDP działa coś innego, typowo Query. Zobacz Crossplay z Bedrockiem.

java.lang.UnsupportedClassVersionError#

Pełny komunikat wygląda na przykład tak:

java.lang.UnsupportedClassVersionError: com/example/plugin/Main has been compiled by a more recent version of the Java Runtime (class file version 69.0), this version of the Java Runtime only recognizes class file versions up to 65.0

Przyczyna: Serwer lub plugin potrzebuje nowszej Javy niż ta, na której działa serwer. Liczby „class file version” odpowiadają wersjom Javy:

W przykładzie plugin potrzebuje Javy 25 (69), ale serwer działa na Javie 21 (65).

Rozwiązanie:

• Błąd pochodzi z pluginu lub moda: Javę dobieramy automatycznie według wersji Minecrafta (do 1.16.5 Java 8, 1.17 Java 16, 1.18–⁠1.20.4 Java 17, 1.20.5–⁠1.21.x Java 21, 26.x Java 25). Pobierz wersję pluginu przeznaczoną dla Twojej wersji Minecrafta albo zaktualizuj serwer do nowszej wersji Minecrafta (poradnik).
• Błąd pochodzi z samego serwera (komunikat wymienia klasę serwera, a nie pluginu): serwer prawdopodobnie nie był instalowany przez zakładkę Oprogramowanie. Użyj Oprogramowanie › Zainstaluj ponownie albo Import i wybierz rzeczywisty typ i wersję – strefa klienta ustawi wtedy właściwą Javę.

Incompatible client! Please use …#

W starszych wersjach gry Outdated client! Please use … lub Outdated server! I'm still on …. Na liście serwerów serwer pokazuje na czerwono Incompatible version!.

Przyczyna: Gracz ma inną wersję gry niż serwer. Komunikat kończy się wersją, której wymaga serwer.

Rozwiązanie:

• Gracz wybiera w launcherze tę samą wersję co serwer (wersję serwera widzisz w zakładce Oprogramowanie).
• Aby mogli dołączać gracze z nowszą wersją gry, zainstaluj na serwerze plugin ViaVersion (Paper, Purpur). Dla graczy ze starszą wersją dodaj jeszcze ViaBackwards.
• Na serwerach z modami gracze potrzebują dokładnie tej samej wersji gry, loadera i modów.

Failed to connect to the server / Connection refused#

Na liście serwerów przy serwerze widnieje Can't connect to server.

Przyczyna: Pod wpisanym adresem i portem nic nie nasłuchuje.

Rozwiązanie:

1. W zakładce Konsola sprawdź, czy serwer działa i czy w konsoli jest linia Done (…)! For help, type "help". Dopóki serwer się uruchamia, nie da się połączyć.
2. Porównaj adres wpisany przez gracza z Adresem połączenia w zakładce Sieć – łącznie z portem po dwukropku.
3. Jeśli gracz łączy się przez domenę, sprawdź rekordy DNS według poradnika Adres serwera i domena.
4. Sprawdź serwer narzędziem Minecraft Status.

Can't resolve hostname#

Przyczyna: Gra nie znalazła domeny w DNS (literówka, brak rekordu A albo zmiana jeszcze się nie rozeszła).

Rozwiązanie: Sprawdź adres i rekordy DNS według poradnika Adres serwera i domena. W międzyczasie gracze mogą łączyć się przez adres IP i port z zakładki Sieć.

Can't keep up! Is the server overloaded? Running 2500ms or 50 ticks behind#

Przyczyna: Serwer nie nadąża z grą. W przykładzie ma 2,5 sekundy (50 ticków) opóźnienia.

Rozwiązanie: Pojedynczy komunikat przy starcie albo podczas generowania nowego terenu jest w porządku. Jeśli powtarza się stale, serwer laguje. Jak znaleźć przyczynę (spark, zasięg widzenia, pregenerowanie świata), opisuje poradnik Wydajność serwera Minecraft.

java.lang.OutOfMemoryError: Java heap space#

Albo serwer wyłącza się bez błędu w logu (ostatnie linie logs/latest.log nie dotyczą wyłączania, brakuje Stopping server), a w Konsoli są linie Exit code: 137 i Out of memory: true.

Przyczyna: Serwerowi zabrakło pamięci. Java heap space oznacza pełną stertę: serwer trzyma więcej danych, niż się mieści (duży modpack, wielu graczy, ogromny świat), albo plugin lub mod ma wyciek pamięci. Wyłączenie bez błędu oznacza, że łączna pamięć Javy (sterta plus pamięć poza nią) przekroczyła limit pakietu i system zatrzymał serwer. OutOfMemoryError: Direct buffer memory lub Metaspace wskazuje na plugin lub mod, który wyczerpał limit buforów sieciowych lub wczytanych klas.

Rozwiązanie:

1. W zakładce Uruchamianie sprawdź ostrzeżenia przy parametrach startowych. Jeśli sterta jest za duża na pakiet albo polecenie nie ma limitów pamięci, kliknij Użyj zalecanych. Po zmianie pakietu parametry przeliczają się automatycznie.
2. Wpisz w konsoli spark health i obserwuj pamięć. Jeśli nawet po odśmiecaniu (garbage collection) zostaje prawie pełna, uruchom spark heapsummary – pokaże, co zajmuje pamięć.
3. Jeśli to zwykłe obciążenie, przejdź na większy pakiet w zakładce Zmiana pakietu.

Szczegóły znajdziesz w poradniku Wydajność serwera Minecraft.

Failed to verify username!#

Gracz może też zobaczyć w grze Failed to log in: Invalid session (Try restarting your game and the launcher) lub Authentication servers are down. Please try again later. Sorry!.

Przyczyna: Serwer (z online-mode=true) nie zdołał zweryfikować konta gracza w Microsofcie. Logowanie gracza wygasło, serwery uwierzytelniania nie działają albo gracz nie używa oryginalnej kopii gry.

Rozwiązanie:

• Gracz całkowicie zamyka grę i launcher, wylogowuje się, loguje ponownie i próbuje jeszcze raz.
• Jeśli serwery uwierzytelniania nie działają, poczekaj.
• Nie zalecamy wyłączania online-mode – wpuściłoby to każdego pod dowolnym nickiem (dlaczego).

You are not white-listed on this server!#

Przyczyna: Whitelista jest włączona, a gracza na niej nie ma. Od wersji 26.3 whitelista jest włączona nawet na nowo utworzonym serwerze.

Rozwiązanie: W konsoli wpisz whitelist add <NICK> (zamiast <NICK> wpisz nick gracza, bez nawiasów ostrych). Graczy Bedrocka dodasz poleceniem fwhitelist add <NICK>. Whitelistę wyłączysz w zakładce Ustawienia serwera (Whitelista). Szczegóły znajdziesz w poradniku Whitelista, operatorzy i bany.

Multiplayer is disabled. Please check your Microsoft account settings.#

Przyczyna: Konto gracza nie ma zgody na grę wieloosobową (typowo konto dziecka albo ustawienia prywatności Xbox).

Rozwiązanie: Gracz (lub rodzic) zezwala na grę wieloosobową w ustawieniach konta Microsoft / Xbox. Na serwerze nie ma nic do zmiany.

Expired profile public key. Check that your system time is synchronized, and try restarting your game.#

Przyczyna: Komputer gracza ma złą godzinę.

Rozwiązanie: Gracz włącza automatyczny czas w ustawieniach systemu i uruchamia grę ponownie.

The server is full!#

Przyczyna: Połączonych jest tylu graczy, na ilu pozwala max-players.

Rozwiązanie: Zwiększ Maksimum graczy w zakładce Ustawienia serwera i uruchom serwer ponownie. Pamiętaj o wydajności – więcej graczy to większe obciążenie.

Could not load 'plugins/….jar' in 'plugins'#

Podobne komunikaty to Could not load plugin '….jar' in folder 'plugins' oraz w starszych wersjach Could not load 'plugins/….jar' in folder 'plugins'. Pod komunikatem są zwykle szczegóły, najczęściej:

org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [Vault]. Please download and install these plugins to run 'MujPlugin'.

Przyczyna: Plugin potrzebuje innego pluginu (zależności), którego brakuje na serwerze – w tym przykładzie Vault.

Rozwiązanie: Zainstaluj brakujący plugin podany w nawiasach kwadratowych. Przy instalacji przez zakładkę Pluginy wymagane zależności są proponowane automatycznie. Inne przyczyny tego komunikatu: uszkodzony plik (pobierz go ponownie), plugin dla innego typu serwera (mod Fabric w folderze plugins) lub dla innej wersji Minecrafta. Więcej w poradniku Instalacja pluginów.

Error occurred while enabling … (Is it up to date?)#

Przyczyna: Plugin się wczytał, ale padł podczas włączania. Najczęściej jest przeznaczony dla innej wersji Minecrafta, ma błąd w konfiguracji albo nie połączył się ze swoją bazą danych.

Rozwiązanie:

1. Pod komunikatem znajdź ostatnią linię Caused by: – powie Ci, co się stało.
2. Sprawdź, czy wersja pluginu obsługuje wersję Twojego serwera (zakładka Pluginy › Sprawdź aktualizacje).
3. Błąd konfiguracji (.yml): zwykle zdradzają go słowa YAML, ScannerException lub mapping values are not allowed here z numerem linii. Popraw wcięcia (tylko spacje) albo usuń plik konfiguracyjny pluginu – przy następnym starcie powstanie domyślny.
4. Błąd bazy danych: zobacz MySQL dla pluginów.

Mody: Incompatible mods found!#

Serwer Fabric nie startuje, a pod komunikatem widzisz na przykład:

Incompatible mods found!
A potential solution has been determined, this may resolve your problem:
    - Install fabric-api, any version.

Przyczyna: Mod potrzebuje innego moda (często Fabric API) albo innej wersji Minecrafta lub loadera. Fabric wypisuje dokładne rozwiązanie (Install …, Replace …, Remove …).

Rozwiązanie: Zrób to, co proponuje Fabric. Linia w postaci <MOD> requires <VERSION> of <DEPENDENCY>, which is missing! mówi, czego brakuje.

Mody: Attempted to load class … for invalid dist DEDICATED_SERVER#

Przyczyna: Na serwerze jest mod przeznaczony tylko dla gry (klienta) – na przykład minimapa, shadery albo poprawka menu. Serwer nie może go wczytać.

Rozwiązanie: Znajdź nazwę moda w komunikacie lub w raporcie awarii i usuń go z folderu mods (albo w zakładce Mody). Mody klienckie gracze instalują tylko we własnej grze. Więcej w poradniku Mody i modpacki.

Mody: gracze są wyrzucani przy dołączaniu z listą modów#

Przyczyna: Gracz nie ma tych samych modów lub tych samych wersji modów co serwer.

Rozwiązanie: Gracze potrzebują tego samego modpacka w tej samej wersji co serwer. Pobierają modpack z tego samego źródła (Modrinth, CurseForge) i wybierają tę samą wersję.

Uszkodzony chunk: Failed to read chunk [x, z]#

Inne podobne komunikaty: Region file … has truncated header, Failed to read chunks from region file ….

Przyczyna: Część świata jest uszkodzona, najczęściej po awarii serwera albo niedokończonym zapisie.

Rozwiązanie:

1. Najbezpieczniej jest przywrócić kopię zapasową z zakładki Kopie zapasowe (poradnik).
2. Bez kopii zapasowej możesz usunąć tylko uszkodzony plik regionu. Region to plik r.<X>.<Z>.mca, gdzie <X> i <Z> to współrzędne chunka z komunikatu podzielone przez 32 i zaokrąglone w dół (chunk [70, -5] jest w r.2.-1.mca). Znajdziesz go w folderze world/dimensions/minecraft/overworld/region (od wersji 26.1), w starszych wersjach w world/region.

Komunikat Chunk file at [x, z] is in the wrong location; relocating. nie jest błędem – serwer sam przeniósł chunk we właściwe miejsce.

Failed to load datapacks, can't proceed with server load.#

Przyczyna: Datapack w świecie jest uszkodzony albo przeznaczony dla innej wersji Minecrafta (często po zmianie wersji).

Rozwiązanie: W zakładce Pliki otwórz folder world/datapacks, przenieś wadliwy datapack gdzie indziej (albo go usuń) i uruchom serwer. Który to jest, powiedzą Ci linie nad komunikatem. Jeśli nie masz pewności, przywróć kopię zapasową sprzed zmiany wersji.

Timed out / Connection Lost#

Przyczyna: Połączenie między grą a serwerem zostało zerwane. Albo po stronie gracza (Wi-Fi, dane komórkowe), albo serwer na chwilę zamarzł i nie odpowiedział na czas.

Rozwiązanie:

• Rozłączony został tylko jeden gracz: problem leży w jego połączeniu. Może spróbować kabla albo innej sieci.
• Rozłączeni zostali wszyscy naraz: serwer zamarzł. Poszukaj w konsoli Can't keep up! lub komunikatów watchdoga (patrz niżej) i postępuj według poradnika Wydajność serwera Minecraft.

Serwer zamarza i się wyłącza: A single server tick took 60.00 seconds (should be max 0.05)#

Tak wygląda to na Vanilli, Fabricu i NeoForge. Następuje po tym Considering it to be crashed, server will forcibly shutdown.

Na Paperze i Purpurze zamarznięcia pilnuje ich własny watchdog i komunikaty są inne. Już po 10 sekundach zamarznięcia jest wielokrotnie wypisywane --- DO NOT REPORT THIS TO PAPER - THIS IS NOT A BUG OR A CRASH ze zrzutem głównego wątku. Gdy zamarznięcie trwa 60 sekund, wypisywany jest blok zaczynający się od The server has stopped responding! This is (probably) not a Paper bug. ze zrzutem wątków, a serwer się wyłącza.

Przyczyna: Pojedynczy tick trwał ponad 60 sekund, serwer uznał, że zamarzł, i się wyłączył. Limit ustawia max-tick-time w server.properties (Vanilla, Fabric, NeoForge), a na Paperze i Purpurze settings.timeout-time w spigot.yml. Najczęściej plugin czeka na głównym wątku na bazę danych albo internet, albo wybucha ogromna konstrukcja z redstone'em lub tysiące TNT.

Rozwiązanie: W zrzucie wątków znajdź Server thread (na Paperze blok Server thread dump) i poszukaj w nim nazwy pluginu lub moda. Zaktualizuj albo usuń ten plugin. Nie podnoś ani nie wyłączaj limitu – zamarznięty serwer wisiałby wtedy długo albo w nieskończoność.

Konsola: Unknown or incomplete command. See below for error#

Przyczyna: Polecenie nie istnieje (literówka) albo należy do pluginu, który się nie wczytał.

Rozwiązanie: Sprawdź nazwę polecenia i miejsce oznaczone <--[HERE] pod komunikatem, gdzie jest błąd. W konsoli polecenia wpisuje się bez ukośnika. Listę poleceń znajdziesz w poradniku Konsola i polecenia.

Strefa klienta: Parametry nie są zgodne, przywrócono poprzednie ustawienia.#

Przyczyna: Serwer nie wystartował z nowymi parametrami startowymi, więc strefa klienta je cofnęła.

Rozwiązanie: W zakładce Uruchamianie sprawdź Własne parametry (literówka, parametr dla innej wersji Javy) albo wybierz domyślny preset Zalecane (G1). Więcej w poradniku Wydajność serwera Minecraft.

Gdy nadal nie działa#

Napisz do nas i wyślij:

• ID usługi lub nazwę serwera (znajdziesz je w Moich usługach),
• co zrobiłeś tuż przed błędem (aktualizacja, nowy plugin, zmiana wersji),
• plik logs/latest.log (pobierzesz go w zakładce Pliki) i, jeśli istnieje, najnowszy plik z folderu crash-reports,
• przy lagach link do profilu z spark profiler start --timeout 600,
• dokładny czas wystąpienia błędu.

Nigdy nie wysyłaj haseł ani zawartości key.pem czy forwarding.secret.

Dalsza lektura#

• Serwer na Minecraft Wiki (otwiera się w nowym oknie)
• Dokumentacja Papera (otwiera się w nowym oknie)
• Profilowanie sparkiem (otwiera się w nowym oknie)