ViaVersion connecte des clients Minecraft Java plus récents à un serveur Java plus ancien. ViaBackwards complète le sens inverse pour les clients plus anciens. Les deux traduisent le protocole réseau ; ils ne mettent à jour ni la version du serveur, ni n'ajoutent de contenu d'une version de jeu plus récente. Ce guide te montre comment vérifier l'installation sur un serveur Paper, tester proprement un changement de version et cerner les erreurs de connexion typiques. Nos propres captures et journaux serveur du 12 septembre 2026 confirment la connexion d'un client en 1.21.4 à un serveur de test Paper 1.21.1 avec ViaVersion 5.11.0.

Qu'est-ce qui est installé sur ton serveur ?

Sur les serveurs Paper et autres serveurs Bukkit compatibles, game-serverhosting installe ViaVersion et ViaBackwards en tant que plugins système lors de la configuration. Dans le panel, tu les trouves sous Plugins → Installés avec la mention « Système ». N'ajoute pas en plus un second fichier JAR ViaVersion depuis le navigateur de plugins : deux fichiers portant le même nom de plugin peuvent empêcher Paper de charger le plugin. Sur un serveur existant ou converti par toi-même, vérifie d'abord les fichiers réellement installés et le journal de démarrage. Les serveurs Fabric ont besoin du mod correspondant, ou du chemin ViaFabric, et ne peuvent pas être traités comme un serveur Paper.

Dans le journal de démarrage, ViaVersion doit s'activer sans erreur. Sur notre serveur de test, on voyait Enabling ViaVersion v5.11.0 puis ViaVersion detected server version: 1.21-1.21.1. Le numéro de version exact dépend de ton serveur et de la version de plugin installée. Depuis la console ou en tant qu'administrateur autorisé, tu peux aussi exécuter /viaversion. /version ViaVersion affiche sur Paper la version du plugin chargée.

ViaVersion répond dans le chat avec la version chargée sur le serveur de test Paper
ViaVersion répond dans le chat avec la version chargée sur le serveur de test Paper

De quel sens as-tu besoin ?

Client plus récent → serveur plus ancien : C'est le rôle de ViaVersion. Notre cas de test était Paper 1.21.1 avec un client Java en 1.21.4. Une connexion réussie prouve exactement cette paire de versions sur ce serveur de test, mais pas automatiquement chaque future version de Minecraft.

Client plus ancien → serveur plus récent : Pour cela, tu as besoin en plus de ViaBackwards. Il nécessite ViaVersion. Les versions de client très anciennes peuvent nécessiter d'autres composants comme ViaRewind. Vérifie le tableau de compatibilité actuel du projet avant de promettre une version précise à tes joueurs.

Les joueurs Bedrock passent par Geyser et Floodgate ; ViaVersion seul ne transforme pas un serveur Java en serveur Bedrock. Avec un proxy Velocity ou Bungee, il faut savoir clairement si la traduction de protocole a lieu sur le proxy ou sur les backends. La documentation de ViaVersion recommande de ne pas l'installer sans raison sur les deux niveaux pour une même connexion.

Tester la connexion étape par étape

  1. Relève la version Minecraft réelle du serveur dans le journal de démarrage et vérifie que ViaVersion a bien été chargé. Vérifie dans le panel sous Plugins → Installés que ViaVersion, et si besoin ViaBackwards, ne sont présents qu'une seule fois.
  2. Lance d'abord un client Java non modifié avec la même version que le serveur. Si même cette connexion échoue, vérifie la connexion de base et le journal de démarrage avant de soupçonner un conflit de version.
  3. Lance ensuite exactement un client avec la version plus récente souhaitée et connecte-toi au même serveur. Note la version du client, la version du serveur, la version de ViaVersion et le message d'erreur exact.
  4. Ne teste un client plus ancien que si ViaBackwards est actif et que la version est prise en charge selon la documentation actuelle du projet. Vérifie en jeu le spawn, l'inventaire, le chat et les plugins importants pour ton serveur.
  5. Utilise /viaversion list pour connaître les versions des joueurs connectés, ou /viaversion player Nomdujoueur pour une connexion précise. Ces commandes d'administration nécessitent viaversion.admin ou les permissions viaversion.command.* correspondantes ; ne les attribue pas au groupe par défaut.

