Connectors als servidors de Minecraft; Opera el sistema d'autorització, economia, protecció, mercat, esdeveniment, reclamació, anti-trampa i molts sistemes especials. Si un dels connectors no està instal·lat, és possible que una part important del servidor no funcioni.

Els errors del connector solen produir-se a la consola o logs/latest.log apareix al fitxer. Els errors més comuns; No s'ha pogut carregar el connector, Versió de l'API no compatible, dependència desconeguda, Plugin.yml no vàlid i incompatibilitats de la versió de Java.

1. On podeu veure l'error del connector?

Si el connector no s'està carregant, el primer lloc a buscar és la consola del servidor i el fitxer latest.log.

tail -n 200 logs/latest.log

Per al seguiment en directe:

tail -f logs/latest.log

Per cercar pel nom del connector:

grep -i "pluginadi" logs/latest.log

2. Error de versió de l'API no compatible

Aquest error indica que la versió de l'API de Minecraft admesa pel connector és incompatible amb la versió del servidor.

Unsupported API version 1.20

Per exemple, el connector pot estar preparat per a 1.20, però el vostre servidor pot estar executant 1.16.5. En aquest cas, és possible que el connector no estigui carregat o que funcioni incorrectament.

Solució:

• Comproveu la versió de Minecraft compatible amb el connector.
• Baixeu la versió del connector compatible amb la versió del vostre servidor.
• No espereu que els connectors nous funcionin en servidors molt antics.
• Si cal, cerqueu la versió adequada a l'arxiu de la versió antiga del connector.

3. Error de dependència desconegut

Alguns connectors no funcionen sols. Primer demana que s'instal·li un altre connector. Això s'anomena dependència.

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

Per exemple, els connectors econòmics sovint Volta vol. Els connectors d'autorització o de mercat també poden necessitar altres connectors de biblioteca.

Solució:

• Llegiu els requisits a la pàgina del connector.
• Baixeu el connector de dependència que falta.
• Assegureu-vos que el connector de dependència també és compatible amb la versió del vostre servidor.
• Reinicieu el servidor completament.

4. Error plugin.yml no vàlid

Dins del fitxer jar del connector plugin.yml Si el fitxer està corrupte, falta o és incorrecte, no es pot instal·lar el connector.

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

Això sol passar quan:

• S'ha baixat el fitxer incorrecte.
• En lloc del connector, el codi font zip s'ha col·locat a la carpeta de connectors.
• El fitxer Jar està malmès.
• El desenvolupador ha empaquetat incorrectament el connector.

Com a solució, el connector és correcte. .jar S'ha de descarregar l'arxiu. El codi font.zip descarregat de GitHub no s'ha de col·locar directament a la carpeta de connectors.

5. Incompatibilitat de la versió de Java

La versió i els connectors de Minecraft requereixen versions específiques de Java. Si s'utilitza una versió de Java incorrecta, és possible que el connector o el servidor no s'obri en absolut.

java -version

Error comú:

UnsupportedClassVersionError

Aquest error indica que el connector es va compilar amb Java més recent, però que s'utilitza Java més antic al servidor.

Lògica general:

• Les versions anteriors de Minecraft sovint requereixen Java més antic.
• Les versions més noves de Minecraft requereixen Java més recent.
• S'ha de comprovar el requisit de Java a la descripció del connector.
• S'ha de verificar la versió de Java seleccionada al tauler d'allotjament.

6. El fitxer del connector està a la carpeta correcta?

Fitxers de connectors als servidors Bukkit, Spigot i Paper connectors es llença a la carpeta.

ls plugins/

El fitxer del connector hauria de ser així:

plugins/PluginAdi.jar

Els connectors que queden a zip, rar, codi font o carpetes sovint no funcionen.

7. Conflictes de connectors

Dos connectors que fan la mateixa feina poden entrar en conflicte entre ells. Per exemple, dos connectors de xat diferents, dos connectors econòmics diferents o dos sistemes de reclamació diferents poden intentar gestionar els mateixos esdeveniments.

Símptomes de conflicte:

• El connector està instal·lat però les seves ordres no funcionen.
• Un connector desborda la configuració d'un altre.
• Es produeix un conflicte d'esdeveniment o una excepció a la consola.
• Els jugadors no poden utilitzar ordres encara que tinguin permís.
• El servidor es comporta de manera diferent després del reinici.

Per trobar una solució, es poden provar els connectors desactivant-los un per un. Tanmateix, abans de fer-ho al servidor en directe, s'hauria de fer una còpia de seguretat i s'haurien de preferir les hores de jugador baixes.

8. L'error de configuració pot impedir que el connector s'obri

Alguns connectors no s'obriran si hi ha un error YAML al fitxer de configuració. Les sagnacions dels espais en blanc són especialment importants als fitxers YAML.

Errors comuns:

• Utilitzant el caràcter de tabulació
• No deixeu un espai després dels dos punts
• Redacció de text que requereix cometes sense cometes
• Fitxer corrupte a causa del caràcter turc o símbol especial
• S'està desant el fitxer de configuració que falta

Si hi ha un fitxer de configuració incorrecte, es pot canviar el nom de la carpeta del connector temporalment per fer una còpia de seguretat de la carpeta del connector i recrear la configuració.

Errors comuns

• Instal·lació de connectors que no són compatibles amb la versió del servidor
• No instal·lar els connectors de dependència que falten
• Confondre el fitxer zip font de GitHub com a connector
• No s'està comprovant la versió de Java
• S'està intentant instal·lar un connector amb /reload
• Ús de pestanyes als fitxers de configuració YAML

PMF

El connector és a la carpeta de connectors però no funciona, per què?
Pot ser incompatibilitat de versions, falta de dependència, incompatibilitat de Java o error de configuració. S'ha d'examinar el fitxer latest.log.

Què significa UnsupportedClassVersionError?
El connector s'acaba de compilar amb Java. La versió de Java utilitzada al servidor està obsoleta.

És segur utilitzar/recarregar?
No es recomana per a molts connectors. Un reinici complet és més segur per a la instal·lació, eliminació i canvis de configuració importants.

Recomanacions de seguretat i operacions

• Baixeu connectors de fonts fiables.
• Abans d'afegir el connector al servidor en directe, proveu-lo al servidor de prova.
• Feu una còpia de seguretat de la carpeta de connectors abans de cada actualització de connectors.
• Reduïu la superfície d'atac eliminant els connectors innecessaris.
• Comproveu els registres dels connectors regularment.

Aquest article està preparat especialment per a PvPServer.