Veelvoorkomende fouten van een Minecraft-server en hoe je ze oplost

Hier vind je de meest voorkomende foutmeldingen van de Minecraft-server en van het spel zelf, met uitleg over wat ze betekenen en hoe je ze oplost. We geven de meldingen exact in het Engels weer, zoals je ze te zien krijgt, zodat je ze gewoon kunt opzoeken (Ctrl+F of de zoekfunctie in de handleidingen).

Zo lees je de log#

De server schrijft alles wat hij doet naar de console en naar bestanden:

Zo vind je de oorzaak in de log:

1. Zoek de eerste regel met ERROR of Exception: de fouten daarna zijn meestal alleen gevolgen.
2. Onder de fout staat de stacktrace (regels die beginnen met at …). Zoek daarin de naam van een plugin of mod: die is vaak te zien in de naam van het package, bijvoorbeeld at com.example.mujplugin.….
3. Staan er in de stacktrace regels met Caused by:, dan staat de echte oorzaak meestal in de laatste daarvan.
4. Regels met WARN zijn waarschuwingen. De server draait meestal gewoon door en je hoeft er niets mee te doen, tenzij iets niet meer werkt.

Het bestand logs/latest.log download je op het tabblad Bestanden met de knop Downloaden, of je opent het direct in de editor.

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

Oorzaak: Je hebt de licentievoorwaarden van Minecraft (EULA) niet geaccepteerd. De server sluit zichzelf direct na de start af.

Oplossing:

1. Open het tabblad Software.
2. Klik in het blok Minecraft EULA op EULA accepteren.

Op je eigen VPS open je het bestand eula.txt in de map van de server en verander je eula=false in eula=true. Meer uitleg staat in de handleiding Eerste start en de EULA.

**** FAILED TO BIND TO PORT!#

De volledige melding:

**** FAILED TO BIND TO PORT!
The exception was: java.net.BindException: Address already in use
Perhaps a server is already running on that port?

Oorzaak: De poort waarop de server moet luisteren, wordt al door een ander programma gebruikt.

Oplossing bij ons: het adres en de poort van de server stellen wij automatisch in, dus de oorzaak is meestal:

• de vorige serversessie is nog niet afgesloten: klik op Stoppen, wacht een halve minuut en klik dan op Starten,
• een plugin of mod (webkaart, voicechat, Geyser) is ingesteld op de poort van de server: stel in de configuratie ervan een andere poort van het tabblad Netwerk in (Poort toevoegen).

Blijft de fout bestaan, stuur dan een bericht naar support.

Oplossing op je eigen VPS: zoek uit wat de poort gebruikt:

ss -tulpn | grep 25565

• ss -tulpn – toont de luisterende TCP- en UDP-poorten, inclusief de programma's die ze gebruiken.
• grep 25565 – laat alleen de regels met poort 25565 over (vul je eigen poort in).

Sluit het andere programma af (vaak een vergeten server die nog draait), of gebruik een andere poort.

Een vergelijkbare fout Address already in use bij Geyser betekent dat er op dezelfde UDP-poort iets anders draait, meestal Query. Zie Crossplay met Bedrock.

java.lang.UnsupportedClassVersionError#

De volledige melding ziet er bijvoorbeeld zo uit:

java.lang.UnsupportedClassVersionError: com/example/plugin/Main 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

Oorzaak: De server of een plugin heeft een nieuwere Java nodig dan die waarop de server draait. De nummers bij “class file version” komen overeen met Java-versies:

In het voorbeeld heeft de plugin Java 25 (69) nodig, maar de server draait op Java 21 (65).

Oplossing:

• Fout bij een plugin of mod: Java kiezen wij automatisch op basis van de Minecraft-versie (tot en met 1.16.5 Java 8, 1.17 Java 16, 1.18–⁠1.20.4 Java 17, 1.20.5–⁠1.21.x Java 21, 26.x Java 25). Download de versie van de plugin die voor jouw Minecraft-versie bedoeld is, of werk de server bij naar een nieuwere Minecraft-versie (handleiding).
• Fout bij de server zelf (in de melding staat een klasse van de server, niet van een plugin): de server is waarschijnlijk niet via het tabblad Software geïnstalleerd. Gebruik Software › Opnieuw installeren, of Import en kies het werkelijke type en de werkelijke versie: het klantaccount stelt dan de juiste Java in.

Incompatible client! Please use …#

In oudere versies van het spel Outdated client! Please use … of Outdated server! I'm still on …. In de serverlijst staat bij de server in het rood Incompatible version!.

Oorzaak: De speler heeft een andere versie van het spel dan de server. Achter de melding staat de versie die de server vereist.

Oplossing:

• De speler kiest in de launcher dezelfde versie als de server (de versie van de server zie je op het tabblad Software).
• Wil je dat spelers met een nieuwere versie van het spel kunnen verbinden, installeer dan op de server (Paper, Purpur) de plugin ViaVersion. Voor spelers met een oudere versie daarnaast ook ViaBackwards.
• Bij gemodde servers moet de speler exact dezelfde versie van het spel, de loader en de mods hebben.

Failed to connect to the server / Connection refused#

In de serverlijst staat bij de server Can't connect to server.

Oorzaak: Op het ingevoerde adres en de ingevoerde poort luistert niets.

Oplossing:

1. Controleer op het tabblad Console of de server draait en of in de console de regel Done (…)! For help, type "help" staat. Zolang de server nog opstart, kun je niet verbinden.
2. Vergelijk het adres dat de speler heeft ingevoerd met het Verbindingsadres op het tabblad Netwerk, inclusief de poort achter de dubbele punt.
3. Verbindt de speler via een domein, controleer dan de DNS-records met de handleiding Serveradres en domein.
4. Controleer de server met de tool Minecraft Status.

Can't resolve hostname#

Oorzaak: Het spel heeft het ingevoerde domein niet in DNS gevonden (een typefout, een ontbrekend A-record, of de wijziging is nog niet overal doorgevoerd).

Oplossing: Controleer het adres en de DNS-records met de handleiding Serveradres en domein. In de tussentijd kunnen spelers verbinden via het IP-adres en de poort van het tabblad Netwerk.

Can't keep up! Is the server overloaded? Running 2500ms or 50 ticks behind#

Oorzaak: De server kan het spel niet bijhouden. In het voorbeeld loopt hij 2,5 seconden (50 ticks) achter.

Oplossing: Eén melding bij het opstarten of bij het genereren van nieuw terrein is geen probleem. Herhaalt de melding zich, dan heeft de server lag. Hoe je de oorzaak zoekt (spark, view distance, de wereld vooraf genereren), staat in de handleiding Prestaties van een Minecraft-server.

java.lang.OutOfMemoryError: Java heap space#

Of de server sluit zichzelf af zonder fout in de log (de laatste regels van logs/latest.log gaan niet over afsluiten, Stopping server ontbreekt) en in de Console staan de regels Exit code: 137 en Out of memory: true.

Oorzaak: Het geheugen is op. Java heap space betekent dat de heap vol is: op de server staan meer gegevens dan erin passen (een grote modpack, veel spelers, een enorme wereld), of een plugin of mod “lekt” geheugen. Afsluiten zonder fout betekent dat het totale geheugen van Java (de heap plus het geheugen daarbuiten) de limiet van het pakket heeft overschreden en dat het systeem de server heeft beëindigd. OutOfMemoryError: Direct buffer memory of Metaspace wijst op een plugin of mod die tegen de limiet van de netwerkbuffers of van de geladen klassen is aangelopen.

Oplossing:

1. Controleer op het tabblad Opstarten de waarschuwingen bij de startflags. Is de heap te groot voor het pakket of heeft het commando geen geheugenlimieten, klik dan op Aanbevolen gebruiken. Na een pakketwijziging worden de flags vanzelf opnieuw berekend.
2. Voer in de console spark health uit en houd het geheugen in de gaten. Blijft het na het opruimen bijna vol, voer dan spark heapsummary uit: dat laat zien wat het geheugen inneemt.
3. Gaat het om normale belasting, stap dan over op een groter pakket op het tabblad Pakket wijzigen.

Meer details staan in de handleiding Prestaties van een Minecraft-server.

Failed to verify username!#

De speler kan in het spel ook Failed to log in: Invalid session (Try restarting your game and the launcher) of Authentication servers are down. Please try again later. Sorry! te zien krijgen.

Oorzaak: De server (met online-mode=true) kon het account van de speler niet bij Microsoft verifiëren. De aanmelding van de speler is verlopen, de verificatieservers hebben een storing, of de speler gebruikt geen origineel spel.

Oplossing:

• De speler sluit het spel en de launcher helemaal af, logt uit, logt opnieuw in en probeert het nog eens.
• Wacht af bij een storing van de verificatieservers.
• online-mode uitschakelen raden we af: dan komt iedereen onder elke willekeurige naam binnen (waarom).

You are not white-listed on this server!#

Oorzaak: De whitelist staat aan en de speler staat er niet op. Sinds versie 26.3 staat de whitelist ook op een nieuw aangemaakte server aan.

Oplossing: Voer in de console whitelist add <NICK> in (vervang <NICK> door de naam van de speler, zonder de punthaken). Bedrock-spelers voeg je toe met het commando fwhitelist add <NICK>. De whitelist zet je uit op het tabblad Serverinstellingen (Whitelist). Meer uitleg staat in de handleiding Whitelist, operators en bans.

