Kompatibilnost verzija pluginova i API-ja
Zašto plugin ne radi na tvojoj verziji, šta znači api-version, kako da čitaš zahteve i šta može da izazove neslaganje.
Ažurirano 13. avgust 2026.
Plugin se pravi za određenu verziju serverskog API-ja. Neslaganje ili sprečava njegovo učitavanje ili izaziva greške tokom rada.
Šta određuje kompatibilnost
- Verzija igre. Plugin za 1.20 obično neće raditi na 1.21: interne klase se menjaju.
- Jezgro. Bukkit/Spigot/Paper su kompatibilni „odozdo nagore”: Bukkit plugin će raditi na Paper-u, ali ne i obrnuto ako se koriste API-ji specifični za Paper.
- Zavisnosti. Vault, PlaceholderAPI, ProtocolLib — i njihove verzije moraju da se poklope.
api-version
U plugin.yml plugina stoji:
api-version: 1.21
Ako ta linija uopšte nedostaje, server tretira plugin kao zastareo i uključuje režim kompatibilnosti — u logu se pojavljuje upozorenje. To nije greška, već znak da je plugin star.
Tipični simptomi
| U logu | Značenje |
|---|---|
Unsupported API version | Plugin je napravljen za novije jezgro |
NoSuchMethodError | Metoda ne postoji u tvojoj verziji — detaljno |
NoClassDefFoundError | Nedostaje zavisnost — detaljno |
Invalid plugin.yml | Fajl je oštećen ili ovo nije plugin — detaljno |
Provera pre instalacije
Katalog „Plugins and mods” u panelu filtrira po tvom jezgru i verziji i upozorava te na nekompatibilnost pre instalacije — Kako instalirati. Kada otpremaš ručno, proveri stranicu plugina: na njoj je uvek naveden raspon podržanih verzija.
Minecraft hostingTvoj server radi i dok si oflajnNapravi server
