Veel plugins werken niet volledig op zichzelf. Premium-plugins controleren bij het starten een licentiesleutel, koppelingen met Discord, Telegram of VK hebben een token nodig (een soort wachtwoord voor een bot of een interface), spraakchat-plugins openen een eigen netwerkpoort en sommige laden bibliotheken of databases van het internet na. Ontbreekt een van deze zaken of wordt het geweigerd, dan schrijft de plugin een melding in het log. Meestal valt alleen de functie van die plugin uit; in één geval zet de plugin de server bewust stil.

Elke sectie hieronder behandelt één melding. De volledige melding vind je in de Console of onder Bestanden in logs/latest.log, de configuratie van de plugins staat in plugins/<Plugin>/. Maak voordat je hier iets aanpast een back-up onder Back-ups. Sleutels en tokens zijn geheim: laat ze aan niemand zien en knip ze weg uit screenshots.

DonutShop weigt de licentiesleutel af

Zo ziet de melding eruit:

[DonutShop]             DONUTSHOP ERROR
[DonutShop] The licensing server rejected this key.

Wat erachter zit: DonutShop is een shopplugin die bij het opstarten zijn licentiesleutel controleert bij de licentieserver van de auteur. Deze controle is bij de laatste start mislukt. Ook een ingevulde, niet-lege waarde kan ongeldig of verlopen zijn, of voor een andere installatie zijn uitgegeven. De Minecraft-server kan dan gewoon blijven draaien, maar DonutShop is niet betrouwbaar beschikbaar: spelers kunnen niet op de shop rekenen.

Zo los je het op:

  1. Haal de gratis licentiesleutel op of controleer hem via de officiële projectpagina van DonutShop op Modrinth.
  2. Open onder Bestanden de configuratie van DonutShop (plugins/DonutShop/config.yml) en vul de sleutel in bij license-key. Zet hem tussen aanhalingstekens, zonder spaties ervoor of erachter.
  3. Sla het bestand op en herstart de server.
  4. Kijk in de Console: pas als de banner "DONUTSHOP ERROR" bij de nieuwe start niet meer verschijnt, is de fout verholpen.

Goed om te weten: Heb je de sleutel van een andere server overgenomen, vraag dan voor deze server een eigen sleutel aan.

LibreLogin stopt de server: bibliotheek kan niet worden geladen

Zo ziet de melding eruit:

[LibreLogin] Failed to load libraries, stopping server to prevent damage
… Failed to download library <Library>

Wat erachter zit: LibreLogin is een inlogplugin waarmee spelers met een wachtwoord inloggen. Bij het opstarten laadt het bibliotheken na, dus programmaonderdelen die het niet zelf meebrengt, waaronder PacketEvents. Lukt deze download niet, dan stopt LibreLogin de server bewust in plaats van half functioneel door te draaien. De server start dus niet totdat het probleem is opgelost.

Zo los je het op:

  1. Herstart de server één keer. Was de downloadbron maar even onbereikbaar, dan lukt het vaak bij de volgende poging.
  2. Werk LibreLogin onder Plugins bij naar de nieuwste versie voor jouw serversoftware. Heb je PacketEvents als eigen plugin geïnstalleerd, werk dat dan ook bij.
  3. Herstart en controleer in de Console of de bibliotheken nu worden geladen.
  4. Verschijnt de melding bij elke start, dan bereikt de server het downloadadres niet. Dat kan liggen aan de internettoegang, aan de naamresolutie (DNS, die vertaalt adressen naar IP-nummers) of aan het adres zelf. Kom je er niet uit, open dan een ticket en vermeld het tijdstip van de melding.

Goed om te weten: Hoe je plugins bijwerkt en vervangt, lees je in Minecraft-plugins installeren en beheren.

„Packet queue has … packets“: Simple Voice Chat kan het niet bijhouden

Zo ziet de melding eruit:

[voicechat] Packet queue has <Count> packets
[voicechat] Dropping voice chat packets!

Wat erachter zit: Simple Voice Chat verstuurt spraak tussen spelers die dicht bij elkaar in het spel zijn. De melding betekent: de voicechat kan de verwerking niet bijhouden, spraakpakketten hopen zich op in een wachtrij of worden weggegooid. De oorzaak is een server die op dat moment overbelast is, met lage TPS (ticks per seconde, de kloksnelheid van Minecraft; normaal is 20) of een hoge CPU-belasting. Spelers horen dan hakkelende of ontbrekende spraak, terwijl de server zelf gewoon doordraait.

