Minecraft-plugin past niet bij de versie: Java-, Paper- en API-fouten oplossen

Een Minecraft-plugin staat als JAR-bestand (een Java-archief) in de map plugins/ en is altijd gebouwd voor bepaalde Minecraft-versies, een bepaalde Java-versie en meestal ook voor een bepaalde serversoftware zoals Paper of Spigot. Past een van deze niet, dan laadt de plugin helemaal niet, schakelt hij zichzelf uit of vallen afzonderlijke functies weg. Elk onderstaand gedeelte behandelt een concrete melding: hoe die eruitziet, wat erachter zit en hoe je het oplost.

De volledige melding vind je in de Console of onder Bestanden in logs/latest.log. Lees ook de regels ervoor, daar staat vaak de betreffende plugin. De Java-versie wordt bij ons automatisch passend bij de Minecraft-versie ingesteld. Welke versies een plugin ondersteunt, staat op de downloadpagina ervan. Maak onder Back-ups een back-up aan voordat je de versie wijzigt of configuratie- en wereldbestanden aanpast.

Plugin of server heeft een nieuwere Java-versie nodig (UnsupportedClassVersionError)

Zo ziet de melding eruit:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: <Class> has been compiled by a more recent version of the Java Runtime (class file version 69.0), this version of the Java Runtime only recognizes class file versions up to 65.0

Wat erachter zit: Java-programma's worden voor een bepaalde Java-versie gecompileerd. Het bestand uit de melding vraagt om een nieuwere Java-versie dan je server op dit moment gebruikt. De getallen verraden welke: getal min 44 is de Java-versie, dus 69 staat voor Java 25 en 65 voor Java 21. Noemt de melding een plugin, dan start alleen die plugin niet. Gaat het om de server-JAR zelf, dan start de hele server niet.

Zo los je het op:

1. Lees de bestandsnaam na Could not load plugin. Dat is het bestand dat niet past.
2. Download op de pluginpagina de uitgave die is gebouwd voor jouw Minecraft-versie.
3. Vervang het oude bestand onder Bestanden in de map plugins/ en start de server opnieuw op.
4. Heb je precies deze pluginuitgave nodig, zet de server dan onder Versie om naar de Minecraft-versie die ervoor nodig is. De juiste Java-versie wordt bij ons automatisch per Minecraft-versie ingesteld. Maak vooraf een back-up.

Goed om te weten: De map plugins/.paper-remapped is een werkkopie van Paper. Vervang het bestand altijd direct in plugins/.

Uitgebreid: Welke Java-versie heeft jouw Minecraft-server nodig?

Plugin is gebouwd voor een nieuwere Minecraft-versie (Unsupported API version)

Zo ziet de melding eruit:

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins/.paper-remapped'
org.bukkit.plugin.InvalidPluginException: Unsupported API version 26.1

Wat erachter zit: Elke plugin heeft een klein informatiebestand, de plugin.yml. Daarin staat onder api-version voor welke serverversie de plugin is geschreven. Is die versie nieuwer dan je server, dan laadt Paper de plugin helemaal niet, bijvoorbeeld bij Unsupported API version 26.1 op een server met 1.21.11. De server start wel, maar alles wat de plugin zou moeten doen ontbreekt volledig: commando's, beschermingsregels, menu's.

Zo los je het op:

1. Vergelijk het getal achter Unsupported API version met de Minecraft-versie van je server onder Versie.
2. Filter op Modrinth of SpigotMC de downloads van de plugin op jouw Minecraft-versie en download de juiste uitgave.
3. Vervang het oude bestand onder Bestanden in de map plugins/ en start opnieuw op.
4. Is er geen passende uitgave, zet de server dan onder Versie om naar de versie die de plugin nodig heeft. Maak vooraf een back-up, want de wereld wordt daarbij naar de nieuwe versie omgezet.

Goed om te weten: Wijzig de api-version niet zelf in het pluginbestand. De plugin laadt dan wel, maar gebruikt functies die je server niet heeft en valt later uit met andere fouten.

Meer hierover: Minecraft-versie en modloader veilig wijzigen

Oudere Paper-server kan een nieuwe plugin niet omzetten (Fatal error trying to convert)

Zo ziet de melding eruit:

Fatal error trying to convert Geyser-Spigot <Version>:org/geysermc/geyser/platform/spigot/GeyserSpigotPlugin.class
java.lang.IllegalArgumentException: Unsupported class file major version 65

Wat erachter zit: Paper in versie 1.19.4 of ouder zet plugins bij het laden om met een ingebouwde converter. Deze converter kan geen klassen lezen die voor Java 21 of nieuwer zijn gecompileerd (major version 65 staat voor Java 21, 69 voor Java 25). De plugin wordt daarom niet geladen. Vaak treft het Geyser: dan kunnen er geen Bedrock-spelers joinen. De server zelf start en Java-spelers komen nog gewoon binnen.

