ViaVersion : Minecraft multi-versions
DOG&DEV · 25/01/2025
Changelogs
Web Hosting
ViaVersion : Minecraft multi-versions
ViaVersion est un plugin (Paper, Spigot, etc.) qui permet à des joueurs en version plus ancienne (ex. 1.8, 1.12, 1.16) de se connecter à un serveur en version plus récente (ex. 1.21). ViaBackwards et ViaRewind étendent le support vers des versions encore plus anciennes. Ce guide décrit l’installation, la configuration de base et le dépannage.
Prérequis
- Serveur Paper ou Spigot (1.9+ recommandé pour un bon support)
- Accès au dossier plugins/ (panel ou FTP/SFTP)
- Java adaptée à la version du serveur
Rôle de ViaVersion
- ViaVersion : traduit le protocole entre le client (1.8, 1.12, …) et le serveur (1.21). Le serveur reste en 1.21 ; les joueurs 1.8 peuvent se connecter (avec des limites : blocs, entités, commandes ajoutés après 1.8 ne sont pas visibles ou fonctionnent différemment).
- ViaBackwards : support de clients 1.9 → 1.20 vers un serveur plus récent.
- ViaRewind : support de clients 1.7.6–1.8.9 vers un serveur 1.9+.
Installation
- Télécharger ViaVersion (et ViaBackwards, ViaRewind si besoin) depuis Modrinth, Hangar ou SpigotMC.
- Placer les .jar dans plugins/.
- Redémarrer le serveur. ViaVersion crée plugins/ViaVersion/config.yml.
Configuration de base
Fichier plugins/ViaVersion/config.yml (extraits) :
# Autoriser les versions de protocole prises en charge
# (par défaut, les anciennes versions sont autorisées)
block-protocols: []
allow-protocols: []
# Avertissement en console si un joueur se connecte en version plus ancienne
suppress-version-chat: false
# Empreinte 1.19+ (signature de chat) : à laisser activée en prod
# (désactiver peut aider en dev/debug, mais réduit la sécurité)
Souvent, la config par défaut suffit. Pour restreindre les versions :
- block-protocols : liste de numéros de protocole à bloquer.
- allow-protocols : si défini, seules ces versions sont autorisées (vide = toutes celles supportées).
Les numéros de protocole sont listés dans la doc ViaVersion ou en console lors de la connexion d’un joueur.
ViaBackwards et ViaRewind
- ViaBackwards : à placer dans plugins/ avec ViaVersion. Pas de config obligatoire pour un usage standard.
- ViaRewind : idem pour les clients 1.7.6–1.8.9. Compatible avec ViaVersion et ViaBackwards.
Ordre de chargement : géré automatiquement ; tous les .jar dans plugins/.
Comportement en jeu
- Blocs / entités inexistants dans l’ancienne version : le client peut voir un bloc « inconnu » ou un placeholder ; pas de crash en général.
- Commandes : les commandes ajoutées après la version du client ne sont pas disponibles pour ce client.
- Protocole 1.19+ (chat signé) : ViaVersion gère la compatibilité ; en cas de souci (chat, kick), vérifier les options liées à la signature dans la config.
Dépannage
| Symptôme | Cause possible | Correctif |
|---|---|---|
| Joueur 1.8 kick « Outdated client/server » | ViaVersion/ViaBackwards/ViaRewind absent ou version incompatible | Vérifier que les bons .jar sont dans plugins/ ; mettre à jour ViaVersion |
| Kick « Invalid signature » (1.19+) | Incompatibilité chat signé | Mettre à jour ViaVersion ; vérifier suppress-version-chat et les options 1.19 |
| Lag ou bugs bizarres | Incompatibilités protocole, trop de versions très éloignées | Limiter les versions avec block-protocols ou allow-protocols ; réduire l’écart (ex. 1.16–1.21 au lieu de 1.8–1.21) |
Bonnes pratiques
- Garder ViaVersion (et ViaBackwards/ViaRewind) à jour.
- En réseau avec proxy (BungeeCord, Velocity) : installer ViaVersion sur les backends (serveurs de jeu), pas sur le proxy. Pour le proxy : velocity-mc, bungeecord-setup.
- Pour les mods : ViaVersion est pour plugins ; les mods côté client obligent en général la même version que le serveur. Voir mods-minecraft.
Ressources
Cet article s’inscrit dans notre série de guides hébergement et gaming. Pour un serveur sur-mesure, contact.