Zo los je het op:

  1. Zoek uit wat de belasting veroorzaakt, bijvoorbeeld met spark: spark: lag op de Minecraft-server vinden en begrijpen.
  2. Verlaag de zichtafstand (view-distance) en de simulatieafstand (simulation-distance) onder Bestanden in server.properties. Zo laadt de server minder chunks, oftewel wereldgedeelten van 16 × 16 blokken.
  3. Verminder het aantal entities (wezens, dieren, rondliggende voorwerpen) op afzonderlijke plekken en controleer plugins die veel belasting veroorzaken.
  4. Is dat niet genoeg, ga dan onder Instellingen & abonnement → Plan naar meer prestaties.

Goed om te weten: Losse meldingen kort na het starten of bij het verkennen van nieuwe gebieden zijn onschuldig, zolang ze weer ophouden.

Simple Voice Chat krijgt zijn UDP-poort niet

Zo ziet de melding eruit:

[voicechat] Failed to run voice chat at UDP port <Port>
[voicechat] Disabling Simple Voice Chat

Wat erachter zit: Simple Voice Chat zendt spraak uit via een eigen UDP-poort. UDP is de netwerkmethode voor snelle realtimedata zoals spraak. De ingestelde poort hoort niet bij jouw server of is al bezet, bijvoorbeeld omdat nog de standaardwaarde uit de pluginhandleiding is ingevuld. Zonder poort schakelt de spraakchat zichzelf uit; het spel zelf draait normaal door.

Zo los je het op:

  1. Open onder Bestanden het bestand plugins/voicechat/voicechat-server.properties. Draait Simple Voice Chat bij jou als mod, dan staat het in config/voicechat/voicechat-server.properties.
  2. Zet port op het poortnummer van jouw server. Je spelpoort is vrijgegeven voor TCP en UDP.
  3. Sla het bestand op en herstart de server.
  4. Controleer in de Console of de melding wegblijft en test de spraakchat in het spel.

Uitgebreid: Simple Voice Chat op de Minecraft-server instellen.

Goed om te weten: Een UDP-poort kan maar door één programma tegelijk worden geopend. Gebruikt al een andere plugin dezelfde poort, bijvoorbeeld Geyser voor Bedrock-spelers, dan heeft een van beide een andere poort nodig die aan jouw server is toegewezen.

„No bot token“: Discord-aanmelding mislukt

Zo ziet de melding eruit:

[DiscordSRV] No bot token has been set in the config; a bot token is required to connect to Discord.
[voicechat-discord] Failed to load a bot. Please make sure that the token property is a string and the vc_id property is a number.
[DiscordWhitelist] Edit plugins/DiscordWhitelist/config.yml and set discord.bot-token, then run /discordwhitelist reload.

Wat erachter zit: Discord-extensies melden zich aan met een eigen bot. Daarvoor hebben ze het token van die bot nodig, een geheime tekenreeks zoals een wachtwoord. Ontbreekt het of is het ongeldig, dan blijft de Discord-koppeling uit, terwijl Minecraft gewoon doorloopt. Bij voicechat-discord kunnen bovendien gegevenstypen verkeerd zijn: token moet tekst zijn en vc_id een getal.

Zo los je het op:

  1. Maak in het Discord Developer Portal een bot aan of kies je bestaande bot. Genereer indien nodig een nieuw token.
  2. Voer het token onder Bestanden in de configuratie in: bij DiscordSRV in plugins/DiscordSRV/config.yml onder BotToken, bij DiscordWhitelist in plugins/DiscordWhitelist/config.yml onder discord.bot-token. Voor andere extensies geldt hun handleiding.
  3. Bij voicechat-discord moet token een tekenreeks zijn en vc_id het getal dat volgens de handleiding nodig is.
  4. Nodig de bot indien nodig uit op je Discord-server, sla op en start Minecraft opnieuw op.

Goed om te weten: Deel het token nooit; reset het als het openbaar is geworden. Bij intents-fouten activeer je in het Developer Portal de gevraagde „Privileged Gateway Intents“.