Zo los je het op:

1. Lees de naam na trying to convert. Dat is de getroffen plugin.
2. Wil je op je Minecraft-versie blijven, download dan een oudere uitgave van de plugin die precies voor die versie is gebouwd en vervang het bestand onder Bestanden in de map plugins/.
3. Je kunt de server ook onder Versie omzetten naar Minecraft 1.20.5 of nieuwer. Nieuwere Paper-builds lezen Java-21-klassen. Maak vooraf een back-up.
4. Start opnieuw op en controleer in de Console of de plugin zonder fouten laadt.

Goed om te weten: De melding verschijnt vaak meerdere keren achter elkaar, eenmaal per klasse. Toch is alleen die ene plugin getroffen.

Uitgebreid: Welke Java-versie heeft jouw Minecraft-server nodig?

Plugin meldt: Deze serverversie wordt niet ondersteund

Zo ziet de melding eruit:

[Essentials] You are running an unsupported server version!
[DecentHolograms] Plugin will now be disabled.
This plugin does not support Paper servers!

Wat erachter zit: De plugin controleert bij het starten op welke Minecraft-versie en welke serversoftware hij draait. Staat geen van beide op zijn lijst, dan waarschuwt hij of schakelt hij zichzelf helemaal of gedeeltelijk uit. De reden kan een te nieuwe of te oude versie zijn, of de verkeerde serversoftware. De server zelf blijft draaien.

Zo los je het op:

1. Typ in de Console plugins. Groen weergegeven plugins zijn actief, rood weergegeven zijn uitgeschakeld.
2. Kijk op de pluginpagina welke Minecraft-versies en welke serversoftware worden ondersteund.
3. Download de juiste uitgave en vervang het oude bestand onder Bestanden in de map plugins/.
4. Is die er niet, kies dan onder Versie een Minecraft-versie die de plugin ondersteunt. Vraagt de plugin om andere serversoftware, dan kan dat via Software / loader wijzigen. Maak vooraf een back-up.

Goed om te weten: Blijft de plugin ondanks de waarschuwing groen, dan werken meestal de basisfuncties. Test de commando's die je nodig hebt en haal de update binnen zodra die verschijnt.

Paper kan een oudere plugin niet aanpassen aan de serverversie (PluginRemapper)

Zo ziet de melding eruit:

[PluginRemapper] Encountered exception remapping plugins
java.util.concurrent.CompletionException: java.lang.RuntimeException: Failed to remap plugin jar 'plugins/<Plugin>.jar'

Wat erachter zit: Nieuwere Paper-versies schrijven oudere plugins bij het starten automatisch om naar de interne structuur van de huidige Minecraft-versie. Dit omschrijven heet remapping, de kant-en-klare kopieën zet Paper in plugins/.paper-remapped. Bij minstens één plugin is dat mislukt. De server start gewoon door, maar de plugin werkt mogelijk helemaal niet of maar gedeeltelijk, vaak zonder verdere foutmelding.

Zo los je het op:

1. Lees de bestandsnaam achter Failed to remap plugin jar.
2. Staat in de naam iets als (1), dan staat het bestand waarschijnlijk dubbel in de map. Verwijder de overbodige kopie onder Bestanden.
3. Download een uitgave van de plugin die uitdrukkelijk voor jouw Minecraft-versie is gebouwd. Dan hoeft Paper niets om te schrijven. Vervang daarmee het oude bestand in plugins/.
4. Start opnieuw op en controleer of de melding is verdwenen.

Goed om te weten: Is er geen passende uitgave, dan is de plugin nog niet klaar voor jouw serverversie. Verwijder hem of wacht op een update.

Dubbele bestanden: Pluginbestand beschadigd, dubbel of helemaal geen plugin

Onbekende blok- of itemnaam in een pluginconfiguratie (Unsupported key)

Zo ziet de melding eruit:

Unsupported key: minecraft:bed

Wat erachter zit: Minecraft voert elk blok en elk item onder een vaste naam van de vorm minecraft:<naam>, de zogeheten registry-sleutel. Een plugin of zijn configuratie noemt een naam die jouw Minecraft-versie niet kent. Een typisch voorbeeld is minecraft:bed: sinds 1.13 heten bedden naar hun kleur, bijvoorbeeld red_bed. Het item wordt overgeslagen, de server en de rest van de plugin blijven draaien.

Zo los je het op:

1. Kijk in de Console of in logs/latest.log naar de regels vóór de melding. Daar staat welke plugin op dat moment laadt.
2. Open onder Bestanden de configuratie van deze plugin in de map plugins/<Plugin>/ en zoek de genoemde naam.
3. Vervang hem door de actuele benaming, die vind je in de Minecraft-wiki. Configuraties in YAML-formaat (.yml) zijn gevoelig: laat inspringing en aanhalingstekens ongewijzigd.
4. Start de server opnieuw op. Staat de naam niet in jouw configuratie maar in de plugin zelf, dan helpt alleen een pluginupdate.

