IT

Server di gioco

Come accettare altre versioni di Minecraft con ViaVersion

Consenti a client Minecraft più recenti o meno recenti di entrare nel tuo server Paper con ViaVersion, ViaBackwards e ViaRewind: installazione, limiti e risoluzione dei problemi.

6 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

Per impostazione predefinita, un server Minecraft accetta solo i client della sua stessa versione. ViaVersion e i suoi componenti aggiuntivi traducono gli scambi tra client e server, così i giocatori rimasti su un'altra versione possono connettersi.

Questa guida è il seguito di Installare e aggiornare i plugin su Paper. Riutilizza la cartella /opt/minecraft/server, il servizio minecraft.service e il comando mc-console.

Al termine di questa guida saprai:

  • quali plugin installare in base alle versioni da accettare
  • come installarli e aggiornarli con un controllo di integrità
  • come limitare le versioni autorizzate e tornare indietro

Prerequisiti

  • Un server Paper con mc-console, installato seguendo la guida Paper, oltre a curl e jq
  • Accesso SSH con un utente che dispone di sudo
  • Un client Minecraft di un'altra versione, per il test finale

Scegliere i plugin

Il plugin da installare dipende dalla versione del client rispetto a quella del server:

Giocatori da accettare Plugin necessari
Client più recente del server ViaVersion
Client meno recente, fino alla 1.9 ViaVersion + ViaBackwards
Client 1.7 o 1.8 ViaVersion + ViaBackwards + ViaRewind

Conoscere i limiti

ViaVersion traduce il protocollo, ma il gioco resta quello del server. Prima di aprire ad altre versioni, tieni conto di questi punti:

  • Contenuti recenti: un client meno recente non conosce i nuovi blocchi, oggetti e creature, che gli vengono mostrati in una forma simile
  • Altezza del mondo: un client precedente alla 1.17 non vede e non può toccare i blocchi sotto y=0 e sopra y=255
  • Inventari: un client precedente alla 1.17 può subire sfasamenti con alcuni clic
  • Tavolo da forgiatura: non è utilizzabile dai client precedenti alla 1.19.4 su un server 1.20 o più recente, salvo con un componente aggiuntivo
  • Suoni: alcuni suoni recenti non hanno un equivalente sui client meno recenti
  • Anti-cheat: le differenze di comportamento tra le versioni possono provocare falsi allarmi. Prova la tua configurazione
  • Nuove versioni: ViaVersion esce generalmente qualche giorno dopo un aggiornamento di Minecraft
  • Bedrock: ViaVersion riguarda solo Java. Per console e dispositivi mobili, usa Geyser e Floodgate

Eseguire il backup dei plugin

ViaVersion non modifica il mondo, ma un backup dei plugin permette di tornare rapidamente allo stato attuale:

Terminale
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

Installare i plugin

Crea uno script che scarica i plugin da Hangar, verifica che supportino la tua versione di Paper e ne controlla il checksum:

Terminale
sudo nano /opt/minecraft/via-get.sh
Terminale
#!/bin/bash
# Scarica i plugin Via da Hangar e ne controlla il checksum
set -euo pipefail

CIBLE="${1:?Indica la cartella di destinazione}"
MC_VERSION="${2:?Indica la versione del server, ad esempio 26.3}"
shift 2
if [ "$#" -eq 0 ]; then
    echo "Indica almeno un plugin, ad esempio ViaVersion." >&2
    exit 1
fi
UA="mon-serveur-minecraft/1.0 (https://tuo-dominio.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 non dichiara il supporto per 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 è stato installato."
done

Sostituisci tuo-dominio.com nella riga UA, poi rendi eseguibile lo script:

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

Installa i plugin scelti. Ecco il caso più comune, per accogliere client meno recenti:

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

Aggiungi ViaRewind alla fine del comando per i client 1.7 e 1.8. Indica solo ViaVersion se vuoi accettare soltanto client più recenti del server.

Riavvia il server e attendi la riga Done:

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

Verificare il risultato