„Could not download GeoLiteAPI database“: landendatabase ontbreekt

Zo ziet de melding eruit:

[AuthMe] Could not download GeoLiteAPI database [FileNotFoundException]: plugins/AuthMe/GeoLite2-Country.mmdb (No such file or directory)

Wat er achter zit: Sommige plugins, zoals AuthMe, koppelen IP-adressen aan een land. Daarvoor downloaden ze een landendatabase, meestal GeoLite2 van MaxMind; dit proces is mislukt. Bij FileNotFoundException met „No such file or directory“ ontbreekt het genoemde lokale bestand of een bijbehorende map. De plugin blijft werken; landafhankelijke functies zoals landblokkades blijven zonder database inactief.

Zo los je het op:

  1. Bij tijdelijke downloadproblemen probeert de volgende herstart het opnieuw.
  2. Controleer bij „No such file or directory“ onder Bestanden de genoemde opslaglocatie en het pad in de pluginconfiguratie. Richt de database in volgens de handleiding van jouw pluginversie.
  3. Blijft de download mislukken, controleer dan de configuratie onder plugins/<Plugin>/. Als jouw versie een licentiesleutel vereist, vul dan je geldige sleutel in het daarvoor bedoelde veld in.
  4. Sla op, herstart de server en controleer in de Console of de melding verdwijnt.

Goed om te weten: Gebruik je geen landafhankelijke functies, dan kun je de melding negeren. De overige functies van de plugin blijven gewoon werken.

DonutShop is vergrendeld zonder licentiesleutel

Zo ziet de melding eruit:

[DonutShop]             DONUTSHOP LOCKED
[DonutShop] No license key is set in config.yml.
[DonutShop] Then run: /link <your-key>

Wat erachter zit: DonutShop start alleen met een licentiesleutel. In de config.yml van de plugin is er geen ingevuld, daarom blijft de shop vergrendeld. De sleutel is gratis, maar je moet hem eenmalig bij de auteur ophalen. De Minecraft-server zelf heeft hier geen last van.

Zo los je het op:

  1. Haal bij de auteur van de plugin de gratis sleutel op. De weg ernaartoe, een Discord-link, staat in de regels rond de banner in de melding.
  2. Voer /link <jouw-sleutel> uit, zoals de melding voorschrijft, of vul de sleutel in bij plugins/DonutShop/config.yml.
  3. Start de server opnieuw op.
  4. Controleer in de Console of de banner "DONUTSHOP LOCKED" is verdwenen.

Goed om te weten: Verschijnt daarna "DONUTSHOP ERROR", dan is de sleutel geweigerd. In dat geval helpt de sectie over de geweigerde DonutShop-licentie je verder.

VK-token van de plugin wordt geweigerd

Zo ziet de melding eruit:

com.vk.api.sdk.exceptions.ApiAuthException: User authorization failed (5): User authorization failed: invalid access_token (4).

Wat erachter zit: Sommige plugins koppelen met VK, het sociale netwerk VKontakte. Daarvoor hebben ze een toegangstoken nodig, een soort wachtwoord voor de koppeling. VK heeft het ingevulde token geweigerd ("invalid access_token"), het is dus ongeldig, verlopen of ingetrokken. De VK-functies van de plugin zijn uitgeschakeld, de rest van de server draait normaal.

Zo los je het op:

  1. Maak bij VK een nieuw toegangstoken aan met de rechten die de plugin vereist. Welke dat zijn, staat in de handleiding van de plugin.
  2. Open bij Bestanden de configuratie van de plugin in plugins/<Plugin>/ en vervang het oude token door het nieuwe.
  3. Sla het bestand op en start de server opnieuw op.
  4. Controleer in de Console of de melding wegblijft.

Goed om te weten: Welke plugin het betreft, zie je in de stacktrace eronder, dus de ingesprongen regels met at …. Naast com.vk.api staat daar de pakketnaam van de plugin.

Plugin kan zijn resourcepack niet beschikbaar stellen

Zo ziet de melding eruit:

java.io.IOException: HTTP 403 dla http://<Adres>/<Pack>.zip
Failed to start resourcepack server: Server is not publicly reachable on <Adres>:<Poort>

