Guide

Så åtgärdar du fel i Minecraft-plugin

Uppdaterad 18 oktober 2026

När ett plugin inte läses in säger servern nästan alltid varför: orsaken står i konsolen under starten, några rader ovanför eller under pluginets namn. Lär dig läsa den delen av loggen så tar de flesta fel en minut att åtgärda. Här är de vanligaste och vad de betyder.

Ange din serverversion och vad pluginet ska göra.

Generera det här med Codexe

Steg för steg

1.Öppna loggen från starten
Läs konsolen, eller logs/latest.log i servermappen. På en hostingpanel använder du dess konsol eller filhanterare.
2.Sök efter pluginets namn
Hitta det första felet som nämner det. Rader som börjar med [ERROR] eller [WARN] och en stack trace under dem är de som spelar roll.
3.Läs den första raden och raderna ”Caused by”
Den första raden säger vad som misslyckades; den sista raden Caused by: säger oftast varför. Rader med pluginets eget paketnamn visar var i koden.
4.Matcha det mot listan nedan
De flesta startfel är ett problem med version, Java eller beroenden, och meddelandet säger vilket.
5.Åtgärda en sak och starta om
Ändra en sak, starta om (inte /reload) och läs loggen igen. Fel från ett plugin kan orsaka fel i andra.

De vanligaste felen

Du ser	Vad det betyder	Åtgärd
`Unsupported API version 1.21`	Pluginets `api-version` är nyare än din server.	Hämta versionen för din server, eller uppdatera servern.
`Could not load 'plugins/X.jar'` med `Invalid plugin.yml` eller `Jar does not contain plugin.yml`	Pluginets deskriptor saknas eller har ett YAML-fel, eller så är filen inte ett plugin.	Kontrollera att du laddade ner pluginet och inte dess källkod, en mod eller en zip. Om du byggde det själv, rätta `plugin.yml`.
`UnsupportedClassVersionError`, ”class file version 65.0”	Pluginet kräver en nyare Java än den servern kör (61 = Java 17, 65 = Java 21, 69 = Java 25).	Kör servern på den Java-versionen, eller bygg om pluginet för din Java.
`NoClassDefFoundError` eller `ClassNotFoundException`	En klass som pluginet behöver finns inte: ett plugin som det är beroende av saknas, ett bibliotek shadades inte in i .jar-filen, eller API:et finns inte i den här versionen.	Installera pluginet som nämns i felet (Vault, ProtocolLib), eller använd ett bygge för din version.
`Unknown/missing dependency plugins`	Ett plugin som anges i `depend` är inte installerat.	Installera det i `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Pluginet lästes in men kraschade i `onEnable`.	Läs raden `Caused by`: ofta ett konfigurationsfel eller ett saknat beroende.
`Ambiguous plugin name`	Två .jar-filer av samma plugin ligger i `plugins/`.	Radera den gamla.

Fel som inte handlar om inläsning

Pluginet är grönt men ett kommando säger ”Unknown command”: kommandot saknas i plugin.yml, eller så använder ett annat plugin samma namn.
”I'm sorry, but you do not have permission”: spelaren saknar behörighetsnoden. Kolla pluginsidan efter noden och ge den med ditt behörighetsplugin.
Fel efter redigering av config.yml: YAML kräver mellanslag, inte tabbar, och citattecken runt text som börjar med : eller &.
Fungerar efter en omstart, går sönder efter /reload: pluginet stöder inte /reload. Starta om i stället.

Vilken Java din server behöver

Minecraft 1.20.5 och nyare kräver Java 21, och 26.x kräver Java 25; 1.18 till 1.20.4 kräver Java 17. Kör java -version med samma Java som servern använder (på en hostingpanel är det oftast en inställning som heter Docker image eller Java version). Ett plugin byggt för en äldre Java körs på en nyare, inte tvärtom.

Åtgärda plugin gjorda med Codexe

Plugin som gjorts på Codexe kompileras för den version du valde och kontrolleras för en giltig plugin.yml innan de blir Redo. På en testserver visar fliken Loggar loggen live med felen markerade, och Exportera loggar sparar den som en fil. Beskriv vad du ser i projektchatten (”pluginet är rött i /plugins och loggen säger ...”) så ändrar Codexe koden och bygger igen. Om en kompilering misslyckas på filer exakt som Codexe levererade dem, rättar Åtgärda med AI dem gratis.

Frågor

Var finns serverloggen?

logs/latest.log i servermappen, för den aktuella körningen. Äldre körningar ligger i samma mapp som .log.gz-filer.

Kan ett plugin förstöra ett annat?

Ja: ett saknat eller trasigt beroende stoppar alla plugin som behöver det. Åtgärda det första felet i loggen före de andra.

Är det säkert att dela min logg?

Oftast, men kontrollera den först: loggar kan innehålla IP-adresser och, med vissa plugin, databaslösenord från felmeddelanden.

Bygg om ett trasigt plugin för din server

Den här prompten öppnas färdig att skicka:

“Ett Paper 1.21.4-plugin som heter SimpleWarps och ersätter mitt gamla som inte längre läses in: /setwarp, /warp och /delwarp med ett namn, /warps listar dem i ett GUI, behörigheten warps.admin för att sätta och ta bort, warps sparas över omstarter, meddelanden i config.yml.”