IT

Server di gioco

Come installare e aggiornare i plugin su un server Minecraft Paper

Passa dal tuo server Minecraft vanilla a Paper senza perdere il mondo, poi installa e aggiorna i plugin su un VPS o server dedicato Linux.

10 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

Il server ufficiale di Minecraft (vanilla) non carica plugin. Questa guida spiega come sostituirlo con Paper conservando il tuo mondo, e poi come installare e aggiornare i plugin in modo pulito.

È il seguito della guida Creare un server Minecraft e ne riutilizza gli elementi: l'utente minecraft, la cartella /opt/minecraft/server, il file server.jar e il servizio minecraft.service.

Al termine di questa guida avrai:

  • Java 25 e Paper al posto del server vanilla, con il tuo mondo intatto
  • un comando mc-console per comunicare con la console del server avviato da systemd
  • un primo plugin installato e un metodo di aggiornamento sicuro

Prerequisiti

  • Un server installato seguendo la guida Creare un server Minecraft
  • Accesso SSH con un utente che dispone di sudo
  • Spazio su disco sufficiente per una copia completa della cartella del server

Verificare il server attuale

Controlla innanzitutto quale versione di Minecraft è in esecuzione e se il server usa già Paper:

Terminale
sudo grep -m1 'Starting minecraft server version' /opt/minecraft/server/logs/latest.log
unzip -l /opt/minecraft/server/server.jar | grep -q 'io/papermc/paperclip/Main.class' && echo Paper || echo Vanilla

Se il secondo comando mostra Paper, il tuo server è già migrato: esegui il backup, poi passa direttamente all'attivazione della console.

Arrestare il server ed eseguire il backup

Arresta il server, controlla lo spazio disponibile, poi crea un archivio completo:

Terminale
sudo systemctl stop minecraft.service
sudo du -sh /opt/minecraft/server
df -h /opt/minecraft
sudo mkdir -p /opt/minecraft/backups
sudo tar -czf /opt/minecraft/backups/avant-paper-$(date +%F-%H%M).tar.gz -C /opt/minecraft server
sudo ls -lh /opt/minecraft/backups

Se avvii il server in screen, digita stop nella sua console al posto del primo comando.

Installare Java 25

Paper consiglia Amazon Corretto, disponibile per Debian e Ubuntu. Aggiungi il suo repository, poi installa Java 25:

Terminale
sudo apt update
sudo apt install -y ca-certificates apt-transport-https gnupg wget curl jq
wget -O - https://apt.corretto.aws/corretto.key | sudo gpg --dearmor --yes -o /usr/share/keyrings/corretto-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/corretto-keyring.gpg] https://apt.corretto.aws stable main" | sudo tee /etc/apt/sources.list.d/corretto.list
sudo apt update
sudo apt install -y java-25-amazon-corretto-jdk libxi6 libxtst6 libxrender1

Il servizio avvia /usr/bin/java. Se è installato anche Java 21, fai puntare questo comando a Java 25:

Terminale
sudo update-alternatives --set java "$(update-alternatives --list java | grep -m1 'java-25')"
java --version

L'output deve iniziare con openjdk 25.

Passare a Paper senza perdere il mondo

Il passaggio consiste nel sostituire server.jar con il file di Paper. Poiché il nome resta identico, il servizio systemd non deve cambiare, e la cartella world, server.properties e le liste dei giocatori restano al loro posto.

Crea uno script che scarica l'ultima build stabile, ne controlla il checksum e sostituisce server.jar. Ti servirà di nuovo a ogni aggiornamento:

Terminale
sudo nano /opt/minecraft/paper-update.sh
Terminale
#!/bin/bash
# Scarica l'ultima build stabile di Paper e sostituisce server.jar
set -euo pipefail

MC_VERSION="${1:?Indica la versione di Minecraft, ad esempio 26.3}"
UA="mon-serveur-minecraft/1.0 (https://tuo-dominio.com)"
API="https://fill.papermc.io/v3/projects/paper/versions/$MC_VERSION/builds"

cd /opt/minecraft/server

BUILD=$(curl -fsSL -H "User-Agent: $UA" "$API" | jq -c 'map(select(.channel == "STABLE")) | .[0]')
if [ "$BUILD" = "null" ]; then
    echo "Nessuna build stabile trovata per Minecraft $MC_VERSION." >&2
    exit 1
