Comment accepter d'autres versions de Minecraft avec ViaVersion
Laissez des clients Minecraft plus récents ou plus anciens rejoindre votre serveur Paper avec ViaVersion, ViaBackwards et ViaRewind : installation, limites et dépannage.
Sur cette page
Vos valeurs
Renseignez-les une fois, les commandes du guide se mettent à jour.
Par défaut, un serveur Minecraft n'accepte que les clients de sa propre version. ViaVersion et ses compléments traduisent les échanges entre le client et le serveur, pour que des joueurs restés sur une autre version puissent se connecter.
Ce guide prolonge Installer et mettre à jour des plugins sur Paper. Il réutilise le dossier /opt/minecraft/server, le service minecraft.service et la commande mc-console.
À la fin de ce guide, vous saurez :
- quels plugins installer selon les versions à accepter
- les installer et les mettre à jour avec un contrôle d'intégrité
- limiter les versions autorisées et revenir en arrière
Prérequis
- Un serveur Paper avec
mc-console, installé avec le guide Paper, ainsi quecurletjq - Un accès SSH avec un utilisateur disposant de
sudo - Un client Minecraft dans une autre version, pour le test final
Choisir les plugins
Le plugin à installer dépend de la position du client par rapport au serveur :
| Joueurs à accepter | Plugins nécessaires |
|---|---|
| Client plus récent que le serveur | ViaVersion |
| Client plus ancien, jusqu'à 1.9 | ViaVersion + ViaBackwards |
| Client en 1.7 ou 1.8 | ViaVersion + ViaBackwards + ViaRewind |
Connaître les limites
ViaVersion traduit le protocole, mais le jeu reste celui du serveur. Avant d'ouvrir d'autres versions, tenez compte de ces points :
- Contenu récent : un client ancien ne connaît pas les nouveaux blocs, objets et créatures. Ils lui sont présentés sous une forme approchante
- Hauteur du monde : un client antérieur à 1.17 ne voit pas et ne peut pas toucher les blocs sous
y=0et au-dessus dey=255 - Inventaires : un client antérieur à 1.17 peut subir des décalages sur certains clics
- Table de forgeron : elle n'est pas utilisable par les clients antérieurs à 1.19.4 sur un serveur 1.20 ou plus récent, sauf avec un module complémentaire
- Sons : certains sons récents n'ont pas d'équivalent chez les anciens clients
- Anti-triche : les différences de comportement entre versions peuvent provoquer de fausses alertes. Testez votre configuration
- Nouvelles versions : ViaVersion sort généralement quelques jours après une mise à jour de Minecraft
- Bedrock : ViaVersion ne concerne que Java. Pour les consoles et les mobiles, utilisez Geyser et Floodgate
Sauvegarder les plugins
ViaVersion ne modifie pas le monde, mais une sauvegarde des plugins permet de revenir rapidement à l'état actuel :
sudo mkdir -p /opt/minecraft/backups
sudo tar -czf /opt/minecraft/backups/plugins-$(date +%F-%H%M).tar.gz -C /opt/minecraft/server plugins
sudo ls -lh /opt/minecraft/backupsInstaller les plugins
Créez un script qui télécharge les plugins depuis Hangar, vérifie qu'ils prennent en charge votre version de Paper et contrôle leur empreinte :
sudo nano /opt/minecraft/via-get.sh#!/bin/bash
# Télécharge des plugins Via depuis Hangar et contrôle leur empreinte
set -euo pipefail
CIBLE="${1:?Indiquez le dossier de destination}"
MC_VERSION="${2:?Indiquez la version du serveur, par exemple 26.3}"
shift 2
if [ "$#" -eq 0 ]; then
echo "Indiquez au moins un plugin, par exemple ViaVersion." >&2
exit 1
fi
UA="mon-serveur-minecraft/1.0 (https://votre-domaine.com)"
mkdir -p "$CIBLE"
cd "$CIBLE"
for PLUGIN in "$@"; do
API="https://hangar.papermc.io/api/v1/projects/$PLUGIN/versions?limit=1&channel=Release&platform=PAPER"
VERSION=$(curl -fsSL -H "User-Agent: $UA" "$API" | jq -c '.result[0]')
if ! echo "$VERSION" | jq -e --arg mc "$MC_VERSION" '.platformDependencies.PAPER | index($mc)' > /dev/null; then
echo "$PLUGIN ne déclare pas la prise en charge de Paper $MC_VERSION." >&2
exit 1
fi
NOM=$(echo "$VERSION" | jq -r '.downloads.PAPER.fileInfo.name')
URL=$(echo "$VERSION" | jq -r '.downloads.PAPER.downloadUrl')
SHA256=$(echo "$VERSION" | jq -r '.downloads.PAPER.fileInfo.sha256Hash')
curl -fL -H "User-Agent: $UA" -o "$NOM.new" "$URL"
echo "$SHA256 $NOM.new" | sha256sum -c -
mv "$NOM.new" "$NOM"
echo "$NOM est en place."
doneRemplacez votre-domaine.com dans la ligne UA, puis rendez le script exécutable :
sudo chmod 755 /opt/minecraft/via-get.shInstallez les plugins choisis. Voici le cas le plus courant, pour accueillir des clients plus anciens :
sudo -u minecraft /opt/minecraft/via-get.sh /opt/minecraft/server/plugins 26.3 ViaVersion ViaBackwardsAjoutez ViaRewind à la fin de la commande pour les clients 1.7 et 1.8. N'indiquez que ViaVersion si vous voulez seulement accepter des clients plus récents que le serveur.
Redémarrez le serveur et attendez la ligne Done :
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fVérifier le résultat
sudo mc-console plugins
sudo journalctl -u minecraft.service --since "10 minutes ago" --no-pager | grep 'ViaVersion detected server version'Les plugins doivent apparaître dans la liste, et le journal doit indiquer la version de votre serveur. Connectez-vous ensuite avec un client d'une autre version, puis affichez les versions utilisées :
sudo mc-console viaversion listVotre pseudo doit figurer en face de la version de votre client. Si personne n'est connecté, la commande répond No players found!.
Essayez enfin ce que font vos joueurs : poser et casser des blocs, ouvrir un coffre, utiliser vos commandes et vos plugins principaux.
Limiter les versions acceptées
Le réglage block-versions refuse certaines versions. Cet exemple bloque tout ce qui est antérieur à 1.20.5 :
sudo -u minecraft sed -i 's/^block-versions: .*/block-versions: ["<1.20.5"]/' /opt/minecraft/server/plugins/ViaVersion/config.yml
sudo grep '^block-versions:' /opt/minecraft/server/plugins/ViaVersion/config.yml
sudo systemctl restart minecraft.serviceLes préfixes < et > sont acceptés, et plusieurs valeurs peuvent se suivre : ["<1.16", "1.16.4", ">1.17.1"]. Le joueur refusé voit le texte du réglage block-disconnect-msg.
Avec un proxy Velocity
Si vous utilisez Velocity, installez ViaVersion soit sur le proxy, soit sur les serveurs, jamais aux deux endroits.
Préférez les serveurs Paper : la documentation de ViaVersion indique que les anti-triche peuvent moins bien fonctionner lorsque la traduction se fait sur le proxy. Répétez alors l'installation pour chaque serveur, en changeant le dossier :
sudo -u minecraft /opt/minecraft/via-get.sh /opt/minecraft/lobby/plugins 26.3 ViaVersion ViaBackwards
sudo systemctl restart minecraft-lobby.serviceLe transfert moderne de Velocity refuse les clients antérieurs à 1.13 : ViaRewind ne leur ouvrira donc pas l'accès dans cette configuration.
Mettre à jour
Paper remplace les plugins au démarrage à partir du dossier plugins/update. Sauvegardez, déposez les nouvelles versions, puis redémarrez :
sudo tar -czf /opt/minecraft/backups/plugins-$(date +%F-%H%M).tar.gz -C /opt/minecraft/server plugins
sudo -u minecraft /opt/minecraft/via-get.sh /opt/minecraft/server/plugins/update 26.3 ViaVersion ViaBackwards
sudo systemctl restart minecraft.serviceMettez à jour tous les plugins Via en même temps, car leurs versions vont ensemble. Après une nouvelle version de Minecraft, attendez qu'ils la prennent en charge.
Revenir en arrière
Retirez les plugins. Le monde n'est pas concerné, et les joueurs dans une autre version seront de nouveau refusés :
sudo systemctl stop minecraft.service
sudo rm -f /opt/minecraft/server/plugins/ViaVersion-*.jar /opt/minecraft/server/plugins/ViaBackwards-*.jar /opt/minecraft/server/plugins/ViaRewind-*.jar
sudo systemctl start minecraft.serviceLes dossiers de configuration restent dans plugins et peuvent être supprimés si vous ne comptez pas réinstaller ces plugins.
En cas de problème
sudo journalctl -u minecraft.service -n 200 --no-pager | grep -iE 'via|error|exception'« Incompatible client! Please use … »
La traduction n'est pas active pour cette version. Vérifiez avec sudo mc-console plugins que les plugins sont bien chargés, et comparez la version du client au tableau Choisir les plugins. Un client ancien a besoin de ViaBackwards.
« You are using an unsupported Minecraft version! »
Cette version est bloquée par block-versions ou block-protocols dans plugins/ViaVersion/config.yml.
« This server is only compatible with Minecraft 1.13 and above. »
Le message vient de Velocity en transfert moderne. Ce client ne peut pas passer par ce proxy.
« ViaVersion does not have any compatible versions for this server version! »
ViaVersion est trop ancien pour votre serveur. Mettez-le à jour. Si la version de Minecraft vient de sortir, attendez une version compatible.
Le script indique « ne déclare pas la prise en charge de Paper »
La dernière version publiée sur Hangar ne cite pas votre version de Paper. Vérifiez le numéro passé au script et la page du projet. Pour une version de Minecraft toute récente, patientez quelques jours.
Un plugin Via ne se charge pas
| Message | Cause | Solution |
|---|---|---|
Unknown/missing dependency plugins |
ViaVersion manque pour ViaBackwards, ou ViaBackwards manque pour ViaRewind | Installez le plugin indiqué |
Ambiguous plugin name |
Deux versions du même plugin dans plugins |
Gardez un seul fichier |
UnsupportedClassVersionError |
Java est trop ancien | Installez Java 25 |
Blocs fantômes ou inventaire décalé
Ces écarts viennent souvent de la traduction entre des versions éloignées. Mettez à jour les plugins Via, et limitez si besoin les versions acceptées pour éviter les plus anciennes.
Pour aller plus loin, consultez la documentation d'installation, celle de la configuration, et l'outil de choix des plugins du projet.