Príručka

Ako opraviť chyby pluginov v Minecrafte

Aktualizované 18. októbra 2026

Keď sa plugin nenačíta, server takmer vždy povie prečo: dôvod je v konzole počas štartu, pár riadkov nad alebo pod názvom pluginu. Nauč sa čítať túto časť logu a väčšinu chýb opravíš za minútu. Tu sú tie bežné a čo znamenajú.

Uveď verziu servera a čo má plugin robiť.

Vygeneruj to v Codexe

Krok za krokom

1.Otvor log zo štartu
Prečítaj si konzolu alebo logs/latest.log v priečinku servera. V hostingovom paneli použi jeho konzolu alebo správcu súborov.
2.Hľadaj názov pluginu
Nájdi prvú chybu, ktorá ho spomína. Dôležité sú riadky začínajúce na [ERROR] alebo [WARN] a stack trace pod nimi.
3.Prečítaj prvý riadok a riadky „Caused by“
Prvý riadok hovorí, čo zlyhalo; posledný riadok Caused by: zvyčajne hovorí prečo. Riadky s názvom balíka samotného pluginu ukazujú, kde v jeho kóde.
4.Porovnaj ju so zoznamom nižšie
Väčšina chýb pri štarte je problém s verziou, Java alebo závislosťou a správa hovorí, ktorý.
5.Oprav jednu vec a reštartuj
Zmeň jednu vec, reštartuj (nie /reload) a znova si prečítaj log. Chyby jedného pluginu môžu spôsobiť chyby v iných.

Bežné chyby

Vidíš	Čo to znamená	Oprava
`Unsupported API version 1.21`	`api-version` pluginu je novšia, než má tvoj server.	Zožeň verziu pre svoj server alebo aktualizuj server.
`Could not load 'plugins/X.jar'` s `Invalid plugin.yml` alebo `Jar does not contain plugin.yml`	Deskriptor pluginu chýba alebo má chybu v YAML, prípadne súbor nie je plugin.	Skontroluj, či si stiahol plugin, a nie jeho zdrojový kód, mod alebo zip. Ak si ho zostavil sám, oprav `plugin.yml`.
`UnsupportedClassVersionError`, „class file version 65.0“	Plugin potrebuje novšiu Java, než na akej beží server (61 = Java 17, 65 = Java 21, 69 = Java 25).	Spusti server na tejto verzii Java alebo zostav plugin znova pre svoju Java.
`NoClassDefFoundError` alebo `ClassNotFoundException`	Trieda, ktorú plugin potrebuje, tam nie je: chýba plugin, od ktorého závisí, knižnica nebola pribalená do .jar alebo API v tejto verzii neexistuje.	Nainštaluj plugin uvedený v chybe (Vault, ProtocolLib) alebo použi build pre svoju verziu.
`Unknown/missing dependency plugins`	Plugin uvedený v `depend` nie je nainštalovaný.	Nainštaluj ho do `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Plugin sa načítal, ale spadol v `onEnable`.	Prečítaj si riadok `Caused by`: často ide o chybu v configu alebo chýbajúcu závislosť.
`Ambiguous plugin name`	V `plugins/` sú dva súbory .jar toho istého pluginu.	Vymaž ten starý.

Chyby, ktoré nesúvisia s načítaním

Plugin je zelený, ale príkaz hlási „Unknown command“: príkaz chýba v plugin.yml alebo rovnaký názov používa iný plugin.
„I'm sorry, but you do not have permission“: hráčovi chýba oprávnenie (permission node). Nájdi ho na stránke pluginu a pridel ho svojím pluginom na oprávnenia.
Chyby po úprave config.yml: YAML potrebuje medzery, nie tabulátory, a úvodzovky okolo textu, ktorý začína na : alebo &.
Po reštarte funguje, po /reload sa pokazí: plugin nepodporuje /reload. Radšej reštartuj.

Akú verziu Java tvoj server potrebuje

Minecraft 1.20.5 a novší potrebuje Java 21 a 26.x potrebuje Java 25; 1.18 až 1.20.4 potrebujú Java 17. Spusti java -version s tou istou Java, ktorú používa server (v hostingovom paneli je to zvyčajne nastavenie s názvom Docker image alebo verzia Java). Plugin zostavený pre staršiu Java beží na novšej, nie naopak.

Oprava pluginov vytvorených v Codexe

Pluginy vytvorené v Codexe sa kompilujú pre verziu, ktorú si vybral, a skôr, než sú v stave Pripravené, sa skontroluje platný plugin.yml. Na testovacom serveri ukazuje karta Logy log naživo so zvýraznenými chybami a Exportovať logy ho uloží ako súbor. Opíš v chate projektu, čo vidíš („plugin je v /plugins červený a log hovorí ...“), a Codexe zmení kód a zostaví ho znova. Ak kompilácia zlyhá na súboroch presne tak, ako ich Codexe dodal, Opraviť pomocou AI ich opraví zadarmo.

Otázky

Kde je log servera?

logs/latest.log v priečinku servera, pre aktuálny beh. Staršie behy sú v tom istom priečinku ako súbory .log.gz.

Môže jeden plugin pokaziť iný?

Áno: chýbajúca alebo pokazená závislosť zastaví každý plugin, ktorý ju potrebuje. Oprav prvú chybu v logu skôr než ostatné.

Je bezpečné zdieľať môj log?

Väčšinou áno, ale najprv ho skontroluj: logy môžu obsahovať IP adresy a pri niektorých pluginoch aj heslá k databáze z chybových hlásení.

Zostav pokazený plugin znova pre svoj server

Toto zadanie sa otvorí pripravené na odoslanie:

“Plugin pre Paper 1.21.4 s názvom SimpleWarps, ktorý nahradí môj starý, čo sa už nenačíta: /setwarp, /warp a /delwarp s názvom, /warps ich vypíše v GUI, oprávnenie warps.admin na nastavenie a mazanie, warpy uložené aj po reštartoch, správy v config.yml.”