Dit artikel gaat over meldingen rond het starten van de server, het inloggen van spelers en netwerkverbindingen, bijvoorbeeld naar poorten of naar een proxy zoals Velocity of BungeeCord. Elke sectie behandelt precies één melding. Sommige voorkomen dat de server start, andere betreffen alleen individuele spelers of een extra functie.

De volledige tekst vind je in de Console en onder Bestanden in logs/latest.log. Meldingen waarbij een proxy zijn doelserver niet bereikt, staan in het log van de proxy. Lees ook altijd de regels direct ervoor en erna.

Voordat je server.properties, plugin-configuraties of wereldbestanden wijzigt, maak je onder Back-ups een back-up aan. Zo kun je altijd terug naar de oude staat.

„Address already in use“: poort van server of plugin is bezet

Zo ziet de melding eruit:

**** FAILED TO BIND TO PORT!
java.net.BindException: Address already in use
io.netty.channel.unix.Errors$NativeIoException: bind(..) failed with error(-98): Address already in use

Wat er achter zit: Een poort accepteert netwerkverbindingen en is hier al in gebruik door een andere dienst. Kan Minecraft zijn spelpoort niet openen, dan start de server niet. Ook Geyser of Simple Voice Chat kunnen mislukken bij het openen van hun UDP-poort; UDP is een netwerkprotocol dat bijvoorbeeld voor spraakdata wordt gebruikt. Dan valt de betreffende koppeling uit; of de server blijft draaien, zie je in de volgende logregels.

Zo los je het op:

  1. Lees de regels vóór en na de fout. Aanwijzingen zoals Voice chat server error of Failed to start the udp server helpen bij het toewijzen; een pluginnaam alleen zegt niet of de server blijft draaien.
  2. Gaat het om de spelpoort, stop de server dan volledig via de Console en start hem opnieuw. Het paneel beheert de spelpoort automatisch; wijzig server-port niet handmatig.
  3. Gaat het om een extra dienst, open dan onder Bestanden de plugin- of modconfiguratie ervan. Gebruik een toegewezen poort die geen andere dienst met hetzelfde netwerkprotocol gebruikt, of schakel de functie uit. Start daarna opnieuw op.
  4. Blijft de spelpoort bezet, open dan een ticket en vermeld het tijdstip van de melding.

Goed om te weten: Simple Voice Chat instellen.

„The server is running in online mode“: login-plugin start niet

Zo ziet de melding eruit:

[LibreLogin] !!!The server is running in online mode! LibreLogin won't start unless you set it to false!!!
[FastLogin] Server has to be in offline mode

Wat er achter zit: In de online-modus (online-mode=true in server.properties) controleert de server Java-accounts rechtstreeks bij Mojang. De betreffende inlogplugin verwacht een andere inlogconfiguratie en weigert daarom te starten of kan het inloggen niet beheren. Hierdoor valt het inloggen via deze plugin uit; de online-modus blijft actief en weigert spelers zonder geldig Minecraft-account nog steeds.

Zo los je het op:

  1. Moeten spelers met een geldig Minecraft-account direct kunnen joinen, laat dan online-mode=true staan. Stop de server, verwijder de betreffende inlogplugin onder Plugins en start opnieuw.
  2. Gebruik je een proxy, dus een voorgeschakelde server, controleer dan het inloggen daarvan, de beveiliging tegen directe verbindingen met de server erachter en de forwarding. Forwarding stuurt de bevestigde spelergegevens door naar die server.
  3. Zet online-mode=false onder Bestanden in server.properties uitsluitend achter een correct beveiligde proxy met juist ingestelde forwarding en bij een gestopte server. Zonder dit beveiligingsconcept blijft de online-modus ingeschakeld.
  4. Start na wijzigingen opnieuw op en controleer in de Console of de login-plugin zoals bedoeld start.

Goed om te weten: Zonder beveiligd inloggen kunnen vreemden spelersnamen overnemen. Meer informatie: Cracked-/offline-modus activeren.

De Minecraft-EULA is niet geaccepteerd

Zo ziet de melding eruit:

You need to agree to the EULA in order to run the server. Go to eula.txt for more info.

