Veel plugins en mods bouwen voort op andere: een winkelplugin heeft Vault en een economieplugin nodig, een menuplugin heeft PlaceholderAPI nodig, een Fabric-mod heeft Fabric API nodig. Ontbreekt deze basis, is hij te oud of start hij zelf niet, dan schakelt het afhankelijke plugin zichzelf geheel of gedeeltelijk uit. De server blijft in de meeste gevallen gewoon draaien, alleen de functies van het betreffende plugin ontbreken.

Elk onderstaand onderdeel behandelt één melding. De volledige melding vind je in de Console of onder Bestanden in logs/latest.log. Lees ook de regels ervoor, daar staat vaak welk plugin als eerste mislukte. Voordat je plugins vervangt of configuratiebestanden wijzigt, maak je onder Back-ups een back-up. Na elke wijziging start je de server volledig opnieuw op in plaats van /reload te gebruiken, zodat alle plugins in de juiste volgorde laden.

Een klasse ontbreekt: NoClassDefFoundError en ClassNotFoundException

Zo ziet de melding eruit:

java.lang.NoClassDefFoundError: org/cloudburstmc/math/GenericMath
	at <Plugin>.jar//org.cloudburstmc.math.vector.Vector3i.from(Vector3i.java:403)
Caused by: java.lang.ClassNotFoundException: <Pakket>.<Class>

Wat erachter zit: Plugins en mods voor Java-servers bestaan uit veel klassen, de afzonderlijke bouwstenen van het programma. De melding zegt: een plugin of mod wil een bouwsteen gebruiken die er op de server niet is. Meestal ontbreekt een andere mod of een andere plugin, of die is geïnstalleerd in een versie die deze bouwsteen niet of niet meer bevat. De rest van de server blijft meestal gewoon draaien, alleen de betreffende functie valt uit.

Zo los je het op:

  1. Zoek uit wie de fout veroorzaakt. Dat zie je aan de pluginnaam achter to in de regel "Could not pass event … to …" of aan de bestandsnaam voor .jar// in de stacktrace, dus in de at …-regels onder de melding.
  2. Lees het ontbrekende klassenpad. Het begin ervan noemt vaak het project waartoe het behoort, bijvoorbeeld org/geysermc voor Geyser.
  3. Vergelijk op de pagina van de betreffende plugin of mod de vereiste afhankelijkheden en versies met je geïnstalleerde Plugins of Mods.
  4. Installeer ontbrekende afhankelijkheden of breng alle betrokken onderdelen naar versies die bij elkaar passen. Start de server daarna opnieuw op.

Goed om te weten: Als een pluginbestand is vervangen terwijl de server draaide, kan de plugin vaak zijn eigen klassen niet meer vinden. Dan volstaat een volledige herstart.

Een commando werkt niet omdat de plugin ervan is uitgeschakeld

Zo ziet de melding eruit:

Unexpected exception while parsing console command "<Commando>"
org.bukkit.command.CommandException: Cannot execute command '<Commando>' in plugin <Plugin> v<Versie> - plugin is disabled.

Wat erachter zit: Het commando zelf is niet fout. Het hoort bij een plugin die bij het starten van de server niet geactiveerd kon worden, en daarom antwoordt de server bij elke aanroep met deze fout. De eigenlijke oorzaak schrijft de server bij het opstarten eerder in het log, vaak "unsupported server version": de pluginversie past niet bij je serverversie. Vervangt de plugin basiscommando's zoals list, zoals EssentialsX doet, dan vallen ook die uit.

Zo los je het op:

  1. Open onder Bestanden het bestand logs/latest.log en zoek op de pluginnaam uit de melding. Belangrijk zijn de regels uit de opstartfase, bijvoorbeeld "Error occurred while enabling …".
  2. Voer in de Console plugins in. Uitgeschakelde plugins verschijnen daar in het rood.
  3. Los de opstartfout op. Meestal installeer je onder Plugins een versie die bij je serverversie past. Je serverversie zie je onder Versie. Meer hierover: Plugin past niet bij de serverversie.
  4. Start de server opnieuw op en controleer met plugins of de plugin nu groen is.