Bij fouten in het bestand: Configuratiebestand van een plugin is foutief

Plugin heeft een nieuwere tekstbibliotheek (Adventure) nodig dan je server heeft

Zo ziet de melding eruit:

Caused by: java.lang.ExceptionInInitializerError: Exception java.lang.TypeNotPresentException: Type net.kyori.adventure.text.TranslationArgument not present

Wat erachter zit: Adventure is de bibliotheek waarmee Paper gekleurde chatteksten, titels en hovertekst maakt. Ze is vast in de server ingebouwd, dus haar versie hangt af van je Minecraft-versie. De plugin is gebouwd tegen een nieuwere Adventure-versie, de genoemde klasse ontbreekt op je server. Delen van de plugin starten daarom niet. De server blijft doorlopen.

Zo los je het op:

1. Zoek uit welke plugin het betreft. In de stacktrace, dus de lijst met at …-regels onder de melding, staat vaak de naam van het JAR-bestand. Anders helpen de regels ervoor.
2. Download een oudere uitgave van de plugin die is gebouwd voor je serverversie en vervang het bestand onder Bestanden in de map plugins/.
3. Of zet de server onder Versie over op een nieuwere Minecraft-versie. Maak daarvoor eerst een back-up.

Goed om te weten: Een extra Adventure-bestand in de map plugins/ helpt niet, omdat Paper zijn ingebouwde versie gebruikt.

ProtocolLib past niet bij de serverversie

Zo ziet de melding eruit:

[ProtocolLib] INTERNAL ERROR: Cannot load ProtocolLib.
  If this problem hasn't already been reported, please open a ticket
  java.lang.IllegalArgumentException: Unable to find a field that matches …

Wat erachter zit: ProtocolLib is een hulpbibliotheek waarmee andere plugins netwerkpakketten lezen en aanpassen. Daarvoor grijpt ze diep in de interne onderdelen van de server, en die veranderen met bijna elke Minecraft-versie. Vindt ProtocolLib de verwachte pakketvelden niet, dan laadt het niet. Alle plugins die ProtocolLib nodig hebben, werken dan ook niet.

Zo los je het op:

1. Download de nieuwste ProtocolLib-build voor je huidige Minecraft-versie. Voor heel nieuwe versies zijn passende builds vaak eerst als voorlopige versie op de projectpagina te vinden.
2. Vervang het oude bestand onder Bestanden in de map plugins/. Houd maar één ProtocolLib-bestand over.
3. Start de server volledig opnieuw op, dus stoppen en weer starten, niet met /reload.
4. Typ in de Console plugins en controleer of ProtocolLib en de afhankelijke plugins groen zijn.

Goed om te weten: Het verzoek om een ticket bij ProtocolLib te openen komt van de plugin zelf. Meestal ontbreekt alleen de juiste build.

Afhankelijke plugins: Plugin heeft een andere plugin nodig die ontbreekt

Citizens schakelt zichzelf uit: build past niet bij de Minecraft-versie

Zo ziet de melding eruit:

[Citizens] v<Versie> (build <Number>) is not compatible with Minecraft <Versie> - try upgrading or downgrading Citizens. Disabling.

Wat erachter zit: Citizens is een plugin voor NPC's, dus door de computer bestuurde figuren zoals handelaren of questgevers. Elke Citizens-build ondersteunt alleen bepaalde Minecraft-versies en server-builds. Past hij niet bij je server, dan schakelt Citizens zichzelf bij het starten uit. Je NPC's verschijnen dan niet en plugins die op Citizens voortbouwen, verliezen die functie. De server zelf blijft doorlopen.

Zo los je het op:

1. Controleer onder Versie welke Minecraft-versie je server heeft.
2. Download de Citizens-build voor precies die versie. Veel Citizens-builds hebben SNAPSHOT in de naam, doorslaggevend is de Minecraft-versie die de downloadpagina erbij noemt.
3. Vervang het oude bestand onder Bestanden in de map plugins/ en start opnieuw op.
4. Is er geen passende build, pas dan de serverversie aan onder Versie. Maak daarvoor eerst een back-up.

Goed om te weten: try upgrading or downgrading betekent: Citizens kan te oud of te nieuw zijn. Het nieuwste bestand is dus niet automatisch het juiste.

Plugin meldt: niet compatibel met je Minecraft-versie

Zo ziet de melding eruit:

[Citizens] v<Versie> (build <Number>) is not compatible with your version of Minecraft. Disabling...
[<Plugin>] Plugin will be disabled!
Your MC version isn't supported

