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.
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-consoleper 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:
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 VanillaSe 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:
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/backupsSe 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:
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 libxrender1Il servizio avvia /usr/bin/java. Se è installato anche Java 21, fai puntare questo comando a Java 25:
sudo update-alternatives --set java "$(update-alternatives --list java | grep -m1 'java-25')"
java --versionL'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:
sudo nano /opt/minecraft/paper-update.sh#!/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:
sudo chmod 755 /opt/minecraft/paper-update.sh
sudo -u minecraft /opt/minecraft/paper-update.sh 26.3La 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:
sudo nano /etc/systemd/system/minecraft.socket[Unit]
Description=Console del server Minecraft
PartOf=minecraft.service
[Socket]
ListenFIFO=/run/minecraft.stdin
SocketMode=0600Solo 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:
sudo mkdir -p /etc/systemd/system/minecraft.service.d
sudo nano /etc/systemd/system/minecraft.service.d/console.conf[Unit]
Requires=minecraft.socket
After=minecraft.socket
[Service]
Sockets=minecraft.socket
StandardInput=socket
StandardOutput=journal
StandardError=journal
SuccessExitStatus=130 143
TimeoutStopSec=180SuccessExitStatus 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:
sudo nano /usr/local/bin/mc-console#!/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 catsudo chmod 755 /usr/local/bin/mc-console
sudo systemctl daemon-reloadAvviare Paper
sudo systemctl start minecraft.service
sudo journalctl -u minecraft.service -fIl 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
sudo mc-console version
sudo mc-console plugins
sudo ls /opt/minecraft/server /opt/minecraft/server/worldDovresti 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.ymle la cartellaconfig, oltre alla tua cartellaworld
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:
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:
URL=$(curl -fsSL -H "User-Agent: $UA" "$API" | jq -r '.result[0].downloads.PAPER.downloadUrl')
curl -fLO -H "User-Agent: $UA" "$URL"
ls -l
exitSe 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:
scp MonPlugin.jar TUO_USER@IP_SERVER:/tmp/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:
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fsudo mc-console pluginsUn 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:
sudo tar -czf /opt/minecraft/backups/plugins-$(date +%F-%H%M).tar.gz -C /opt/minecraft/server pluginsMetti poi la nuova versione in update. Ecco l'esempio di Chunky:
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"
exitInfine riavvia il server:
sudo systemctl restart minecraft.serviceAll'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.
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 -fTieni 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:
for item in world world_nether world_the_end plugins config server.properties; doRipristinare 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:
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.serviceLa 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:
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 numeroNessuna build stabile trovata: la versione esiste, ma non ha ancora una build stabilesha256sum: WARNING: il download è danneggiato, esegui di nuovo lo script. Il tuoserver.jarnon è 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:
sudo chown -R minecraft /opt/minecraft/servermc-console non risponde
Il servizio minecraft.service non è avviato: avvia il server consudo 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 consudo 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 consudo systemctl stop minecraft.service, poi avvialo di nuovo
Per approfondire
Il tuo server è pronto per accogliere altri plugin:
- Gestire gradi e permessi con LuckPerms
- Installare e configurare EssentialsX
- Accogliere i giocatori Bedrock con Geyser e Floodgate
Per i dettagli sulle opzioni di Paper, consulta la documentazione ufficiale.