Plugin-uri pe serverele Minecraft; Funcționează sistemul de autorizare, economie, protecție, piață, eveniment, revendicare, anti-cheat și multe sisteme speciale. Dacă unul dintre pluginuri nu este instalat, este posibil ca o parte semnificativă a serverului să nu funcționeze.

Erorile de plugin apar de obicei în consolă sau logs/latest.log apare în dosar. Cele mai frecvente greșeli; Nu s-a putut încărca pluginul, Versiunea API neacceptată, dependență necunoscută, Plugin.yml nevalid și incompatibilitățile versiunii Java.

1. Unde puteți vedea eroarea de plugin?

Dacă pluginul nu se încarcă, primul loc în care trebuie căutat este consola serverului și fișierul latest.log.

tail -n 200 logs/latest.log

Pentru urmărire în direct:

tail -f logs/latest.log

Pentru a căuta după numele pluginului:

grep -i "pluginadi" logs/latest.log

2. Eroare de versiune API neacceptată

Această eroare indică faptul că versiunea Minecraft API acceptată de plugin este incompatibilă cu versiunea serverului.

Unsupported API version 1.20

De exemplu, pluginul poate fi pregătit pentru 1.20, dar serverul dumneavoastră poate rula 1.16.5. În acest caz, este posibil ca pluginul să nu fie încărcat sau să funcționeze incorect.

Soluție:

• Verificați versiunea Minecraft acceptată de plugin.
• Descărcați versiunea de plugin compatibilă cu versiunea de server.
• Nu vă așteptați ca pluginuri noi să funcționeze pe servere foarte vechi.
• Dacă este necesar, găsiți versiunea corespunzătoare din arhiva versiunii vechi a pluginului.

3. Eroare de dependență necunoscută

Unele plugin-uri nu funcționează singure. Solicită mai întâi instalarea unui alt plugin. Aceasta se numește dependență.

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

De exemplu, pluginuri economice adesea Seif vrea. Pluginurile de autorizare sau de piață pot avea nevoie și de alte pluginuri de bibliotecă.

Soluție:

• Citiți cerințele pe pagina de plugin.
• Descărcați pluginul de dependență care lipsește.
• Asigurați-vă că pluginul de dependență este compatibil și cu versiunea de server.
• Reporniți complet serverul.

4. Eroare plugin.yml nevalidă

În interiorul fișierului jar plugin plugin.yml Dacă fișierul este corupt, lipsește sau incorect, pluginul nu poate fi instalat.

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

Acest lucru se întâmplă de obicei atunci când:

• A fost descărcat fișierul greșit.
• În loc de plugin, codul sursă zip a fost plasat în folderul plugins.
• Fișierul Jar este corupt.
• Pluginul a fost împachetat incorect de către dezvoltator.

Ca o soluție, pluginul este corect. .borcan Fișierul ar trebui să fie descărcat. Source-code.zip descărcat de pe GitHub nu ar trebui să fie plasat direct în folderul de pluginuri.

5. Incompatibilitatea versiunii Java

Versiunea și pluginurile Minecraft necesită versiuni Java specifice. Dacă este utilizată o versiune Java greșită, este posibil ca pluginul sau serverul să nu se deschidă deloc.

java -version

Eroare comună:

UnsupportedClassVersionError

Această eroare indică faptul că pluginul a fost compilat cu Java mai nou, dar Java mai vechi este folosit pe server.

Logica generala:

• Versiunile Minecraft mai vechi necesită adesea Java mai vechi.
• Versiunile Minecraft mai noi necesită Java mai nou.
• Cerința Java din descrierea pluginului trebuie verificată.
• Versiunea Java selectată în panoul de găzduire trebuie verificată.

6. Fișierul plugin este în folderul corect?

Fișiere plugin pe serverele Bukkit, Spigot și Paper pluginuri este aruncat în dosar.

ls plugins/

Fișierul plugin ar trebui să fie așa:

plugins/PluginAdi.jar

Pluginurile lăsate în zip, rar, codul sursă sau foldere adesea nu funcționează.

7. Conflicte de pluginuri

Două plugin-uri care fac aceeași treabă pot intra în conflict unul cu celălalt. De exemplu, două plugin-uri de chat diferite, două plugin-uri economice diferite sau două sisteme de revendicare diferite pot încerca să gestioneze aceleași evenimente.

Simptome de conflict:

• Pluginul este instalat, dar comenzile sale nu funcționează.
• Un plugin copleșește setarea altuia.
• Un conflict de eveniment sau o excepție are loc în consolă.
• Jucătorii nu pot folosi comenzi chiar dacă au permisiunea.
• Serverul se comportă diferit după repornire.

Pentru a găsi o soluție, pluginurile pot fi testate dezactivându-le unul câte unul. Cu toate acestea, înainte de a face acest lucru pe serverul live, ar trebui făcută o copie de rezervă și ar trebui să fie preferate ore reduse de jucător.

8. Eroare de configurare poate împiedica deschiderea pluginului

Unele plugin-uri nu se vor deschide dacă există o eroare YAML în fișierul de configurare. Indentările spațiilor albe sunt deosebit de importante în fișierele YAML.

Greșeli frecvente:

• Folosind caracterul tabulator
• Nu lăsați un spațiu după două puncte
• Scrierea de text care necesită ghilimele fără ghilimele
• Coruperea fișierului din cauza caracterului turcesc sau a simbolului special
• Se salvează fișierul de configurare lipsă

Dacă există un fișier de configurare incorect, folderul plugin poate fi redenumit temporar pentru a crea o copie de rezervă a folderului plugin și a recrea configurația.

Greșeli comune

• Instalarea pluginurilor care nu sunt compatibile cu versiunea de server
• Nu se instalează pluginuri de dependență lipsă
• Confundarea fișierului zip sursă GitHub ca un plugin
• Nu se verifică versiunea Java
• Încerc să instalez un plugin cu /reload
• Folosind file în fișierele de configurare YAML

Întrebări frecvente

Pluginul se află în folderul de pluginuri, dar nu funcționează, de ce?
Ar putea fi incompatibilitatea versiunii, lipsa dependenței, incompatibilitatea Java sau eroarea de configurare. Ar trebui examinat fișierul latest.log.

Ce înseamnă UnsupportedClassVersionError?
Pluginul tocmai a fost compilat cu Java. Versiunea Java folosită pe server este învechită.

Este sigur să utilizați/reîncărcați?
Nu este recomandat pentru multe plugin-uri. O repornire completă este mai sigură pentru instalarea pluginului, eliminarea și modificările majore de configurare.

Recomandări de siguranță și operațiuni

• Descărcați pluginuri din surse de încredere.
• Înainte de a adăuga pluginul la serverul live, încercați-l pe serverul de testare.
• Faceți o copie de rezervă a folderului de pluginuri înainte de fiecare actualizare a pluginului.
• Reduceți suprafața de atac prin eliminarea pluginurilor inutile.
• Verificați în mod regulat jurnalele de pluginuri.

Acest articol este pregătit special pentru PvPServer.