Časté chyby Minecraft servera a ako ich opraviť

Nájdete tu najčastejšie chybové hlášky Minecraft servera aj hry s vysvetlením, čo znamenajú a ako ich opraviť. Hlášky uvádzame presne v angličtine, ako ich uvidíte, takže ich stačí vyhľadať (Ctrl+F alebo hľadanie v návodoch).

Ako čítať log#

Server zapisuje všetko, čo robí, do konzoly a do súborov:

Ako v logu nájsť príčinu:

1. Nájdite prvý riadok s ERROR alebo Exception – ďalšie chyby bývajú iba následky.
2. Pod chybou je výpis volaní (riadky začínajúce at …). Hľadajte v ňom názov pluginu alebo modu – často je vidieť v názve balíka, napríklad at com.example.mujplugin.….
3. Ak sú vo výpise riadky Caused by:, skutočná príčina býva v poslednom z nich.
4. Riadky WARN sú varovania. Server zvyčajne beží ďalej a nemusíte ich riešiť, ak niečo neprestane fungovať.

Súbor logs/latest.log stiahnete v záložke Súbory tlačidlom Stiahnuť, alebo ho otvoríte priamo v editore.

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

Príčina: Neprijali ste licenčné podmienky Minecraftu (EULA). Server sa hneď po štarte sám vypne.

Riešenie:

1. Otvorte záložku Softvér.
2. V bloku Minecraft EULA kliknite na Prijať a spustiť.

Na vlastnej VPS otvorte súbor eula.txt v priečinku servera a zmeňte eula=false na eula=true. Podrobne v návode Prvé spustenie a EULA.

**** FAILED TO BIND TO PORT!#

Celá hláška:

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

Príčina: Port, na ktorom má server počúvať, už používa iný program.

Riešenie u nás: adresu a port servera nastavujeme automaticky, takže príčinou býva:

• predchádzajúci beh servera sa ešte neukončil – kliknite na Vypnúť, počkajte pol minúty a potom Spustiť,
• plugin alebo mod (webová mapa, hlasový chat, Geyser) je nastavený na port servera – v jeho konfigurácii nastavte iný port zo záložky Sieť (Pridať port).

Ak chyba trvá, napíšte podpore.

Riešenie na vlastnej VPS: zistite, čo port používa:

ss -tulpn | grep 25565

• ss -tulpn – vypíše počúvajúce TCP a UDP porty aj s programami, ktoré ich používajú.
• grep 25565 – nechá iba riadky s portom 25565 (dosaďte svoj port).

Ukončite druhý program (často zabudnutý bežiaci server), alebo použite iný port.

Podobná chyba Address already in use pri Geyseri znamená, že na rovnakom UDP porte beží niečo iné, typicky Query. Pozrite Crossplay s Bedrockom.

java.lang.UnsupportedClassVersionError#

Celá hláška vyzerá napríklad takto:

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

Príčina: Server alebo plugin vyžaduje novšiu Javu, než na akej server beží. Čísla „class file version“ zodpovedajú verziám Javy:

V príklade plugin potrebuje Javu 25 (69), server však beží na Jave 21 (65).

Riešenie:

• Chyba pri plugine alebo mode: Javu u nás volíme automaticky podľa verzie Minecraftu (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). Stiahnite verziu pluginu určenú pre vašu verziu Minecraftu, alebo server aktualizujte na novšiu verziu Minecraftu (návod).
• Chyba pri samotnom serveri (v hláške je trieda servera, nie pluginu): server pravdepodobne nebol nainštalovaný cez záložku Softvér. Použite Softvér › Preinštalovať, alebo Import a zvoľte skutočný typ a verziu – zákaznícka zóna potom nastaví správnu Javu.

Incompatible client! Please use …#

V starších verziách hry Outdated client! Please use … alebo Outdated server! I'm still on …. V zozname serverov je pri serveri načerveno Incompatible version!.

Príčina: Hráč má inú verziu hry než server. Za hláškou je verzia, ktorú server vyžaduje.

Riešenie:

• Hráč si v launcheri zvolí rovnakú verziu, akú má server (verziu servera vidíte v záložke Softvér).
• Aby sa mohli pripojiť hráči s novšou verziou hry, nainštalujte na server (Paper, Purpur) plugin ViaVersion. Pre hráčov so staršou verziou navyše ViaBackwards.
• Pri modovaných serveroch musí mať hráč presne rovnakú verziu hry, loadera aj modov.

