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.
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:
java --version
sudo apt install -y curl jq unzipIl 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
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/backupsSe 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:
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.txtIl 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:
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
exitSe 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:
sudo mkdir -p /etc/systemd/system/minecraft.service.d
sudo nano /etc/systemd/system/minecraft.service.d/modded.conf[Service]
WorkingDirectory=/opt/minecraft/modded
ExecStart=
ExecStart=/usr/bin/java -Xms2G -Xmx4G -jar /opt/minecraft/modded/fabric-server.jar nogui
SuccessExitStatus=130 143
TimeoutStopSec=180La 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:
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
exitL'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:
sudo mkdir -p /etc/systemd/system/minecraft.service.d
sudo nano /etc/systemd/system/minecraft.service.d/modded.conf[Service]
WorkingDirectory=/opt/minecraft/modded
ExecStart=
ExecStart=/bin/sh /opt/minecraft/modded/run.sh nogui
SuccessExitStatus=130 143
TimeoutStopSec=180La 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:
sudo nano /opt/minecraft/mod-get.sh#!/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')"
doneSostituisci tuo-dominio.com nella riga UA, poi rendi eseguibile lo script:
sudo chmod 755 /opt/minecraft/mod-get.shIl 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:
sudo -u minecraft /opt/minecraft/mod-get.sh fabric-api fabric 26.3
sudo -u minecraft /opt/minecraft/mod-get.sh lithium fabric 26.3Con NeoForge:
sudo -u minecraft /opt/minecraft/mod-get.sh lithium neoforge 26.3Ogni riga .part: OK conferma che il download è integro. Installa anche ogni Dipendenza richiesta mostrata, con lo stesso comando.
Avviare il server
sudo systemctl daemon-reload
sudo systemctl start minecraft.service
sudo journalctl -u minecraft.service -fIl 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
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 *:
sudo unzip -p /opt/minecraft/modded/mods/NOME_DEL_MOD.jar fabric.mod.json | jq -r '.environment // empty'Ogni giocatore deve poi:
- Installare la stessa versione di Minecraft e lo stesso loader, con l'installer di Fabric o l'installer di NeoForge
- Avviare una volta il profilo creato nel launcher
- Copiare le mod richieste, nelle stesse versioni del server, nella cartella
modsdel 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:
tar -czf $BACKUP_DIR/world_modded_$DATE.tar.gz -C /opt/minecraft/modded world mods config server.propertiesAggiornare
Esegui sempre il backup prima di un aggiornamento, a server arrestato:
sudo systemctl stop minecraft.service
sudo tar -czf /opt/minecraft/backups/modded-$(date +%F-%H%M).tar.gz -C /opt/minecraft moddedPer aggiornare una mod, elimina il suo vecchio file, poi esegui di nuovo lo script:
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.servicePer 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:
sudo systemctl stop minecraft.service
sudo rm /etc/systemd/system/minecraft.service.d/modded.conf
sudo systemctl daemon-reload
sudo systemctl start minecraft.serviceLa 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
sudo journalctl -u minecraft.service -n 200 --no-pager
sudo less /opt/minecraft/modded/logs/latest.logI 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 versionecurlsegnala un errore404: il nome della mod non è correttonon si installa su un server: questa mod va installata solo dai giocatorisha512sum: 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.