Časté chyby Minecraft serveru a jak je opravit

Tady najdete nejčastější chybové hlášky Minecraft serveru i hry s vysvětlením, co znamenají a jak je opravit. Hlášky uvádíme přesně v angličtině, jak je uvidíte, takže je stačí vyhledat (Ctrl+F nebo hledání v návodech).

Jak číst log#

Server zapisuje vše, co dělá, do konzole a do souborů:

Jak v logu najít příčinu:

1. Najděte první řádek s ERROR nebo Exception – další chyby bývají jen následky.
2. Pod chybou je výpis volání (řádky začínající at …). Hledejte v něm název pluginu nebo módu – často je vidět v názvu balíčku, například at com.example.mujplugin.….
3. Pokud jsou ve výpisu řádky Caused by:, skutečná příčina bývá v posledním z nich.
4. Řádky WARN jsou varování. Server obvykle běží dál a nemusíte je řešit, pokud něco nepřestane fungovat.

Soubor logs/latest.log stáhnete v záložce Soubory tlačítkem Stáhnout, nebo ho otevřete přímo v editoru.

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

Příčina: Nepřijali jste licenční podmínky Minecraftu (EULA). Server se hned po startu sám vypne.

Řešení:

1. Otevřete záložku Software.
2. V bloku Minecraft EULA klikněte na Přijmout a spustit.

Na vlastní VPS otevřete soubor eula.txt ve složce serveru a změňte eula=false na eula=true. Podrobně v návodu První spuštění 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?

Příčina: Port, na kterém má server poslouchat, už používá jiný program.

Řešení u nás: adresu a port serveru nastavujeme automaticky, takže příčinou bývá:

• předchozí běh serveru se ještě neukončil – klikněte na Vypnout, počkejte půl minuty a pak Spustit,
• plugin nebo mód (webová mapa, hlasový chat, Geyser) je nastavený na port serveru – v jeho konfiguraci nastavte jiný port ze záložky Síť (Přidat port).

Pokud chyba trvá, napište podpoře.

Řešení na vlastní VPS: zjistěte, co port používá:

ss -tulpn | grep 25565

• ss -tulpn – vypíše naslouchající TCP a UDP porty i s programy, které je používají.
• grep 25565 – nechá jen řádky s portem 25565 (dosaďte svůj port).

Ukončete druhý program (často zapomenutý běžící server), nebo použijte jiný port.

Podobná chyba Address already in use u Geyseru znamená, že na stejném UDP portu běží něco jiného, typicky Query. Viz Crossplay s Bedrockem.

java.lang.UnsupportedClassVersionError#

Celá hláška vypadá napří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

Příčina: Server nebo plugin vyžaduje novější Javu, než na které server běží. Čísla „class file version“ odpovídají verzím Javy:

V příkladu plugin potřebuje Javu 25 (69), server ale běží na Javě 21 (65).

Řešení:

• Chyba u pluginu nebo módu: Javu u nás volíme automaticky podle verze 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). Stáhněte verzi pluginu určenou pro vaši verzi Minecraftu, nebo server aktualizujte na novější verzi Minecraftu (návod).
• Chyba u samotného serveru (v hlášce je třída serveru, ne pluginu): server pravděpodobně nebyl nainstalovaný přes záložku Software. Použijte Software › Přeinstalovat, nebo Import a zvolte skutečný typ a verzi – zákaznická zóna pak nastaví správnou Javu.

Incompatible client! Please use …#

Ve starších verzích hry Outdated client! Please use … nebo Outdated server! I'm still on …. V seznamu serverů je u serveru červeně Incompatible version!.

Příčina: Hráč má jinou verzi hry než server. Za hláškou je verze, kterou server vyžaduje.

Řešení:

• Hráč si v launcheru zvolí stejnou verzi, jakou má server (verzi serveru vidíte v záložce Software).
• Aby se mohli připojit hráči s novější verzí hry, nainstalujte na server (Paper, Purpur) plugin ViaVersion. Pro hráče se starší verzí navíc ViaBackwards.
• U módovaných serverů musí mít hráč přesně stejnou verzi hry, loaderu i módů.