Failed to connect to the server / Connection refused#

V zozname serverov je pri serveri Can't connect to server.

Príčina: Na zadanej adrese a porte nič nepočúva.

Riešenie:

1. V záložke Konzola skontrolujte, že server beží a v konzole je riadok Done (…)! For help, type "help". Kým sa server spúšťa, pripojiť sa nedá.
2. Porovnajte adresu, ktorú hráč zadal, s Adresou na pripojenie v záložke Sieť – vrátane portu za dvojbodkou.
3. Keď sa hráč pripája cez doménu, overte záznamy DNS podľa návodu Adresa servera a doména.
4. Skontrolujte server nástrojom Minecraft Status.

Can't resolve hostname#

Príčina: Hra nenašla zadanú doménu v DNS (preklep, chýbajúci záznam A, zmena sa ešte nerozšírila).

Riešenie: Skontrolujte adresu a záznamy DNS podľa návodu Adresa servera a doména. Medzitým sa hráči môžu pripojiť cez IP adresu a port zo záložky Sieť.

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

Príčina: Server nestíha počítať hru. V príklade je 2,5 sekundy (50 tickov) pozadu.

Riešenie: Jedna hláška pri štarte alebo pri generovaní nového terénu neprekáža. Ak sa opakuje, server laguje. Postup hľadania príčiny (spark, view distance, predgenerovanie sveta) nájdete v návode Výkon Minecraft servera.

java.lang.OutOfMemoryError: Java heap space#

Alebo sa server sám vypne bez chyby v logu (posledné riadky logs/latest.log nie sú o vypínaní, chýba Stopping server) a v Konzole sú riadky Exit code: 137 a Out of memory: true.

Príčina: Došla pamäť. Java heap space znamená plnú haldu: na serveri je viac dát, než sa do nej zmestí (veľký modpack, mnoho hráčov, obrovský svet), alebo plugin či mod pamäť „stráca“. Vypnutie bez chyby znamená, že celková pamäť Javy (halda aj pamäť mimo nej) prekročila limit balíka a systém server ukončil. OutOfMemoryError: Direct buffer memory alebo Metaspace ukazuje na plugin alebo mod, ktorý narazil na strop sieťových bufferov alebo načítaných tried.

Riešenie:

1. V záložke Spustenie skontrolujte upozornenia pri spúšťacích parametroch. Keď je halda na balík príliš veľká alebo príkaz nemá stropy pamäte, kliknite na Použiť odporúčané. Po zmene balíka sa parametre prepočítajú samy.
2. V konzole spustite spark health a sledujte pamäť. Keď po upratovaní zostáva takmer plná, spustite spark heapsummary – ukáže, čo pamäť zaberá.
3. Ak ide o bežné zaťaženie, prejdite na väčší balík v záložke Zmena balíka.

Podrobnosti v návode Výkon Minecraft servera.

Failed to verify username!#

Hráč môže v hre vidieť aj Failed to log in: Invalid session (Try restarting your game and the launcher) alebo Authentication servers are down. Please try again later. Sorry!.

Príčina: Server (s online-mode=true) nedokázal u Microsoftu overiť účet hráča. Hráčovo prihlásenie vypršalo, overovacie servery majú výpadok, alebo hráč nepoužíva originálnu hru.

Riešenie:

• Hráč úplne zavrie hru aj launcher, odhlási sa, znova sa prihlási a skúsi to znova.
• Pri výpadku overovacích serverov počkajte.
• Vypnutie online-mode neodporúčame – pustilo by kohokoľvek pod akýmkoľvek menom (prečo).

You are not white-listed on this server!#

Príčina: Je zapnutý whitelist a hráč na ňom nie je. Od verzie 26.3 je whitelist zapnutý aj na novo vytvorenom serveri.

Riešenie: V konzole zadajte whitelist add <NICK> (za <NICK> dosaďte meno hráča bez lomených zátvoriek). Hráčov z Bedrocku pridáte príkazom fwhitelist add <NICK>. Whitelist vypnete v záložke Nastavenia servera (Whitelist). Podrobne v návode Whitelist, operátori a bany.

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

