Plugins på Minecraft-servere; Den driver autorisasjonssystemet, økonomi, beskyttelse, marked, begivenhet, krav, anti-juks og mange spesialsystemer. Hvis en av pluginene ikke er installert, kan det hende at en betydelig del av serveren ikke fungerer.

Plugin-feil oppstår vanligvis i konsollen eller logger/nyeste.logg vises i filen. De vanligste feilene; Kunne ikke laste inn plugin, Ustøttet API-versjon, ukjent avhengighet, Ugyldig plugin.yml og inkompatibilitet med Java-versjon.

1. Hvor kan du se plugin-feilen?

Hvis plugin-modulen ikke lastes, er det første stedet å se på serverkonsollen og last.log-filen.

tail -n 200 logs/latest.log

For live sporing:

tail -f logs/latest.log

For å søke etter pluginnavn:

grep -i "pluginadi" logs/latest.log

2. Ustøttet API-versjonsfeil

Denne feilen indikerer at Minecraft API-versjonen som støttes av plugin-en er inkompatibel med serverversjonen.

Unsupported API version 1.20

For eksempel kan plugin-modulen være forberedt for 1.20, men serveren din kan kjøre 1.16.5. I dette tilfellet kan det hende at programtillegget ikke lastes inn eller fungerer feil.

Løsning:

• Sjekk Minecraft-versjonen som støttes av plugin.
• Last ned plugin-versjonen som er kompatibel med serverversjonen din.
• Ikke forvent at nye plugins skal fungere på veldig gamle servere.
• Om nødvendig, finn riktig versjon fra det gamle versjonsarkivet til plugin-modulen.

3. Ukjent avhengighetsfeil

Noen plugins fungerer ikke alene. Den ber om å installere en annen plugin først. Dette kalles avhengighet.

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

For eksempel økonomi-plugins ofte Hvelv ønsker. Autorisasjons- eller markedsplugins kan også trenge andre bibliotekplugins.

Løsning:

• Les kravene på plugin-siden.
• Last ned den manglende avhengighetsplugin.
• Sørg for at avhengighetspluginen også er kompatibel med serverversjonen din.
• Start serveren helt på nytt.

4. Ugyldig plugin.yml-feil

Inne i plugin-jar-filen plugin.yml Hvis filen er korrupt, mangler eller feil, kan ikke plugin-modulen installeres.

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

Dette skjer vanligvis når:

• Feil fil ble lastet ned.
• I stedet for plugin, har kildekoden zip blitt plassert i plugins-mappen.
• Jar-filen er ødelagt.
• Programtillegget ble pakket feil av utvikleren.

Som en løsning er plugin-en riktig. .jar Filen skal lastes ned. Kildekoden.zip som er lastet ned fra GitHub skal ikke plasseres direkte i plugins-mappen.

5. Inkompatibilitet med Java-versjon

Minecraft-versjon og plugins krever spesifikke Java-versjoner. Hvis feil Java-versjon brukes, kan det hende at plugin-en eller serveren ikke åpnes i det hele tatt.

java -version

Vanlig feil:

UnsupportedClassVersionError

Denne feilen indikerer at plugin-en ble kompilert med nyere Java, men eldre Java brukes på serveren.

Generell logikk:

• Eldre Minecraft-versjoner krever ofte eldre Java.
• Nyere Minecraft-versjoner krever nyere Java.
• Java-kravet i plugin-beskrivelsen bør sjekkes.
• Den valgte Java-versjonen i vertspanelet må verifiseres.

6. Er plugin-filen i riktig mappe?

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

ls plugins/

Plugin-filen skal være slik:

plugins/PluginAdi.jar

Plugins igjen i zip, rar, kildekode eller mapper fungerer ofte ikke.

7. Plugin-konflikter

To plugins som gjør samme jobb kan komme i konflikt med hverandre. For eksempel kan to forskjellige chat-plugins, to forskjellige økonomi-plugins eller to forskjellige kravsystemer prøve å administrere de samme hendelsene.

Konfliktsymptomer:

• Programtillegget er installert, men kommandoene fungerer ikke.
• En plugin overvelder en annens innstilling.
• En hendelseskonflikt eller unntak oppstår i konsollen.
• Spillere kan ikke bruke kommandoer selv om de har tillatelse.
• Serveren oppfører seg annerledes etter omstart.

For å finne en løsning kan plugins testes ved å deaktivere dem én etter én. Men før du gjør dette på live-serveren, bør det lages en sikkerhetskopi og lave spillertimer bør foretrekkes.

8. Konfigurasjonsfeil kan forhindre at plugin-modulen åpnes

Noen plugins vil ikke åpne hvis det er en YAML-feil i konfigurasjonsfilen. Mellomromsinnrykk er spesielt viktig i YAML-filer.

Vanlige feil:

• Bruker tabulatortegn
• Ikke legg igjen et mellomrom etter tykktarmen
• Skrive tekst som krever sitater uten anførselstegn
• Filkorrupsjon på grunn av tyrkisk tegn eller spesialsymbol
• Lagrer manglende konfigurasjonsfil

Hvis det er en feil konfigurasjonsfil, kan plugin-mappen endres midlertidig for å sikkerhetskopiere plugin-mappen og gjenskape konfigurasjonen.

Vanlige feil

• Installere plugins som ikke er kompatible med serverversjonen
• Installerer ikke manglende avhengighetsplugins
• Tar feil av GitHub-kildezip-filen som en plugin
• Sjekker ikke Java-versjonen
• Prøver å installere en plugin med /reload
• Bruke faner i YAML-konfigurasjonsfiler

FAQ

Programtillegget er i plugin-mappen, men det fungerer ikke, hvorfor?
Det kan være versjonsinkompatibilitet, manglende avhengighet, Java-inkompatibilitet eller konfigurasjonsfeil. Den nyeste.log-filen bør undersøkes.

Hva betyr UnsupportedClassVersionError?
Programtillegget har nettopp blitt kompilert med Java. Java-versjonen som brukes på serveren er utdatert.

Er det trygt å bruke /reload?
Det anbefales ikke for mange plugins. En full omstart er tryggere for plugin-installasjon, fjerning og større konfigurasjonsendringer.

Sikkerhets- og driftsanbefalinger

• Last ned plugins fra pålitelige kilder.
• Før du legger til plugin-en til live-serveren, prøv den på testserveren.
• Sikkerhetskopier plugin-mappen før hver plugin-oppdatering.
• Reduser angrepsoverflaten ved å fjerne unødvendige plugins.
• Sjekk plugin-loggene regelmessig.

Denne artikkelen er spesielt utarbeidet for PvPServer.