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.

Simple Voice Chat laat spraakpakketten vallen

Zo ziet de melding eruit:

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

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

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) bij de Instellingen of in server.properties. Zo laadt de server minder chunks, oftewel wereldsecties 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, schakel dan onder Instellingen & abonnement → Plan over naar meer vermogen.

Goed om te weten: Enkele meldingen kort na het opstarten 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.

Discord-plugin heeft geen geldig bottoken

Zo ziet de melding eruit:

[DiscordSRV] No bot token has been set in the config; a bot token is required to connect to Discord.
[DiscordSRV] The bot token is invalid
[EssentialsDiscord] An error occurred while logging into Discord

Wat erachter zit: Discord-plugins zoals DiscordSRV of EssentialsX Discord melden zich met een eigen bot aan bij Discord. Daarvoor hebben ze het token van de bot nodig, een lange tekenreeks die op een wachtwoord lijkt. In de configuratie staat er geen, of Discord weigert het ingevulde, bijvoorbeeld omdat het inmiddels is gereset. De Discord-koppeling blijft dan uit, de Minecraft-server draait normaal door.

Zo los je het op:

  1. Maak in het Discord Developer Portal een applicatie met bot aan of kies je bestaande bot. Kopieer in het gedeelte "Bot" het token of genereer een nieuw token.
  2. Open onder Bestanden de config.yml van de plugin, bijvoorbeeld plugins/DiscordSRV/config.yml, en vul het token in (bij DiscordSRV in het veld BotToken).
  3. Nodig de bot uit op je Discord-server, als dat nog niet is gebeurd.
  4. Sla het bestand op en herstart de server.

Goed om te weten: Staat achter "could not connect to Discord because:" een verwijzing naar intents, schakel dan in het Developer Portal bij de bot de gevraagde "Privileged Gateway Intents" in. Is een token openbaar geworden, reset het dan daar en vul het nieuwe in.

Plugin kan de landendatabase niet downloaden

Zo ziet de melding eruit:

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

Wat erachter zit: Sommige plugins, zoals AuthMe, koppelen IP-adressen aan een land. Daarvoor downloaden ze een landendatabase, meestal GeoLite2 van de aanbieder MaxMind. Deze download is mislukt. De plugin draait door; alleen landafhankelijke functies zoals landblokkades blijven inactief zolang de database ontbreekt.

Zo los je het op:

  1. Meestal is dit een tijdelijk probleem aan de andere kant. Bij de volgende herstart wordt de download opnieuw geprobeerd; je hoeft niet direct iets te doen.
  2. Blijft de melding over meerdere starts bestaan, kijk dan in de configuratie van de plugin onder plugins/<Plugin>/. Vaak heeft de plugin voor de download een eigen licentiesleutel nodig, en de configuratie noemt het veld daarvoor.
  3. Vul de sleutel in, sla op en herstart de server.

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

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.

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.