fi

URL=$(echo "$BUILD" | jq -r '.downloads."server:default".url')
SHA256=$(echo "$BUILD" | jq -r '.downloads."server:default".checksums.sha256')

curl -fL -H "User-Agent: $UA" -o server.jar.new "$URL"
echo "$SHA256  server.jar.new" | sha256sum -c -

if [ -f server.jar ]; then
    mv server.jar server.jar.old
fi
mv server.jar.new server.jar
echo "Paper $MC_VERSION, build $(echo "$BUILD" | jq -r '.id'), è stato installato."

Nella riga UA, sostituisci tuo-dominio.com con l'indirizzo del tuo sito o con un modo per contattarti: l'API di Paper richiede uno User-Agent che identifichi il tuo progetto e indichi un contatto.

Rendi eseguibile lo script, poi avvialo con l'utente minecraft:

Terminale
sudo chmod 755 /opt/minecraft/paper-update.sh
sudo -u minecraft /opt/minecraft/paper-update.sh 26.3

La riga server.jar.new: OK conferma che il file scaricato è integro. Il vecchio server viene conservato con il nome server.jar.old.

Attivare la console del servizio

Il servizio della guida di base contiene StandardInput=null: non ha quindi alcuna console, mentre molti plugin si configurano tramite comandi. Gliene darai una con una named pipe, senza aprire alcuna porta di rete.

Crea l'unità che gestisce la pipe:

Terminale
sudo nano /etc/systemd/system/minecraft.socket
Configurazione
[Unit]
Description=Console del server Minecraft
PartOf=minecraft.service

[Socket]
ListenFIFO=/run/minecraft.stdin
SocketMode=0600

Solo root può scrivere in questa pipe, da cui il sudo davanti a mc-console.

Aggiungi poi un'integrazione al servizio. Questo file si aggiunge a minecraft.service senza modificarlo:

Terminale
sudo mkdir -p /etc/systemd/system/minecraft.service.d
sudo nano /etc/systemd/system/minecraft.service.d/console.conf
Configurazione
[Unit]
Requires=minecraft.socket
After=minecraft.socket

[Service]
Sockets=minecraft.socket
StandardInput=socket
StandardOutput=journal
StandardError=journal
SuccessExitStatus=130 143
TimeoutStopSec=180

SuccessExitStatus evita che il servizio risulti in errore dopo un arresto normale, e TimeoutStopSec lascia al server tre minuti per salvare il mondo.

Crea infine il comando mc-console, che invia un comando al server e ne mostra la risposta:

Terminale
sudo nano /usr/local/bin/mc-console
Terminale
#!/bin/bash
# Invia un comando alla console di Minecraft e mostra la risposta dai log
if [ "$#" -eq 0 ]; then
    echo "Uso: mc-console <comando>" >&2
    exit 1
fi
if ! systemctl is-active --quiet minecraft.service; then
    echo "Il servizio minecraft.service non è avviato." >&2
    exit 1
fi
DEBUT=$(date '+%Y-%m-%d %H:%M:%S')
printf '%s\n' "$*" > /run/minecraft.stdin
sleep "${MC_CONSOLE_WAIT:-2}"
journalctl -u minecraft.service --since "$DEBUT" --no-pager -o cat
Terminale
sudo chmod 755 /usr/local/bin/mc-console
sudo systemctl daemon-reload

Avviare Paper

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

Il primo avvio è più lungo: Paper scarica i file di Minecraft, poi converte il mondo. Mostra World storage migration is required during startup e attende 30 secondi prima di continuare, lasciandoti il tempo di interrompere l'avvio se non hai un backup.

Il server è pronto quando compare la riga Done (…)! For help, type "help". Esci dalla visualizzazione dei log con Ctrl+C: il server continua a funzionare.

Verificare il risultato

Terminale
sudo mc-console version
sudo mc-console plugins
sudo ls /opt/minecraft/server /opt/minecraft/server/world

Dovresti ottenere:

  • una riga This server is running Paper version 26.3-…
  • Server Plugins (0), perché nessun plugin è ancora installato
  • i nuovi file bukkit.yml, spigot.yml e la cartella config, oltre alla tua cartella world