Wat erachter zit: De plugin is gebouwd voor een andere Minecraft-versie of serversoftware en meldt dat zelf. Vergelijkbare formuleringen zijn This plugin only supports Spigot-API … of Unable to load Adventure, chat components will not work. Afhankelijk van de plugin schakelt hij zich helemaal uit, of vallen losse functies uit, bijvoorbeeld gekleurde chatteksten. De server blijft doorlopen.

Zo los je het op:

1. Lees de pluginnaam in de rechte haken aan het begin van de regel. Ontbreekt hij, dan staat hij in de regels ervoor.
2. Kijk op de pluginpagina welke Minecraft-versies en welke serversoftware worden ondersteund.
3. Download de passende uitgave en vervang het oude bestand onder Bestanden in de map plugins/.
4. Is die er niet, zet de server dan onder Versie over op de versie die de plugin vereist. Maak daarvoor eerst een back-up.
5. Typ na het herstarten in de Console plugins en controleer of de plugin groen is.

Goed om te weten: Overstappen naar een nieuwere Minecraft-versie zet de wereld om. Terug kun je betrouwbaar alleen via de back-up.

Plugin heeft een nieuwere Paper-build van je Minecraft-versie nodig

Zo ziet de melding eruit:

[EntrypointUtil] Class io.papermc.paper.plugin.loader.library.impl.MavenLibraryResolver does not have member field 'java.lang.String MAVEN_CENTRAL_DEFAULT_MIRROR'
java.lang.NoSuchFieldError: …

Wat erachter zit: Paper wordt ook binnen één Minecraft-versie voortdurend doorontwikkeld, elke uitgave heet een build. De plugin gebruikt een veld van de Paper-API, en wel in het deel dat bij het starten extra bibliotheken voor plugins downloadt. Dit veld (MAVEN_CENTRAL_DEFAULT_MIRROR) bestaat pas in nieuwere builds. In jouw build ontbreekt het, daarom laadt de plugin niet. De server zelf blijft doorlopen.

Zo los je het op:

1. Open in het paneel Versie en werk bij naar de nieuwste Paper-build van je Minecraft-versie.
2. Start opnieuw op en controleer in de Console of de plugin nu zonder fouten laadt.
3. Wil je de build niet wijzigen, gebruik dan een oudere uitgave van de plugin en vervang het bestand onder Bestanden in de map plugins/.

Goed om te weten: Een nieuwere build van dezelfde Minecraft-versie is een kleine stap. De wereld blijft daarbij op dezelfde Minecraft-versie. Een back-up vooraf kan toch geen kwaad.

Plugin vindt interne serveronderdelen niet (Failed to init reflection)

Zo ziet de melding eruit:

Failed to init reflection: Index 3 out of bounds for length 3

Wat erachter zit: Sommige plugins gebruiken niet alleen de officiële interface van de server, maar lezen interne klassen rechtstreeks uit via hun naam. Dat heet reflection. Die interne onderdelen veranderen met bijna elke Minecraft-versie. Vindt de plugin niet wat hij verwacht, dan is hij voor een andere serverversie gebouwd, en de functies die ervan afhangen vallen uit. De server blijft doorlopen.

Zo los je het op:

1. De melding zelf noemt geen plugin. Kijk in de Console of in logs/latest.log naar de regels er direct voor. Daar staat welke plugin net werd geladen.
2. Werk die plugin bij naar een uitgave voor je serverversie en vervang het bestand onder Bestanden in de map plugins/.
3. Start opnieuw op en controleer of de melding verdwenen is.

Goed om te weten: Is er geen nieuwere uitgave, dan wordt de plugin waarschijnlijk niet meer onderhouden. Dan loont het om een actuele vervangende plugin met dezelfde functie te zoeken.

Gloei-effecten van een plugin zijn uitgeschakeld (GlowingEntities)

Zo ziet de melding eruit:

[GlowingEntities] [GlowingEntities] Glowing Entities reflection failed to initialize. The util is disabled. Please ensure your version (<Versie>) is supported.
java.lang.NoSuchFieldException: MARKER

Wat erachter zit: GlowingEntities is geen losse plugin, maar een bouwsteen die andere plugins meebrengen om spelers, mobs of objecten te laten gloeien. De bouwsteen vindt een intern veld van jouw server-build niet. Daarom zijn de gloei-effecten van de betreffende plugin uitgeschakeld. De server blijft draaien en meestal werkt de plugin ook zonder de effecten gewoon door.

Zo los je het op:

1. Zoek de plugin die GlowingEntities meebrengt. In de at …-regels onder de melding staat een vermelding in de vorm <Plugin>.jar//….
2. Download deze plugin in een uitgave voor jouw Paper-build.
3. Vervang het oude bestand onder Bestanden in de map plugins/ en start opnieuw op.