Goed om te weten: De commandomelding is slechts een gevolg. Ze verdwijnt zodra de plugin weer start.

Vault of een economy-plugin ontbreekt

Zo ziet de melding eruit:

[<Plugin>] Vault economy not found! Disabling plugin...
[<Plugin>] - Disabled due to no Vault dependency found!

Wat erachter zit: Plugins met geld, prijzen of premies beheren het saldo niet zelf. Ze benaderen via Vault een economy-plugin. Vault is daarbij alleen de koppeling, de rekeningen worden bijgehouden door de economy-plugin. Ontbreekt een van beide, of is het pas na de afhankelijke plugin geladen, dan schakelt die plugin zichzelf uit. De server blijft draaien, maar de betreffende plugin ontbreekt volledig.

Zo los je het op:

  1. Controleer onder Plugins of Vault is geïnstalleerd.
  2. Controleer of er een economy-plugin met Vault-koppeling is geïnstalleerd, bijvoorbeeld EssentialsX met EssentialsX Economy, CMI of XConomy.
  3. Installeer wat ontbreekt, telkens in een versie voor jouw serverversie.
  4. Start de server volledig opnieuw op. Een /reload of het opnieuw laden van losse plugins brengt de laadvolgorde snel door elkaar.
  5. Voer in de Console vault-info in. Achter "Economy" zou nu je economy-plugin moeten staan.

Goed om te weten: De melding verschijnt ook als Vault aanwezig is, maar de economy-plugin zelf bij het starten faalt. Zoek dan in logs/latest.log naar de naam ervan.

Plugin kan onderdelen niet registreren omdat een andere plugin ontbreekt

Zo ziet de melding eruit:

[<Plugin>] Failed to register events for class <Class> because me/clip/placeholderapi/<Class> does not exist.
[QuickShop-FindItemAddOn] Uh oh! Looks like either this plugin has crashed or you don't have QuickShop-Hikari installed.

Wat erachter zit: Een plugin meldt bij het starten zijn listeners aan, dus de onderdelen die reageren op gebeurtenissen zoals joinen, afbreken of kopen. Sommige daarvan hebben een andere plugin nodig. Ontbreekt die, dan worden precies deze onderdelen niet geregistreerd en draait de rest van de plugin gewoon. Welke plugin ontbreekt, zie je aan het pad achter because:

  • me/clip/placeholderapi hoort bij PlaceholderAPI
  • net/milkbowl/vault hoort bij Vault
  • com/ghostchu/quickshop hoort bij QuickShop-Hikari
  • net/ess3 hoort bij EssentialsX

Zo los je het op:

  1. Koppel het pad uit de melding met de lijst hierboven aan een plugin. Bij andere paden helpt de projectnaam in het pad, bijvoorbeeld com/projectkorra voor ProjectKorra.
  2. Installeer de ontbrekende plugin onder Plugins in een versie voor jouw serverversie.
  3. Start de server opnieuw op en controleer of de melding bij het opstarten uitblijft.

Goed om te weten: Begint het pad met io/papermc of org/bukkit, dan ontbreekt er geen plugin. Dan is je serversoftware te oud voor de plugin of draait de verkeerde software, bijvoorbeeld Spigot in plaats van Paper. Hulp hierbij: Plugin past niet bij de serverversie.

Een plugin kan geen verbinding maken met een andere plugin

Zo ziet de melding eruit:

[<Plugin>] Could not hook into PlaceholderAPI!
<Plugin> will now disable!

Wat erachter zit: "Hook" betekent hier koppeling. De plugin die de melding geeft, wilde bij het starten verbinding maken met een andere plugin die hij nodig heeft om te werken. Die ontbrak echter of was op dat moment nog niet geladen. Veel plugins schakelen zichzelf daarna uit. De server draait normaal verder, maar de functies van de meldende plugin ontbreken volledig, bij een menuplugin dus alle menu's.