Failed to connect to the server / Connection refused#

V seznamu serverů je u serveru Can't connect to server.

Příčina: Na zadané adrese a portu nic neposlouchá.

Řešení:

1. V záložce Konzole zkontrolujte, že server běží a v konzoli je řádek Done (…)! For help, type "help". Dokud se server spouští, připojit se nejde.
2. Porovnejte adresu, kterou hráč zadal, s Adresou pro připojení v záložce Síť – včetně portu za dvojtečkou.
3. Když se hráč připojuje přes doménu, ověřte záznamy DNS podle návodu Adresa serveru a doména.
4. Zkontrolujte server nástrojem Minecraft Status.

Can't resolve hostname#

Příčina: Hra nenašla zadanou doménu v DNS (překlep, chybějící záznam A, změna se ještě nerozšířila).

Řešení: Zkontrolujte adresu a záznamy DNS podle návodu Adresa serveru a doména. Mezitím se hráči mohou připojit přes IP adresu a port ze záložky Síť.

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

Příčina: Server nestíhá počítat hru. V příkladu je 2,5 sekundy (50 ticků) pozadu.

Řešení: Jedna hláška při startu nebo při generování nového terénu nevadí. Pokud se opakuje, server laguje. Postup hledání příčiny (spark, view distance, předgenerování světa) najdete v návodu Výkon Minecraft serveru.

java.lang.OutOfMemoryError: Java heap space#

Nebo se server sám vypne bez chyby v logu (poslední řádky logs/latest.log nejsou o vypínání, chybí Stopping server) a v Konzoli jsou řádky Exit code: 137 a Out of memory: true.

Příčina: Došla paměť. Java heap space znamená plnou haldu: na serveru je víc dat, než se do ní vejde (velký modpack, mnoho hráčů, obří svět), nebo plugin či mód paměť „ztrácí“. Vypnutí bez chyby znamená, že celková paměť Javy (halda i paměť mimo ni) překročila limit balíčku a systém server ukončil. OutOfMemoryError: Direct buffer memory nebo Metaspace ukazuje na plugin nebo mód, který narazil na strop síťových bufferů nebo načtených tříd.

Řešení:

1. V záložce Spuštění zkontrolujte upozornění u spouštěcích flagů. Když je halda na balíček moc velká nebo příkaz nemá stropy paměti, klikněte na Použít doporučené. Po změně balíčku se flagy přepočítají samy.
2. V konzoli spusťte spark health a sledujte paměť. Když po úklidu zůstává skoro plná, spusťte spark heapsummary – ukáže, co paměť zabírá.
3. Pokud jde o běžné zatížení, přejděte na větší balíček v záložce Změna balíčku.

Podrobnosti v návodu Výkon Minecraft serveru.

Failed to verify username!#

Hráč může ve hře vidět také Failed to log in: Invalid session (Try restarting your game and the launcher) nebo Authentication servers are down. Please try again later. Sorry!.

Příčina: Server (s online-mode=true) nedokázal u Microsoftu ověřit účet hráče. Hráčovo přihlášení vypršelo, ověřovací servery mají výpadek, nebo hráč nepoužívá originální hru.

Řešení:

• Hráč úplně zavře hru i launcher, odhlásí se, znovu přihlásí a zkusí to znovu.
• Při výpadku ověřovacích serverů počkejte.
• Vypnutí online-mode nedoporučujeme – pustilo by kohokoli pod jakýmkoli jménem (proč).

You are not white-listed on this server!#

Příčina: Je zapnutý whitelist a hráč na něm není. Od verze 26.3 je whitelist zapnutý i na nově vytvořeném serveru.

Řešení: V konzoli zadejte whitelist add <NICK> (za <NICK> dosaďte jméno hráče bez špičatých závorek). Hráče z Bedrocku přidáte příkazem fwhitelist add <NICK>. Whitelist vypnete v záložce Nastavení serveru (Whitelist). Podrobně v návodu Whitelist, operátoři a bany.

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

