In dit artikel leggen we uit hoe je op een veilige manier de Minecraft-versie van je server upgradet, zonder dat je wereld, plugins of data kwijtraken.

Let op! Een versie-upgrade kan niet ongedaan worden gemaakt. Zodra je wereld op een nieuwere Minecraft-versie is geopend, kan deze niet meer terug naar de oudere versie. Maak daarom altijd eerst een back-up voordat je gaat upgraden.

Wat heb je nodig?

• Toegang tot het Gamepaneel
• Een Minecraft-server bij Etheron
• Een paar minuten voor het maken van een back-up

Stap 1. Controleer je huidige versie

Voordat je iets wijzigt, is het belangrijk om te weten welke versie en welke serversoftware je nu draait (bijvoorbeeld Paper, Spigot of Vanilla).

1. Log in op het Gamepaneel en kies je server.
2. Bekijk in het overzicht welke serversoftware en welke Minecraft-versie momenteel actief zijn.
3. Noteer deze versie. Je hebt deze later nodig als je wilt teruggaan naar de oude situatie.

Stap 2. Maak eerst een back-up

Dit is de belangrijkste stap. Zonder een goede back-up kun je niet meer terug naar de oude versie als er iets misgaat.

1. Ga in het Gamepaneel naar je server en klik links op Backups.
2. Klik rechtsboven op Create Backup.
3. Geef de back-up een duidelijke naam, bijvoorbeeld voor-upgrade-1.20-naar-1.21, en klik op Start Backup.
4. Wacht tot de back-up volledig is afgerond voordat je verdergaat.

Let op! Controleer of de back-up echt is geslaagd. Een back-up die niet compleet is, heeft geen zin op het moment dat je hem nodig hebt.

Stap 3. Controleer of de nieuwe versie al beschikbaar is voor jouw serversoftware

Niet elke nieuwe Minecraft-versie is meteen beschikbaar voor elke serversoftware. Vooral bij Paper, Spigot en veel modded-platforms duurt het vaak enige tijd na een Minecraft-update voordat er een stabiele build beschikbaar is.

Controleer dit voordat je gaat upgraden:

• Paper: kijk op de officiële PaperMC downloads-pagina. Zoek jouw gewenste Minecraft-versie op. Staat er geen stabiele build (of alleen een build met een waarschuwing/experimenteel label), dan is de versie nog niet klaar voor productiegebruik.
• Spigot/Bukkit: kijk op SpigotMC of de betreffende build al als stabiel wordt aangemerkt.
• Modded servers (Forge/Fabric/NeoForge): controleer of de modloader zelf al een stabiele release heeft voor de nieuwe Minecraft-versie, dit duurt vaak langer dan bij Paper/Spigot.

Let op! Als er voor jouw serversoftware nog geen stabiele build is voor de nieuwe versie, raden we aan om te wachten. Upgraden naar een build die nog experimenteel is, kan zorgen voor crashes, corrupte werelden of rare bugs.

Stap 4. Controleer je plugins/mods op compatibiliteit

Dit is de stap die de meeste problemen voorkomt. Plugins en mods zijn gebouwd voor een specifieke Minecraft-versie en werken niet altijd automatisch mee met een nieuwere versie.

1. Maak een lijst van alle plugins/mods die op je server draaien.
2. Controleer per plugin/mod op de pagina van de ontwikkelaar (bijvoorbeeld SpigotMC, Modrinth of CurseForge) of er al een versie beschikbaar is die jouw nieuwe Minecraft-versie ondersteunt.
3. Verdeel je plugins/mods in drie groepen:
   • Wordt al ondersteund: je kunt de nieuwste versie van de plugin/mod downloaden.
   • Nog niet bijgewerkt, maar wel actief onderhouden: overweeg te wachten tot de ontwikkelaar een update uitbrengt.
   • Niet meer onderhouden: zoek een alternatief, of houd er rekening mee dat deze functionaliteit (tijdelijk) wegvalt.

Let op! Een plugin die niet compatibel is met de nieuwe versie, kan ervoor zorgen dat je server niet meer opstart, of dat bepaalde functies stoppen met werken. Upgrade daarom nooit alle plugins/mods blind tegelijk met de serverversie zonder dit te controleren.

Stap 5. Voer de upgrade uit

Zodra je een geslaagde back-up hebt en hebt gecontroleerd dat zowel de serversoftware als je plugins/mods klaar zijn voor de nieuwe versie, kun je de upgrade uitvoeren.

1. Log in op het Gamepaneel en kies je server.
2. Klik in het menu op More > Version Changer.
3. Kies de gewenste nieuwe Minecraft-versie en serversoftware.
4. Klik op View, en daarna op Install bij de gewenste versie.

Let op! Vink WIPE SERVER FILES niet aan, tenzij je bewust een volledig schone server wilt. Hiermee wordt namelijk alles op je Minecraft-server verwijderd.

1. Wacht tot de installatie volledig is afgerond.
2. Start je server en volg de opstart-log. Foutmeldingen over plugins staan meestal direct na het opstarten in de log.

Stap 6. Update je plugins/mods naar de nieuwe versie

1. Vervang de oude pluginbestanden door de nieuwe, compatibele versies.
2. Verwijder oude, niet-compatibele pluginbestanden uit de plugins-map om opstartfouten te voorkomen.
3. Start de server opnieuw op en controleer de log op foutmeldingen zoals NoSuchMethodError of Plugin failed to load. Dit wijst bijna altijd op een verouderde of niet-ondersteunde plugin.

Stap 7. Test grondig voordat je spelers weer toelaat

• Log zelf in en loop een stukje door de wereld.
• Controleer of belangrijke plugins (zoals permissies, economy of protection-plugins) goed werken.
• Controleer of oude instellingen (bijvoorbeeld rechten, claims of economy-data) goed zijn meegenomen.
• Houd de server de eerste uren goed in de gaten; sommige problemen komen pas naar boven zodra spelers weer actief zijn.

Problemen oplossen

• Server start niet meer op: bekijk de laatste regels van de opstart-log. Vaak wordt hier direct genoemd welke plugin of welk onderdeel het probleem veroorzaakt.
• Plugin geeft foutmeldingen: controleer of er een nieuwere versie van de plugin beschikbaar is voor jouw Minecraft-versie.
• Spelers kunnen niet meer verbinden: controleer of hun Minecraft-launcher/client overeenkomt met de nieuwe serverversie.
• Iets is misgegaan en je wilt terug: herstel de back-up die je in stap 2 hebt gemaakt via Backups in het Gamepaneel.

Lukt het niet, of wil je liever hulp bij het upgraden van je Minecraft-server? Neem dan contact met ons op via Discord of maak een ticket aan.