Zo los je het op:

  1. Lees beide namen uit de melding af: tussen de rechte haken de meldende plugin, achter "hook into" de ontbrekende.
  2. Ontbreekt de gemiste plugin onder Plugins, installeer die dan in een versie voor jouw serverversie. Heel vaak is het PlaceholderAPI.
  3. Is die al geïnstalleerd, zoek dan in logs/latest.log naar de naam ervan. Geeft hij bij het starten zelf een fout, dan is dat de eigenlijke oorzaak. Los eerst die op.
  4. Start de server volledig opnieuw op.

Goed om te weten: De meldende plugin hoef je niet opnieuw te installeren. Hij werkt weer zodra de afhankelijkheid bij het starten beschikbaar is.

ViaBackwards schakelt zichzelf uit omdat ViaVersion te oud is

Zo ziet de melding eruit:

[ViaBackwards] YOUR VIAVERSION IS OUTDATED
[ViaBackwards] VIABACKWARDS WILL NOW DISABLE

Wat erachter zit: ViaVersion laat spelers met nieuwere Minecraft-versies op je server, ViaBackwards vult dat aan voor oudere versies. ViaBackwards is een uitbreiding van ViaVersion en vereist een passende, voldoende nieuwe ViaVersion-build. Is ViaVersion ouder, dan schakelt ViaBackwards zichzelf uit. De server blijft draaien, maar spelers met oudere clients komen er dan niet meer op.

Zo los je het op:

  1. Kijk onder Plugins welke versies van ViaVersion en ViaBackwards zijn geïnstalleerd.
  2. Update beide samen naar actuele builds die bij elkaar passen. De melding noemt zelf de officiële downloadpagina. Gebruik je daarnaast ViaRewind, update die dan in dezelfde stap.
  3. Start de server opnieuw op en controleer met plugins in de Console of ViaBackwards groen verschijnt.

Goed om te weten: Update de Via-plugins altijd samen. Wie alleen ViaBackwards vernieuwt, krijgt precies deze melding.

Uitgebreid: ViaVersion instellen: oudere en nieuwere clients laten verbinden

UltimateDonutSmp schakelt zichzelf uit zonder PlaceholderAPI

Zo ziet de melding eruit:

[UltimateDonutSmp] UltimateDonutSmp requires PlaceholderAPI
[UltimateDonutSmp] UltimateDonutSmp is disabling itself to prevent broken sidebar output.

Wat erachter zit: UltimateDonutSmp toont waarden in de sidebar, het scorebord aan de rechterkant van het scherm. Deze waarden komen via placeholders, kleine variabelen zoals %player_name%, die PlaceholderAPI met echte waarden vult. Ontbreekt PlaceholderAPI of is het uitgeschakeld, dan schakelt UltimateDonutSmp zichzelf bewust uit, zodat spelers geen kapotte placeholders zien. De server zelf draait gewoon door.

Zo los je het op:

  1. Installeer PlaceholderAPI onder Plugins in een versie voor jouw serverversie.
  2. Is het al geïnstalleerd, controleer dan in logs/latest.log of het bij het opstarten een fout geeft en los die eerst op.
  3. Stop de server en start hem daarna opnieuw. Opnieuw laden met een commando is hier niet genoeg.

Goed om te weten: Toont de sidebar daarna tekst zoals %vault_eco_balance% in plaats van cijfers, dan ontbreekt er een extensie van PlaceholderAPI. Je downloadt die in de Console met papi ecloud download <extensie> en activeert hem met papi reload.

Een vereiste plugin is niet geïnstalleerd

Zo ziet de melding eruit:

[<Plugin>] <Dependency> is required but was not found
[<Plugin>] <Dependency> plugin not found! Disabling
[<Plugin>] Download <Dependency> from https://<Address>

Wat erachter zit: De plugin bouwt voort op een andere plugin en kan die bij het opstarten niet vinden. De naam van die basis staat in de melding zelf, soms zelfs met een downloadadres. Afhankelijk van de plugin schakelt hij zichzelf helemaal uit of werkt een deel ervan niet. De melding verschijnt ook als de basis wel als bestand in de map plugins staat, maar zelf niet start.

