Vodič

Kako popraviti greške u Minecraft pluginu

Ažurirano 18. listopada 2026.

Kad se plugin ne učita, poslužitelj gotovo uvijek kaže zašto: razlog je u konzoli tijekom pokretanja, nekoliko redaka iznad ili ispod imena plugina. Nauči čitati taj dio loga i većina grešaka popravi se za minutu. Evo najčešćih i što znače.

Navedi verziju svog poslužitelja i što plugin treba raditi.

Generiraj ovo uz Codexe

Korak po korak

1.Otvori log pokretanja
Čitaj konzolu ili logs/latest.log u mapi poslužitelja. Na panelu hostinga koristi njegovu konzolu ili upravitelj datoteka.
2.Potraži ime plugina
Pronađi prvu grešku koja ga spominje. Važni su retci koji počinju s [ERROR] ili [WARN] i stack trace ispod njih.
3.Pročitaj prvi redak i retke „Caused by”
Prvi redak kaže što nije uspjelo; zadnji redak Caused by: obično kaže zašto. Retci s imenom paketa samog plugina pokazuju gdje u njegovu kodu.
4.Usporedi s popisom ispod
Većina grešaka pri pokretanju problem je s verzijom, Javom ili ovisnošću, a poruka kaže koji.
5.Popravi jednu stvar i ponovno pokreni
Promijeni jednu stvar, ponovno pokreni poslužitelj (ne /reload) i ponovno pročitaj log. Greške jednog plugina mogu izazvati greške u drugima.

Česte greške

Vidiš	Što znači	Rješenje
`Unsupported API version 1.21`	`api-version` plugina noviji je od tvog poslužitelja.	Nabavi verziju za svoj poslužitelj ili ažuriraj poslužitelj.
`Could not load 'plugins/X.jar'` uz `Invalid plugin.yml` ili `Jar does not contain plugin.yml`	Deskriptor plugina nedostaje ili ima YAML grešku ili datoteka nije plugin.	Provjeri jesi li preuzeo plugin, a ne njegov izvorni kod, mod ili zip. Ako si ga sam izradio, popravi `plugin.yml`.
`UnsupportedClassVersionError`, „class file version 65.0”	Plugin treba noviju Javu od one na kojoj radi poslužitelj (61 = Java 17, 65 = Java 21, 69 = Java 25).	Pokreni poslužitelj na toj Javi ili ponovno izradi plugin za svoju Javu.
`NoClassDefFoundError` ili `ClassNotFoundException`	Klase koja pluginu treba nema: nedostaje plugin o kojem ovisi, biblioteka nije shadeana u .jar ili API ne postoji na ovoj verziji.	Instaliraj plugin naveden u grešci (Vault, ProtocolLib) ili koristi build za svoju verziju.
`Unknown/missing dependency plugins`	Plugin naveden u `depend` nije instaliran.	Instaliraj ga u `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Plugin se učitao, ali se srušio u `onEnable`.	Pročitaj redak `Caused by`: često je to greška u konfiguraciji ili ovisnost koja nedostaje.
`Ambiguous plugin name`	U `plugins/` su dvije .jar datoteke istog plugina.	Obriši staru.

Greške koje nisu vezane uz učitavanje

Plugin je zelen, ali naredba javlja „Unknown command”: naredba nedostaje u plugin.yml ili drugi plugin koristi isto ime.
„I'm sorry, but you do not have permission”: igraču nedostaje permission node. Na stranici plugina pronađi node i dodijeli ga svojim pluginom za dopuštenja.
Greške nakon uređivanja config.yml: YAML treba razmake, a ne tabulatore, i navodnike oko teksta koji počinje s : ili &.
Radi nakon ponovnog pokretanja, kvari se nakon /reload: plugin ne podržava /reload. Umjesto toga ponovno pokreni poslužitelj.

Koju Javu treba tvoj poslužitelj

Minecraft 1.20.5 i noviji trebaju Javu 21, a 26.x treba Javu 25; od 1.18 do 1.20.4 treba Java 17. Pokreni java -version s istom Javom koju koristi poslužitelj (na panelu hostinga to je obično postavka koja se zove Docker image ili Java version). Plugin izrađen za stariju Javu radi na novijoj, ali ne i obrnuto.

Popravljanje pluginova napravljenih s Codexeom

Pluginovi napravljeni na Codexeu kompajliraju se za verziju koju si odabrao i provjerava se imaju li valjan plugin.yml prije nego što su Spremno. Na testnom poslužitelju kartica Logovi prikazuje log uživo s istaknutim greškama, a Izvezi logove sprema ga kao datoteku. Opiši što vidiš u chatu projekta („plugin je crven u /plugins, a log kaže ...”) i Codexe mijenja kod i ponovno radi build. Ako Kompajliraj ne uspije na datotekama točno onakvima kakve je Codexe isporučio, Popravi uz AI besplatno ih popravlja.

Pitanja

Gdje je log poslužitelja?

logs/latest.log u mapi poslužitelja, za trenutno pokretanje. Starija pokretanja nalaze se u istoj mapi kao .log.gz datoteke.

Može li jedan plugin pokvariti drugi?

Da: ovisnost koja nedostaje ili je pokvarena zaustavlja svaki plugin koji je treba. Popravi prvu grešku u logu prije ostalih.

Je li sigurno podijeliti svoj log?

Uglavnom jest, ali ga najprije provjeri: logovi mogu sadržavati IP adrese, a kod nekih pluginova i lozinke baza podataka iz grešaka.

Ponovno izradi pokvareni plugin za svoj poslužitelj

Ovaj prompt otvara se spreman za slanje:

“Paper 1.21.4 plugin pod nazivom SimpleWarps koji zamjenjuje moj stari koji se više ne učitava: /setwarp, /warp i /delwarp s imenom, /warps ih prikazuje u GUI-ju, dopuštenje warps.admin za postavljanje i brisanje, warpovi se čuvaju kroz ponovna pokretanja, poruke u config.yml.”