Príčina: Účet hráča nemá povolenú hru pre viacerých hráčov (typicky detský účet alebo nastavenie súkromia Xbox).

Riešenie: Hráč (alebo rodič) povolí hru pre viacerých hráčov v nastaveniach účtu Microsoft / Xbox. Na serveri sa nedá nič nastaviť.

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

Príčina: Počítač hráča má zle nastavený čas.

Riešenie: Hráč zapne automatické nastavenie času v systéme a reštartuje hru.

The server is full!#

Príčina: Je pripojených toľko hráčov, koľko povoľuje max-players.

Riešenie: Zvýšte Maximum hráčov v záložke Nastavenia servera a server reštartujte. Pozor na výkon – viac hráčov znamená viac záťaže.

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

Podobne vyzerajú hlášky Could not load plugin '….jar' in folder 'plugins' a v starších verziách Could not load 'plugins/….jar' in folder 'plugins'. Pod hláškou býva spresnenie, najčastejšie:

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

Príčina: Plugin potrebuje iný plugin (závislosť), ktorý na serveri chýba – v príklade Vault.

Riešenie: Nainštalujte chýbajúci plugin z hranatých zátvoriek. Pri inštalácii cez záložku Pluginy sa povinné závislosti ponúknu samy. Iné príčiny tejto hlášky: poškodený súbor (stiahnite ho znova), plugin pre iný typ servera (mod pre Fabric v priečinku plugins) alebo pre inú verziu Minecraftu. Viac v návode Inštalácia pluginov.

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

Príčina: Plugin sa načítal, ale pri zapnutí spadol. Najčastejšie je pre inú verziu Minecraftu, má chybu v konfigurácii, alebo sa nepripojil k databáze.

Riešenie:

1. Pod hláškou nájdite posledný riadok Caused by: – povie, čo sa stalo.
2. Skontrolujte, že verzia pluginu podporuje vašu verziu servera (záložka Pluginy › Skontrolovať aktualizácie).
3. Chyba v konfigurácii (.yml): zvyčajne ju prezradia slová YAML, ScannerException alebo mapping values are not allowed here a číslo riadka. Opravte odsadenie (iba medzery) alebo zmažte konfiguračný súbor pluginu – pri štarte sa vytvorí predvolený.
4. Chyba databázy: pozrite MySQL pre pluginy.

Mody: Incompatible mods found!#

Server s Fabricom sa nespustí a pod hláškou je napríklad:

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

Príčina: Mod potrebuje iný mod (často Fabric API) alebo inú verziu Minecraftu či loadera. Fabric vypíše presné riešenie (Install …, Replace …, Remove …).

Riešenie: Urobte, čo Fabric navrhuje. Riadok v tvare <MOD> requires <VERZE> of <ZAVISLOST>, which is missing! hovorí, čo chýba.

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

Príčina: Na serveri je mod určený iba pre hru (klienta) – napríklad minimapa, shadery alebo úprava menu. Server ho nedokáže načítať.

Riešenie: Nájdite v hláške alebo v crash reporte názov modu a odoberte ho z priečinka mods (alebo v záložke Mody). Klientske mody si hráči inštalujú iba do svojej hry. Viac v návode Mody a modpacky.

Mody: hráča pri pripojení odpojí so zoznamom modov#

Príčina: Hráč nemá rovnaké mody alebo ich rovnaké verzie ako server.

Riešenie: Hráči musia mať rovnaký modpack v rovnakej verzii ako server. Modpack si stiahnu z rovnakého zdroja (Modrinth, CurseForge) a zvolia rovnakú verziu.

Poškodený chunk: Failed to read chunk [x, z]#

Ďalšie podobné hlášky: Region file … has truncated header, Failed to read chunks from region file ….

Príčina: Časť sveta je poškodená, najčastejšie po páde servera alebo nedokončenom ukladaní.

Riešenie:

1. Najbezpečnejšie je obnoviť zálohu zo záložky Zálohy (návod).
2. Bez zálohy môžete zmazať iba poškodený súbor regiónu. Región je súbor r.<X>.<Z>.mca, kde <X> a <Z> sú súradnice chunku z hlášky vydelené 32 a zaokrúhlené nadol (chunk [70, -5] je v r.2.-1.mca). Nájdete ho v priečinku world/dimensions/minecraft/overworld/region (od verzie 26.1), v starších verziách v world/region.

