Útmutató

Hogyan javítsd a Minecraft-pluginhibákat

Frissítve: 2026. október 18.

Ha egy plugin nem töltődik be, a szerver szinte mindig megmondja, miért: az ok indításkor a konzolban áll, néhány sorral a plugin neve fölött vagy alatt. Tanuld meg olvasni a naplónak ezt a részét, és a legtöbb hibát egy perc alatt kijavítod. Íme a gyakoriak és a jelentésük.

Írd meg a szervered verzióját, és hogy mit csináljon a plugin.

Generáld ezt a Codexe-szel

Lépésről lépésre

1.Nyisd meg az indítás naplóját
Olvasd a konzolt, vagy a szervermappában a logs/latest.log fájlt. Hosztingpanelen használd a konzolját vagy a fájlkezelőjét.
2.Keresd meg a plugin nevét
Keresd meg az első hibát, amely említi. A [ERROR] vagy [WARN] kezdetű sorok és az alattuk lévő stack trace számítanak.
3.Olvasd el az első és a „Caused by” sorokat
Az első sor megmondja, mi hibázott; az utolsó Caused by: sor általában azt, hogy miért. A plugin saját csomagnevét tartalmazó sorok megmutatják, hol a kódjában.
4.Keresd meg az alábbi listában
A legtöbb indítási hiba verzió-, Java- vagy függőségi probléma, és az üzenet megmondja, melyik.
5.Javíts egy dolgot, és indíts újra
Változtass meg egy dolgot, indíts újra (ne /reload), és olvasd el újra a naplót. Egy plugin hibái másokban is hibákat okozhatnak.

A gyakori hibák

Amit látsz	Mit jelent	Javítás
`Unsupported API version 1.21`	A plugin `api-version` értéke újabb, mint a szervered.	Szerezd be a szerveredhez való verziót, vagy frissítsd a szervert.
`Could not load 'plugins/X.jar'`, mellette `Invalid plugin.yml` vagy `Jar does not contain plugin.yml`	A plugin leírója hiányzik vagy YAML-hibás, vagy a fájl nem plugin.	Ellenőrizd, hogy a plugint töltötted-e le, és nem a forráskódját, egy modot vagy egy zipet. Ha te buildelted, javítsd a `plugin.yml` fájlt.
`UnsupportedClassVersionError`, „class file version 65.0”	A pluginnak újabb Java kell, mint amin a szerver fut (61 = Java 17, 65 = Java 21, 69 = Java 25).	Futtasd a szervert azon a Java-verzión, vagy buildeld újra a plugint a te Java-verziódra.
`NoClassDefFoundError` vagy `ClassNotFoundException`	Egy osztály, amely a pluginnak kell, nincs meg: hiányzik egy függőségként szolgáló plugin, egy könyvtár nem lett a .jar fájlba csomagolva, vagy az API nem létezik ezen a verzión.	Telepítsd a hibában megnevezett plugint (Vault, ProtocolLib), vagy használj a verziódhoz való buildet.
`Unknown/missing dependency plugins`	Egy, a `depend` alatt felsorolt plugin nincs telepítve.	Telepítsd a `plugins/` mappába.
`Error occurred while enabling X (Is it up to date?)`	A plugin betöltődött, de összeomlott az `onEnable` metódusban.	Olvasd el a `Caused by` sort: gyakran egy confighiba vagy egy hiányzó függőség.
`Ambiguous plugin name`	Ugyanannak a pluginnak két .jar fájlja van a `plugins/` mappában.	Töröld a régit.

Nem a betöltéssel kapcsolatos hibák

A plugin zöld, de egy parancs azt írja, hogy „Unknown command”: a parancs hiányzik a plugin.yml fájlból, vagy egy másik plugin ugyanazt a nevet használja.
„I'm sorry, but you do not have permission”: a játékosnak nincs meg a jogosultsági node-ja. Nézd meg a plugin oldalán a node-ot, és add meg a jogosultságkezelő pluginoddal.
Hibák a config.yml szerkesztése után: a YAML szóközöket kér, nem tabulátorokat, és idézőjeleket a : vagy & karakterrel kezdődő szövegek köré.
Újraindítás után működik, /reload után elromlik: a plugin nem támogatja a /reload parancsot. Inkább indíts újra.

Melyik Java kell a szerverednek

A Minecraft 1.20.5 és újabb verzióihoz Java 21 kell, a 26.x-hez Java 25; az 1.18 és 1.20.4 közöttiekhez Java 17. Futtasd a java -version parancsot ugyanazzal a Java-val, amelyet a szerver használ (hosztingpanelen ez általában egy Docker image vagy Java version nevű beállítás). A régebbi Java-ra buildelt plugin fut egy újabbon, fordítva nem.

Codexe-szel készült pluginok javítása

A Codexe-en készült pluginok a választott verzióra fordulnak, és érvényes plugin.yml fájlra ellenőrizzük őket, mielőtt Kész lenne. Egy tesztszerveren a Naplók lap élőben mutatja a naplót kiemelt hibákkal, a Naplók exportálása pedig fájlba menti. Írd le a projekt chatjében, amit látsz („a plugin piros a /plugins listában, és a napló azt írja, hogy ...”), és a Codexe módosítja a kódot, majd újra buildel. Ha a Fordítás pontosan a Codexe által átadott fájlokon hiúsul meg, a Javítás AI-val ingyen kijavítja őket.

Kérdések

Hol van a szervernapló?

Az aktuális futáshoz a szervermappában a logs/latest.log. A korábbi futások ugyanebben a mappában vannak .log.gz fájlokként.

Elronthatja az egyik plugin a másikat?

Igen: egy hiányzó vagy hibás függőség minden plugint leállít, amelynek kell. Előbb a napló első hibáját javítsd, aztán a többit.

Biztonságos megosztani a naplómat?

Többnyire igen, de előbb nézd át: a naplók IP-címeket, egyes pluginoknál pedig a hibákból származó adatbázis-jelszavakat is tartalmazhatnak.

Buildelj újra egy hibás plugint a szerveredre

Ez a prompt küldésre készen nyílik meg:

“Egy Paper 1.21.4 plugin SimpleWarps néven, amely a már be nem töltődő régi pluginomat váltja: /setwarp, /warp és /delwarp névvel, a /warps GUI-ban listázza őket, warps.admin jog a beállításhoz és törléshez, a warpok újraindítás után is megmaradnak, üzenetek a config.yml-ben.”