IT

Server di gioco

Come creare un server Minecraft moddato con Fabric o NeoForge

Crea un server Minecraft moddato con Fabric o NeoForge su un VPS o server dedicato Linux: installazione, mod lato server e lato client, aggiornamenti e risoluzione dei problemi.

10 min di lettura, aggiornato il 18 novembre 2026

In questa pagina

I tuoi valori

Inseriscili una volta: i comandi della guida si aggiornano.

Le mod aggiungono contenuti o modificano il funzionamento del gioco. Hanno bisogno di un loader: questa guida installa Fabric o NeoForge in una cartella separata, senza toccare il tuo server attuale.

È il seguito della guida Creare un server Minecraft e riutilizza l'utente minecraft e il servizio minecraft.service.

Al termine di questa guida avrai:

  • un server moddato in /opt/minecraft/modded, avviato dal solito servizio
  • uno script che scarica le mod e ne controlla l'integrità
  • un metodo per sapere quali mod installare sul server e sui client dei giocatori
  • un modo semplice per tornare al tuo server originale

Prerequisiti

  • Un server installato seguendo la guida Creare un server Minecraft
  • Java 25, da installare come indicato nella sezione Installare Java 25 della guida Paper
  • Accesso SSH con un utente che dispone di sudo
  • Almeno 4 GB di memoria per il server, e di più per un gran numero di mod

Verifica Java e installa gli strumenti usati da questa guida:

Terminale
java --version
sudo apt install -y curl jq unzip

Il primo comando deve mostrare openjdk 25 o una versione superiore.

Scegliere tra Fabric e NeoForge

Fabric NeoForge
Origine Loader leggero e modulare Progetto derivato da Forge
Base comune Fabric API, richiesta da molte mod Integrata nel loader
Avvio Un file .jar Installer, poi argomenti Java dedicati

La scelta giusta dipende soprattutto dalle mod che vuoi: una mod viene pubblicata per un loader preciso, e una mod Fabric non funziona su NeoForge, né viceversa. Verifica prima la loro disponibilità su Modrinth.

Eseguire il backup e arrestare il server attuale

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

Se hai configurato Velocity, arresta anche velocity.service, che occupa la porta 25565.

Preparare la cartella

Crea la cartella e riprendi le impostazioni del tuo server:

Terminale
sudo -u minecraft mkdir -p /opt/minecraft/modded/mods
sudo -u minecraft cp /opt/minecraft/server/server.properties /opt/minecraft/modded/
sudo -u minecraft sed -i \
    -e 's/^server-ip=.*/server-ip=/' \
    -e 's/^server-port=.*/server-port=25565/' \
    -e 's/^online-mode=.*/online-mode=true/' \
    /opt/minecraft/modded/server.properties
echo "eula=true" | sudo -u minecraft tee /opt/minecraft/modded/eula.txt

Il server moddato creerà un nuovo mondo in /opt/minecraft/modded/world.

Segui poi una sola delle due sezioni seguenti.

Installare Fabric

Apri una sessione minecraft, poi recupera le ultime versioni stabili del loader e del launcher:

Terminale
sudo -u minecraft bash
cd /opt/minecraft/modded
MC=26.3
LOADER=$(curl -fsSL "https://meta.fabricmc.net/v2/versions/loader/$MC" | jq -r 'map(select(.loader.stable)) | .[0].loader.version')
INSTALLER=$(curl -fsSL "https://meta.fabricmc.net/v2/versions/installer" | jq -r 'map(select(.stable)) | .[0].version')
echo "Fabric Loader $LOADER, launcher $INSTALLER"
curl -fL -o fabric-server.jar "https://meta.fabricmc.net/v2/versions/loader/$MC/$LOADER/$INSTALLER/server/jar"
ls -l fabric-server.jar
exit

Se la versione del loader è vuota o vale null, Fabric non supporta questo numero di versione di Minecraft: controllalo.

Fai poi puntare il servizio a Fabric. 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/modded.conf
Configurazione
[Service]
WorkingDirectory=/opt/minecraft/modded
ExecStart=
ExecStart=/usr/bin/java -Xms2G -Xmx4G -jar /opt/minecraft/modded/fabric-server.jar nogui
SuccessExitStatus=130 143
TimeoutStopSec=180