Wat erachter zit: De EULA is de licentieovereenkomst van Mojang resp. Microsoft voor Minecraft-servers. Een Java-server start pas als in het bestand eula.txt de regel eula=true staat. Ontbreekt die of staat er eula=false, dan stopt de server direct na het starten weer. Bij ons wordt deze waarde automatisch ingesteld. De melding verschijnt daarom meestal pas als eula.txt is verwijderd of overschreven, bijvoorbeeld bij het uploaden van eigen serverbestanden.

Zo los je het op:

  1. Open onder Bestanden in de hoofdmap van de server, waar ook server.properties staat, het bestand eula.txt.
  2. Verander eula=false in eula=true en sla op. Ontbreekt het bestand, maak het dan aan met precies deze ene regel.
  3. Start de server en volg het opstarten in de Console.

Goed om te weten: Met eula=true ga je akkoord met de voorwaarden van de Minecraft-EULA.

Uitgebreid: Minecraft-EULA en eerste serverstart

„… tried to join with an invalid session“: Minecraft-aanmelding geweigerd

Zo ziet de melding eruit:

Username '<Player>' tried to join with an invalid session

Wat erachter zit: De server kon de sessie van een Java-speler niet als geldig bevestigen en weigert de toegang in de online-modus (online-mode=true). Dit gebeurt bij clients zonder geldig, gekocht Minecraft-account, maar ook bij een verlopen sessie van een geldig account. Je server is gezond en draait gewoon door.

Zo los je het op:

  1. Vraag de speler of hij Minecraft: Java Edition met een Microsoft-account heeft gekocht en daarmee in de officiële launcher is aangemeld.
  2. Heeft hij een geldig account, dan moet hij de Minecraft-client helemaal afsluiten en opnieuw starten. Blijft de sessie ongeldig, dan moet hij zich in de launcher opnieuw aanmelden met het juiste account en het spel weer starten.
  3. Speelt hij met Bedrock op mobiel, console of Windows, dan kan hij in plaats daarvan via het crossplay-adres van je server meedoen, mits crossplay actief is.
  4. Schakel daarvoor niet handmatig de online-modus uit.

Goed om te weten: Wil je alleen echte accounts toelaten, dan hoef je niets te wijzigen. De melding laat dan zien dat de beveiliging werkt.

Uitgebreid: Cracked-server: inloggen en beperkingen

„Couldn't verify username because servers are unavailable“: Minecraft-aanmelding verstoord

Zo ziet de melding eruit:

Couldn't verify username because servers are unavailable

Wat erachter zit: In de online-modus vraagt de server bij elke join aan de aanmeldservers van Mojang of Microsoft of het account echt is. Reageren die op dat moment niet, dan kan de server het account niet controleren en laat hij de speler niet binnen. Dit ligt niet aan je server: bij een storing daar worden alle servers met actieve premium-controle tegelijk getroffen. Nieuwe spelers komen zolang niet op de server, wie al online is, speelt meestal gewoon door.

Zo los je het op:

  1. Wacht de storing af. Meestal lost die zichzelf binnen een paar minuten op.
  2. Controleer de officiële storingsmeldingen van Minecraft of Mojang/Microsoft.
  3. Vraag je spelers het over een paar minuten opnieuw te proberen.
  4. Schakel daarvoor online-mode niet uit. Daarmee zet je je server permanent open voor valse accounts in plaats van een kortdurend probleem op te lossen.

Goed om te weten: Komen spelers op andere servers zonder problemen binnen en houdt de melding bij jou lang aan, open dan een ticket en geef het tijdstip van de melding door.

„Unable to initialise query system“: query-poort is bezet

Zo ziet de melding eruit:

Unable to initialise query system on <IP>:<Port>
java.net.BindException: Address already in use

Wat er achter zit: Query is een extra interface via het netwerkprotocol UDP, waarmee serverlijsten en tools het aantal spelers en de online-status opvragen. Start het niet, dan ontbreken deze gegevens via Query. Het spelen zelf wordt niet beïnvloed, spelers kunnen gewoon joinen. De BindException eronder toont de reden: de query-poort is al bezet of botst met een andere dienst, bijvoorbeeld Geyser of een voice-chat-plugin op dezelfde UDP-poort.

