Hoe verander ik de Java-versie van mijn Minecraft-server?

Elke Minecraft-versie vraagt een bepaalde Java-versie: Minecraft 26.1 en nieuwer draait op Java 25, 1.20.5 tot en met 1.21 op Java 21, 1.18 tot 1.20.4 op Java 17, en oude modpacks op 1.12 en 1.16 op Java 8. Klopt de Java-versie niet, dan start de server niet en zie je in de console een foutmelding als UnsupportedClassVersionError. In ons paneel wissel je van Java-versie door een andere Docker image te kiezen.

Java-versie wisselen in het paneel

1. Ga naar het gamepaneel en klik op je server.
2. Open de pagina Instellingen.
3. Kies onder Docker image de gewenste Java-versie, bijvoorbeeld Java 25 voor Minecraft 26.x of Java 17 voor een 1.20-modpack.
4. Sla op en herstart de server. Bij de eerste start met een nieuwe image kan het opstarten een halve minuut langer duren.

Je wereld, plugins en instellingen blijven onaangetast: de Java-versie is alleen de omgeving waarin de server draait. Een backup vooraf is toch verstandig, omdat een plugin of mod die van de oude Java afhing kan weigeren te starten.

Welke Java bij welke versie

• 26.1, 26.2, 26.3: Java 25 (minimaal).
• 1.20.5 tot en met 1.21.x: Java 21.
• 1.18 tot en met 1.20.4: Java 17.
• 1.17: Java 16 (Java 17 werkt meestal ook).
• 1.16.5 en ouder: Java 8; nieuwere Java's breken Forge uit die tijd.

De vuistregel: neem de versie die Mojang minimaal eist, niet een veel nieuwere. Een uitgebreide tabel met uitleg over de foutmeldingen staat in ons blogartikel welke Java-versie je Minecraft-server nodig heeft.

De foutmelding herkennen

Staat er in de console class file version 69.0 ... only recognizes class file versions up to 65.0, dan wil de server Java 25 en draait hij op Java 21. De getallen vertalen zich zo: 52 = Java 8, 61 = Java 17, 65 = Java 21, 69 = Java 25. Is Java juist te nieuw voor een oude modpack, dan zie je meldingen over module java.base does not export of ClassCastException; kies dan een oudere image.

Controleren welke versie actief is

Bij het opstarten meldt Paper in de eerste regels van de console welke Java-versie wordt gebruikt. Op elke server werkt ook het commando about (Paper/Purpur) of version (vanilla) in de console; de serverversie staat daar direct bij. Zie ook hoe zie ik mijn Minecraft-versie.

Na een update van Minecraft

Update je de server naar een versie die een nieuwere Java vereist (bijvoorbeeld van 1.21 naar 26.x), doe dat dan in deze volgorde: backup maken, Docker image op Java 25 zetten, daarna pas de serverversie wisselen in de versiekiezer, en dan de plugins bijwerken. Andersom start de server tussentijds niet, wat de versiewissel kan onderbreken.

Draai je op een VPS?

Op een VPS is er geen Docker image; daar installeer je Java zelf en kies je per server welke java het startscript gebruikt. Zie Java installeren op je VPS.

Start de server ook met de juiste image niet, stuur dan de eerste twintig regels van de console mee in een ticket; daar staat vrijwel altijd wat er mis is.