Wat erachter zit: Sommige plugins leveren spelers een eigen resourcepack. Daarvoor downloaden ze het van een adres, stellen ze het zelf samen of starten ze een kleine ingebouwde webserver waar spelers het vandaan halen. Een van deze stappen is mislukt. Spelers krijgen het pack dan niet en teksturen of functies die ervan afhangen ontbreken. De server blijft draaien.

Zo los je het op:

  1. Lees de HTTP-status in de melding: 403 betekent toegang geweigerd, 404 betekent bestand niet gevonden.
  2. Open het pack-adres uit de pluginconfiguratie in de browser. Het moet direct het ZIP-bestand downloaden en mag geen voorbeeld- of inlogpagina tonen.
  3. Corrigeer het adres of upload het pack naar een plek waar het openbaar wordt aangeboden.
  4. Gebruikt de plugin een ingebouwde webserver, vul dan alleen een poort in die aan je server in het paneel is toegewezen en openbaar bereikbaar is.
  5. Start de server opnieuw op.

Plugin heeft een API-sleutel nodig voor een externe dienst

Zo ziet de melding eruit:

Please set your <Service> API key
Get your API key from: https://<Aanbieder>/…
accessToken=MISSING

Wat erachter zit: De plugin werkt samen met een externe dienst, bijvoorbeeld voor statistieken of een koppeling met een website. Daarvoor heeft hij een API-sleutel of inloggegevens nodig. Een API-sleutel is een code waarmee de plugin zich bij de dienst identificeert. In de configuratie ontbreekt hij. Zolang hij niet is ingevuld, werkt de plugin niet; de rest van de server draait gewoon door.

Zo los je het op:

  1. Lees de melding: die noemt meestal de dienst, het bestand en het veld, vaak ook het adres waar je de sleutel krijgt ("Get your API key from:").
  2. Maak bij de dienst een account aan en genereer daar de sleutel.
  3. Open bij Bestanden het genoemde bestand in plugins/<Plugin>/ en vul de sleutel in. Het bestand is meestal in YAML-formaat, waarbij de inspringing met spaties de structuur bepaalt; wijzig die niet en zet de waarde tussen aanhalingstekens.
  4. Sla het bestand op en start de server opnieuw op.

Goed om te weten: Meldt de plugin daarna dat hij het bestand niet kan lezen, dan helpt Configuratiebestand van een plugin is foutief je verder.

Premium-plugin vindt geen geldige licentiesleutel

Zo ziet de melding eruit:

No License Key Found!
Please enter a valid key in license.yml
Authentication failed! API key is invalid

Wat erachter zit: De plugin is een premium-plugin of heeft een sleutel van de aanbieder nodig en vindt in zijn configuratie geen geldige. Hij schakelt zichzelf dan helemaal uit of zet afzonderlijke functies uit. De server blijft draaien, alleen zonder de functies van deze plugin.

Zo los je het op:

  1. Zoek de sleutel uit je aankoop erbij, bijvoorbeeld in het account op de site waar je de plugin hebt gekocht, of vraag ernaar bij de aanbieder.
  2. Open bij Bestanden het bestand dat in de melding wordt genoemd, meestal plugins/<Plugin>/license.yml of plugins/<Plugin>/config.yml, en vul de sleutel in.
  3. Sla het bestand op en start de server opnieuw op.
  4. Heb je geen sleutel, verwijder de plugin dan bij Plugins, in plaats van hem blijvend met fouten te laten draaien.

Goed om te weten: Download premium-plugins alleen van de officiële verkoopsite. Versies uit onofficiële bronnen waarin de licentiecontrole is verwijderd, bevatten niet zelden schadelijke software.

Telegram-bot van de plugin start niet

Zo ziet de melding eruit:

Error removing old webhook

Wat erachter zit: Een plugin met Telegram-koppeling meldt zich bij het opstarten met een bot aan bij Telegram. Daarbij verwijdert hij eerst een oude webhook, dus een opgeslagen adres waarnaar Telegram nieuwe berichten zou sturen. Dat is mislukt, meestal doordat het bottoken ongeldig is of Telegram even niet bereikbaar was. De Telegram-functie blijft uit, de Minecraft-server draait normaal door.

Zo los je het op:

  1. Open in Telegram de chat met @BotFather en laat het token van je bot weergeven of genereer een nieuw token.
  2. Open bij Bestanden de configuratie van de plugin in plugins/<Plugin>/ en vervang het token. Kopieer het volledig, een bottoken begint met een getal en een dubbele punt.
  3. Sla het bestand op en start de server opnieuw op.
  4. Controleer in de Console of de melding wegblijft.

