Plugin problemen oplossen

Plugins werken meestal prima, maar soms gaat er iets mis. Een plugin die niet laadt, een conflict tussen twee plugins, of mysterieuze foutmeldingen in de console. In dit artikel leer je hoe je de meest voorkomende plugin problemen herkent en oplost.

Plugin laadt niet: meest voorkomende oorzaken

Als een plugin niet verschijnt in /plugins of rood gekleurd is, is er iets misgegaan bij het laden. Dit zijn de meest voorkomende oorzaken:

1. Verkeerde Minecraft versie

De meest voorkomende oorzaak. Een plugin die is gemaakt voor Minecraft 1.20 werkt niet altijd op 1.21 en andersom. Controleer op de downloadpagina van de plugin welke versies ondersteund worden. In de console zie je dan vaak een foutmelding als:

[Server] ERROR Could not load 'plugins/PluginNaam.jar'
Caused by: java.lang.UnsupportedClassVersionError

Oplossing: Download de juiste versie van de plugin die past bij jouw Minecraft versie. Op SpigotMC kun je bij "Version History" oudere versies terugvinden.

2. Ontbrekende dependencies (afhankelijkheden)

Veel plugins hebben andere plugins nodig om te werken. Bijvoorbeeld: WorldGuard heeft WorldEdit nodig, en veel plugins hebben Vault nodig. Als een afhankelijkheid ontbreekt, zie je dit in de console:

[Server] ERROR Could not load 'plugins/WorldGuard.jar'
Caused by: org.bukkit.plugin.UnknownDependencyException: WorldEdit

Oplossing: Lees op de pluginpagina welke dependencies nodig zijn en installeer deze eerst. De foutmelding vertelt je precies welke plugin ontbreekt.

3. Verkeerd servertype

Een Bukkit/Spigot plugin werkt niet op een Forge of Fabric server, en een Forge mod werkt niet op een Paper server. Zorg dat je plugin past bij je servertype.

Oplossing: Controleer je servertype in de Startup tab van je server op het panel. Als je plugins wilt gebruiken, moet je Paper, Spigot of Purpur draaien.

4. Corrupt bestand

Soms is een download niet goed voltooid, waardoor het .jar bestand corrupt is.

Oplossing: Verwijder het bestand en download de plugin opnieuw. Controleer of de bestandsgrootte overeenkomt met wat op de downloadpagina staat.

Conflicten tussen plugins

Soms werken twee plugins niet goed samen. Dit kan zich uiten als crashes, commando’s die niet werken, of onverwacht gedrag. Veelvoorkomende conflicten:

Twee permissions plugins – Gebruik er maar één (LuckPerms is de beste keuze).
Twee economy plugins – Als je EssentialsX Economy gebruikt, installeer dan geen tweede economy plugin tenzij je weet wat je doet.
Overlappende functies – Twee plugins die dezelfde commando’s registreren (zoals twee chat plugins) kunnen botsen.

Hoe conflicten opsporen:

Isoleer het probleem – Verwijder alle plugins behalve de plugin die problemen geeft. Werkt deze alleen? Voeg dan één voor één de andere plugins terug toe totdat het probleem terugkomt. Zo vind je welke combinatie het conflict veroorzaakt.
Check de console – Vaak geven plugins warnings als er een conflict is.
Zoek online – Zoek op Google naar "[Plugin A] conflict [Plugin B]". Vaak hebben andere serverhouders hetzelfde probleem al gehad en een oplossing gevonden.

Foutmeldingen in de console herkennen

De console is je belangrijkste hulpmiddel bij het oplossen van problemen. Hier leer je de meest voorkomende soorten meldingen herkennen:

INFO (wit/grijs) – Normale berichten. Plugins loggen hier hun activiteiten. Niks om je zorgen over te maken.

[EssentialsX] INFO Enabling EssentialsX v2.20.1
[LuckPerms] INFO Loading configuration...

WARN (geel) – Waarschuwingen. De plugin werkt waarschijnlijk nog wel, maar er is iets dat aandacht nodig heeft.

[Plugin] WARN Configuration option 'x' is deprecated, please use 'y' instead

ERROR (rood) – Fouten. Hier gaat iets mis. De plugin werkt mogelijk niet correct.

[Plugin] ERROR An error occurred while enabling PluginNaam
java.lang.NullPointerException
    at com.example.plugin.Main.onEnable(Main.java:45)

Wat doe je met een ERROR?

Lees de eerste regel – Dit vertelt je welke plugin de fout veroorzaakt en wat er mis is.
Kopiëer de foutmelding – Selecteer de volledige error (inclusief de "stack trace" regels met at ...) en kopieer deze.
Zoek online – Plak de foutmelding op Google. Vaak vind je een oplossing op SpigotMC forums of GitHub issues.
Meld het bij de ontwikkelaar – Als je geen oplossing vindt, meld de fout dan op de pluginpagina met je Minecraft versie, servertype, Java versie en de volledige foutmelding.
Vraag ons – Ons supportteam helpt je graag. Stuur een ticket met een screenshot of kopie van de foutmelding.

Een plugin volledig verwijderen

Als je een plugin wilt verwijderen, is het niet genoeg om alleen het .jar bestand te wissen. Volg deze stappen voor een schone verwijdering:

Stop je server – Verwijder nooit een plugin terwijl de server draait.
Verwijder het .jar bestand – Ga naar de Bestanden tab, open de plugins map, en verwijder het .jar bestand van de plugin.
Verwijder de config map – In de plugins map staat ook een map met de naam van de plugin (bijvoorbeeld plugins/EssentialsX/). Verwijder deze map als je de plugin echt niet meer nodig hebt. Als je de plugin later misschien terug wilt, kun je de map laten staan zodat je configuratie bewaard blijft.
Start je server – Start de server weer op en controleer de console op foutmeldingen. Als andere plugins afhankelijk waren van de verwijderde plugin, kunnen die nu errors geven.

Snelle checklist bij problemen

Als een plugin niet werkt, loop dan deze checklist af:

Is de plugin compatibel met jouw Minecraft versie?
Draai je het juiste servertype (Paper/Spigot/Purpur)?
Zijn alle dependencies geïnstalleerd?
Heb je de server herstart (niet alleen gereload)?
Staat de plugin als groen in /plugins?
Staan er errors in de console?
Heb je de nieuwste versie van de plugin?
Zijn er conflicten met andere plugins?

Kom je er niet uit? Geen probleem! Open een ticket via het HytaleNode panel of stuur ons een bericht. Stuur daarbij altijd een screenshot van de foutmelding in de console mee, dan kunnen we je sneller helpen.

Plugin problemen oplossen