La riga ExecStart= vuota annulla il comando originale. Adatta -Xmx alla tua memoria, poi passa ad Aggiungere mod.

Installare NeoForge

Apri una sessione minecraft e cerca l'ultima versione stabile per la tua versione di Minecraft. Per Minecraft 26.3, le versioni di NeoForge iniziano con 26.3.0:

Terminale
sudo -u minecraft bash
cd /opt/minecraft/modded
PREFIXE=26.3.0
MAVEN=https://maven.neoforged.net/releases/net/neoforged/neoforge
NEO=$(curl -fsSL "$MAVEN/maven-metadata.xml" | grep -F "<version>$PREFIXE." | grep -v beta | sed 's/ *<[^>]*>//g' | sort -V | tail -n 1)
echo "NeoForge $NEO"
curl -fLO "$MAVEN/$NEO/neoforge-$NEO-installer.jar"
echo "$(curl -fsSL "$MAVEN/$NEO/neoforge-$NEO-installer.jar.sha256")  neoforge-$NEO-installer.jar" | sha256sum -c -
java -jar "neoforge-$NEO-installer.jar" --installServer
printf -- '\n-Xms2G\n-Xmx4G\n' >> user_jvm_args.txt
ls
exit

L'installer scarica il server Minecraft e le sue librerie. Dovresti poi vedere run.sh, user_jvm_args.txt e la cartella libraries.

Fai puntare il servizio a NeoForge. Lo script run.sh avvia Java con gli argomenti corretti e resta valido dopo un aggiornamento:

Terminale
sudo mkdir -p /etc/systemd/system/minecraft.service.d
sudo nano /etc/systemd/system/minecraft.service.d/modded.conf
Configurazione
[Service]
WorkingDirectory=/opt/minecraft/modded
ExecStart=
ExecStart=/bin/sh /opt/minecraft/modded/run.sh nogui
SuccessExitStatus=130 143
TimeoutStopSec=180

La memoria si imposta in user_jvm_args.txt.

Aggiungere mod

Crea uno script che recupera una mod da Modrinth, ne controlla il checksum, scarta le mod riservate al client e segnala le dipendenze:

Terminale
sudo nano /opt/minecraft/mod-get.sh
Terminale
#!/bin/bash
# Scarica da Modrinth l'ultima versione stabile di una mod per il server
set -euo pipefail

MOD="${1:?Indica la mod, ad esempio lithium}"
CHARGEUR="${2:?Indica il loader: fabric o neoforge}"
MC_VERSION="${3:?Indica la versione di Minecraft, ad esempio 26.3}"
UA="mon-serveur-minecraft/1.0 (https://tuo-dominio.com)"
API="https://api.modrinth.com/v2"

cd /opt/minecraft/modded/mods

VERSION=$(curl -fsSL -H "User-Agent: $UA" -G "$API/project/$MOD/version" \
    --data-urlencode "loaders=[\"$CHARGEUR\"]" \
    --data-urlencode "game_versions=[\"$MC_VERSION\"]" \
    --data-urlencode "include_changelog=false" \
    | jq -c 'map(select(.version_type == "release")) | .[0]')
if [ "$VERSION" = "null" ]; then
    echo "Nessuna versione stabile di $MOD per $CHARGEUR $MC_VERSION." >&2
    exit 1
fi

ENVIRONNEMENT=$(echo "$VERSION" | jq -r '.environment // "unknown"')
case "$ENVIRONNEMENT" in
    client_only|singleplayer_only)
        echo "$MOD non si installa su un server ($ENVIRONNEMENT)." >&2
        exit 1
        ;;
esac

FICHIER=$(echo "$VERSION" | jq -c '(.files | map(select(.primary)) | .[0]) // .files[0]')
NOM=$(basename "$(echo "$FICHIER" | jq -r '.filename')")
URL=$(echo "$FICHIER" | jq -r '.url')
SHA512=$(echo "$FICHIER" | jq -r '.hashes.sha512')

