FR

Serveurs de jeux

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.

7 min de lecture, mis à jour le 18 novembre 2026

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 que curl et jq
  • 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=0 et au-dessus de y=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 :

Terminal
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/backups

Installer 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 :

Terminal
sudo nano /opt/minecraft/via-get.sh
Terminal
#!/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."
done

Remplacez votre-domaine.com dans la ligne UA, puis rendez le script exécutable :

Terminal
sudo chmod 755 /opt/minecraft/via-get.sh

Installez les plugins choisis. Voici le cas le plus courant, pour accueillir des clients plus anciens :

Terminal
sudo -u minecraft /opt/minecraft/via-get.sh /opt/minecraft/server/plugins 26.3 ViaVersion ViaBackwards

Ajoutez 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 :

Terminal
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f

Vérifier le résultat

Terminal
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 :

Terminal
sudo mc-console viaversion list

Votre 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 :

Terminal
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.service

Les 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 :

Terminal
sudo -u minecraft /opt/minecraft/via-get.sh /opt/minecraft/lobby/plugins 26.3 ViaVersion ViaBackwards
sudo systemctl restart minecraft-lobby.service

Le 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 :

Terminal
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.service

Mettez à 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 :

Terminal
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.service

Les 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

Terminal
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.