Návod

Jak opravit chyby pluginů pro Minecraft

Aktualizováno 18. října 2026

Když se plugin nenačte, server skoro vždy řekne proč: důvod je v konzoli při startu, pár řádků nad nebo pod názvem pluginu. Nauč se tuhle část logu číst a většinu chyb opravíš za minutu. Tady jsou ty běžné a co znamenají.

Napiš verzi svého serveru a co má plugin dělat.

Vygeneruj to s Codexe

Krok za krokem

1.Otevři log ze startu
Přečti si konzoli nebo logs/latest.log ve složce serveru. V hostingovém panelu použij jeho konzoli nebo správce souborů.
2.Vyhledej název pluginu
Najdi první chybu, která ho zmiňuje. Důležité jsou řádky začínající [ERROR] nebo [WARN] a stack trace pod nimi.
3.Přečti první řádek a řádky „Caused by“
První řádek říká, co selhalo; poslední řádek Caused by: obvykle říká proč. Řádky s vlastním názvem balíčku pluginu ukazují, kde v jeho kódu.
4.Porovnej to se seznamem níže
Většina chyb při startu je problém s verzí, Javou nebo závislostí a zpráva říká, který to je.
5.Oprav jednu věc a restartuj
Změň jednu věc, restartuj (ne /reload) a znovu si přečti log. Chyby jednoho pluginu můžou způsobit chyby v jiných.

Běžné chyby

Vidíš	Co to znamená	Oprava
`Unsupported API version 1.21`	`api-version` pluginu je novější než tvůj server.	Sežeň verzi pro svůj server, nebo aktualizuj server.
`Could not load 'plugins/X.jar'` s `Invalid plugin.yml` nebo `Jar does not contain plugin.yml`	Deskriptor pluginu chybí nebo má chybu v YAML, případně soubor není plugin.	Zkontroluj, že jsi stáhl/a plugin, a ne jeho zdrojový kód, mód nebo zip. Pokud jsi ho sestavil/a, oprav `plugin.yml`.
`UnsupportedClassVersionError`, „class file version 65.0“	Plugin potřebuje novější Javu, než na jaké server běží (61 = Java 17, 65 = Java 21, 69 = Java 25).	Spusť server na této Javě, nebo plugin znovu sestav pro svou Javu.
`NoClassDefFoundError` nebo `ClassNotFoundException`	Třída, kterou plugin potřebuje, tam není: chybí plugin, na kterém závisí, knihovna nebyla zabalena do .jar, nebo API v této verzi neexistuje.	Nainstaluj plugin uvedený v chybě (Vault, ProtocolLib), nebo použij sestavení pro svou verzi.
`Unknown/missing dependency plugins`	Plugin uvedený v `depend` není nainstalovaný.	Nainstaluj ho do `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Plugin se načetl, ale spadl v `onEnable`.	Přečti si řádek `Caused by`: často jde o chybu v konfiguraci nebo chybějící závislost.
`Ambiguous plugin name`	V `plugins/` jsou dva soubory .jar stejného pluginu.	Smaž ten starý.

Chyby, které se netýkají načítání

Plugin je zelený, ale příkaz hlásí „Unknown command“: příkaz chybí v plugin.yml, nebo stejný název používá jiný plugin.
„I'm sorry, but you do not have permission“: hráči chybí oprávnění (permission node). Najdi ho na stránce pluginu a přiděl ho svým pluginem na oprávnění.
Chyby po úpravě config.yml: YAML potřebuje mezery, ne tabulátory, a uvozovky kolem textu, který začíná : nebo &.
Po restartu funguje, po /reload se rozbije: plugin nepodporuje /reload. Místo toho restartuj.

Jakou Javu tvůj server potřebuje

Minecraft 1.20.5 a novější potřebuje Javu 21 a 26.x potřebuje Javu 25; 1.18 až 1.20.4 potřebují Javu 17. Spusť java -version se stejnou Javou, kterou používá server (v hostingovém panelu je to obvykle nastavení Docker image nebo Java version). Plugin sestavený pro starší Javu běží na novější, ne naopak.

Oprava pluginů vytvořených v Codexe

Pluginy vytvořené v Codexe se zkompilují pro verzi, kterou jsi zvolil/a, a než jsou Ready, zkontroluje se platný plugin.yml. Na testovacím serveru ukazuje karta Logy log živě se zvýrazněnými chybami a Exportovat logy ho uloží jako soubor. Popiš v chatu projektu, co vidíš („plugin je v /plugins červený a log říká ...“), a Codexe kód upraví a znovu sestaví. Pokud kompilace selže na souborech přesně tak, jak je Codexe dodal, Opravit pomocí AI je opraví zdarma.

Otázky

Kde je log serveru?

logs/latest.log ve složce serveru, pro aktuální běh. Starší běhy jsou ve stejné složce jako soubory .log.gz.

Může jeden plugin rozbít jiný?

Ano: chybějící nebo rozbitá závislost zastaví každý plugin, který ji potřebuje. Oprav první chybu v logu dřív než ostatní.

Je bezpečné sdílet můj log?

Většinou ano, ale nejdřív ho zkontroluj: logy můžou obsahovat IP adresy a u některých pluginů i hesla k databázi z chybových hlášek.

Sestav rozbitý plugin znovu pro svůj server

Toto zadání se otevře připravené k odeslání:

“Plugin pro Paper 1.21.4 jménem SimpleWarps, který nahradí můj starý, co se už nenačítá: /setwarp, /warp a /delwarp s názvem, /warps je vypíše v GUI, oprávnění warps.admin pro nastavení a mazání, warpy uložené i po restartu, zprávy v config.yml.”