Zo los je het op:

  1. Noteer de naam van de ontbrekende basis uit de melding.
  2. Controleer onder Plugins of die is geïnstalleerd. Zo niet, installeer hem dan in een versie die bij jouw serverversie past. Hoe dat werkt: Plugins installeren en beheren.
  3. Is hij geïnstalleerd, zoek dan in logs/latest.log naar zijn naam. Een fout bij het opstarten is dan de eigenlijke oorzaak.
  4. Start de server opnieuw.

Goed om te weten: Heb je de meldende plugin niet meer nodig, dan kun je hem in plaats daarvan verwijderen. Dan verdwijnt ook de melding.

Een plugin vindt geen economiesysteem

Zo ziet de melding eruit:

[<Plugin>] Vault economy provider not found!
[<Plugin>] Vault is not found or no economy plugin found

Wat erachter zit: Voor geld, prijzen en beloningen heeft de plugin twee partners nodig: Vault of VaultUnlocked als koppeling en een economieplugin zoals EssentialsX, die de saldo's bijhoudt. Vindt hij niet beide, dan schakelt hij zichzelf uit of deelt hij geen geldbeloningen uit. Typische gevolgen: een shopplugin zoals QuickShop start niet goed, een questplugin meldt dat hij een beloning niet kan uitbetalen.

Zo los je het op:

  1. Controleer onder Plugins of Vault of VaultUnlocked is geïnstalleerd.
  2. Controleer of er een economieplugin draait, bijvoorbeeld EssentialsX. Zonder zo'n plugin heeft Vault niets om door te geven.
  3. Installeer wat ontbreekt, in versies voor jouw serverversie, en start de server opnieuw.
  4. Controleer bij Vault met vault-info in de Console of achter „Economy“ een economieplugin staat.

Goed om te weten: Hoe je EssentialsX instelt, lees je in EssentialsX instellen.

De premieplugin Bountys vindt Vault niet

Zo ziet de melding eruit:

[Bountys] Vault Plugin wasn't detected!

Wat erachter zit: Bountys betaalt premies uit via Vault en heeft daarvoor meestal ook een economieplugin nodig die de saldo's bijhoudt. Bij het opstarten is Vault niet gevonden. Daardoor werken de geldfuncties van Bountys niet en kunnen premies dus niet worden uitbetaald. De server zelf en andere plugins hebben hier geen last van.

Zo los je het op:

  1. Bepaal of je Bountys nodig hebt. Zo niet, verwijder het dan onder Plugins, dan is de melding weg.
  2. Wil je het houden, zet dan Vault en een compatibele economieplugin zoals EssentialsX in de pluginmap, het makkelijkst via Plugins.
  3. Staat Vault er al, controleer dan in logs/latest.log of Vault bij het opstarten zelf een fout meldt.
  4. Start de server opnieuw en controleer met vault-info in de Console of Vault een economieplugin heeft gevonden.

Goed om te weten: Melden meer plugins dat Vault of een economie ontbreekt, dan los je al die meldingen met dezelfde stap op.

AuthMe vindt via Vault geen rechtenplugin

Zo ziet de melding eruit:

[AuthMe] Error while hooking into Vault [PermissionHandlerException]: Could not load permissions provider service

Wat erachter zit: AuthMe is een loginplugin waarbij spelers zich met een wachtwoord aanmelden. Voor de groeps- en rechtenfuncties vraagt het via Vault een permissiedienst op, dus een rechtenplugin. Vault is wel geïnstalleerd, maar levert AuthMe geen such dienst. Daardoor vallen de groeps- en permissionfuncties van AuthMe weg. De melding betreft alleen deze extra functies.

Zo los je het op:

  1. Installeer onder Plugins LuckPerms of een andere rechtenplugin met Vault-koppeling.
  2. Werk Vault en AuthMe bij naar versies voor jouw serverversie.
  3. Start de server opnieuw.
  4. Voer in de Console vault-info in. Achter „Permission“ hoort nu jouw rechtenplugin te staan.

Goed om te weten: Hoe je groepen en rechten aanmaakt, zie je in LuckPerms instellen.