Hláška Chunk file at [x, z] is in the wrong location; relocating. chybou nie je – server chunk presunul na správne miesto sám.

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

Príčina: Datapack vo svete je poškodený alebo určený pre inú verziu Minecraftu (často po zmene verzie).

Riešenie: V záložke Súbory otvorte priečinok world/datapacks, chybný datapack presuňte inam (alebo zmažte) a server spustite. Ktorý to je, prezradia riadky nad hláškou. Ak neviete, obnovte zálohu z času pred zmenou verzie.

Timed out / Connection Lost#

Príčina: Spojenie medzi hrou a serverom sa prerušilo. Buď na strane hráča (Wi-Fi, mobilné pripojenie), alebo server na chvíľu zamrzol a nestihol odpovedať.

Riešenie:

• Odpojilo jedného hráča: problém je v jeho pripojení. Skúsi kábel alebo inú sieť.
• Odpojilo všetkých naraz: server zamrzol. V konzole hľadajte Can't keep up! alebo hlášky strážneho psa (pozrite nižšie) a postupujte podľa návodu Výkon Minecraft servera.

Server zamrzne a vypne sa: A single server tick took 60.00 seconds (should be max 0.05)#

Takto to vyzerá na Vanille, Fabricu a NeoForge. Nasleduje Considering it to be crashed, server will forcibly shutdown.

Na Paperi a Purpure stráži zamrznutie ich vlastný strážny pes (watchdog) a hlášky sú iné. Už po 10 sekundách zamrznutia sa opakovane vypisuje --- DO NOT REPORT THIS TO PAPER - THIS IS NOT A BUG OR A CRASH s výpisom hlavného vlákna. Keď zamrznutie trvá 60 sekúnd, vypíše sa blok začínajúci The server has stopped responding! This is (probably) not a Paper bug. s výpisom vlákien (thread dump) a server sa vypne.

Príčina: Jeden tick trval viac než 60 sekúnd, server usúdil, že zamrzol, a vypol sa. Limit určuje max-tick-time v server.properties (Vanilla, Fabric, NeoForge), na Paperi a Purpure settings.timeout-time v spigot.yml. Najčastejšie plugin čaká na databázu alebo internet v hlavnom vlákne, obrovská redstonová stavba, alebo explózia tisícov TNT.

Riešenie: Vo výpise vlákien nájdite Server thread (na Paperi blok Server thread dump) a v ňom názov pluginu alebo modu. Plugin aktualizujte alebo odoberte. Limit nezvyšujte ani nevypínajte – zamrznutý server by potom visel dlho alebo donekonečna.

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

Príčina: Príkaz neexistuje (preklep), alebo patrí pluginu, ktorý sa nenačítal.

Riešenie: Skontrolujte názov príkazu a pod hláškou miesto označené <--[HERE], kde je chyba. V konzole sa príkazy píšu bez lomky. Zoznam príkazov nájdete v návode Konzola a príkazy.

Zákaznícka zóna: Parametre nie sú kompatibilné, vrátené na predchádzajúce nastavenie.#

Príčina: Server s novými spúšťacími parametrami nenaštartoval a zákaznícka zóna ich vrátila.

Riešenie: V záložke Spustenie skontrolujte Vlastné parametre (preklep, parameter pre inú verziu Javy) alebo zvoľte predvolený preset Odporúčané (G1). Viac v návode Výkon Minecraft servera.

Keď niečo nefunguje ani po oprave#

Napíšte nám a pošlite:

• ID služby alebo názov servera (nájdete ho v Moje služby),
• čo ste robili tesne pred chybou (aktualizácia, nový plugin, zmena verzie),
• súbor logs/latest.log (stiahnite ho v záložke Súbory), prípadne najnovší súbor z priečinka crash-reports,
• pri lagu odkaz na profil zo spark profiler start --timeout 600,
• presný čas, kedy sa chyba stala.

Heslá, obsah key.pem ani forwarding.secret nikdy neposielajte.

Ďalšie zdroje#

• Server na Minecraft Wiki (otvorí sa v novom okne)
• Dokumentácia Paperu (otvorí sa v novom okne)
• Profilovanie so spark (otvorí sa v novom okne)