Beépülő modulok a Minecraft szervereken; Működteti az engedélyezési rendszert, a gazdaságot, a védelmet, a piacot, az eseményt, a követelést, az anti-cheat és számos speciális rendszert. Ha valamelyik bővítmény nincs telepítve, előfordulhat, hogy a szerver jelentős része nem működik.

A plugin hibák általában a konzolban, ill logs/latest.log megjelenik a fájlban. A leggyakoribb hibák; Nem sikerült betölteni a bővítményt, Nem támogatott API-verzió, ismeretlen függőség, Érvénytelen plugin.yml és a Java verzió inkompatibilitása.

1. Hol láthatja a beépülő modul hibáját?

Ha a beépülő modul nem töltődik be, akkor először a kiszolgálókonzolt és a latest.log fájlt kell keresni.

tail -n 200 logs/latest.log

Élő követéshez:

tail -f logs/latest.log

Keresés bővítmény neve alapján:

grep -i "pluginadi" logs/latest.log

2. Nem támogatott API-verzió hiba

Ez a hiba azt jelzi, hogy a bővítmény által támogatott Minecraft API-verzió nem kompatibilis a szerververzióval.

Unsupported API version 1.20

Előfordulhat például, hogy a beépülő modul 1.20-ra készült, de a kiszolgálón az 1.16.5-ös verzió fut. Ebben az esetben előfordulhat, hogy a bővítmény nem töltődik be, vagy hibásan működik.

Megoldás:

• Ellenőrizze a bővítmény által támogatott Minecraft verziót.
• Töltse le a beépülő modul verzióját, amely kompatibilis a szerver verziójával.
• Ne várja el, hogy az új beépülő modulok működjenek nagyon régi szervereken.
• Ha szükséges, keresse meg a megfelelő verziót a bővítmény régi verziójának archívumában.

3. Ismeretlen függőségi hiba

Egyes beépülő modulok nem működnek egyedül. Először egy másik bővítmény telepítését kéri. Ezt hívják függőségnek.

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

Például a gazdaságos bővítmények gyakran Vault akar. Az engedélyezési vagy piaci beépülő modulokhoz más könyvtárbővítményekre is szükség lehet.

Megoldás:

• Olvassa el a követelményeket a beépülő modul oldalán.
• Töltse le a hiányzó függőségi beépülő modult.
• Győződjön meg arról, hogy a függőségi beépülő modul kompatibilis a kiszolgáló verziójával is.
• Indítsa újra a szervert teljesen.

4. Érvénytelen plugin.yml hiba

A plugin jar fájl belsejében plugin.yml Ha a fájl sérült, hiányzik vagy hibás, a bővítmény nem telepíthető.

Invalid plugin.yml
Plugin does not contain a plugin.yml

Ez általában akkor fordul elő, ha:

• Rossz fájl lett letöltve.
• A plugin helyett a forráskód zip-je került a plugins mappába.
• A Jar fájl sérült.
• A bővítményt helytelenül csomagolta be a fejlesztő.

Megoldásként a plugin helyes. .jar A fájlt le kell tölteni. A GitHubról letöltött forráskód.zip fájlt nem szabad közvetlenül a beépülő modulok mappájába helyezni.

5. Java-verzió inkompatibilitása

A Minecraft verzióhoz és a beépülő modulokhoz meghatározott Java-verziók szükségesek. Ha nem megfelelő Java-verziót használ, előfordulhat, hogy a bővítmény vagy a kiszolgáló egyáltalán nem nyílik meg.

java -version

Gyakori hiba:

UnsupportedClassVersionError

Ez a hiba azt jelzi, hogy a beépülő modult újabb Java-val fordították, de a kiszolgálón régebbi Java-t használnak.

Általános logika:

• A régebbi Minecraft verziókhoz gyakran régebbi Java szükséges.
• Az újabb Minecraft verziókhoz újabb Java szükséges.
• A beépülő modul leírásában a Java követelményt ellenőrizni kell.
• A hosting panelen kiválasztott Java verziót ellenőrizni kell.

6. A beépülő modul a megfelelő mappában van?

Beépülő fájlok a Bukkit, Spigot és Paper szervereken bővítmények a mappába kerül.

ls plugins/

A plugin fájlnak a következőnek kell lennie:

plugins/PluginAdi.jar

A zip-ben, rar-ban, forráskódban vagy mappákban hagyott beépülő modulok gyakran nem működnek.

7. Plugin-ütközések

Két, ugyanazt a munkát végző beépülő modul ütközhet egymással. Például két különböző chat-bővítmény, két különböző gazdaságos bővítmény vagy két különböző igénylési rendszer megpróbálhatja kezelni ugyanazokat az eseményeket.

Konfliktus tünetei:

• A bővítmény telepítve van, de a parancsai nem működnek.
• Az egyik bővítmény túlterheli a másik beállításait.
• Eseményütközés vagy kivétel lép fel a konzolban.
• A játékosok akkor sem használhatnak parancsokat, ha engedélyük van rá.
• A szerver másként viselkedik újraindítás után.

A megoldás érdekében a bővítményeket egyenként letiltva tesztelhetjük. Mielőtt azonban ezt megtenné az élő szerveren, biztonsági mentést kell készíteni, és előnyben kell részesíteni az alacsony játékosórákat.

8. Konfigurációs hiba megakadályozhatja a beépülő modul megnyitását

Egyes beépülő modulok nem nyílnak meg, ha YAML hiba van a konfigurációs fájlban. A szóközök behúzása különösen fontos a YAML-fájlokban.

Gyakori hibák:

• Tabulátor karakter használata
• Ne hagyjon szóközt a kettőspont után
• Idézőket igénylő szöveg írása idézőjel nélkül
• Fájlsérülés török karakter vagy különleges szimbólum miatt
• A hiányzó konfigurációs fájl mentése

Ha hibás konfigurációs fájl található, a beépülő modul mappája ideiglenesen átnevezhető, hogy biztonsági másolatot készítsen a beépülő modulról, és újra létrehozza a konfigurációt.

Gyakori hibák

• A kiszolgáló verziójával nem kompatibilis bővítmények telepítése
• Nem telepíti a hiányzó függőségi beépülő modulokat
• A GitHub-forrás zip-fájlja tévedésből beépülő modulként
• Nem ellenőrzi a Java verziót
• Megpróbál telepíteni egy bővítményt a /reload segítségével
• Tabulátorok használata YAML konfigurációs fájlokban

GYIK

A plugin a plugins mappában van, de nem működik, miért?
Lehetséges verzió-inkompatibilitás, hiányzó függőség, Java-inkompatibilitás vagy konfigurációs hiba. Meg kell vizsgálni a legfrissebb.log fájlt.

Mit jelent a UnsupportedClassVersionError?
A plugint nemrég fordították le Java-val. A szerveren használt Java verzió elavult.

Biztonságos a használata /újratöltés?
Sok beépülő modulhoz nem ajánlott. A teljes újraindítás biztonságosabb a beépülő modulok telepítéséhez, eltávolításához és a nagyobb konfigurációs módosításokhoz.

Biztonsági és üzemeltetési ajánlások

• Töltse le a bővítményeket megbízható forrásból.
• Mielőtt hozzáadná a bővítményt az élő szerverhez, próbálja ki a tesztkiszolgálón.
• Minden bővítményfrissítés előtt készítsen biztonsági másolatot a beépülő modulok mappájáról.
• Csökkentse a támadási felületet a szükségtelen bővítmények eltávolításával.
• Rendszeresen ellenőrizze a beépülő modulok naplóit.

Ez a cikk kifejezetten a PvPServer számára készült.