StackSpawners heeft DecentHolograms nodig

Zo ziet de melding eruit:

[StackSpawners] DecentHolograms was not found. The plugin will not work

Wat erachter zit: StackSpawners voegt spawners samen en gebruikt voor zijn zwevende weergaven, zogenaamde hologrammen, de plugin DecentHolograms. Deze functie zit er niet zelf in. Vindt StackSpawners DecentHolograms bij het opstarten niet, dan kan het niet werken. De server draait door, maar de functies van StackSpawners ontbreken.

Zo los je het op:

  1. Installeer DecentHolograms onder Plugins in een versie die past bij jouw serverversie en bij StackSpawners. De pluginpagina van StackSpawners vermeldt de ondersteunde versies.
  2. Is DecentHolograms er al, zoek dan in logs/latest.log naar een opstartfout van DecentHolograms en los die eerst op.
  3. Stop de server volledig en start hem opnieuw. Zo laden beide plugins in de juiste volgorde.

Goed om te weten: Gebruik je StackSpawners niet meer, verwijder het dan. Dan vervalt ook de afhankelijkheid.

LightAntiCheat-Plus kan PacketEvents niet vinden

Zo ziet de melding eruit:

(LightAntiCheat-Plus) Failed to start listener-mode … com/github/retrooper/packetevents/event/PacketListenerCommon

Wat erachter zit: LightAntiCheat-Plus is een anticheat-plugin. Het leest het dataverkeer van de spelers mee via PacketEvents, een aparte plugin die netwerkpakketten geschikt maakt voor andere plugins. Ontbreekt PacketEvents, of is het geïnstalleerd in een versie die LightAntiCheat-Plus niet verwacht, dan start de bewaking niet. De server blijft draaien, maar de cheatbescherming staat dan geheel of gedeeltelijk uit.

Zo los je het op:

  1. Kijk op de pagina van LightAntiCheat-Plus welke PacketEvents-versie nodig is.
  2. Installeer of update PacketEvents onder Plugins naar die versie, passend bij je serverversie.
  3. Update indien nodig ook LightAntiCheat-Plus, zodat beide bij elkaar passen.
  4. Stop de server volledig en start hem opnieuw.

Goed om te weten: Andere plugins gebruiken PacketEvents vaak ook. Controleer na de wissel in logs/latest.log of ze zonder fouten blijven starten.

Een plugin heeft zichzelf uitgeschakeld na een fout

Zo ziet de melding eruit:

[<Plugin>] An unexpected error occurred, disabling the plugin
[<Plugin>] Cannot enable plugin: <Reden>

Wat erachter zit: De plugin is bij het starten of tijdens het draaien op een fout gestuit en heeft zichzelf daarom uitgeschakeld. Tot de volgende herstart ontbreken al zijn functies en zijn commando's antwoorden alleen nog met een foutmelding. Welke plugin het betreft, staat tussen vierkante haken. De oorzaak staat meestal in de regels ervoor, afhankelijk van de herkomst van de plugin soms ook in een andere taal.

Zo los je het op:

  1. Open logs/latest.log en lees de regels direct voor de melding. Een ontbrekende plugin, een niet-passende versie of een fout in de configuratie is daar meestal te herkennen.
  2. Update de plugin en controleer op de pagina ervan of hij bij je serverversie past.
  3. Blijft de fout, verwijder de plugin dan als test en start opnieuw. Werkt alles zonder de plugin, meld de fout dan bij de pluginauteur en voeg de regels uit het log toe.

Goed om te weten: Fouten tijdens het draaien kun je plaatsen met Plugin geeft fouten tijdens het draaien.

AuthMeBia past niet bij je AuthMe-versie

Zo ziet de melding eruit:

[AuthMeBia] AuthMe DataSource reflection unavailable; premium skip and session autologin both disabled