Příčina: Účet hráče nemá povolenou hru více hráčů (typicky dětský účet nebo nastavení soukromí Xbox).

Řešení: Hráč (nebo rodič) povolí hru více hráčů v nastavení účtu Microsoft / Xbox. Na serveru se nic nastavit nedá.

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

Příčina: Počítač hráče má špatně nastavený čas.

Řešení: Hráč zapne automatické nastavení času v systému a restartuje hru.

The server is full!#

Příčina: Je připojeno tolik hráčů, kolik povoluje max-players.

Řešení: Zvyšte Maximum hráčů v záložce Nastavení serveru a server restartujte. Pozor na výkon – víc hráčů znamená víc zátěže.

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

Podobně vypadají hlášky Could not load plugin '….jar' in folder 'plugins' a ve starších verzích Could not load 'plugins/….jar' in folder 'plugins'. Pod hláškou bývá upřesnění, nejčastěji:

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

Příčina: Plugin potřebuje jiný plugin (závislost), který na serveru chybí – v příkladu Vault.

Řešení: Nainstalujte chybějící plugin z hranatých závorek. Při instalaci přes záložku Pluginy se povinné závislosti nabídnou samy. Jiné příčiny této hlášky: poškozený soubor (stáhněte ho znovu), plugin pro jiný typ serveru (mód pro Fabric ve složce plugins) nebo pro jinou verzi Minecraftu. Více v návodu Instalace pluginů.

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

Příčina: Plugin se načetl, ale při zapnutí spadl. Nejčastěji je pro jinou verzi Minecraftu, má chybu v konfiguraci, nebo se nepřipojil k databázi.

Řešení:

1. Pod hláškou najděte poslední řádek Caused by: – řekne, co se stalo.
2. Zkontrolujte, že verze pluginu podporuje vaši verzi serveru (záložka Pluginy › Zkontrolovat aktualizace).
3. Chyba v konfiguraci (.yml): obvykle ji prozradí slova YAML, ScannerException nebo mapping values are not allowed here a číslo řádku. Opravte odsazení (jen mezery) nebo smažte konfigurační soubor pluginu – při startu se vytvoří výchozí.
4. Chyba databáze: viz MySQL pro pluginy.

Módy: Incompatible mods found!#

Server s Fabricem se nespustí a pod hláškou je například:

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

Příčina: Mód potřebuje jiný mód (často Fabric API) nebo jinou verzi Minecraftu či loaderu. Fabric vypíše přesné řešení (Install …, Replace …, Remove …).

Řešení: Udělejte, co Fabric navrhuje. Řádek ve tvaru <MOD> requires <VERZE> of <ZAVISLOST>, which is missing! říká, co chybí.

Módy: Attempted to load class … for invalid dist DEDICATED_SERVER#

Příčina: Na serveru je mód určený jen pro hru (klienta) – například minimapa, shadery nebo úprava menu. Server ho nedokáže načíst.

Řešení: Najděte v hlášce nebo v crash reportu název módu a odeberte ho ze složky mods (nebo v záložce Módy). Klientské módy si hráči instalují jen do své hry. Více v návodu Módy a modpacky.

Módy: hráče při připojení odpojí se seznamem módů#

Příčina: Hráč nemá stejné módy nebo jejich stejné verze jako server.

Řešení: Hráči musí mít stejný modpack ve stejné verzi jako server. Modpack si stáhnou ze stejného zdroje (Modrinth, CurseForge) a zvolí stejnou verzi.

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

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

Příčina: Část světa je poškozená, nejčastěji po pádu serveru nebo nedokončeném ukládání.

Řešení:

1. Nejbezpečnější je obnovit zálohu ze záložky Zálohy (návod).
2. Bez zálohy můžete smazat jen poškozený soubor regionu. Region je soubor r.<X>.<Z>.mca, kde <X> a <Z> jsou souřadnice chunku z hlášky vydělené 32 a zaokrouhlené dolů (chunk [70, -5] je v r.2.-1.mca). Najdete ho ve složce world/dimensions/minecraft/overworld/region (od verze 26.1), ve starších verzích v world/region.