Goed om te weten: Verschijnt de melding maar één keer en bij de volgende start niet meer, dan was Telegram even niet bereikbaar. Dan hoef je niets te wijzigen.

Plugin krijgt geen eigen netwerkpoort

Zo ziet de melding eruit:

Failed to bind to /<Address>:<Port>
[PlasmoVoice] Failed to start the udp server

Wat er achter zit: Sommige plugins openen een eigen netwerkpoort, bijvoorbeeld voor een spraakchat zoals Plasmo Voice of voor een website met kaart of statistieken. Het ingestelde adres of de poort is op jouw server niet beschikbaar: de poort is niet aan de server toegewezen, al in gebruik, of in de configuratie staat een vast IP-adres dat de server zo niet kan gebruiken. De functie van de plugin blijft uit, de rest van de server draait gewoon door.

Zo los je het op:

  1. Open onder Bestanden de configuratie van de plugin in plugins/<Plugin>/ en zoek de vermeldingen voor poort en adres.
  2. Vul een poort in die in het paneel aan jouw server is toegewezen en nog vrij is.
  3. Laat het adres leeg of zet 0.0.0.0. Dat betekent: bereikbaar via alle netwerkaansluitingen van de server.
  4. Sla het bestand op, start de server opnieuw op en controleer in de Console of de melding wegblijft.

Goed om te weten: Een poort kan maar door één programma tegelijk worden geopend. Gebruiken twee plugins dezelfde poort, dan heeft elk een eigen poort nodig. Meer over poorten: Minecraft-poorten en verbindingsfouten controleren.

Plugin of extra dienst krijgt zijn poort niet

Zo ziet de melding eruit:

[<Plugin>] Failed to start HTTP server: Address already in use
java.net.BindException: Address already in use

Wat erachter zit: Een plugin of een extra dienst zoals voicechat, een eigen website, Query of RCON wil een eigen poort openen die al bezet is. Vaak staat in de configuratie de spelpoort, en die heeft de server bij het starten zelf al geopend. De server draait gewoon door en spelers kunnen meedoen, alleen deze ene functie blijft uit.

Zo los je het op:

  1. Lees in de Console de naam tussen vierkante haken vóór de melding, bijvoorbeeld [<Plugin>]. In de Servergezondheid staat die onder „Betrokken plugin of dienst".
  2. Open onder Bestanden de configuratie in plugins/<Plugin>/ en zoek het item voor de poort. Bij Query en RCON zijn dat query.port en rcon.port in de server.properties.
  3. Vul een poort in die niet de spelpoort is en die geen ander plugin gebruikt. Alle poorten van je server zie je op het tabblad Ports.
  4. Voor Simple Voice Chat en andere bekende plugins richten de assistenten onder Plugins automatisch een vrije poort voor je in.
  5. Sla het bestand op, start de server opnieuw op en controleer in de Console of de melding wegblijft.

Goed om te weten: Alleen een herstart helpt niet zolang in de configuratie dezelfde poort staat. Meer over poorten: Minecraft-poorten en verbindingsfouten controleren.

DonatePay: ongeldig teken in het opvraagadres

Zo ziet de melding eruit:

java.net.URISyntaxException: Illegal character in query at index <Positie>: <Adres met verwijderde token>

Wat erachter zit: De DonatePay-integratie wil nieuwe donaties opvragen, maar kan het daarvoor samengestelde adres niet verwerken. Een URI is een gestructureerd adres; het querygedeelte bevat hier een ongeldig teken. Daardoor mislukt het opvragen van donaties, terwijl de Minecraft-server gewoon blijft draaien.

Zo los je het op:

  1. Open de Console of logs/latest.log onder Bestanden en controleer of de foutmelding de DonatePay-integratie noemt.
  2. Controleer de pluginconfiguratie onder Bestanden. Vergelijk de ingevoerde toegangsgegevens met de handleiding en verwijder per ongeluk meegekopieerde spaties of aanhalingstekens.
  3. Werk de integratie bij onder Plugins of vervang het zelf geüploade bestand onder Bestanden. Start de server volledig opnieuw op.
  4. Blijft de melding bestaan, geef dan de opgeschoonde foutmelding aan de pluginauteur. Verwijder alle tokenwaarden voordat je deze doorgeeft.

