ViaVersion verbindt nieuwere Minecraft-Java-clients met een oudere Java-server. ViaBackwards vult de andere richting aan voor oudere clients. Beide vertalen het netwerkprotocol; ze werken de serverversie niet bij en voegen ook geen content uit een nieuwere spelversie toe. Deze guide laat je zien hoe je de installatie op een Paper-server controleert, een versiewissel netjes test en typische verbindingsfouten afbakent. De eigen opnames en serverlogs van 12 september 2026 bewijzen de join van een client met 1.21.4 op een Paper-1.21.1-testserver met ViaVersion 5.11.0.

Wat is er op je server geïnstalleerd?

Op daarvoor geschikte Paper- en andere Bukkit-servers installeert game-serverhosting ViaVersion en ViaBackwards bij het inrichten als systeem-plugins. In het panel vind je ze onder Plugins → Geïnstalleerd met de melding “Systeem”. Voeg niet daarnaast nog een tweede ViaVersion-JAR uit de pluginbrowser toe: twee bestanden met dezelfde pluginnaam kunnen voorkomen dat Paper de plugin laadt. Op een bestaande of zelf omgezette server controleer je eerst de daadwerkelijk geïnstalleerde bestanden en het startlog. Fabric-servers hebben het passende mod- of ViaFabric-pad nodig en zijn niet gelijk te stellen aan de Paper-handleiding.

In het startlog moet ViaVersion zonder fouten worden geactiveerd. Op onze testserver stond Enabling ViaVersion v5.11.0 en daarna ViaVersion detected server version: 1.21-1.21.1. Het exacte versienummer hangt af van je server en de geïnstalleerde pluginstand. In de console of als bevoegde admin kun je bovendien /viaversion uitvoeren. /version ViaVersion toont op Paper de geladen pluginversie.

ViaVersion antwoordt in de chat met de geladen versie op de Paper-testserver
ViaVersion antwoordt in de chat met de geladen versie op de Paper-testserver

Welke richting heb je nodig?

Nieuwere client → oudere server: Daarvoor is ViaVersion verantwoordelijk. Onze testcase was Paper 1.21.1 en een Java-client met 1.21.4. Een succesvolle join bewijst precies dit versiepaar op deze testserver, niet automatisch elke toekomstige Minecraft-versie.

Oudere client → nieuwere server: Daarvoor heb je daarnaast ViaBackwards nodig. Die vereist ViaVersion. Zeer oude clientversies kunnen extra componenten zoals ViaRewind nodig hebben. Controleer de actuele compatibiliteitstabel van het project voordat je spelers een bepaalde versie belooft.

Bedrock-spelers lopen via Geyser en Floodgate; ViaVersion alleen maakt van een Java-server geen Bedrock-server. Bij een Velocity- of Bungee-proxy moet duidelijk zijn of de protocolvertaling op de proxy of op de backends plaatsvindt. De ViaVersion-documentatie raadt aan om ze voor één verbinding niet zonder reden op beide niveaus te installeren.

Verbinding stap voor stap testen

  1. Lees de echte Minecraft-versie van de server uit het startlog af en controleer of ViaVersion is geladen. Controleer in het panel onder Plugins → Geïnstalleerd of ViaVersion en indien nodig ViaBackwards maar één keer aanwezig zijn.
  2. Start eerst een ongewijzigde Java-client met dezelfde versie als de server. Als zelfs deze verbinding mislukt, controleer dan de basisverbinding en het startlog voordat je een versieconflict vermoedt.
  3. Start daarna precies één client met de gewenste nieuwere versie en join dezelfde server. Noteer clientversie, serverversie, ViaVersion-versie en de concrete foutmelding.
  4. Test een oudere client alleen als ViaBackwards actief is en de versie volgens de actuele projectdocumentatie wordt ondersteund. Controleer spawn, inventaris, chat en de plugins die voor je server belangrijk zijn in het spel.
  5. Gebruik /viaversion list voor de versies van verbonden spelers of /viaversion player Spielername voor één specifieke verbinding. Deze admin-commands hebben viaversion.admin of de passende viaversion.command.*-rechten nodig; geef ze niet aan de standaardgroep.

Maak vóór een plugin-update een back-up. Vervang de systeem-JAR niet aanvullend door een geversioneerde browser-JAR en start de server na een wijziging volledig opnieuw. Een plugin-manager-reload is volgens de ViaVersion-documentatie geen betrouwbare vervanging voor een herstart.

Als een client niet kan joinen

  • “Outdated server” of “Outdated client”: Controleer eerst de richting. Voor nieuwere clients heb je ViaVersion nodig, voor oudere daarnaast ViaBackwards. Controleer daarna de daadwerkelijk ondersteunde versies en de pluginstand.
  • Plugin laadt niet: Zoek in het startlog naar ViaVersion, ViaBackwards, Java-fouten en Ambiguous plugin name. Controleer bij dubbele JAR's eerst de bestanden in het panel en verwijder alleen het duidelijk overtollige bestand.
  • Joinen lukt, functies niet: Protocolvertaling kan nieuwe blokken, menu's of mechanics op oude servers niet volledig achteraf toevoegen. Test de relevante functies met de betrokken clientversie; bij modpacks moeten client en server nog steeds bij het pack passen.
  • Proxy-verbinding mislukt: Controleer proxyversie, backendversie en de installatielocatie van de Via-plugins apart. Een succesvolle directe backend-test bewijst nog niet dat het proxypad werkt.

FAQ

Maakt ViaVersion van mijn server de nieuwe Minecraft-versie?

Nee. ViaVersion vertaalt alleen het netwerkprotocol, zodat een nieuwere client met een oudere server kan praten. Blokken, items en spelmechanieken van een nieuwere versie komen daardoor niet op de server — daarvoor moet je de serverversie zelf wijzigen.

Heb ik ViaBackwards daarnaast nodig?

Alleen voor de andere richting, dus als spelers met een oudere client op een nieuwere server willen. ViaBackwards vereist ViaVersion; voor zeer oude clientversies komt ViaRewind erbij. Controleer de compatibiliteitstabel van het project voordat je spelers een bepaalde versie toezegt.

Kunnen Bedrock-spelers via ViaVersion joinen?

Nee. Bedrock gebruikt een fundamenteel ander protocol; daarvoor zijn Geyser en Floodgate verantwoordelijk. ViaVersion werkt uitsluitend tussen Java-versies.

Wat gebeurt er bij twee ViaVersion-bestanden?

Paper kan de plugin dan niet eenduidig laden en meldt in het startlog Ambiguous plugin name. Op geschikte servers is ViaVersion al als systeem-plugin geïnstalleerd — laad geen tweede JAR uit de browser erbij, maar controleer onder Plugins → Geïnstalleerd dat elke Via-component precies één keer aanwezig is.

Is een plugin-reload na een update genoeg?

Nee. De projectdocumentatie noemt een volledige serverherstart als betrouwbare manier; een reload via een plugin-manager kan een half geladen toestand achterlaten. Maak vóór de update een back-up en start daarna volledig opnieuw.

Verdere guides

De eigenlijke serverstand wijzig je met Minecraft-serverversie wijzigen. Voor het controleren van de installatie helpt Minecraft-plugins installeren en beheren. Als een speler door een verkeerd modpack wordt geweigerd, lees dan Minecraft-modpack-server joinen.

Bronnen