Le cartelle plugins/spark e plugins/bStats vengono create da Paper stesso: è normale. Infine connettiti al server con il tuo client Minecraft e verifica che le tue costruzioni siano ancora lì.

Installare un plugin

Scegliere un plugin compatibile

Prima di scaricare un plugin, verifica tre punti sulla sua pagina:

  • è previsto per Paper (o Spigot/Bukkit), non per Fabric o Forge, che sono mod
  • dichiara il supporto per la tua versione di Minecraft
  • le eventuali dipendenze sono indicate, perché vanno installate anch'esse

Scarica solo da fonti affidabili: Hangar, il repository di plugin di Paper, Modrinth, oppure il sito e il repository GitHub ufficiali del progetto. Un plugin viene eseguito con i permessi dell'utente minecraft e può leggere tutta la cartella del server.

Installare da Hangar

L'esempio seguente installa Chunky, un plugin di pregenerazione del mondo. Inizia controllando la sua ultima versione e le versioni di Minecraft supportate:

Terminale
sudo -u minecraft bash
cd /opt/minecraft/server/plugins
UA="mon-serveur-minecraft/1.0 (https://tuo-dominio.com)"
API="https://hangar.papermc.io/api/v1/projects/Chunky/versions?limit=1&channel=Release&platform=PAPER"
curl -fsSL -H "User-Agent: $UA" "$API" | jq '.result[0] | {version: .name, minecraft: .platformDependencies.PAPER, fichier: .downloads.PAPER.fileInfo.name}'

Se la tua versione di Minecraft compare nell'elenco, scarica il file ed esci dalla sessione minecraft:

Terminale
URL=$(curl -fsSL -H "User-Agent: $UA" "$API" | jq -r '.result[0].downloads.PAPER.downloadUrl')
curl -fLO -H "User-Agent: $UA" "$URL"
ls -l
exit

Se l'indirizzo è null, il plugin è ospitato altrove: segui il link indicato sulla sua pagina Hangar.

Installare dal tuo computer

Invia il file .jar al server, poi spostalo nella cartella plugins con il proprietario corretto:

Terminale
scp MonPlugin.jar TUO_USER@IP_SERVER:/tmp/
Terminale
sudo install -o minecraft -m 644 /tmp/MonPlugin.jar /opt/minecraft/server/plugins/

Il file deve trovarsi direttamente in plugins: Paper non legge le sottocartelle. Se il download è un archivio .zip, estrailo e conserva il .jar previsto per Paper o Bukkit.

Caricare il plugin

Riavvia il server, attendi la riga Done, poi elenca i plugin:

Terminale
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f
Terminale
sudo mc-console plugins

Un plugin caricato appare in verde in gioco con /plugins. Nei log viene elencato senza messaggi di errore all'avvio.

La sua configurazione si trova poi in /opt/minecraft/server/plugins/<NomePlugin>/. Modificala con l'utente minecraft, poi riavvia il server o usa il comando di ricaricamento del plugin stesso.

Aggiornare i plugin

Paper è in grado di sostituire i plugin all'avvio grazie alla cartella plugins/update. Non devi quindi eliminare nulla a mano.

Esegui prima il backup dei plugin e della loro configurazione:

Terminale
sudo tar -czf /opt/minecraft/backups/plugins-$(date +%F-%H%M).tar.gz -C /opt/minecraft/server plugins

Metti poi la nuova versione in update. Ecco l'esempio di Chunky:

Terminale
sudo -u minecraft bash
mkdir -p /opt/minecraft/server/plugins/update
cd /opt/minecraft/server/plugins/update
UA="mon-serveur-minecraft/1.0 (https://tuo-dominio.com)"
API="https://hangar.papermc.io/api/v1/projects/Chunky/versions?limit=1&channel=Release&platform=PAPER"
URL=$(curl -fsSL -H "User-Agent: $UA" "$API" | jq -r '.result[0].downloads.PAPER.downloadUrl')
curl -fLO -H "User-Agent: $UA" "$URL"
exit

Infine riavvia il server:

Terminale
sudo systemctl restart minecraft.service

All'avvio, Paper riconosce il plugin dal nome dichiarato nel suo file, e non dal nome del .jar. Sostituisce la vecchia versione, mantiene il nome del nuovo file e svuota la cartella update.

