Kompatibilita verzií pluginov a API
Prečo plugin nefunguje na tvojej verzii, čo znamená api-version, ako čítať požiadavky a čo môže spôsobiť nesúlad.
Aktualizované 13. augusta 2026
Plugin je vytvorený pre konkrétnu verziu serverového API. Nesúlad buď zabráni jeho načítaniu, alebo spôsobí chyby počas behu.
Čo určuje kompatibilitu
- Verzia hry. Plugin pre 1.20 zvyčajne nebude fungovať na 1.21: interné triedy sa menia.
- Core. Bukkit/Spigot/Paper sú kompatibilné „zdola nahor“: Bukkit plugin pobeží na Paper, ale nie naopak, ak sa použijú Paper-špecifické API.
- Závislosti. Vault, PlaceholderAPI, ProtocolLib — aj ich verzie musia sedieť.
api-version
V plugin.yml pluginu sa uvádza:
api-version: 1.21
Ak riadok úplne chýba, server považuje plugin za legacy a zapne režim kompatibility — v logu sa objaví upozornenie. Nie je to chyba, ale znak starého pluginu.
Typické príznaky
| V logu | Význam |
|---|---|
Unsupported API version | Plugin bol vytvorený pre novší core |
NoSuchMethodError | Metóda vo tvojej verzii už neexistuje — rozbor |
NoClassDefFoundError | Chýbajúca závislosť — rozbor |
Invalid plugin.yml | Súbor je poškodený alebo to nie je plugin — rozbor |
Kontrola pred inštaláciou
Katalóg „Pluginy a mody“ v ovládacom paneli filtruje podľa tvojho core a verzie a upozorní ťa na nekompatibilitu ešte pred inštaláciou — Ako nainštalovať. Pri manuálnom nahrávaní si skontroluj stránku pluginu: vždy uvádza rozsah podporovaných verzií.
Minecraft hostingTvoj server beží, aj keď si offlineVytvoriť server
