Guide

Sådan retter du fejl i Minecraft-plugins

Opdateret 18. oktober 2026

Når et plugin ikke indlæses, siger serveren næsten altid hvorfor: årsagen står i konsollen under opstarten, et par linjer over eller under pluginets navn. Lær at læse den del af loggen, så tager de fleste fejl et minut at rette. Her er de almindelige, og hvad de betyder.

Skriv din serverversion, og hvad pluginet skal gøre.

Generér dette med Codexe

Trin for trin

1.Åbn loggen fra opstarten
Læs konsollen eller logs/latest.log i servermappen. På et hostingpanel bruger du dets konsol eller filhåndtering.
2.Søg efter pluginets navn
Find den første fejl, der nævner det. Linjer, der starter med [ERROR] eller [WARN], og en stack trace under dem er dem, der betyder noget.
3.Læs den første linje og "Caused by"-linjerne
Den første linje siger, hvad der fejlede; den sidste Caused by:-linje siger som regel hvorfor. Linjer med pluginets eget pakkenavn viser, hvor i koden det skete.
4.Find den på listen nedenfor
De fleste opstartsfejl er et problem med version, Java eller afhængigheder, og beskeden siger hvilket.
5.Ret én ting, og genstart
Ændr én ting, genstart (ikke /reload), og læs loggen igen. Fejl fra ét plugin kan give fejl i andre.

De almindelige fejl

Du ser	Hvad det betyder	Løsning
`Unsupported API version 1.21`	Pluginets `api-version` er nyere end din server.	Hent versionen til din server, eller opdatér serveren.
`Could not load 'plugins/X.jar'` med `Invalid plugin.yml` eller `Jar does not contain plugin.yml`	Pluginets descriptor mangler eller har en YAML-fejl, eller filen er ikke et plugin.	Tjek, at du har downloadet pluginet og ikke dets kildekode, en mod eller en zip. Hvis du selv har bygget det, så ret `plugin.yml`.
`UnsupportedClassVersionError`, "class file version 65.0"	Pluginet kræver en nyere Java, end serveren kører (61 = Java 17, 65 = Java 21, 69 = Java 25).	Kør serveren på den Java, eller genbyg pluginet til din Java.
`NoClassDefFoundError` eller `ClassNotFoundException`	En klasse, som pluginet har brug for, er der ikke: et plugin, det afhænger af, mangler, et bibliotek blev ikke shadet ind i .jar-filen, eller API'en findes ikke på denne version.	Installér det plugin, der nævnes i fejlen (Vault, ProtocolLib), eller brug et build til din version.
`Unknown/missing dependency plugins`	Et plugin angivet i `depend` er ikke installeret.	Installér det i `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	Pluginet blev indlæst, men crashede i `onEnable`.	Læs `Caused by`-linjen: ofte en konfigurationsfejl eller en manglende afhængighed.
`Ambiguous plugin name`	Der ligger to .jar-filer af det samme plugin i `plugins/`.	Slet den gamle.

Fejl, der ikke handler om indlæsning

Pluginet er grønt, men en kommando siger "Unknown command": kommandoen mangler i plugin.yml, eller et andet plugin bruger det samme navn.
"I'm sorry, but you do not have permission": spilleren mangler permission-noden. Tjek pluginets side for noden, og giv den med dit permissions-plugin.
Fejl efter redigering af config.yml: YAML kræver mellemrum, ikke tabulatorer, og anførselstegn om tekst, der starter med : eller &.
Virker efter en genstart, går i stykker efter /reload: pluginet understøtter ikke /reload. Genstart i stedet.

Hvilken Java din server har brug for

Minecraft 1.20.5 og nyere kræver Java 21, og 26.x kræver Java 25; 1.18 til 1.20.4 kræver Java 17. Kør java -version med den samme Java, som serveren bruger (på et hostingpanel er det som regel en indstilling, der hedder Docker image eller Java version). Et plugin bygget til en ældre Java kører på en nyere, ikke omvendt.

Ret plugins lavet med Codexe

Plugins lavet på Codexe kompileres til den version, du valgte, og tjekkes for en gyldig plugin.yml, før de er Klar. På en testserver viser fanen Logs loggen live med fejlene fremhævet, og Eksportér logs gemmer den som en fil. Beskriv, hvad du ser, i projektchatten ("pluginet er rødt i /plugins, og loggen siger ..."), så ændrer Codexe koden og bygger igen. Hvis en Kompilér fejler på filer, der er præcis, som Codexe leverede dem, retter Ret med AI dem gratis.

Spørgsmål

Hvor er serverloggen?

logs/latest.log i servermappen for den aktuelle kørsel. Ældre kørsler ligger i den samme mappe som .log.gz-filer.

Kan ét plugin ødelægge et andet?

Ja: en manglende eller ødelagt afhængighed stopper alle plugins, der har brug for den. Ret den første fejl i loggen før de andre.

Er det sikkert at dele min log?

For det meste, men tjek den først: logs kan indeholde IP-adresser og, med nogle plugins, databaseadgangskoder fra fejl.

Genbyg et ødelagt plugin til din server

Denne prompt åbnes klar til at sende:

“Et Paper 1.21.4-plugin kaldet SimpleWarps, der erstatter mit gamle, som ikke længere indlæses: /setwarp, /warp og /delwarp med et navn, /warps viser dem i en GUI, permissionen warps.admin til at sætte og slette, warps gemt på tværs af genstarter, beskeder i config.yml.”