Aggiornare Paper

Paper pubblica spesso correzioni e consiglia di aggiornarlo almeno una volta alla settimana. Sconsiglia invece gli aggiornamenti automatici, perché può verificarsi un conflitto con un plugin.

Terminale
sudo systemctl stop minecraft.service
sudo tar -czf /opt/minecraft/backups/avant-maj-$(date +%F-%H%M).tar.gz -C /opt/minecraft server
sudo -u minecraft /opt/minecraft/paper-update.sh 26.3
sudo systemctl start minecraft.service
sudo journalctl -u minecraft.service -f

Tieni d'occhio l'avvio: è lì che compaiono i conflitti tra plugin.

Adattare il backup automatico

Lo script backup.sh della guida di base archivia le cartelle del mondo presenti sul server. Per salvare anche i plugin, sostituisci la riga for di /opt/minecraft/backup.sh con:

Terminale
for item in world world_nether world_the_end plugins config server.properties; do

Ripristinare il backup

Se la migrazione non va a buon fine, ripristina l'archivio creato all'inizio. Sostituisci il nome del file con quello mostrato da ls:

Terminale
sudo systemctl stop minecraft.service
sudo ls -lh /opt/minecraft/backups
sudo mv /opt/minecraft/server /opt/minecraft/server-echec
sudo tar -xzf /opt/minecraft/backups/avant-paper-AAAA-MM-GG-HHMM.tar.gz -C /opt/minecraft
sudo systemctl start minecraft.service

La cartella server-echec può essere eliminata quando tutto funziona di nuovo.

In caso di problemi

Inizia sempre leggendo la parte iniziale dei log, dove vengono caricati i plugin:

Terminale
sudo journalctl -u minecraft.service -n 200 --no-pager
sudo less /opt/minecraft/server/logs/latest.log

« Minecraft 26.1 and newer requires running the server with Java 25 or above »

Il servizio usa ancora una vecchia versione di Java. Verifica java --version, poi esegui di nuovo il comando update-alternatives della sezione Installare Java 25. L'errore UnsupportedClassVersionError ha la stessa causa, anche quando riguarda un plugin.

« Server attempted to load chunk saved with newer version of minecraft! »

Il mondo è stato salvato da una versione più recente di quella di Paper installata. Installa la versione corretta con paper-update.sh, oppure ripristina il backup.

Lo script paper-update.sh non funziona

  • curl: (22) … 404: questa versione di Minecraft non esiste per Paper, controlla il numero
  • Nessuna build stabile trovata: la versione esiste, ma non ha ancora una build stabile
  • sha256sum: WARNING: il download è danneggiato, esegui di nuovo lo script. Il tuo server.jar non è stato modificato

Un plugin non si carica

Cerca il nome del plugin nei log. I messaggi più comuni sono:

Messaggio Causa Soluzione
Unknown/missing dependency plugins o UnknownDependencyException Manca una dipendenza Installa il plugin indicato
Ambiguous plugin name Due file per lo stesso plugin Conserva un solo .jar
Invalid plugin.yml o zip END header not found Non è un plugin Paper, oppure il file è incompleto Scarica di nuovo il file corretto
Unsupported API version Il plugin è destinato a una versione più recente del tuo server Aggiorna Paper o scegli una versione compatibile del plugin

AccessDeniedException o « Permission denied »

Un file è stato creato con sudo e non appartiene a minecraft. Restituisci la cartella a questo utente. La guida di base crea un account di sistema senza gruppo dedicato, quindi indica solo l'utente:

Terminale
sudo chown -R minecraft /opt/minecraft/server

mc-console non risponde

  • Il servizio minecraft.service non è avviato: avvia il server con sudo systemctl start minecraft.service
  • Nessuna risposta visualizzata: il server si sta ancora avviando oppure il comando richiede tempo. Attendi la riga Done, oppure aumenta l'attesa con sudo MC_CONSOLE_WAIT=10 mc-console version
  • Socket service minecraft.service already active, refusing: il server era in esecuzione quando la pipe è stata creata. Arrestalo con sudo systemctl stop minecraft.service, poi avvialo di nuovo

Per approfondire

Il tuo server è pronto per accogliere altri plugin:

Per i dettagli sulle opzioni di Paper, consulta la documentazione ufficiale.