Plugins på Minecraft-servrar; Den driver auktoriseringssystem, ekonomi, skydd, marknad, evenemang, anspråk, anti-fusk och många specialsystem. Om ett av plugin-programmen inte är installerat kanske en betydande del av servern inte fungerar.

Plugin-fel uppstår vanligtvis i konsolen eller logs/senaste.logg visas i filen. De vanligaste misstagen; Det gick inte att ladda plugin, API-version som inte stöds, okänt beroende, Ogiltig plugin.yml och Java-versionsinkompatibiliteter.

1. Var kan du se plugin-felet?

Om plugin-programmet inte laddas, är det första stället att leta efter serverkonsolen och filen latest.log.

tail -n 200 logs/latest.log

För livespårning:

tail -f logs/latest.log

För att söka efter pluginnamn:

grep -i "pluginadi" logs/latest.log

2. API-versionsfel som inte stöds

Det här felet indikerar att Minecraft API-versionen som stöds av plugin är inkompatibel med serverversionen.

Unsupported API version 1.20

Till exempel kan plugin-programmet vara förberett för 1.20, men din server kan köra 1.16.5. I det här fallet kanske plugin-programmet inte laddas eller fungerar felaktigt.

Lösning:

• Kontrollera Minecraft-versionen som stöds av plugin.
• Ladda ner pluginversionen som är kompatibel med din serverversion.
• Förvänta dig inte att nya plugins ska fungera på mycket gamla servrar.
• Om det behövs, hitta rätt version från det gamla versionsarkivet för plugin-programmet.

3. Okänt beroendefel

Vissa plugins fungerar inte ensamma. Den ber om att ett annat plugin installeras först. Detta kallas beroende.

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

Till exempel ekonomi plugins ofta Valv vill ha. Auktoriserings- eller marknadsplugin kan också behöva andra biblioteksplugin.

Lösning:

• Läs kraven på pluginsidan.
• Ladda ner den saknade beroendeplugin.
• Se till att beroendeplugin också är kompatibel med din serverversion.
• Starta om servern helt.

4. Ogiltigt plugin.yml-fel

Inuti plugin-jar-filen plugin.yml Om filen är korrupt, saknas eller felaktig kan plugin-programmet inte installeras.

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

Detta inträffar vanligtvis när:

• Fel fil laddades ner.
• Istället för pluginet har källkodens zip placerats i plugins-mappen.
• Jar-filen är skadad.
• Insticksprogrammet paketerades felaktigt av utvecklaren.

Som en lösning är pluginet korrekt. .jar Filen bör laddas ner. Den source-code.zip som laddas ner från GitHub ska inte placeras direkt i plugins-mappen.

5. Inkompatibilitet med Java-version

Minecraft-versionen och plugins kräver specifika Java-versioner. Om fel Java-version används kan det hända att plugin-programmet eller servern inte öppnas alls.

java -version

Vanligt fel:

UnsupportedClassVersionError

Det här felet indikerar att plugin-programmet kompilerades med nyare Java, men äldre Java används på servern.

Allmän logik:

• Äldre Minecraft-versioner kräver ofta äldre Java.
• Nyare Minecraft-versioner kräver nyare Java.
• Java-kravet i plugin-beskrivningen bör kontrolleras.
• Den valda Java-versionen i värdpanelen måste verifieras.

6. Finns plugin-filen i rätt mapp?

Plugin-filer på Bukkit, Spigot och Paper-servrar plugins slängs i mappen.

ls plugins/

Plugin-filen ska vara så här:

plugins/PluginAdi.jar

Plugins som finns kvar i zip, rar, källkod eller mappar fungerar ofta inte.

7. Plugin-konflikter

Två plugins som gör samma jobb kan komma i konflikt med varandra. Till exempel kan två olika chattplugins, två olika ekonomiplugins eller två olika anspråkssystem försöka hantera samma händelser.

Konfliktsymptom:

• Insticksprogrammet är installerat men dess kommandon fungerar inte.
• En plugin överväldigar en annans inställning.
• En händelsekonflikt eller ett undantag uppstår i konsolen.
• Spelare kan inte använda kommandon även om de har tillstånd.
• Servern beter sig annorlunda efter omstart.

För att hitta en lösning kan plugins testas genom att inaktivera dem en efter en. Innan du gör detta på liveservern bör dock en säkerhetskopia göras och låga spelartimmar bör föredras.

8. Konfigurationsfel kan förhindra att plugin öppnas

Vissa plugins öppnas inte om det finns ett YAML-fel i konfigurationsfilen. Indrag i blanksteg är särskilt viktiga i YAML-filer.

Vanliga misstag:

• Använder tab-tecken
• Lämna inte ett mellanslag efter tjocktarmen
• Att skriva text som kräver citat utan citattecken
• Filkorruption på grund av turkiskt tecken eller specialsymbol
• Sparar saknad konfigurationsfil

Om det finns en felaktig konfigurationsfil kan plugin-mappen tillfälligt bytas om för att säkerhetskopiera plugin-mappen och återskapa konfigurationen.

Vanliga misstag

• Installera plugins som inte är kompatibla med serverversionen
• Installerar inte saknade beroendeplugins
• Misstag GitHub-källzip-filen som ett plugin
• Kontrollerar inte Java-versionen
• Försöker installera ett plugin med /reload
• Använda flikar i YAML-konfigurationsfiler

FAQ

Plugin-programmet finns i plugins-mappen men det fungerar inte, varför?
Det kan vara versionsinkompatibilitet, saknat beroende, Java-inkompatibilitet eller konfigurationsfel. Den senaste.log-filen bör undersökas.

Vad betyder UnsupportedClassVersionError?
Plugin-programmet har precis kompilerats med Java. Java-versionen som används på servern är föråldrad.

Är det säkert att använda /reload?
Det rekommenderas inte för många plugins. En fullständig omstart är säkrare för plugininstallation, borttagning och större konfigurationsändringar.

Säkerhets- och driftsrekommendationer

• Ladda ner plugins från pålitliga källor.
• Innan du lägger till plugin-programmet till liveservern, prova det på testservern.
• Säkerhetskopiera plugin-mappen före varje plugin-uppdatering.
• Minska attackytan genom att ta bort onödiga plugins.
• Kontrollera plugin-loggarna regelbundet.

Den här artikeln är speciellt förberedd för PvPServer.