Avant une mise à jour de plugin, crée une sauvegarde. Ne remplace pas en plus le fichier JAR système par une version issue du navigateur, et redémarre entièrement le serveur après toute modification. Selon la documentation de ViaVersion, un rechargement via un gestionnaire de plugins n'est pas un substitut fiable à un redémarrage.

Si un client ne peut pas se connecter

  • « Outdated server » ou « Outdated client » : Vérifie d'abord le sens. Pour les clients plus récents, tu as besoin de ViaVersion, pour les plus anciens, en plus de ViaBackwards. Vérifie ensuite les versions réellement prises en charge et l'état du plugin.
  • Le plugin ne se charge pas : Recherche dans le journal de démarrage ViaVersion, ViaBackwards, des erreurs Java et Ambiguous plugin name. En cas de fichiers JAR en double, vérifie d'abord les fichiers dans le panel et ne supprime que le fichier clairement excédentaire.
  • La connexion fonctionne, mais pas les fonctionnalités : La traduction de protocole ne peut pas reproduire entièrement de nouveaux blocs, menus ou mécaniques sur d'anciens serveurs. Teste les fonctionnalités concernées avec la version de client affectée ; pour les modpacks, le client et le serveur doivent toujours correspondre au pack.
  • La connexion via le proxy échoue : Vérifie séparément la version du proxy, la version du backend et l'emplacement d'installation des plugins Via. Un test direct réussi sur le backend ne prouve pas encore que le chemin via le proxy fonctionne.

FAQ

ViaVersion transforme-t-il mon serveur vers la nouvelle version de Minecraft ?

Non. ViaVersion traduit uniquement le protocole réseau afin qu'un client plus récent puisse communiquer avec un serveur plus ancien. Les blocs, objets et mécaniques de jeu d'une version plus récente n'arrivent pas pour autant sur le serveur — pour cela, tu dois changer toi-même la version du serveur.

Ai-je besoin de ViaBackwards en plus ?

Uniquement pour le sens inverse, c'est-à-dire lorsque des joueurs avec un client plus ancien veulent rejoindre un serveur plus récent. ViaBackwards nécessite ViaVersion ; pour les versions de client très anciennes, il faut ajouter ViaRewind. Vérifie le tableau de compatibilité du projet avant de promettre une version précise à tes joueurs.

Les joueurs Bedrock peuvent-ils se connecter via ViaVersion ?

Non. Bedrock utilise un protocole fondamentalement différent ; c'est le rôle de Geyser et Floodgate. ViaVersion fonctionne exclusivement entre versions Java.

Que se passe-t-il avec deux fichiers ViaVersion ?

Paper ne peut alors plus charger le plugin de manière univoque et affiche Ambiguous plugin name dans le journal de démarrage. Sur les serveurs compatibles, ViaVersion est déjà installé en tant que plugin système — n'ajoute pas de second fichier JAR depuis le navigateur, mais vérifie sous Plugins → Installés que chaque composant Via est présent exactement une fois.

Un rechargement de plugin suffit-il après une mise à jour ?

Non. La documentation du projet indique qu'un redémarrage complet du serveur est la méthode fiable ; un rechargement via un gestionnaire de plugins peut laisser un état chargé à moitié. Crée une sauvegarde avant la mise à jour, puis redémarre entièrement le serveur ensuite.

Guides complémentaires

Tu modifies l'état réel du serveur avec Changer la version du serveur Minecraft. Pour vérifier l'installation, consulte Installer et gérer des plugins Minecraft. Si un joueur est rejeté à cause d'un mauvais modpack, lis Rejoindre un serveur Minecraft avec modpack.

Sources