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.
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 acurlejq - 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=0e sopray=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:
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/backupsInstallare i plugin
Crea uno script che scarica i plugin da Hangar, verifica che supportino la tua versione di Paper e ne controlla il checksum:
sudo nano /opt/minecraft/via-get.sh#!/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."
doneSostituisci tuo-dominio.com nella riga UA, poi rendi eseguibile lo script:
sudo chmod 755 /opt/minecraft/via-get.shInstalla i plugin scelti. Ecco il caso più comune, per accogliere client meno recenti:
sudo -u minecraft /opt/minecraft/via-get.sh /opt/minecraft/server/plugins 26.3 ViaVersion ViaBackwardsAggiungi 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:
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fVerificare il risultato
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:
sudo mc-console viaversion listIl 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:
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.serviceI 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:
sudo -u minecraft /opt/minecraft/via-get.sh /opt/minecraft/lobby/plugins 26.3 ViaVersion ViaBackwards
sudo systemctl restart minecraft-lobby.serviceL'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:
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.serviceAggiorna 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:
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.serviceLe cartelle di configurazione restano in plugins e possono essere eliminate se non intendi reinstallare questi plugin.
In caso di problemi
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.