Ghid

Cum repari erorile de plugin Minecraft

Actualizat 18 octombrie 2026

Când un plugin nu se încarcă, serverul spune aproape mereu de ce: motivul este în consolă în timpul pornirii, cu câteva linii deasupra sau dedesubtul numelui pluginului. Învață să citești acea parte a log-ului și majoritatea erorilor se repară într-un minut. Iată cele mai comune și ce înseamnă.

Spune versiunea serverului și ce trebuie să facă pluginul.

Generează asta cu Codexe

Pas cu pas

1.Deschide log-ul pornirii
Citește consola sau logs/latest.log din folderul serverului. Pe un panou de hosting, folosește consola sau managerul de fișiere.
2.Caută numele pluginului
Găsește prima eroare care îl menționează. Contează liniile care încep cu [ERROR] sau [WARN] și stack trace-ul de sub ele.
3.Citește prima linie și liniile „Caused by”
Prima linie spune ce a eșuat; ultima linie Caused by: spune de obicei de ce. Liniile cu numele pachetului pluginului arată unde anume în codul lui.
4.Potrivește-o cu lista de mai jos
Majoritatea erorilor de pornire sunt o problemă de versiune, de Java sau de dependență, iar mesajul spune care.
5.Repară un singur lucru și repornește
Schimbă un singur lucru, repornește (nu /reload) și citește din nou log-ul. Erorile unui plugin pot provoca erori în altele.

Erorile comune

Vezi	Ce înseamnă	Soluție
`Unsupported API version 1.21`	`api-version`-ul pluginului este mai nou decât serverul tău.	Ia versiunea pentru serverul tău sau actualizează serverul.
`Could not load 'plugins/X.jar'` cu `Invalid plugin.yml` sau `Jar does not contain plugin.yml`	Descriptorul pluginului lipsește sau are o eroare YAML, ori fișierul nu este un plugin.	Verifică dacă ai descărcat pluginul și nu sursa lui, un mod sau un zip. Dacă l-ai construit tu, repară `plugin.yml`.
`UnsupportedClassVersionError`, „class file version 65.0”	Pluginul are nevoie de un Java mai nou decât cel pe care rulează serverul (61 = Java 17, 65 = Java 21, 69 = Java 25).	Rulează serverul pe acel Java sau recompilează pluginul pentru Java-ul tău.
`NoClassDefFoundError` sau `ClassNotFoundException`	O clasă de care are nevoie pluginul nu există: lipsește un plugin de care depinde, o bibliotecă nu a fost inclusă prin shade în .jar sau API-ul nu există pe această versiune.	Instalează pluginul numit în eroare (Vault, ProtocolLib) sau folosește un build pentru versiunea ta.
`Unknown/missing dependency plugins`	Un plugin listat în `depend` nu este instalat.	Instalează-l în `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Pluginul s-a încărcat, dar a dat crash în `onEnable`.	Citește linia `Caused by`: adesea e o eroare de configurare sau o dependență lipsă.
`Ambiguous plugin name`	În `plugins/` sunt două fișiere .jar ale aceluiași plugin.	Șterge-l pe cel vechi.

Erori care nu țin de încărcare

Pluginul e verde, dar o comandă spune „Unknown command”: comanda lipsește din plugin.yml sau alt plugin folosește același nume.
„I'm sorry, but you do not have permission”: jucătorului îi lipsește nodul de permisiune. Caută nodul pe pagina pluginului și dă-l cu pluginul tău de permisiuni.
Erori după editarea config.yml: YAML are nevoie de spații, nu de tab-uri, și de ghilimele în jurul textului care începe cu : sau &.
Funcționează după o repornire, se strică după /reload: pluginul nu suportă /reload. Repornește în schimb.

De ce Java are nevoie serverul tău

Minecraft 1.20.5 și mai nou are nevoie de Java 21, iar 26.x de Java 25; de la 1.18 la 1.20.4 e nevoie de Java 17. Rulează java -version cu același Java pe care îl folosește serverul (pe un panou de hosting este de obicei o setare numită Docker image sau Java version). Un plugin construit pentru un Java mai vechi rulează pe unul mai nou, nu și invers.

Repararea plugin-urilor făcute cu Codexe

Plugin-urile făcute pe Codexe sunt compilate pentru versiunea aleasă și verificate pentru un plugin.yml valid înainte să fie Gata. Pe un server de testare, tab-ul Jurnale arată log-ul live, cu erorile evidențiate, iar Exportă jurnalele îl salvează ca fișier. Descrie ce vezi în chatul proiectului („pluginul e roșu în /plugins, iar log-ul spune ...”), iar Codexe schimbă codul și compilează din nou. Dacă o compilare eșuează pe fișierele exact așa cum le-a livrat Codexe, Repară cu AI le repară gratuit.

Întrebări

Unde este log-ul serverului?

logs/latest.log în folderul serverului, pentru rularea curentă. Rulările mai vechi sunt în același folder, ca fișiere .log.gz.

Poate un plugin să strice altul?

Da: o dependență lipsă sau stricată oprește toate plugin-urile care au nevoie de ea. Repară prima eroare din log înaintea celorlalte.

E sigur să îmi împărtășesc log-ul?

În mare parte, dar verifică-l mai întâi: log-urile pot conține adrese IP și, cu unele plugin-uri, parole de baze de date din erori.

Reconstruiește un plugin stricat pentru serverul tău

Acest prompt se deschide gata de trimis:

“Un plugin Paper 1.21.4 numit SimpleWarps care îl înlocuiește pe cel vechi, care nu se mai încarcă: /setwarp, /warp și /delwarp cu un nume, /warps le listează într-un GUI, permisiunea warps.admin pentru setare și ștergere, warp-urile salvate între reporniri, mesajele în config.yml.”