Handleiding

Fouten in Minecraft-plugins oplossen

Bijgewerkt 18 oktober 2026

Als een plugin niet laadt, zegt de server bijna altijd waarom: de reden staat in de console tijdens het opstarten, een paar regels boven of onder de naam van de plugin. Leer dat deel van het log lezen en de meeste fouten zijn in een minuut opgelost. Dit zijn de veelvoorkomende fouten en wat ze betekenen.

Zeg je serverversie en wat de plugin moet doen.

Genereer dit met Codexe

Stap voor stap

1.Open het log van het opstarten
Lees de console, of logs/latest.log in de servermap. Gebruik in een hostingpaneel de console of de bestandsbeheerder.
2.Zoek op de naam van de plugin
Zoek de eerste fout waarin hij wordt genoemd. Regels die beginnen met [ERROR] of [WARN] met een stacktrace eronder zijn de regels die ertoe doen.
3.Lees de eerste regel en de regels met "Caused by"
De eerste regel zegt wat er misging; de laatste regel Caused by: zegt meestal waarom. Regels met de eigen packagenaam van de plugin laten zien waar in de code het gebeurt.
4.Zoek hem op in de lijst hieronder
De meeste opstartfouten zijn een probleem met de versie, Java of een dependency, en de melding zegt welk.
5.Herstel één ding en herstart
Verander één ding, herstart (niet /reload) en lees het log opnieuw. Fouten van één plugin kunnen fouten in andere veroorzaken.

De veelvoorkomende fouten

Wat je ziet	Wat het betekent	Oplossing
`Unsupported API version 1.21`	De `api-version` van de plugin is nieuwer dan je server.	Haal de versie voor je server op, of werk de server bij.
`Could not load 'plugins/X.jar'` met `Invalid plugin.yml` of `Jar does not contain plugin.yml`	De descriptor van de plugin ontbreekt of bevat een YAML-fout, of het bestand is geen plugin.	Controleer of je de plugin hebt gedownload en niet de broncode, een mod of een zip. Heb je hem zelf gebouwd, herstel dan `plugin.yml`.
`UnsupportedClassVersionError`, "class file version 65.0"	De plugin heeft een nieuwere Java nodig dan de server draait (61 = Java 17, 65 = Java 21, 69 = Java 25).	Draai de server op die Java, of bouw de plugin opnieuw voor jouw Java.
`NoClassDefFoundError` of `ClassNotFoundException`	Een klasse die de plugin nodig heeft, is er niet: een plugin waarvan hij afhangt ontbreekt, een library is niet in de .jar geshade, of de API bestaat niet op deze versie.	Installeer de plugin die in de fout wordt genoemd (Vault, ProtocolLib), of gebruik een build voor jouw versie.
`Unknown/missing dependency plugins`	Een plugin die in `depend` staat, is niet geïnstalleerd.	Installeer hem in `plugins/`.
`Error occurred while enabling X (Is it up to date?)`	De plugin is geladen maar crashte in `onEnable`.	Lees de regel `Caused by`: vaak een configfout of een ontbrekende dependency.
`Ambiguous plugin name`	Er staan twee .jar-bestanden van dezelfde plugin in `plugins/`.	Verwijder de oude.

Fouten die niet over laden gaan

De plugin is groen maar een commando zegt "Unknown command": het commando ontbreekt in plugin.yml, of een andere plugin gebruikt dezelfde naam.
"I'm sorry, but you do not have permission": de speler mist de permission node. Zoek de node op de pluginpagina op en geef hem met je permissieplugin.
Fouten na het bewerken van config.yml: YAML vereist spaties, geen tabs, en aanhalingstekens rond tekst die begint met : of &.
Werkt na een herstart, gaat stuk na /reload: de plugin ondersteunt /reload niet. Herstart in plaats daarvan.

Welke Java je server nodig heeft

Minecraft 1.20.5 en nieuwer hebben Java 21 nodig, en 26.x Java 25; 1.18 tot en met 1.20.4 hebben Java 17 nodig. Voer java -version uit met dezelfde Java die de server gebruikt (in een hostingpaneel is het meestal een instelling die Docker image of Java-versie heet). Een plugin die voor een oudere Java is gebouwd, draait op een nieuwere, niet andersom.

Plugins oplossen die met Codexe zijn gemaakt

Plugins die op Codexe zijn gemaakt, worden gecompileerd voor de versie die je hebt gekozen en gecontroleerd op een geldige plugin.yml voordat ze Klaar zijn. Op een testserver toont het tabblad Logs het log live met gemarkeerde fouten, en Logs exporteren slaat het op als bestand. Beschrijf in de projectchat wat je ziet ("de plugin is rood in /plugins en het log zegt ...") en Codexe past de code aan en bouwt opnieuw. Mislukt een compilatie op bestanden precies zoals Codexe ze heeft opgeleverd, dan herstelt Herstel met AI ze gratis.

Vragen

Waar staat het serverlog?

logs/latest.log in de servermap, voor de huidige sessie. Oudere sessies staan in dezelfde map als .log.gz-bestanden.

Kan de ene plugin de andere stukmaken?

Ja: een ontbrekende of kapotte dependency houdt elke plugin tegen die hem nodig heeft. Los eerst de eerste fout in het log op, dan de rest.

Is het veilig om mijn log te delen?

Meestal wel, maar controleer het eerst: logs kunnen IP-adressen bevatten en, bij sommige plugins, databasewachtwoorden uit foutmeldingen.

Bouw een kapotte plugin opnieuw voor je server

Deze prompt opent klaar om te versturen:

“Een Paper 1.21.4-plugin genaamd SimpleWarps die mijn oude plugin vervangt die niet meer laadt: /setwarp, /warp en /delwarp met een naam, /warps toont ze in een GUI, permissie warps.admin om in te stellen en te verwijderen, warps blijven bewaard na herstarts, berichten in config.yml.”