WATERCRAFTWIKI
Illustration de ViaVersion — Versions Java
← Retour au wiki
🔄

PLUGINS ET TECHNIQUE

ViaVersion — Versions Java

Comprendre la compatibilité des clients Java et fournir les bonnes informations lorsqu'une connexion échoue.

Mis à jour le 2026-08-01

Rejoindre avec une version Java compatible

ViaVersion traduit le protocole réseau entre certaines versions de Minecraft Java et le serveur. Le joueur se connecte normalement : le plugin négocie automatiquement la version lorsqu'elle est prise en charge.

ViaVersion ne change pas les blocs du monde, n'ajoute pas les nouveautés absentes du serveur et ne transforme pas un client Bedrock en client Java.

Méthode conseillée au joueur Java

  1. Utilise d'abord la version de référence annoncée par WaterCraft.
  2. Lance un profil Minecraft propre si tu rencontres un problème : sans mod de protocole, proxy ou pack expérimental.
  3. Ajoute l'adresse du serveur et tente une seule connexion.
  4. Si le serveur accepte la version, aucune commande ViaVersion n'est nécessaire.
  5. Si la connexion échoue, copie le message complet au lieu de résumer par « ça ne marche pas ».
  6. Note la version exacte affichée dans ton launcher, par exemple version stable ou instantané.
  7. Indique si le même compte arrive à rejoindre avec la version de référence.

Le fait qu'une version puisse ouvrir une connexion ne garantit pas que chaque animation, son ou interface soit identique. Le contenu réellement disponible reste celui du serveur.

Informations à envoyer à l'équipe

  • pseudo Java exact ;
  • version complète du client ;
  • launcher utilisé ;
  • message d'erreur complet ;
  • heure de la tentative ;
  • présence éventuelle de mods, proxy, VPN ou pack de ressources ;
  • résultat avec la version de référence.

Une capture de l'écran de déconnexion est souvent plus utile qu'une longue description.

Commandes de diagnostic de l'équipe

CommandeUtilité
/viaversionAfficher la version et l'aide principale
/viaversion listRegrouper les joueurs connectés selon leur version de protocole
/viaversion ppsAfficher les paquets par seconde observés
/viaversion dumpProduire un rapport technique de configuration
/viaversion debugActiver ou arrêter le diagnostic détaillé
/viaversion reloadRecharger la configuration

Les alias enregistrés sont /viaver et /vvbukkit, mais le wiki utilise /viaversion afin de rester clair. Toutes les sous-commandes de diagnostic sont réservées au staff.

Flux d'analyse pour l'équipe

  1. Confirmer que ViaVersion est chargé sans erreur dans le journal de démarrage.
  2. Demander la version exacte du client et l'heure de l'échec.
  3. Utiliser /viaversion list si le joueur réussit à se connecter avec un autre profil.
  4. Comparer le problème avec un client Java de référence sans mod.
  5. Contrôler les versions bloquées dans la configuration. La copie locale actuelle ne contient aucune version ni aucun protocole explicitement bloqué.
  6. Utiliser /viaversion dump seulement pour un rapport technique destiné à une personne de confiance.
  7. Activer /viaversion debug pendant une courte reproduction, puis le désactiver pour éviter un journal inutilement volumineux.
  8. Recharger uniquement après une modification validée et prévoir qu'un rechargement peut demander aux joueurs de se reconnecter.

Précautions

  • ne promets jamais « toutes les versions » : la compatibilité dépend de la version du serveur et des traductions disponibles ;
  • ne bloque pas une plage entière pour corriger le cas d'un seul joueur ;
  • garde une copie de plugins/ViaVersion/config.yml avant modification ;
  • ne publie pas un dump sans le relire, car il décrit l'environnement technique du serveur ;
  • vérifie aussi GrimAC lorsqu'un problème concerne les mouvements plutôt que la connexion ;
  • teste Java et Bedrock séparément : leurs chemins de connexion ne sont pas les mêmes.

Dépannage

« Version incompatible »

Essaie la version de référence WaterCraft. Si elle fonctionne, fournis à l'équipe la version refusée et le message exact. N'installe pas plusieurs plugins ou mods de traduction côté client en même temps.

Connexion acceptée, puis comportement étrange

Teste sans mod et relève l'action précise : inventaire, véhicule, combat, bloc ou téléportation. L'équipe pourra comparer ViaVersion, GrimAC et les journaux serveur.

/viaversion list ne montre pas le joueur

La commande ne peut analyser qu'un joueur déjà connecté. Pour un échec avant l'entrée sur le serveur, utilise l'heure, l'adresse et le message de déconnexion dans les journaux.

Le problème concerne Bedrock

Ne modifie pas ViaVersion pour le résoudre. Vérifie plutôt l'état de la passerelle décrite dans Bedrock et distingue bien le pseudo Java du gamertag Bedrock.