Multiplayer is disabled. Please check your Microsoft account settings.#

Oorzaak: Multiplayer is voor het account van de speler niet toegestaan (meestal een kinderaccount of de privacy-instellingen van Xbox).

Oplossing: De speler (of een ouder) staat multiplayer toe in de instellingen van het Microsoft- / Xbox-account. Op de server valt hier niets in te stellen.

Expired profile public key. Check that your system time is synchronized, and try restarting your game.#

Oorzaak: De tijd op de computer van de speler is verkeerd ingesteld.

Oplossing: De speler zet in het systeem de automatische tijdinstelling aan en start het spel opnieuw.

The server is full!#

Oorzaak: Er zijn zoveel spelers verbonden als max-players toestaat.

Oplossing: Verhoog Maximumaantal spelers op het tabblad Serverinstellingen en herstart de server. Let op de prestaties: meer spelers betekent meer belasting.

Could not load 'plugins/….jar' in 'plugins'#

De meldingen Could not load plugin '….jar' in folder 'plugins' en, in oudere versies, Could not load 'plugins/….jar' in folder 'plugins' zien er vergelijkbaar uit. Onder de melding staat meestal een toelichting, het vaakst:

org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [Vault]. Please download and install these plugins to run 'MujPlugin'.

Oorzaak: De plugin heeft een andere plugin nodig (een afhankelijkheid) die op de server ontbreekt, in het voorbeeld Vault.

Oplossing: Installeer de ontbrekende plugin die tussen de vierkante haken staat. Bij installatie via het tabblad Plugins worden verplichte afhankelijkheden vanzelf aangeboden. Andere oorzaken van deze melding: een beschadigd bestand (download het opnieuw), een plugin voor een ander servertype (een mod voor Fabric in de map plugins) of voor een andere Minecraft-versie. Meer in de handleiding Plugins installeren.

Error occurred while enabling … (Is it up to date?)#

Oorzaak: De plugin is geladen, maar is bij het inschakelen gecrasht. Meestal is hij voor een andere Minecraft-versie bedoeld, zit er een fout in de configuratie, of kon hij geen verbinding maken met de database.

Oplossing:

1. Zoek onder de melding de laatste regel met Caused by:: die vertelt wat er is gebeurd.
2. Controleer of de versie van de plugin jouw serverversie ondersteunt (tabblad Plugins › Controleren op updates).
3. Een fout in de configuratie (.yml): die herken je meestal aan de woorden YAML, ScannerException of mapping values are not allowed here en een regelnummer. Herstel de inspringing (alleen spaties) of verwijder het configuratiebestand van de plugin: bij de start wordt een standaardbestand aangemaakt.
4. Een databasefout: zie MySQL voor plugins.

Mods: Incompatible mods found!#

Een server met Fabric start niet en onder de melding staat bijvoorbeeld:

Incompatible mods found!
A potential solution has been determined, this may resolve your problem:
    - Install fabric-api, any version.

Oorzaak: Een mod heeft een andere mod nodig (vaak Fabric API) of een andere versie van Minecraft of van de loader. Fabric toont de exacte oplossing (Install …, Replace …, Remove …).

Oplossing: Doe wat Fabric voorstelt. Een regel in de vorm <MOD> requires <VERSIE> of <AFHANKELIJKHEID>, which is missing! vertelt wat er ontbreekt.

Mods: Attempted to load class … for invalid dist DEDICATED_SERVER#

Oorzaak: Op de server staat een mod die alleen voor het spel (de client) bedoeld is, bijvoorbeeld een minimap, shaders of een aanpassing van het menu. De server kan hem niet laden.

Oplossing: Zoek in de melding of in het crashrapport de naam van de mod en verwijder hem uit de map mods (of op het tabblad Mods). Clientmods installeren spelers alleen in hun eigen spel. Meer in de handleiding Mods en modpacks.

Mods: bij het verbinden wordt de speler losgekoppeld met een lijst van mods#

Oorzaak: De speler heeft niet dezelfde mods als de server, of niet dezelfde versies ervan.

Oplossing: Spelers moeten dezelfde modpack in dezelfde versie hebben als de server. Ze downloaden de modpack van dezelfde bron (Modrinth, CurseForge) en kiezen dezelfde versie.

Beschadigde chunk: Failed to read chunk [x, z]#

Andere vergelijkbare meldingen: Region file … has truncated header, Failed to read chunks from region file ….

Oorzaak: Een deel van de wereld is beschadigd, meestal na een crash van de server of doordat het opslaan niet is afgerond.

Oplossing:

1. Het veiligst is een back-up herstellen via het tabblad Back-ups (handleiding).
2. Zonder back-up kun je alleen het beschadigde regiobestand verwijderen. Een regio is een bestand r.<X>.<Z>.mca, waarbij <X> en <Z> de chunkcoördinaten uit de melding zijn, gedeeld door 32 en naar beneden afgerond (chunk [70, -5] zit in r.2.-1.mca). Je vindt het in de map world/dimensions/minecraft/overworld/region (vanaf versie 26.1), in oudere versies in world/region.

De melding Chunk file at [x, z] is in the wrong location; relocating. is geen fout: de server heeft de chunk zelf naar de juiste plek verplaatst.

Failed to load datapacks, can't proceed with server load.#

Oorzaak: Een datapack in de wereld is beschadigd of bedoeld voor een andere Minecraft-versie (vaak na een versiewijziging).

Oplossing: Open op het tabblad Bestanden de map world/datapacks, verplaats de defecte datapack naar een andere plek (of verwijder hem) en start de server. Welke het is, zie je aan de regels boven de melding. Weet je het niet, herstel dan een back-up van vóór de versiewijziging.

Timed out / Connection Lost#

Oorzaak: De verbinding tussen het spel en de server is verbroken. Ofwel aan de kant van de speler (wifi, mobiele verbinding), ofwel de server is even vastgelopen en kon niet op tijd antwoorden.

Oplossing:

• Eén speler is losgekoppeld: het probleem zit in de verbinding van die speler. Die probeert een kabel of een ander netwerk.
• Iedereen is tegelijk losgekoppeld: de server is vastgelopen. Zoek in de console naar Can't keep up! of naar meldingen van de watchdog (zie hieronder) en volg de handleiding Prestaties van een Minecraft-server.

De server loopt vast en sluit af: A single server tick took 60.00 seconds (should be max 0.05)#

Zo ziet het eruit op Vanilla, Fabric en NeoForge. Daarna volgt Considering it to be crashed, server will forcibly shutdown.

Op Paper en Purpur bewaakt hun eigen waakhond (watchdog) het vastlopen en zijn de meldingen anders. Al na 10 seconden vastlopen verschijnt herhaaldelijk --- DO NOT REPORT THIS TO PAPER - THIS IS NOT A BUG OR A CRASH met een dump van de hoofdthread. Duurt het vastlopen 60 seconden, dan verschijnt een blok dat begint met The server has stopped responding! This is (probably) not a Paper bug. met een dump van de threads (thread dump), en de server sluit af.

Oorzaak: Eén tick duurde langer dan 60 seconden, de server concludeerde dat hij was vastgelopen en sloot af. De limiet wordt bepaald door max-tick-time in server.properties (Vanilla, Fabric, NeoForge), en op Paper en Purpur door settings.timeout-time in spigot.yml. Meestal wacht een plugin in de hoofdthread op een database of op het internet, of het gaat om een enorm redstonebouwwerk of een explosie van duizenden TNT.

Oplossing: Zoek in de thread dump de Server thread (op Paper het blok Server thread dump) en daarin de naam van een plugin of mod. Werk de plugin bij of verwijder hem. Verhoog de limiet niet en schakel hem niet uit: een vastgelopen server zou dan lang of eindeloos blijven hangen.

Console: Unknown or incomplete command. See below for error#

Oorzaak: Het commando bestaat niet (een typefout), of het hoort bij een plugin die niet is geladen.

Oplossing: Controleer de naam van het commando en, onder de melding, de plek die met <--[HERE] is gemarkeerd: daar zit de fout. In de console typ je commando's zonder schuine streep. Een lijst met commando's vind je in de handleiding Console en commando's.

Klantaccount: De parameters zijn niet compatibel, teruggezet naar de vorige instellingen.#

Oorzaak: De server is met de nieuwe startflags niet opgestart en het klantaccount heeft ze teruggezet.

Oplossing: Controleer op het tabblad Opstarten de Eigen parameters (een typefout, een flag voor een andere Java-versie) of kies de standaardpreset Aanbevolen (G1). Meer in de handleiding Prestaties van een Minecraft-server.

Als iets ook na de oplossing niet werkt#

Stuur ons een bericht en stuur mee:

• het ID van de dienst of de naam van de server (die vind je bij Mijn diensten),
• wat je vlak voor de fout hebt gedaan (een update, een nieuwe plugin, een versiewijziging),
• het bestand logs/latest.log (download het op het tabblad Bestanden) en eventueel het nieuwste bestand uit de map crash-reports,
• bij lag de link naar het profiel van spark profiler start --timeout 600,
• het exacte tijdstip waarop de fout optrad.

Stuur nooit wachtwoorden of de inhoud van key.pem of forwarding.secret mee.

Meer bronnen#

• Server op de Minecraft Wiki (opent in een nieuw venster)
• Documentatie van Paper (opent in een nieuw venster)
• Profileren met spark (opent in een nieuw venster)