Plug-ins op Minecraft-servers; Het beheert het autorisatiesysteem, economie, bescherming, markt, gebeurtenis, claim, anti-cheat en vele speciale systemen. Als een van de plug-ins niet is geïnstalleerd, werkt een aanzienlijk deel van de server mogelijk niet.

Plug-infouten komen meestal voor in de console of logs/laatste.log verschijnt in het bestand. De meest voorkomende fouten; Kan plug-in niet laden, Niet-ondersteunde API-versie, onbekende afhankelijkheid, Ongeldige plugin.yml en incompatibiliteit met Java-versies.

1. Waar kunt u de plug-infout zien?

Als de plug-in niet wordt geladen, moet u eerst kijken naar de serverconsole en het bestand Latest.log.

tail -n 200 logs/latest.log

Voor live volgen:

tail -f logs/latest.log

Zoeken op plug-innaam:

grep -i "pluginadi" logs/latest.log

2. Niet-ondersteunde API-versiefout

Deze fout geeft aan dat de Minecraft API-versie die door de plug-in wordt ondersteund, incompatibel is met de serverversie.

Unsupported API version 1.20

De plug-in is bijvoorbeeld voorbereid voor versie 1.20, maar uw server draait mogelijk versie 1.16.5. In dit geval wordt de plug-in mogelijk niet geladen of werkt deze mogelijk niet correct.

Oplossing:

• Controleer de Minecraft-versie die door de plug-in wordt ondersteund.
• Download de plug-inversie die compatibel is met uw serverversie.
• Verwacht niet dat nieuwe plug-ins op hele oude servers werken.
• Zoek indien nodig de juiste versie uit het oude versiearchief van de plug-in.

3. Onbekende afhankelijkheidsfout

Sommige plug-ins werken niet alleen. Er wordt gevraagd om eerst een andere plug-in te installeren. Dit heet afhankelijkheid.

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

Economy-plug-ins worden bijvoorbeeld vaak gebruikt Kluis wil. Autorisatie- of marktplug-ins hebben mogelijk ook andere bibliotheekplug-ins nodig.

Oplossing:

• Lees de vereisten op de plug-inpagina.
• Download de ontbrekende afhankelijkheidsplug-in.
• Zorg ervoor dat de afhankelijkheidsplug-in ook compatibel is met uw serverversie.
• Start de server volledig opnieuw op.

4. Ongeldige plugin.yml-fout

In het jar-bestand van de plug-in plug-in.yml Als het bestand beschadigd is, ontbreekt of onjuist is, kan de plug-in niet worden geïnstalleerd.

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

Dit gebeurt meestal wanneer:

• Het verkeerde bestand is gedownload.
• In plaats van de plug-in is de broncode-zip in de map Plug-ins geplaatst.
• Jar-bestand is beschadigd.
• De plug-in is verkeerd verpakt door de ontwikkelaar.

Als oplossing is de plug-in correct. .jar Het bestand moet worden gedownload. De source-code.zip gedownload van GitHub mag niet rechtstreeks in de map met plug-ins worden geplaatst.

5. Incompatibiliteit met Java-versie

Minecraft-versie en plug-ins vereisen specifieke Java-versies. Als de verkeerde Java-versie wordt gebruikt, wordt de plug-in of server mogelijk helemaal niet geopend.

java -version

Veel voorkomende fout:

UnsupportedClassVersionError

Deze fout geeft aan dat de plug-in is gecompileerd met nieuwer Java, maar dat ouder Java op de server wordt gebruikt.

Algemene logica:

• Oudere Minecraft-versies vereisen vaak ouder Java.
• Nieuwere Minecraft-versies vereisen nieuwer Java.
• De Java-vereiste in de plug-inbeschrijving moet worden gecontroleerd.
• De geselecteerde Java-versie in het hostingpaneel moet worden geverifieerd.

6. Staat het plug-inbestand in de juiste map?

Plug-inbestanden op Bukkit-, Spigot- en Paper-servers plug-ins wordt in de map gegooid.

ls plugins/

Het plug-inbestand zou er als volgt uit moeten zien:

plugins/PluginAdi.jar

Plug-ins die achterblijven in zip, rar, broncode of mappen werken vaak niet.

7. Plug-inconflicten

Twee plug-ins die hetzelfde werk doen, kunnen met elkaar conflicteren. Twee verschillende chatplug-ins, twee verschillende economy-plug-ins of twee verschillende claimsystemen kunnen bijvoorbeeld proberen dezelfde gebeurtenissen te beheren.

Conflictsymptomen:

• De plug-in is geïnstalleerd, maar de opdrachten werken niet.
• De ene plug-in overweldigt de instellingen van een andere.
• Er doet zich een gebeurtenisconflict of uitzondering voor in de console.
• Spelers kunnen geen opdrachten gebruiken, zelfs niet als ze daarvoor toestemming hebben.
• De server gedraagt zich anders na het opnieuw opstarten.

Om een ​​oplossing te vinden, kunnen plug-ins worden getest door ze één voor één uit te schakelen. Voordat u dit echter op de live server doet, moet er een back-up worden gemaakt en verdient het de voorkeur om lage speeluren te hebben.

8. Configuratiefout kan voorkomen dat de plug-in wordt geopend

Sommige plug-ins worden niet geopend als er een YAML-fout in het configuratiebestand staat. Witruimte-inspringingen zijn vooral belangrijk in YAML-bestanden.

Veel voorkomende fouten:

• Tabteken gebruiken
• Laat geen spatie achter na de dikke darm
• Tekst schrijven waarvoor aanhalingstekens nodig zijn, zonder aanhalingstekens
• Bestandscorruptie als gevolg van Turkse karakters of speciaal symbolen
• Ontbrekend configuratiebestand opslaan

Als er een onjuist configuratiebestand is, kan de map met plug-ins tijdelijk worden hernoemd om een back-up te maken van de map met plug-ins en de configuratie opnieuw te maken.

Veelvoorkomende fouten

• Plug-ins installeren die niet compatibel zijn met de serverversie
• Geen ontbrekende afhankelijkheidsplug-ins installeren
• Het GitHub-bron-zipbestand aangezien voor een plug-in
• Controleert de Java-versie niet
• Ik probeer een plug-in te installeren met /reload
• Tabbladen gebruiken in YAML-configuratiebestanden

Veelgestelde vragen

De plug-in staat in de map Plug-ins, maar werkt niet. Waarom?
Het kan een versie-incompatibiliteit, een ontbrekende afhankelijkheid, een Java-incompatibiliteit of een configuratiefout zijn. Het bestand Latest.log moet worden onderzocht.

Wat betekent UnsupportedClassVersionError?
De plug-in is zojuist gecompileerd met Java. De Java-versie die op de server wordt gebruikt, is verouderd.

Is het veilig om te gebruiken/herladen?
Voor veel plug-ins wordt het niet aanbevolen. Een volledige herstart is veiliger voor het installeren, verwijderen van plug-ins en grote configuratiewijzigingen.

Aanbevelingen voor veiligheid en bediening

• Download plug-ins van betrouwbare bronnen.
• Voordat u de plug-in aan de live-server toevoegt, probeert u deze op de testserver.
• Maak vóór elke plug-inupdate een back-up van de map met plug-ins.
• Verklein het aanvalsoppervlak door onnodige plug-ins te verwijderen.
• Controleer plug-inlogboeken regelmatig.

Dit artikel is speciaal opgesteld voor PvPServer.