curl -fL -H "User-Agent: $UA" -o "$NOM.part" "$URL"
echo "$SHA512  $NOM.part" | sha512sum -c -
mv "$NOM.part" "$NOM"
echo "$NOM è stato installato (ambiente: $ENVIRONNEMENT)."

for ID in $(echo "$VERSION" | jq -r '.dependencies[]? | select(.dependency_type == "required") | .project_id // empty'); do
    echo "Dipendenza richiesta: $(curl -fsSL -H "User-Agent: $UA" "$API/project/$ID" | jq -r '.slug')"
done

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

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

Il nome da passare allo script è quello presente nell'indirizzo della mod su Modrinth: da modrinth.com/mod/lithium si ottiene lithium. Ecco due esempi con Lithium, una mod di ottimizzazione che funziona senza essere installata dai giocatori.

Con Fabric, aggiungi anche Fabric API, richiesta dalla maggior parte delle mod:

Terminale
sudo -u minecraft /opt/minecraft/mod-get.sh fabric-api fabric 26.3
sudo -u minecraft /opt/minecraft/mod-get.sh lithium fabric 26.3

Con NeoForge:

Terminale
sudo -u minecraft /opt/minecraft/mod-get.sh lithium neoforge 26.3

Ogni riga .part: OK conferma che il download è integro. Installa anche ogni Dipendenza richiesta mostrata, con lo stesso comando.

Avviare il server

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

Il primo avvio è più lungo, perché viene creato il mondo. Il server è pronto quando compare la riga Done (…)! For help, type "help". Esci dalla visualizzazione dei log con Ctrl+C.

Verificare il risultato

Terminale
systemctl show minecraft.service -p WorkingDirectory
sudo ls -l /opt/minecraft/modded/mods
sudo journalctl -u minecraft.service --since "15 minutes ago" --no-pager | grep -iE 'fabric loader|loading [0-9]+ mods|neoforge|done \('

La cartella di lavoro deve essere /opt/minecraft/modded. Con Fabric, i log mostrano Loading Minecraft 26.3 with Fabric Loader e il numero di mod. Con NeoForge, citano NeoForge all'avvio. In entrambi i casi deve essere presente la riga Done, senza errori relativi alle mod nelle righe precedenti.

Se avevi creato il comando mc-console con la guida Paper, funziona ancora, perché il servizio resta lo stesso: sudo mc-console list.

Installare le mod lato client

Non tutte le mod vanno nello stesso posto. Su Modrinth, ogni versione indica un ambiente, che viene mostrato dallo script:

Ambiente Server Giocatori
client_and_server Sì Sì
server_only, dedicated_server_only Sì No
server_only_client_optional Sì Facoltativo
client_only No Sì
client_only_server_optional Facoltativo Sì
client_or_server Basta uno dei due Basta uno dei due
client_or_server_prefers_both Consigliato Consigliato
singleplayer_only No Solo in giocatore singolo
unknown Consulta la pagina della mod Consulta la pagina della mod

Ad esempio, Sodium è riservata al client e FabricProxy-Lite al server dedicato. Una mod che aggiunge blocchi o oggetti deve quasi sempre essere presente su entrambi i lati.

Per una mod Fabric già scaricata, anche il file può indicare il lato. Il comando mostra client, server o * per entrambi, e nulla se il campo è assente, il che equivale a *:

Terminale
sudo unzip -p /opt/minecraft/modded/mods/NOME_DEL_MOD.jar fabric.mod.json | jq -r '.environment // empty'

Ogni giocatore deve poi:

  1. Installare la stessa versione di Minecraft e lo stesso loader, con l'installer di Fabric o l'installer di NeoForge
  2. Avviare una volta il profilo creato nel launcher
  3. Copiare le mod richieste, nelle stesse versioni del server, nella cartella mods del gioco
Sistema Cartella mods
Windows %APPDATA%\.minecraft\mods
macOS ~/Library/Application Support/minecraft/mods
Linux ~/.minecraft/mods

Per un gruppo di giocatori, un modpack evita le differenze di versione: pubblica un elenco preciso, oppure un pack in formato Modrinth che ciascuno importa nel proprio launcher. Se un modpack offre una versione « server », usala sul server.

Eseguire il backup del server moddato