Goed om te weten: GlowingEntities zelf kun je niet los bijwerken. Dat doet de ontwikkelaar van de plugin waarin de bouwsteen zit. Heb je de gloei-effecten niet nodig, dan kun je de melding tot de volgende update negeren.

Simple_RTP: hoofden in het menu worden niet weergegeven

Zo ziet de melding eruit:

[Simple_RTP] Failed to apply GUI head texture: IllegalArgumentException: Can not set net.minecraft.world.item.component.ResolvableProfile field org.bukkit.craftbukkit.inventory.CraftMetaSkull.profile to com.mojang.authlib.GameProfile

Wat erachter zit: Simple_RTP is een plugin voor willekeurige teleports. Voor de hoofden in het menu gebruikt het een spelersprofiel in het oude formaat (GameProfile). Jouw Minecraft-versie verwacht op die plek echter een nieuwer formaat (ResolvableProfile). Dat past niet bij elkaar, daarom werken de hoofden in het menu niet. De server blijft draaien.

Zo los je het op:

1. Controleer onder Versie welke Minecraft-versie je server heeft.
2. Download Simple_RTP in de uitgave voor deze Minecraft-versie.
3. Vervang het oude bestand onder Bestanden in de map plugins/ en start opnieuw op.
4. Open het menu in het spel en controleer of de hoofden nu verschijnen.

Goed om te weten: De melding kan zich bij elke opening van het menu herhalen. Ze richt verder geen schade aan, ze laat alleen zien dat de pluginuitgave verouderd is.

ZNPCs: opgeslagen NPC's passen niet bij de pluginversie

Zo ziet de melding eruit:

io.github.gonalez.znpcs.commands.CommandExecuteException
No enum constant io.github.gonalez.znpcs.npc.<…>.PLAYER

Wat erachter zit: ZNPCs slaat jouw NPC's inclusief type en acties op in een bestand. Daarin staat een type of actie die jouw geïnstalleerde ZNPCs-versie niet kent, bijvoorbeeld ActionType.PLAYER. Dat gebeurt meestal als de NPC's met een andere ZNPCs-versie zijn aangemaakt. Het uitgevoerde commando wordt afgebroken, de server blijft draaien.

Zo los je het op:

1. Maak onder Back-ups een back-up aan.
2. Installeer de ZNPCs-versie waarmee de NPC's zijn aangemaakt en start opnieuw op.
3. Lukt dat niet, stop dan de server, open onder Bestanden het bestand plugins/ZNPCs/data.json en verwijder de betreffende NPC-vermelding. JSON is een tekstformaat met haakjes en komma's: een ontbrekende komma maakt het hele bestand onleesbaar.
4. Start de server en test het commando opnieuw.

Goed om te weten: Bewerk het bestand alleen als de server is gestopt. Als hij draait, kan ZNPCs jouw wijziging bij het afsluiten weer overschrijven.

Plugin heeft Paper of een nieuwere versie nodig (failed to register events)

Zo ziet de melding eruit:

Plugin <Plugin> v<Versie> has failed to register events for class <Class> because io/papermc/paper/event/<Gebeurtenis> does not exist.

Wat erachter zit: Plugins reageren op gebeurtenissen in het spel, bijvoorbeeld wanneer een speler een blok afbreekt. Deze plugin wil luisteren naar een gebeurtenis die jouw serversoftware niet kent. Meestal is de plugin voor Paper geschreven, maar draait de server op Spigot. Of de gebeurtenis bestaat pas in een nieuwere Minecraft-versie. Het betreffende deel van de plugin werkt niet, de server blijft draaien.

Zo los je het op:

1. Lees de naam na because. Begint die met io/papermc/paper of com/destroystokyo/paper, dan heeft de plugin Paper nodig.
2. Draait je server op Spigot, schakel hem dan onder Software / loader wijzigen over naar Paper. Plugins voor Spigot draaien in de regel ook op Paper. Maak vooraf een back-up.
3. Draait hij al op Paper, dan is de gebeurtenis nieuwer dan jouw versie. Gebruik een uitgave van de plugin voor jouw Minecraft-versie of zet de server onder Versie om.
4. Start opnieuw op en controleer of de melding is verdwenen.

Meer hierover: Serversoftware en versie in het paneel wijzigen

Bestand is gebouwd voor een nieuwere Java-versie (Unsupported class file major version)

Zo ziet de melding eruit:

java.lang.IllegalArgumentException: Unsupported class file major version 69

Wat erachter zit: Plugins, mods en bibliotheken worden voor een bepaalde Java-versie gecompileerd. Het getal achter major version verraadt welke: getal min 44 geeft de Java-versie, 65 staat dus voor Java 21 en 69 voor Java 25. De hulpmiddelen van je server die plugins en mods bij het laden lezen of herschrijven, begrijpen deze nieuwere versie niet. Het betreffende onderdeel wordt niet geladen.