Zo los je het op:

  1. Bekijk in het paneel welke poorten aan je server zijn toegewezen en welke daarvan al door Geyser of een voice-chat-plugin worden gebruikt.
  2. Stop de server en open onder Bestanden het bestand server.properties.
  3. Zet enable-query=true en vul bij query.port een toegewezen poort in die geen andere UDP-dienst gebruikt.
  4. Sla op en start de server opnieuw. Controleer in de Console of de melding wegblijft.

Het servericoon is niet 64 × 64 pixels

Zo ziet de melding eruit:

Couldn't load server icon
java.lang.IllegalArgumentException: Invalid world icon size [<Breedte>, <Hoogte>], but expected [64, 64]

Wat erachter zit: De afbeelding server-icon.png in de hoofdmap verschijnt in de serverlijst van de spelers naast de servernaam. Minecraft accepteert hiervoor uitsluitend een PNG van precies 64 × 64 pixels. Heeft de afbeelding een ander formaat, dan laadt de server hem niet en zien de spelers geen eigen icoon. De server draait gewoon verder.

Zo los je het op:

  1. Open je afbeelding in een beeldbewerkingsprogramma en schaal hem naar precies 64 × 64 pixels.
  2. Sla hem op als PNG met de naam server-icon.png.
  3. Upload hem onder Bestanden naar de hoofdmap van de server en vervang het oude bestand.
  4. Herstart de server. Het nieuwe icoon verschijnt zodra spelers hun serverlijst vernieuwen.

Goed om te weten: Wil je geen eigen icoon, verwijder dan server-icon.png en herstart de server. De melding verdwijnt dan ook.

Een client heeft een ongeldig inlogpakket gestuurd

Zo ziet de melding eruit:

Failed to decode packet 'serverbound/minecraft:hello'

Wat erachter zit: "hello" is het eerste pakket dat een client bij het inloggen verstuurt, onder andere met de spelersnaam. Kon de server het niet lezen, dan past de client niet bij de serverversie of het verwachte protocol, bijvoorbeeld door een andere Minecraft-versie of een ontbrekende modloader. De server verbreekt alleen deze ene verbinding en draait verder.

Zo los je het op:

  1. Controleer of er op dat tijdstip een speler wilde joinen en dat niet is gelukt.
  2. Zo ja, vergelijk dan zijn Minecraft-versie met de versie van je server onder Versie. Bij een Modpack heeft hij hetzelfde pack met dezelfde modloader nodig.
  3. Wilde niemand joinen, dan was het meestal een automatische poortscanner die servers op internet aftast. Dan hoef je niets te doen.

Goed om te weten: Moeten spelers met andere clientversies kunnen joinen, dan helpt op Paper-servers ViaVersion.

De proxy bereikt de doelserver niet op tijd

Zo ziet de melding eruit:

io.netty.channel.ConnectTimeoutException: connection timed out after <Milliseconden> ms: /<Adres>:<Poort>

Wat erachter zit: Een proxy zoals Velocity of BungeeCord is de ingangsserver waarlangs spelers joinen en vervolgens worden verdeeld over de ingestelde doelservers. Hier wilde de proxy een doelserver bereiken en kreeg binnen de wachttijd geen antwoord. Meestal kloppen het adres of de poort niet, of de doelserver is offline of slaapt. Spelers komen dan niet op die doelserver, de proxy zelf draait verder.

Zo los je het op:

  1. Lees aan het einde van de melding af welk adres en welke poort de proxy wilde bereiken.
  2. Vergelijk ze in velocity.toml (sectie [servers]) of in de config.yml van BungeeCord (sectie servers) met de gegevens die het paneel voor de doelserver toont. Ze moeten exact overeenkomen.
  3. Start de doelserver en wacht tot hij volledig is opgestart. Slapende servers wek je eerst op.
  4. Herstart de proxy zodat hij gewijzigde items overneemt, en test het joinen.

Uitgebreid: BungeeCord: Could not connect to a default or fallback server

De Velocity-ondersteuning is ingeschakeld zonder secret

Zo ziet de melding eruit:

Velocity is enabled, but no secret key was specified. A secret key is required. Disabling velocity...