Hláška Chunk file at [x, z] is in the wrong location; relocating. chybou není – server chunk přesunul na správné místo sám.

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

Příčina: Datapack ve světě je poškozený nebo určený pro jinou verzi Minecraftu (často po změně verze).

Řešení: V záložce Soubory otevřete složku world/datapacks, vadný datapack přesuňte jinam (nebo smažte) a server spusťte. Který to je, prozradí řádky nad hláškou. Pokud nevíte, obnovte zálohu z doby před změnou verze.

Timed out / Connection Lost#

Příčina: Spojení mezi hrou a serverem se přerušilo. Buď na straně hráče (Wi-Fi, mobilní připojení), nebo server na chvíli zamrzl a nestihl odpovídat.

Řešení:

• Odpojilo jednoho hráče: problém je v jeho připojení. Zkusí kabel nebo jinou síť.
• Odpojilo všechny najednou: server zamrzl. V konzoli hledejte Can't keep up! nebo hlášky hlídacího psa (viz níže) a postupujte podle návodu Výkon Minecraft serveru.

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

Tak to vypadá na Vanille, Fabricu a NeoForge. Následuje Considering it to be crashed, server will forcibly shutdown.

Na Paperu a Purpuru hlídá zamrznutí jejich vlastní hlídací pes (watchdog) a hlášky jsou jiné. Už po 10 sekundách zamrznutí se opakovaně vypisuje --- DO NOT REPORT THIS TO PAPER - THIS IS NOT A BUG OR A CRASH s výpisem hlavního vlákna. Když zamrznutí trvá 60 sekund, vypíše se blok začínající The server has stopped responding! This is (probably) not a Paper bug. s výpisem vláken (thread dump) a server se vypne.

Příčina: Jeden tick trval přes 60 sekund, server usoudil, že zamrzl, a vypnul se. Limit určuje max-tick-time v server.properties (Vanilla, Fabric, NeoForge), na Paperu a Purpuru settings.timeout-time v spigot.yml. Nejčastěji plugin čeká na databázi nebo internet v hlavním vlákně, obří redstonová stavba, nebo exploze tisíců TNT.

Řešení: Ve výpisu vláken najděte Server thread (na Paperu blok Server thread dump) a v něm název pluginu nebo módu. Plugin aktualizujte nebo odeberte. Limit nezvyšujte ani nevypínejte – zamrzlý server by pak visel dlouho nebo donekonečna.

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

Příčina: Příkaz neexistuje (překlep), nebo patří pluginu, který se nenačetl.

Řešení: Zkontrolujte název příkazu a pod hláškou místo označené <--[HERE], kde je chyba. V konzoli se příkazy píšou bez lomítka. Seznam příkazů najdete v návodu Konzole a příkazy.

Zákaznická zóna: Flagy nejsou kompatibilní, vráceno na předchozí nastavení.#

Příčina: Server s novými spouštěcími flagy nenastartoval a zákaznická zóna je vrátila.

Řešení: V záložce Spuštění zkontrolujte Vlastní parametry (překlep, flag pro jinou verzi Javy) nebo zvolte výchozí preset Doporučené (G1). Více v návodu Výkon Minecraft serveru.

Když něco nefunguje ani po opravě#

Napište nám a pošlete:

• ID služby nebo název serveru (najdete ho v Moje služby),
• co jste dělali těsně před chybou (aktualizace, nový plugin, změna verze),
• soubor logs/latest.log (stáhněte ho v záložce Soubory), případně nejnovější soubor ze složky crash-reports,
• při lagu odkaz na profil ze spark profiler start --timeout 600,
• přesný čas, kdy se chyba stala.

Hesla, obsah key.pem ani forwarding.secret nikdy neposílejte.

Další zdroje#

• Server na Minecraft Wiki (otevře se v novém okně)
• Dokumentace Paperu (otevře se v novém okně)
• Profilování se spark (otevře se v novém okně)