Rugzak-plugin kan zijn resourcepack niet gebruiken

Zo ziet de melding eruit:

[ᴠᴢʙᴀᴄᴋᴘᴀᴄᴋ] Die URL der Datei '<Bestand>.zip' ist ungültig!

Wat erachter zit: De plugin kan een ingesteld resourcepack-bestand niet gebruiken. Either het adres is ongeldig of het externe pakket wordt als defect herkend. Daardoor krijgt de weergave van de rugzak onjuiste of ontbrekende texturen en lettertypen; de server blijft gewoon draaien.

Zo los je het op:

  1. Controleer onder Bestanden in de pluginconfiguratie welk pakketbestand en welk adres zijn ingesteld.
  2. Vergelijk het bestand met de handleiding van jouw pluginversie. Gebruik een geldig direct downloadadres en een volledig, bijpassend archief.
  3. Start de server volledig opnieuw op. Laat de client het gecorrigeerde pakket opnieuw laden en controleer de rugzaktexturen en lettertypen.

libdatachannel: Datakanaalverbinding of verzenden mislukt

Zo ziet de melding eruit:

[tel.schich.libdatachannel.LibDataChannel] SCTP connection failed
[tel.schich.libdatachannel.LibDataChannel] SCTP sending failed, errno=104

Wat erachter zit: libdatachannel is een bibliotheek voor dataverbindingen. SCTP is de benaming voor de hierbij gebruikte overdrachtsmethode. Er komt geen verbinding tot stand of er kan niet meer worden verzonden; de betreffende pluginverbinding valt uit. De gameserver blijft draaien.

Zo los je het op:

  1. Probeer de betreffende verbinding opnieuw. Controleer of slechts één enkele join of meerdere verbindingen mislukken.
  2. Lees in de Console de regels vóór en na de melding. Koppel de bibliotheek aan de daar genoemde plugin.
  3. Vergelijk de netwerkinstellingen en vereisten van die plugin met de documentatie. Controleer vooral de daarin voorziene poorten en de bereikbaarheid van de andere kant.
  4. Controleer onder Plugins of er een passende update is. Blijft de fout bestaan, open dan een ticket en vermeld het tijdstip en bijbehorende meldingen.

Netty: netwerkmelding komt terecht bij een beëindigde executor

Zo ziet de melding eruit:

Failed to submit a listener notification task. Event loop shut down?
java.util.concurrent.RejectedExecutionException: event executor terminated

Wat erachter zit: Netty verwerkt netwerktaken in een gebeurtenislus (event loop). Die is hier al beëindigd, terwijl er nog een melding in de wachtrij moet worden geplaatst. De melding wordt verworpen. Bij het stoppen kan dit als bijkomende fout optreden; tijdens het spelen kan een netwerkfunctie verstoord zijn.

Zo los je het op:

  1. Controleer het tijdstip in de Console en vergelijk het met het starten of stoppen van de server.
  2. Treedt de fout op tijdens normaal gebruik, bewaar dan de volledige melding uit logs/latest.log samen met eerdere fouten. De regels met aanroepen die erop volgen heten stacktrace en kunnen de betrokken component tonen.
  3. Controleer de bijbehorende component onder Plugins en de serverversie onder Versie op bij elkaar passende updates. Vervang bestanden terwijl de server is gestopt.
  4. Start volledig opnieuw op en herhaal de betreffende verbinding. Blijft de fout bestaan, open dan een ticket met het tijdstip en de volledige melding.

Staat jouw melding er niet bij?

Lees de hele melding in de Console of in logs/latest.log, ook de regels ervoor. De naam tussen vierkante haken aan het begin van de regel, bijvoorbeeld [DiscordSRV], noemt meestal de plugin. Ontbreekt die, dan helpt de stacktrace: in de ingesprongen regels met at … staan pakket- en mapnamen die naar de plugin of de mod verwijzen. Welke sleutels, tokens of poorten een plugin nodig heeft, staat uitgelegd op de projectpagina. Maak voordat je de configuratie aanpast een back-up. Kom je er niet uit, open dan een ticket en vermeld het tijdstip van de melding.