Wat erachter zit: AuthMeBia is een uitbreiding voor de loginplugin AuthMe. Het benadert een functie diep in AuthMe die er in jouw AuthMe-versie zo niet is. Daarom schakelt AuthMeBia twee functies uit: premium-skip, waarmee spelers met een gekocht Minecraft-account zonder wachtwoord binnenkomen, en sessie-autologin, de automatische aanmelding wanneer iemand kort na het verlaten weer joint. AuthMe zelf blijft werken, de spelers loggen dan gewoon in met een wachtwoord.

Zo los je het op:

  1. Kijk onder Plugins welke versies van AuthMe en AuthMeBia geïnstalleerd zijn.
  2. Controleer op de pagina van AuthMeBia voor welke AuthMe-versie het gebouwd is.
  3. Update beide naar versies die bij elkaar passen en start de server opnieuw.
  4. Test met een gekocht account of joinen zonder wachtwoord weer lukt.

Een ProjectKorra-uitbreiding past niet bij de hoofdversie

Zo ziet de melding eruit:

java.lang.NoSuchMethodError: 'void com.projectkorra.projectkorra.<Class>.<Method>()'
com.jedk1.jedcore.ability.<Vaardigheid>@<ID>[…]

Wat erachter zit: ProjectKorra brengt bending-vaardigheden naar de server, uitbreidingen zoals JedCore voegen er meer aan toe. Elke uitbreiding is gebouwd voor een bepaalde ProjectKorra-versie. Roept ze een methode aan, dus een functie die in jouw ProjectKorra-versie niet bestaat, dan stopt ze met een „NoSuchMethodError“. Soms schrijft ze daarbij ook de status van een vaardigheid als lange regel in het log. De betreffende vaardigheden werken dan niet, de rest van de server blijft draaien.

Zo los je het op:

  1. Noteer onder Plugins de versie van ProjectKorra en de versies van alle uitbreidingen.
  2. Open de downloadpagina van elke uitbreiding. Daar staat welke ProjectKorra-versie ze nodig heeft.
  3. Installeer ProjectKorra en alle uitbreidingen in versies die bij elkaar en bij je serverversie passen.
  4. Start de server opnieuw en test een vaardigheid van de uitbreiding.

Goed om te weten: Bestaat een uitbreiding niet voor jouw ProjectKorra-versie, verwijder haar dan liever in plaats van oude en nieuwe versies te mengen.

AppleSkin start niet doordat Fabric API ontbreekt

Zo ziet de melding eruit:

Mod 'AppleSkin' (appleskin) <Versie> requires any version of fabric-api, which is missing!

Wat erachter zit: De meeste Fabric-mods hebben de bibliotheek Fabric API nodig, een verzameling gedeelde bouwstenen die niet in de Fabric Loader zelf zit. AppleSkin is geïnstalleerd, Fabric API niet. De Fabric Loader controleert dat bij het starten en breekt het starten af. Je server start dus pas weer als je Fabric API toevoegt of AppleSkin uitschakelt.

Zo los je het op:

  1. Installeer onder Mods de Fabric API in de versie voor jouw Minecraft-versie.
  2. Heb je AppleSkin niet nodig, gebruik dan de herstelknop bij de melding in de Servergezondheid. Die deactiveert AppleSkin (het bestand blijft behouden) en start de server opnieuw.
  3. Controleer in de Console of de server volledig opstart.

Goed om te weten: Fabric API moet bij je Minecraft-versie passen. De melding zegt „any version“, AppleSkin zelf stelt dus geen bijzondere eis.

Uitgebreid: Fabric Loader en Fabric API: versiefouten gericht oplossen

Staat jouw melding er niet bij?

Lees de hele melding in logs/latest.log, ook de regels ervoor. Meestal noemt de server eerst het plugin dat is mislukt en pas daarna de vervolgfouten van andere plugins. In de stacktrace verraden de bestandsnamen vóór .jar en de mapnamen in het klassenpad, bijvoorbeeld me/clip/placeholderapi, welk plugin of welke mod erbij betrokken is. Vergelijk daarna de afhankelijkheden op de projectpagina met je geïnstalleerde plugins. Maak vóór elke ingreep een back-up. Kom je er niet uit, open dan een ticket en vermeld het tijdstip van de melding.