Wat erachter zit: Velocity is een proxy die spelers doorstuurt naar Paper-servers. Zodat Paper deze doorverwijzingen kan vertrouwen, delen proxy en server een gezamenlijk geheim woord, het secret. In de Paper-configuratie is de Velocity-ondersteuning ingeschakeld, maar het secret ontbreekt. Paper schakelt de ondersteuning daarom uit en het doorsturen van spelers via de proxy werkt niet.

Zo los je het op:

  1. Haal het secret op bij de Velocity-proxy. Bij actuele Velocity-versies staat het in het bestand forwarding.secret waarnaar velocity.toml verwijst, bij oudere direct in velocity.toml.
  2. Open op de Paper-server onder Bestanden het bestand config/paper-global.yml en zoek de sectie proxies → velocity.
  3. Zet enabled: true en vul bij secret precies hetzelfde secret in.
  4. Gebruik je helemaal geen Velocity-proxy, zet daar dan juist enabled: false.
  5. Herstart de Paper-server en controleer of de melding verdwenen is.

Goed om te weten: In velocity.toml moet hiervoor player-info-forwarding-mode op modern staan. Bij Paper-versies vóór 1.19 staat de instelling niet in config/paper-global.yml, maar in paper.yml onder settings → velocity-support. Behandel het secret als een wachtwoord.

De doelserver weigert de verbinding van de proxy

Zo ziet de melding eruit:

io.netty.channel.AbstractChannel$AnnotatedConnectException: finishConnect(..) failed with error(-111): Connection refused: /<Adres>:<Poort>

Wat erachter zit: De proxy heeft het ingestelde adres van de doelserver bereikt, maar daar neemt geen dienst op de poort verbindingen aan. Anders dan bij een time-out reageert het adres dus wel, er luistert alleen niets. Typische oorzaken: de doelserver is gestopt, is nog aan het opstarten, of de poort in de proxy hoort niet bij deze server. Spelers komen zolang niet op deze doelserver.

Zo los je het op:

  1. Lees aan het einde van de melding adres en poort af.
  2. Start de doelserver en wacht in zijn Console tot hij volledig is gestart.
  3. Vergelijk adres en poort in velocity.toml of in de config.yml van BungeeCord met de gegevens die het paneel voor de doelserver toont.
  4. Vul niet 127.0.0.1 in als proxy en doelserver aparte servers zijn. Dat adres wijst naar de proxy zelf.

Goed om te weten: Terwijl een doelserver opnieuw opstart, is de melding normaal en verdwijnt hij vanzelf.

Uitgebreid: BungeeCord: Could not connect to a default or fallback server

Servericoon heeft het verkeerde afbeeldingsformaat

Zo ziet de melding eruit:

Couldn't load server icon
java.io.IOException: Bad PNG Signature: <File signature>

Wat erachter zit: Minecraft verwacht voor het servericoon een PNG-bestand. De bestandssignatuur, oftewel de herkenning aan het begin van het bestand, past hier niet bij PNG. Daarom verschijnt de gewenste afbeelding niet in de serverlijst; de server draait gewoon door.

Zo los je het op:

  1. Open de gewenste afbeelding in een beeldbewerkingsprogramma en exporteer die uitdrukkelijk als PNG. Stel daarbij 64 × 64 pixels in.
  2. Vervang onder Bestanden het bestand server-icon.png in de hoofdmap van de server door de nieuw geëxporteerde afbeelding.
  3. Start de server opnieuw en controleer in de Console of de melding verdwenen is. Ververs daarna de serverlijst in de Minecraft-client.

Goed om te weten: Een JPEG-bestand hernoemen naar .png verandert het afbeeldingsformaat niet.

Staat jouw melding er niet bij?

Lees de hele melding in de Console of in logs/latest.log, ook de regels direct ervoor. Vaak staat daar wat er als eerste misging. Volgt er een stacktrace, dus een lijst met regels die beginnen met „at“, dan verraden map- en bestandsnamen daarin zoals plugins/<Plugin> of <Plugin>.jar de betrokken plugin of mod. Lees bij proxyproblemen de logs van de proxy en de doelserver van hetzelfde tijdstip. Maak vóór wijzigingen een back-up aan. Kom je er niet uit, open dan een ticket en noem het tijdstip van de melding.