Installare un server Minecraft su Debian o Ubuntu (Paper)

Vuoi gestire un server Minecraft sul tuo server root Linux con Debian o Ubuntu? Allora sei nel posto giusto. In questa guida installiamo passo dopo passo un server Paper (compatibile con i plugin Spigot e Bukkit) tramite la console SSH.

Tutti i comandi sono pensati per Debian 13, Debian 12 e Ubuntu 24.04 LTS. I sistemi più vecchi come Debian 10 o Ubuntu 20.04 hanno già raggiunto la fine del supporto e non ricevono più aggiornamenti di sicurezza. Per un server raggiungibile da internet non dovresti più usare queste versioni.

Requisiti per un server Minecraft personale

• Un server root o VPS con Debian 13, Debian 12 o Ubuntu 24.04 LTS
• Accesso root via SSH
• Almeno 2 GB di RAM riservati al solo server Minecraft, di più se usi plugin o hai molti giocatori
• La porta TCP 25565 aperta, la porta standard di Minecraft Java Edition

Aggiornare l'elenco dei pacchetti e installare gli aggiornamenti

Prima di iniziare, aggiorna l'elenco dei pacchetti del tuo sistema operativo e installa tutti gli aggiornamenti disponibili. Basta un solo comando:

apt update && apt upgrade -y

Di quale versione di Java ha bisogno il tuo server Minecraft?

Minecraft richiede una versione di Java diversa a seconda della versione del server. Se il server viene avviato con una versione di Java troppo vecchia, si interrompe subito con un messaggio di errore, di solito con un riferimento a una versione di classe non supportata. Per la Java Edition vale questo abbinamento:

• Minecraft 1.20.5 e successivi: Java 21
• Da Minecraft 1.18 a 1.20.4: Java 17
• Minecraft 1.17: Java 16
• Minecraft 1.16.5 e precedenti: Java 8

Le versioni attuali del server richiedono quindi Java 21. Nel dubbio installa Java 21, perché una versione di Java più recente di norma riesce ad avviare anche le build di Minecraft più vecchie.

Installare Java 21 su Debian 13 e Ubuntu 24.04 LTS

Entrambi i sistemi includono Java 21 direttamente nei propri repository:

apt install openjdk-21-jre-headless -y

Su Debian 12 il repository standard contiene solo Java 17. Come ottenere comunque Java 21 lo spiega la nostra guida dedicata Installare Java 21 su Debian.

Java 17 per le versioni di Minecraft più vecchie

Se scegli consapevolmente di gestire una versione del server compresa tra la 1.18 e la 1.20.4, installa invece Java 17:

apt install openjdk-17-jre-headless -y

Altri modi per installarlo sono descritti nella nostra guida Installare Java 17 su Debian.

Verificare l'installazione di Java

Controlla poi quale versione di Java è effettivamente attiva:

java -version

Nell'output deve comparire la versione principale desiderata, quindi ad esempio "openjdk version 21". Se compare un'altra versione, significa che una seconda installazione di Java è ancora impostata come predefinita.

Installare screen perché il server resti sempre attivo

Senza un aiuto esterno il server Minecraft verrebbe terminato non appena chiudi la sessione SSH. Il pacchetto "screen" mantiene il processo attivo in una sessione separata:

apt install screen -y

Creare un utente dedicato per il server Minecraft

Non gestire mai il server come root. Crea invece un utente dedicato. Questo è importante soprattutto se sullo stesso server girano altre applicazioni, perché in questo modo un plugin compromesso non arriva all'intero sistema.

adduser --disabled-login spigot

L'opzione --disabled-login disattiva l'accesso diretto via SSH per questo utente. Le domande su nome, indirizzo o numero di telefono le puoi saltare con il tasto Invio.

Ora passa al nuovo utente e alla sua directory home:

su spigot && cd

Lì crea una directory per il server (nell'esempio "server") ed entraci:

mkdir server && cd server/

Scegliere e scaricare la versione di Paper

La versione di Paper che ti serve la trovi sulla pagina ufficiale dei download: https://papermc.io/downloads. Dal selettore delle versioni raggiungi anche le build più vecchie.

Copia il link di download (clic destro sul pulsante della build, poi "Copia indirizzo link"), torna nella console SSH e scarica il file con wget. Il risultato è più o meno questo:

#SOLO UN LINK DI ESEMPIO, USA IL LINK ATTUALE DI PAPERMC.IO!

wget https://api.papermc.io/v2/projects/paper/versions/1.20.1/builds/45/downloads/paper-1.20.1-45.jar

Poi rinomina il file scaricato in "spigot.jar", così lo script di avvio può usare sempre lo stesso nome di file. A un cambio di versione successivo ti basterà sostituire il file:

mv paper*.jar spigot.jar

Creare lo script di avvio e accettare l'EULA

Crea un file "start.sh":

nano start.sh

Inserisci il contenuto seguente. Nell'esempio il server riceve 4 GB di RAM, valore che adatti al tuo server tramite -Xmx:

screen -AmdS spigot java -Xmx4G -jar spigot.jar

Con "CTRL + X", poi "Y" e "Invio" salvi il file.

Rendi quindi lo script eseguibile e accetta la licenza per l'utente finale di Minecraft. Senza EULA accettata nessun server Minecraft si avvia:

chmod +x start.sh && echo "eula = true" > eula.txt

Avviare il server Minecraft e usare la console

Adesso avvia il server:

./start.sh

Il primo avvio dura un po' di più, perché vengono generati il mondo e i file di configurazione.

Con "CTRL + A + D" esci dalla console del server senza terminarlo. Puoi tornare nella console in qualsiasi momento con:

screen -r spigot

Importante: la sessione screen appartiene all'utente "spigot". Accedi quindi prima con su spigot e solo dopo lancia screen -r.

Prossimi passi dopo l'installazione

Il server è in funzione, l'installazione di base è quindi completata. Ci sono due aspetti che conviene affrontare subito dopo:

• Avvio automatico: perché il server riparta da solo dopo un riavvio del sistema operativo, configura una service unit systemd. L'intera procedura è descritta nella nostra guida Avviare automaticamente un server Minecraft.
• Configurazione: nel file "server.properties" definisci tra l'altro la modalità di gioco, il livello di difficoltà, il numero massimo di giocatori e la porta. Dopo ogni modifica è necessario un riavvio del server.