Pluginy na serverech Minecraft; Provozuje autorizační systém, ekonomiku, ochranu, trh, událost, reklamaci, anti-cheat a mnoho speciálních systémů. Pokud některý z pluginů není nainstalován, značná část serveru nemusí fungovat.

Chyby pluginů se většinou vyskytují v konzoli resp logs/latest.log se objeví v souboru. Nejčastější chyby; Plugin se nepodařilo načíst, Nepodporovaná verze API, neznámá závislost, Neplatný plugin.yml a nekompatibilita verzí Java.

1. Kde můžete vidět chybu pluginu?

Pokud se plugin nenačítá, první místo, kam se podívat, je konzole serveru a soubor nejnovější.log.

tail -n 200 logs/latest.log

Pro živé sledování:

tail -f logs/latest.log

Chcete-li hledat podle názvu pluginu:

grep -i "pluginadi" logs/latest.log

2. Chyba nepodporované verze API

Tato chyba znamená, že verze Minecraft API podporovaná pluginem není kompatibilní s verzí serveru.

Unsupported API version 1.20

Plugin může být například připraven pro verzi 1.20, ale váš server může používat verzi 1.16.5. V tomto případě se plugin nemusí načíst nebo může fungovat nesprávně.

Řešení:

• Zkontrolujte verzi Minecraft podporovanou pluginem.
• Stáhněte si verzi pluginu kompatibilní s verzí vašeho serveru.
• Neočekávejte, že nové pluginy budou fungovat na velmi starých serverech.
• V případě potřeby vyhledejte příslušnou verzi v archivu staré verze pluginu.

3. Neznámá chyba závislosti

Některé pluginy nefungují samostatně. Nejdříve požádá o instalaci dalšího pluginu. Tomu se říká závislost.

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

Například ekonomické pluginy často Vault chce. Zásuvné moduly pro autorizaci nebo trh mohou také vyžadovat další zásuvné moduly knihovny.

Řešení:

• Přečtěte si požadavky na stránce pluginu.
• Stáhněte si chybějící plugin pro závislost.
• Ujistěte se, že je plugin pro závislost kompatibilní také s vaší verzí serveru.
• Zcela restartujte server.

4. Neplatný plugin.yml Chyba

Uvnitř souboru jar pluginu plugin.yml Pokud je soubor poškozený, chybí nebo je nesprávný, plugin nelze nainstalovat.

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

K tomu obvykle dochází, když:

• Byl stažen nesprávný soubor.
• Místo pluginu byl do složky pluginů umístěn zip zdrojového kódu.
• Soubor Jar je poškozen.
• Plugin byl vývojářem nesprávně zabalen.

Jako řešení je plugin správný. .jar Soubor by měl být stažen. Zdrojový kód.zip stažený z GitHubu by neměl být umístěn přímo do složky pluginů.

5. Nekompatibilita verze Java

Verze Minecraft a pluginy vyžadují specifické verze Java. Pokud je použita nesprávná verze Java, plugin nebo server se nemusí vůbec otevřít.

java -version

Běžná chyba:

UnsupportedClassVersionError

Tato chyba znamená, že plugin byl zkompilován s novější Javou, ale na serveru se používá starší Java.

Obecná logika:

• Starší verze Minecraftu často vyžadují starší Javu.
• Novější verze Minecraftu vyžadují novější Javu.
• Je třeba zkontrolovat požadavek Java v popisu pluginu.
• Vybraná verze Java v hostitelském panelu musí být ověřena.

6. Je soubor pluginu ve správné složce?

Soubory zásuvných modulů na serverech Bukkit, Spigot a Paper pluginy je vhozen do složky.

ls plugins/

Soubor pluginu by měl vypadat takto:

plugins/PluginAdi.jar

Pluginy ponechané v zip, rar, zdrojovém kódu nebo složkách často nefungují.

7. Konflikty pluginů

Dva pluginy, které dělají stejnou práci, mohou být ve vzájemném konfliktu. Například dva různé chatovací pluginy, dva různé ekonomické pluginy nebo dva různé systémy nároků se mohou pokusit spravovat stejné události.

Příznaky konfliktu:

• Plugin je nainstalován, ale jeho příkazy nefungují.
• Jeden plugin přebije nastavení jiného.
• V konzole dojde ke konfliktu událostí nebo výjimce.
• Hráči nemohou používat příkazy, i když mají oprávnění.
• Server se po restartu chová jinak.

Chcete-li najít řešení, lze pluginy testovat tak, že je jeden po druhém deaktivujete. Než to však provedete na živém serveru, měla by být provedena záloha a měla by být preferována nízká doba hraní.

8. Chyba konfigurace může zabránit otevření pluginu

Některé pluginy se neotevře, pokud je v konfiguračním souboru chyba YAML. Odsazení mezer je zvláště důležité v souborech YAML.

Časté chyby:

• Použití znaku tabulátoru
• Za dvojtečkou nenechávejte mezeru
• Psaní textu, který vyžaduje uvozovky bez uvozovek
• Poškození souboru kvůli tureckému znaku nebo speciálnímu symbolu
• Ukládání chybějícího konfiguračního souboru

Pokud existuje nesprávný konfigurační soubor, lze složku zásuvných modulů dočasně přejmenovat, aby byla zálohována a znovu vytvořena konfigurace.

Časté chyby

• Instalace zásuvných modulů, které nejsou kompatibilní s verzí serveru
• Chybějící pluginy se neinstalují
• Záměna zdrojového souboru zip GitHubu za plugin
• Nekontroluje verzi Java
• Pokus o instalaci pluginu pomocí /reload
• Použití karet v konfiguračních souborech YAML

FAQ

Plugin je ve složce plugins, ale nefunguje, proč?
Může to být nekompatibilita verze, chybějící závislost, nekompatibilita Java nebo chyba konfigurace. Měl by být prozkoumán soubor nejnovější.log.

Co znamená UnsupportedClassVersionError?
Plugin byl právě zkompilován s Javou. Verze Java použitá na serveru je zastaralá.

Je bezpečné používat/reload?
Nedoporučuje se pro mnoho pluginů. Úplný restart je bezpečnější pro instalaci, odstranění a zásadní změny konfigurace.

Bezpečnostní a provozní doporučení

• Stáhněte si pluginy ze spolehlivých zdrojů.
• Před přidáním pluginu na živý server jej vyzkoušejte na testovacím serveru.
• Před každou aktualizací pluginu zálohujte složku plugins.
• Snižte plochu útoku odstraněním nepotřebných pluginů.
• Pravidelně kontrolujte protokoly pluginů.

Tento článek je speciálně připraven pro PvPServer.