Plugins på Minecraft-servere; Det driver autorisationssystemet, økonomi, beskyttelse, marked, begivenhed, krav, anti-snyd og mange specielle systemer. Hvis et af plugins ikke er installeret, fungerer en væsentlig del af serveren muligvis ikke.

Plugin-fejl opstår normalt i konsollen eller logs/seneste.log vises i filen. De mest almindelige fejl; Kunne ikke indlæse plugin, Ikke-understøttet API-version, ukendt afhængighed, Ugyldigt plugin.yml og Java-versionsinkompatibilitet.

1. Hvor kan du se plugin-fejlen?

Hvis plugin'et ikke indlæses, er det første sted at kigge efter serverkonsollen og den nyeste.log-fil.

tail -n 200 logs/latest.log

Til live tracking:

tail -f logs/latest.log

For at søge efter pluginnavn:

grep -i "pluginadi" logs/latest.log

2. Ikke-understøttet API-versionsfejl

Denne fejl indikerer, at Minecraft API-versionen, der understøttes af pluginnet, er inkompatibel med serverversionen.

Unsupported API version 1.20

For eksempel kan plugin'et være forberedt til 1.20, men din server kører muligvis 1.16.5. I dette tilfælde er plugin'et muligvis ikke indlæst eller fungerer forkert.

Løsning:

• Tjek Minecraft-versionen, der understøttes af plugin.
• Download plugin-versionen, der er kompatibel med din serverversion.
• Forvent ikke, at nye plugins virker på meget gamle servere.
• Find om nødvendigt den passende version fra plugin'ets gamle versionsarkiv.

3. Ukendt afhængighedsfejl

Nogle plugins virker ikke alene. Den beder om at installere et andet plugin først. Dette kaldes afhængighed.

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

For eksempel økonomi-plugins ofte Vault ønsker. Autorisations- eller markedsplugins kan også have brug for andre biblioteksplugins.

Løsning:

• Læs kravene på plugin-siden.
• Download det manglende afhængighedsplugin.
• Sørg for, at afhængighedspluginnet også er kompatibelt med din serverversion.
• Genstart serveren helt.

4. Ugyldig plugin.yml fejl

Inde i plugin-jar-filen plugin.yml Hvis filen er korrupt, mangler eller forkert, kan plugin'et ikke installeres.

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

Dette sker normalt, når:

• Den forkerte fil blev downloadet.
• I stedet for plugin'et er kildekodens zip blevet placeret i plugins-mappen.
• Jar-filen er beskadiget.
• Pluginnet blev pakket forkert af udvikleren.

Som en løsning er plugin'et korrekt. .jar Filen skal downloades. Den source-code.zip, der er downloadet fra GitHub, bør ikke placeres direkte i plugins-mappen.

5. Java-versionsinkompatibilitet

Minecraft-version og plugins kræver specifikke Java-versioner. Hvis den forkerte Java-version bruges, åbner plugin'et eller serveren muligvis slet ikke.

java -version

Almindelig fejl:

UnsupportedClassVersionError

Denne fejl indikerer, at plugin'et blev kompileret med nyere Java, men ældre Java bruges på serveren.

Generel logik:

• Ældre Minecraft-versioner kræver ofte ældre Java.
• Nyere Minecraft-versioner kræver nyere Java.
• Java-kravet i plugin-beskrivelsen bør kontrolleres.
• Den valgte Java-version i hostingpanelet skal verificeres.

6. Er plugin-filen i den rigtige mappe?

Plugin-filer på Bukkit-, Spigot- og Paper-servere plugins er smidt i mappen.

ls plugins/

Plugin-filen skal være sådan:

plugins/PluginAdi.jar

Plugins efterladt i zip, rar, kildekode eller mapper virker ofte ikke.

7. Plugin-konflikter

To plugins, der udfører det samme arbejde, kan være i konflikt med hinanden. For eksempel kan to forskellige chat-plugins, to forskellige økonomi-plugins eller to forskellige kravsystemer forsøge at administrere de samme begivenheder.

Konfliktsymptomer:

• Plugin'et er installeret, men dets kommandoer virker ikke.
• Et plugin overvælder en andens indstilling.
• En begivenhedskonflikt eller undtagelse opstår i konsollen.
• Spillere kan ikke bruge kommandoer, selvom de har tilladelse.
• Serveren opfører sig anderledes efter genstart.

For at finde en løsning kan plugins testes ved at deaktivere dem én efter én. Men før du gør dette på live-serveren, bør der laves en backup og lave spillertimer bør foretrækkes.

8. Konfigurationsfejl kan forhindre plugin i at åbne

Nogle plugins vil ikke åbne, hvis der er en YAML-fejl i konfigurationsfilen. Indrykninger i hvide mellemrum er især vigtige i YAML-filer.

Almindelige fejl:

• Brug af tabulatortegn
• Efterlad ikke et mellemrum efter tyktarmen
• At skrive tekst, der kræver citater uden anførselstegn
• Filkorruption på grund af tyrkisk tegn eller specialsymbol
• Gemmer manglende konfigurationsfil

Hvis der er en forkert konfigurationsfil, kan plugin-mappen midlertidigt omdøbes for at sikkerhedskopiere plugin-mappen og genskabe konfigurationen.

Almindelige fejl

• Installation af plugins, der ikke er kompatible med serverversionen
• Installerer ikke manglende afhængighedsplugins
• Forveksler GitHub-kildezip-filen som et plugin
• Tjek ikke Java-version
• Forsøger at installere et plugin med /reload
• Brug af faner i YAML-konfigurationsfiler

FAQ

Plugin'et er i plugins-mappen, men det virker ikke, hvorfor?
Det kan være versionsinkompatibilitet, manglende afhængighed, Java-inkompatibilitet eller konfigurationsfejl. Den seneste.log-fil bør undersøges.

Hvad betyder UnsupportedClassVersionError?
Pluginnet er netop blevet kompileret med Java. Java-versionen, der bruges på serveren, er forældet.

Er det sikkert at bruge /genindlæse?
Det anbefales ikke til mange plugins. En fuld genstart er sikrere for plugin-installation, fjernelse og større konfigurationsændringer.

Sikkerheds- og driftsanbefalinger

• Download plugins fra pålidelige kilder.
• Før du tilføjer plugin'et til live-serveren, skal du prøve det på testserveren.
• Sikkerhedskopier plugins-mappen før hver plugin-opdatering.
• Reducer angrebsoverfladen ved at fjerne unødvendige plugins.
• Tjek plugin logs regelmæssigt.

Denne artikel er specielt forberedt til PvPServer.