Terminale
sudo mc-console plugins
sudo journalctl -u minecraft.service --since "10 minutes ago" --no-pager | grep 'ViaVersion detected server version'

I plugin devono comparire nell'elenco e i log devono indicare la versione del tuo server. Connettiti poi con un client di un'altra versione, quindi mostra le versioni in uso:

Terminale
sudo mc-console viaversion list

Il tuo nome utente deve comparire accanto alla versione del tuo client. Se non c'è nessuno connesso, il comando risponde No players found!.

Prova infine ciò che fanno i tuoi giocatori: piazzare e rompere blocchi, aprire un baule, usare i tuoi comandi e i tuoi plugin principali.

Limitare le versioni accettate

L'impostazione block-versions rifiuta determinate versioni. Questo esempio blocca tutto ciò che è precedente alla 1.20.5:

Terminale
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

I prefissi < e > sono accettati e si possono indicare più valori di seguito: ["<1.16", "1.16.4", ">1.17.1"]. Il giocatore rifiutato vede il testo dell'impostazione block-disconnect-msg.

Con un proxy Velocity

Se usi Velocity, installa ViaVersion o sul proxy o sui server, mai in entrambi i posti.

Preferisci i server Paper: la documentazione di ViaVersion indica che gli anti-cheat possono funzionare peggio quando la traduzione avviene sul proxy. Ripeti quindi l'installazione per ogni server, cambiando la cartella:

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

L'inoltro moderno di Velocity rifiuta i client precedenti alla 1.13: in questa configurazione, ViaRewind non consentirà loro l'accesso.

Aggiornare

Paper sostituisce i plugin all'avvio a partire dalla cartella plugins/update. Esegui il backup, metti le nuove versioni nella cartella, poi riavvia:

Terminale
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

Aggiorna tutti i plugin Via contemporaneamente, perché le loro versioni vanno di pari passo. Dopo una nuova versione di Minecraft, attendi che la supportino.

Tornare indietro

Rimuovi i plugin. Il mondo non è interessato, e i giocatori con un'altra versione verranno di nuovo rifiutati:

Terminale
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

Le cartelle di configurazione restano in plugins e possono essere eliminate se non intendi reinstallare questi plugin.

In caso di problemi

Terminale
sudo journalctl -u minecraft.service -n 200 --no-pager | grep -iE 'via|error|exception'

« Incompatible client! Please use … »

La traduzione non è attiva per questa versione. Verifica con sudo mc-console plugins che i plugin siano caricati e confronta la versione del client con la tabella Scegliere i plugin. Un client meno recente ha bisogno di ViaBackwards.

« You are using an unsupported Minecraft version! »

Questa versione è bloccata da block-versions o block-protocols in plugins/ViaVersion/config.yml.

« This server is only compatible with Minecraft 1.13 and above. »

Il messaggio proviene da Velocity con l'inoltro moderno. Questo client non può passare da questo proxy.

« ViaVersion does not have any compatible versions for this server version! »

ViaVersion è troppo vecchio per il tuo server. Aggiornalo. Se la versione di Minecraft è appena uscita, attendi una versione compatibile.

Lo script indica « non dichiara il supporto per Paper »

L'ultima versione pubblicata su Hangar non cita la tua versione di Paper. Verifica il numero passato allo script e la pagina del progetto. Per una versione di Minecraft appena uscita, attendi qualche giorno.

Un plugin Via non si carica

Messaggio Causa Soluzione
Unknown/missing dependency plugins Manca ViaVersion per ViaBackwards, oppure ViaBackwards per ViaRewind Installa il plugin indicato
Ambiguous plugin name Due versioni dello stesso plugin in plugins Conserva un solo file
UnsupportedClassVersionError Java è troppo vecchio Installa Java 25

Blocchi fantasma o inventario sfasato

Queste anomalie dipendono spesso dalla traduzione tra versioni molto distanti. Aggiorna i plugin Via e, se necessario, limita le versioni accettate per escludere quelle più vecchie.

Per approfondire, consulta la documentazione di installazione, quella sulla configurazione e lo strumento di scelta dei plugin del progetto.