Zo los je het op:

1. Zoek in de regels ervoor uit welke plugin of welke mod net werd geladen.
2. Download hiervoor een uitgave die voor jouw Minecraft-versie is gebouwd en vervang het oude bestand onder Bestanden in de map plugins/ resp. mods/.
3. Of werk de server onder Versie bij naar een nieuwere Minecraft-versie die op Java 21 of nieuwer draait. De passende Java-versie wordt bij ons automatisch ingesteld. Maak vooraf een back-up.

Goed om te weten: Staat er direct voor Fatal error trying to convert, dan geldt de sectie over oudere Paper-servers hierboven.

Uitgebreid: Welke Java-versie heeft jouw Minecraft-server nodig?

Oude plugin zoekt een verwijderde chunkfunctie (legacy-ID's)

Zo ziet de melding eruit:

java.lang.NoSuchMethodException: net.minecraft.world.level.chunk.Chunk.k(net.minecraft.core.BlockPosition)

Wat erachter zit: Tot Minecraft 1.12 hadden blokken numerieke ID's, steen was bijvoorbeeld de 1. Sommige oude plugins rekenen intern nog met deze legacy-ID's en gebruiken daarvoor rechtstreeks interne functies van het spel, de klassen onder net.minecraft. De gezochte chunkfunctie bestaat in jouw versie niet meer. De legacy-ID-functie van de plugin start daarom niet. Afhankelijk van de plugin vallen daardoor enkele of veel functies uit.

Zo los je het op:

1. Kijk in de stacktrace onder de melding, dus de at …-regels. Daar staat de naam van de plugin of van zijn JAR-bestand.
2. Werk deze plugin bij naar een uitgave voor jouw Minecraft-versie en vervang het bestand onder Bestanden in de map plugins/.
3. Bestaat die niet, dan wordt de plugin niet meer onderhouden voor moderne versies. Zoek een actuele vervangende plugin.

Goed om te weten: De korte naam k is een versluierde interne naam. Zulke namen veranderen met elke Minecraft-versie. Plugins die ze rechtstreeks gebruiken, gaan daarom bij bijna elke update kapot.

Plugin gebruikt een verouderde Mojang-profielfunctie (spelerskoppen)

Zo ziet de melding eruit:

java.lang.NoSuchMethodException: com.mojang.authlib.GameProfile.getProperties()

Wat erachter zit: authlib is de bibliotheek van Mojang waarmee de server spelersprofielen met naam en skin beheert. De plugin leest deze profielen via een methode (GameProfile.getProperties) die in jouw Minecraft-versie niet meer bestaat. De betreffende functie valt uit, meestal zijn dat de spelerskoppen in menu's. De server draait gewoon door.

Zo los je het op:

1. Zoek de plugin: de naam of de naam van het JAR-bestand staat in de at …-regels onder de melding of in de regels ervoor.
2. Download een uitgave van deze plugin voor jouw Minecraft-versie.
3. Vervang het oude bestand onder Bestanden in de map plugins/ en start opnieuw op.
4. Open het betreffende menu in het spel en controleer of de koppen weer verschijnen.

Goed om te weten: Deze wijziging treft veel menu- en kopplugins tegelijk. Als meerdere plugins geen koppen meer tonen, ligt dat meestal aan dezelfde oorzaak en heeft elke plugin zijn eigen update nodig.

Plugin zoekt blokken, deeltjes of attributen die in jouw versie niet bestaan

Zo ziet de melding eruit:

java.lang.IllegalArgumentException: No enum constant org.bukkit.Material.<NAME>
Unknown material '<NAME>' for button
java.lang.NoSuchFieldError: Class org.bukkit.<Class> does not have member field '<Field>'

Wat erachter zit: Elke Minecraft-versie brengt nieuwe blokken, deeltjes en attributen mee en geeft sommige een andere naam. De plugin is voor een andere versie gebouwd en gebruikt iets wat hier niet of alleen onder een andere naam bestaat. Afhankelijk van de plugin verschijnt de fout bij elke actie, of vallen enkele functies uit. Ook Could not initialize Brigadier mappings hoort hierbij. Brigadier is het commandosysteem van Minecraft, dat onder andere de tab-aanvulling levert.

Zo los je het op:

1. Lees de pluginnaam in de regels ervoor of in de at …-regels eronder.
2. Download de uitgave van de plugin die bij jouw Minecraft-versie past en vervang het bestand onder Bestanden in de map plugins/.
3. Of zet de server onder Versie om naar de Minecraft-versie die de plugin vereist. Maak vooraf een back-up.
4. Staat de onbekende naam in een configuratiebestand van de plugin, bijvoorbeeld bij menuknoppen, dan kun je hem daar vervangen door de actuele benaming.

Marriage-plugin past niet bij de Minecraft-versie

Zo ziet de melding eruit:

[Marriage] Marriage is not compatible with the version of minecraft you are using
Marriage kissing will be disabled!

Wat erachter zit: Met Marriage kunnen spelers in het spel trouwen en de plugin brengt daarvoor functies mee, zoals zoenen. De plugin ondersteunt jouw Minecraft-versie niet. Daarom schakelt hij minstens de zoenfunctie uit, andere onderdelen kunnen ook getroffen zijn. De server draait normaal door.

Zo los je het op:

1. Kijk op de pluginpagina of er een Marriage-uitgave voor jouw Minecraft-versie is. Je versie zie je onder Versie.
2. Is die er, vervang dan het oude bestand onder Bestanden in de map plugins/ en start opnieuw op.
3. Is die er niet, vervang de plugin dan door een actuele met een vergelijkbare functie. Houd er rekening mee dat een andere plugin de opgeslagen gegevens van Marriage niet overneemt, en maak vooraf een back-up.

Goed om te weten: Als alleen de ontbrekende zoenfunctie je stoort en de rest werkt, kun je de melding negeren totdat er een update verschijnt.

Anticheat- of pakket-plugin kent jouw Minecraft-versie nog niet volledig

Zo ziet de melding eruit:

java.lang.IllegalStateException: Unknown entity metadata type id: <Getal> version V_<Versie>

Wat erachter zit: Sommige plugins lezen de netwerkpakketten tussen spel en server mee, bijvoorbeeld de anticheat GrimAC via de bibliotheek PacketEvents. Met nieuwe Minecraft-versies komen er nieuwe datatypen voor wezens en objecten bij, de entity-metadata. De plugin kent een daarvan nog niet, meestal omdat hij ouder is dan jouw serverversie. Betreffende pakketten worden verkeerd verwerkt. Dat kan valse meldingen van de anticheat of verbindingsproblemen veroorzaken.

Zo los je het op:

1. Werk de plugin bij en, als PacketEvents als apart bestand is geïnstalleerd, ook PacketEvents naar een versie die jouw Minecraft-versie uitdrukkelijk ondersteunt.
2. Start de server volledig opnieuw op.
3. Is er nog geen passende versie, schakel de plugin dan tijdelijk uit: hernoem het bestand onder Bestanden, bijvoorbeeld naar <Plugin>.jar.off. De server laadt alleen bestanden met de extensie .jar.
4. Als alternatief gebruik je onder Versie een Minecraft-versie die de plugin ondersteunt. Maak vooraf een back-up.

Extra plugin voor WorldEdit gebruikt een verwijderde interface

Zo ziet de melding eruit:

[WorldEdit] Got request to set EditSessionFactory <…> EditSessionFactories have been removed …

Wat erachter zit: WorldEdit heeft een oudere interface verwijderd, de EditSessionFactory. Daarmee konden extra plugins zich in elke WorldEdit-wijziging haken. Een extra plugin, bijvoorbeeld voor blokloggen of gebiedsbescherming, probeert die nog te gebruiken. WorldEdit zelf werkt normaal. De log- of beschermfunctie van de extra plugin grijpt bij WorldEdit-wijzigingen echter niet in: wat je met WorldEdit bouwt of verwijdert, wordt door die plugin niet vastgelegd en niet geblokkeerd.

Zo los je het op:

1. Zoek uit welke plugin het verzoek doet. De naam staat meestal in de melding zelf of in de regels ervoor.
2. Werk deze extra plugin bij naar een versie die samenwerkt met jouw WorldEdit of FastAsyncWorldEdit (FAWE, een snellere WorldEdit-variant).
3. Is die er niet, schakel dan de WorldEdit-koppeling uit in de configuratie van de extra plugin, als daarvoor een instelling bestaat.
4. Start opnieuw op en controleer of de melding verdwenen is.

Goed om te weten: Zolang dit niet is opgelost, kun je er niet op vertrouwen dat WorldEdit-wijzigingen worden gelogd of daarmee kunnen worden teruggedraaid.

Braslety: recept wordt niet geregistreerd

Zo ziet de melding eruit:

[Braslety] … java.lang.IllegalAccessException: class com.example.braslety.BraceletsPlugin cannot access …

Wat erachter zit: Braslety gebruikt reflection om interne CraftBukkit-klassen aan te spreken. Reflection betekent: de plugin leest onderdelen van de server direct uit in plaats van de officiële interface te gebruiken. In jouw serverversie zijn die onderdelen niet toegankelijk, Java weigert de toegang. Het betreffende recept wordt daarom niet geregistreerd, het bijbehorende item kan dus niet worden gemaakt. De server draait door.

Zo los je het op:

1. Controleer of er een Braslety-versie is voor jouw huidige Paper-build. Jouw stand zie je onder Versie.
2. Is die er, vervang dan het oude bestand onder Bestanden in de map plugins/ en start opnieuw op.
3. Is die er niet, vervang de plugin dan door een onderhouden plugin met een vergelijkbare functie.
4. Controleer in het spel of het recept werkt.

Goed om te weten: De pakketnaam com.example wijst op een zelfgemaakte of weinig verspreide plugin. Een update kan dan alleen de maker leveren.

ViaVersion kan een vertaalmodule niet laden

Zo ziet de melding eruit:

[ViaVersion] Error during loading of Protocol<Version>To<Version>

Wat hierachter zit: ViaVersion vertaalt tussen spelversies, zodat ook spelers met nieuwere of oudere clients kunnen joinen. Uitbreidingen zoals ViaBackwards vullen dat aan voor oudere clients. Elke vertaling zit in een eigen module waarvan de naam met Protocol begint. Eén daarvan kon niet worden geladen, meestal omdat ViaVersion en de uitbreidingen niet bij elkaar passen of niet bij de serverversie passen. Spelers met de betreffende clientversies kunnen dan niet joinen. Wie precies de serverversie speelt, heeft er geen last van.

Zo los je het op:

1. Download de nieuwste versies van ViaVersion en van alle Via-uitbreidingen die je gebruikt.
2. Vervang ze allemaal tegelijk onder Bestanden in de map plugins/. Meng geen oude en nieuwe Via-bestanden.
3. Start de server volledig opnieuw op.
4. Test het joinen met de clientversie die eerder niet werkte.

Uitgebreid: ViaVersion instellen: oudere en nieuwere clients verbinden

LibreLogin werkt niet op Spigot

Zo ziet de melding eruit:

[LibreLogin] Detected an unsupported server distribution. Please use Paper or its forks. SPIGOT IS NOT SUPPORTED!

Wat hierachter zit: LibreLogin is een loginplugin: spelers melden zich aan met een wachtwoord. Dat is vooral belangrijk op servers in offlinemodus. LibreLogin heeft Paper of een compatibele fork nodig, dus een variant van Paper zoals Purpur, en schakelt zichzelf uit op Spigot. Draait je server in offlinemodus, dan ontbreekt daardoor de wachtwoordbescherming: spelers kunnen onder andermans naam verbinden.

Zo los je het op:

1. Maak onder Back-ups een back-up aan.
2. Zet de server onder Software / loader wijzigen om naar Paper of Purpur. Plugins voor Spigot blijven daar in de regel werken.
3. Start opnieuw op en controleer in de Console of LibreLogin zonder deze melding laadt.
4. Wil je bij Spigot blijven, gebruik dan een loginplugin die Spigot uitdrukkelijk ondersteunt.

Goed om te weten: Draait je server in offlinemodus, los dit dan op voordat spelers joinen.

Meer hierover: Serversoftware en versie wijzigen in het paneel

Nova mist een Java-startparameter (-javaagent)

Zo ziet de melding eruit:

[Nova] Missing required JVM argument: -javaagent:plugins/Nova-<Version>.jar

Wat hierachter zit: Nova is een uitgebreide plugin die eigen blokken en items op Paper-servers mogelijk maakt. Voor een deel van de functies moet Java bij het opstarten een zogeheten Java-agent laden. Dat is een toevoeging die al actief wordt vóór de eigenlijke server en via een startparameter wordt ingeladen. Je server start zonder deze parameter. Nova werkt daardoor niet volledig, maar de server zelf draait.

Zo los je het op:

1. Lees in de melding de exacte parameter af, inclusief de bestandsnaam van de Nova-JAR.
2. Het startcommando van je Minecraft-server kun je niet zelf aanpassen in het paneel. Open daarom een ticket, kopieer de parameter uit de melding erin en noem het tijdstip van de melding.
3. Heb je Nova niet per se nodig, verwijder de plugin dan onder Plugins en start de server opnieuw op. De melding verdwijnt dan.

Goed om te weten: Met elke nieuwe Nova-versie verandert meestal ook de bestandsnaam in de parameter. Na een Nova-update komt de melding daarom vaak terug.

Staat jouw melding er niet bij?

Lees de hele melding in de Console of in logs/latest.log, ook de regels ervoor. De betreffende plugin herken je aan de naam tussen vierkante haken aan het begin van de regel of in de stacktrace, de lijst met at …-regels: daar staan JAR-namen uit plugins/ of mods/ en pakketnamen, die vaak de pluginnaam bevatten. Vergelijk daarna op de pluginpagina de ondersteunde versies met die van je server. Maak vóór elke versiewissel een back-up. Kom je er niet uit, open dan een ticket en vermeld het tijdstip van de melding.