Lo script backup.sh della guida di base non conosce questa cartella. Aggiungi questa riga a /opt/minecraft/backup.sh, dopo la riga tar esistente. Il prefisso world_ fa sì che la pulizia automatica tenga conto di questo archivio:

Terminale
tar -czf $BACKUP_DIR/world_modded_$DATE.tar.gz -C /opt/minecraft/modded world mods config server.properties

Aggiornare

Esegui sempre il backup prima di un aggiornamento, a server arrestato:

Terminale
sudo systemctl stop minecraft.service
sudo tar -czf /opt/minecraft/backups/modded-$(date +%F-%H%M).tar.gz -C /opt/minecraft modded

Per aggiornare una mod, elimina il suo vecchio file, poi esegui di nuovo lo script:

Terminale
sudo ls /opt/minecraft/modded/mods
sudo -u minecraft rm /opt/minecraft/modded/mods/lithium-fabric-VECCHIA_VERSIONE.jar
sudo -u minecraft /opt/minecraft/mod-get.sh lithium fabric 26.3
sudo systemctl start minecraft.service

Per aggiornare il loader, esegui di nuovo i comandi della sua sezione di installazione, senza la riga printf per NeoForge, poi controlla la memoria in user_jvm_args.txt. Comunica le modifiche ai giocatori quando una mod o il loader sono installati anche sui loro client.

Tornare al server originale

Rimuovi l'integrazione del servizio. La tua cartella /opt/minecraft/server non è stata modificata:

Terminale
sudo systemctl stop minecraft.service
sudo rm /etc/systemd/system/minecraft.service.d/modded.conf
sudo systemctl daemon-reload
sudo systemctl start minecraft.service

La cartella /opt/minecraft/modded resta al suo posto: puoi tornarci ricreando il file modded.conf. Se usi Velocity, riavvia anche velocity.service.

In caso di problemi

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

I crash report si trovano in /opt/minecraft/modded/crash-reports.

« Incompatible mods found! » (Fabric)

Il messaggio elenca le mod interessate, con righe come requires … which is missing! o but only the wrong version is present. Installa la dipendenza mancante, spesso fabric-api, oppure scegli una versione compatibile.

« Cannot load class … in environment type SERVER »

Sul server è presente una mod riservata al client. Rimuovi la mod citata nel report. Con NeoForge, lo stesso problema si presenta spesso sotto forma di NoClassDefFoundError su una classe net/minecraft/client/….

« Mod … requires … » (NeoForge)

Manca una dipendenza oppure la sua versione non è corretta. Il messaggio indica la mod da installare e la versione attesa.

« Mod … is present in multiple files »

Con NeoForge, in mods si trovano due versioni della stessa mod. Conserva la più recente. Anche con Fabric, tieni un solo file per mod.

« You are trying to connect to a server that is running NeoForge, but you are not »

Il giocatore avvia il gioco senza NeoForge. Deve installare la versione indicata e scegliere questo profilo nel launcher.

« Your client is missing the following mods »

Con NeoForge, la schermata di connessione elenca le mod che il giocatore deve aggiungere. La dicitura The following mod versions do not match segnala versioni diverse: allineale a quelle del server.

« Received a registry entry that is unknown to this client »

Con Fabric, il client e il server non hanno le stesse mod di contenuto. Confronta i due elenchi, comprese le versioni.

« Incompatible client! Please use … »

Il client non usa la stessa versione di Minecraft del server. Seleziona il profilo corretto nel launcher.

« UnsupportedClassVersionError »

Java è troppo vecchio per questo server o per una mod. Controlla java --version, poi la sezione Installare Java 25.

« FAILED TO BIND TO PORT »

Un altro servizio occupa la porta 25565, spesso Velocity. Individualo con sudo ss -ltnp | grep 25565.

Lo script mod-get.sh non funziona

  • Nessuna versione stabile: la mod non esiste per questo loader e questa versione
  • curl segnala un errore 404: il nome della mod non è corretto
  • non si installa su un server: questa mod va installata solo dai giocatori
  • sha512sum: WARNING: il download è danneggiato. Esegui di nuovo lo script

Per approfondire, consulta la documentazione di Fabric, la guida al server di NeoForge e la spiegazione degli ambienti su Modrinth.