Héberger un serveur Minecraft moddé (Forge ou Fabric) sur un VPS Linux

Pourquoi un serveur Minecraft modde demande une installation differente

Un serveur Minecraft vanilla utilise le JAR officiel de Mojang. Un serveur modde ajoute une couche intermediaire, le mod loader, qui intercepte le code du jeu pour charger des mods cote serveur. Ce mod loader modifie le processus de demarrage, la structure des fichiers de config et la consommation de ressources de la machine. Il impose ses propres flags JVM, son repertoire mods/ et sa logique de mise a jour. Si vous avez deja installe un serveur vanilla en suivant notre guide pour heberger un serveur Minecraft, ce tuto reprend la ou il s'arrete.

Ce guide s'adresse aux administrateurs et admins systeme qui gerent un serveur distant : VPS Linux (serveur prive virtuel) ou serveur dedie sous Ubuntu ou Debian. Un VPS est une machine virtuelle isolee grace a la virtualisation, avec ses propres ressources CPU, RAM et espace disque. Vous y trouverez les commandes exactes a executer dans un shell Unix pour installer Forge, NeoForge ou Fabric, configurer les flags JVM, ajouter des mods d'optimisation serveur et dimensionner votre machine en fonction du nombre de joueurs et de mods charges.

Forge, NeoForge ou Fabric : quel mod loader choisir

Il existe trois mod loaders principaux pour Minecraft Java Edition en 2026. Chacun a son ecosysteme de mods, sa methode d'installation et ses avantages. Le choix du mod loader determine quels mods et modpacks vous pourrez installer sur votre serveur.

En resume : pour un nouveau serveur modde sous Minecraft 26.x en 2026, choisissez NeoForge si vous voulez des modpacks lourds (All The Mods 10, Better MC 5) ou Fabric si vous privilegiez la performance et la legerete. Forge reste pertinent uniquement pour maintenir un serveur existant sous Minecraft 1.20.1 ou anterieur.

Prerequis

• Un VPS Linux (machine virtuelle) ou un serveur dedie sous Ubuntu 22.04+, Ubuntu 24.04+ ou Debian 12+, chez un hebergeur proposant un acces root ;
• Un acces SSH root ou sudo pour executer des commandes dans le shell distant ;
• Java 25 (obligatoire pour Minecraft 26.x) : les versions anterieures provoquent une erreur UnsupportedClassVersionError au demarrage du serveur ;
• Le port 25565/TCP ouvert dans le firewall (pare-feu) du serveur (guide UFW pour serveurs de jeu).

Connectez-vous a votre serveur distant via SSH et installez les paquets Java avec la commande suivante :

sudo apt update
sudo apt install -y openjdk-25-jre-headless

Verifiez l'installation avec la commande suivante :

java -version

Le shell doit afficher openjdk version "25" ou superieur. Si votre distribution ne propose pas encore le package Java 25 dans ses depots de paquets, utilisez le PPA Adoptium pour installer Temurin :

sudo apt install -y wget apt-transport-https gpg
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo gpg --dearmor -o /usr/share/keyrings/adoptium.gpg
echo "deb [signed-by=/usr/share/keyrings/adoptium.gpg] https://packages.adoptium.net/artifactory/deb $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
sudo apt update
sudo apt install -y temurin-25-jre

Installer un serveur NeoForge (ou Forge)

NeoForge est le successeur de Forge pour Minecraft 1.20.5 et superieur. La procedure d'installation est identique pour Forge classique : seul le fichier executable JAR change.

Creez un repertoire dedie sur votre serveur et telechargez l'executable de l'installeur depuis le site officiel de NeoForge :

mkdir -p ~/minecraft-modde && cd ~/minecraft-modde
wget https://maven.neoforged.net/releases/net/neoforged/neoforge/DERNIERE_VERSION/neoforge-DERNIERE_VERSION-installer.jar

Remplacez DERNIERE_VERSION par le numero de version affiche sur la page de telechargement officielle (par exemple 26.1.0.1 pour Minecraft 26.1). Lancez l'installation serveur en mode headless (sans interface graphique desktop) avec la commande suivante :

java -jar neoforge-*-installer.jar --installServer

L'installeur telecharge le serveur Minecraft, les bibliotheques NeoForge et genere un script de demarrage run.sh. Acceptez le contrat de licence :

echo "eula=true" > eula.txt

Editez le fichier de config user_jvm_args.txt pour definir la memoire allouee a la JVM :

echo "-Xms4G -Xmx4G" > user_jvm_args.txt

Rendez le script executable et demarrez le serveur :

chmod +x run.sh
./run.sh

Le serveur genere les fichiers de config server.properties, le repertoire world/ et le repertoire mods/. Arretez-le avec stop dans la console, deposez vos mods (fichiers JAR) dans mods/, puis redemarrez le serveur.

Pour Forge classique (Minecraft 1.20.1 ou anterieur), la procedure est la meme : telechargez l'executable de l'installeur depuis files.minecraftforge.net et executez java -jar forge-*-installer.jar --installServer.

Installer un serveur Fabric

Fabric est plus leger que NeoForge/Forge. Son installeur en ligne de commande telecharge l'executable du serveur Minecraft et le loader en une seule operation depuis le shell :

mkdir -p ~/minecraft-fabric && cd ~/minecraft-fabric
wget https://maven.fabricmc.net/net/fabricmc/fabric-installer/1.1.1/fabric-installer-1.1.1.jar
java -jar fabric-installer-1.1.1.jar server -mcversion 26.3 -downloadMinecraft

L'option -mcversion 26.3 precise la version de Minecraft. L'option -downloadMinecraft telecharge automatiquement le JAR serveur officiel. Acceptez le EULA et lancez le serveur :

echo "eula=true" > eula.txt
java -Xms4G -Xmx4G -jar fabric-server-launch.jar nogui

Fabric necessite l'API Fabric pour la plupart des mods. Telechargez-la depuis Modrinth ou CurseForge et deposez le fichier JAR dans le repertoire mods/ :

mkdir -p mods
wget -O mods/fabric-api.jar "https://cdn.modrinth.com/data/P7dR8mSH/versions/DERNIERE_VERSION/fabric-api-DERNIERE_VERSION.jar"

Avant d'ajouter un mod, verifiez toujours qu'il est compatible avec votre version de Minecraft et de Fabric Loader. Un mod incompatible empeche le serveur de demarrer et affiche un message d'erreur dans les logs. Pour auditer la fiabilite d'un mod avant de l'installer, consultez notre guide pour scanner et auditer les plugins Minecraft.

Lancer le serveur en arriere-plan avec screen

Par defaut, quand vous fermez votre session SSH, le processus du serveur Minecraft s'arrete. Pour que le serveur continue de tourner en arriere-plan sur votre VPS, utilisez screen, un multiplexeur de terminal disponible sur la plupart des distributions Unix et Linux.

Installez le package screen si ce n'est pas deja fait :

sudo apt install -y screen

Lancez une session screen nommee, puis demarrez le serveur a l'interieur :

screen -S minecraft
cd ~/minecraft-modde
./run.sh

Pour detacher la session et revenir au shell principal sans arreter le serveur, appuyez sur Ctrl+A puis D. Pour vous reconnecter plus tard depuis un terminal SSH distant :

screen -r minecraft

Vous pouvez aussi creer un script shell de demarrage automatique pour ne pas avoir a lancer les commandes manuellement a chaque redemarrage du VPS. Creez un fichier start.sh :

#!/bin/bash
cd ~/minecraft-modde
screen -dmS minecraft ./run.sh

Rendez le script executable avec chmod +x start.sh. Pour un demarrage automatique au boot du serveur, la methode la plus fiable est de creer un service systemd dedie qui gere le demarrage, l'arret propre et le redemarrage automatique du serveur Minecraft.

Configurer les flags JVM pour un serveur modde

Les flags JVM d'Aikar sont la reference pour configurer le ramasse-miettes (garbage collector) G1GC de Java sur un serveur Minecraft. Ils minimisent les pauses de GC qui provoquent des chutes de TPS. Ces flags restent valides et fonctionnels sur Java 25 pour Minecraft 26.x, sans aucun avertissement de la JVM.

Voici la ligne de demarrage recommandee (adaptez la valeur de -Xmx a la RAM disponible sur votre VPS ou serveur dedie) :

java -Xms8G -Xmx8G \
  -XX:+UseG1GC \
  -XX:+ParallelRefProcEnabled \
  -XX:MaxGCPauseMillis=200 \
  -XX:+UnlockExperimentalVMOptions \
  -XX:+DisableExplicitGC \
  -XX:+AlwaysPreTouch \
  -XX:G1NewSizePercent=30 \
  -XX:G1MaxNewSizePercent=40 \
  -XX:G1HeapRegionSize=8M \
  -XX:G1ReservePercent=20 \
  -XX:G1HeapWastePercent=5 \
  -XX:G1MixedGCCountTarget=4 \
  -XX:InitiatingHeapOccupancyPercent=15 \
  -XX:G1MixedGCLiveThresholdPercent=90 \
  -XX:G1RSetUpdatingPauseTimePercent=5 \
  -XX:SurvivorRatio=32 \
  -XX:+PerfDisableSharedMem \
  -XX:MaxTenuringThreshold=1 \
  -jar server.jar nogui

Regle importante : les valeurs -Xms et -Xmx doivent etre identiques. Si elles different, la JVM redimensionne le tas dynamiquement, ce qui provoque des pauses supplementaires. Pour un serveur NeoForge, placez ces flags dans le fichier de config user_jvm_args.txt (un flag par ligne, sans -jar).

Pour surveiller l'impact de ces flags sur la consommation memoire et CPU en temps reel, utilisez htop ou btop depuis un terminal SSH. Si votre serveur virtuel manque de RAM, configurez un fichier swap comme filet de securite (le swap sur la partition disque ne remplace pas la RAM physique pour les performances).

Mods d'optimisation serveur

Un serveur modde charge davantage de logique a chaque tick qu'un serveur vanilla. Des mods d'optimisation reduisent le temps par tick (MSPT) sans modifier le gameplay. Pour une explication detaillee du MSPT et du TPS, consultez notre guide d'optimisation des performances Minecraft.

Lithium

Lithium optimise la physique du jeu, l'IA des entites, le ticking des blocs et la generation de terrain. Il reduit le MSPT de 20 a 40 % selon la charge du serveur, sans changer le comportement vanilla. Lithium est disponible pour Fabric et NeoForge (version 0.26.3 pour Minecraft 26.3). Il fonctionne cote serveur uniquement : les joueurs n'ont pas besoin de l'installer sur leur client.

Telechargez le fichier JAR et placez-le dans le repertoire mods/ de votre serveur :

wget -O mods/lithium.jar "https://cdn.modrinth.com/data/gvQqBUqZ/versions/DERNIERE_VERSION/lithium-fabric-mc26.3-0.26.3.jar"

ScalableLux (successeur de Starlight)

Starlight accelerait le moteur d'eclairage de Minecraft. Le projet a ete archive en mars 2024, mais sa technologie est integree nativement dans Paper. Pour les serveurs Fabric, le fork ScalableLux reprend les optimisations de Starlight avec des correctifs supplementaires. Il ameliore les performances de calcul de la lumiere et permet au systeme de chunks de mieux passer a l'echelle sur les processeurs multi-coeurs. La version 0.3.0-alpha supporte Minecraft 26.3 sur Fabric.

Autres mods d'optimisation selon le mod loader

Ces mods sont cumulables. Installez-les dans le repertoire mods/ de votre serveur et redemarrez le processus Java. Verifiez dans les logs (logs/latest.log) que chaque mod se charge sans erreur. Pour decouvrir d'autres mods utiles, consultez notre selection des meilleurs mods pour debuter sur Minecraft.

Configurer le fichier server.properties

Le fichier de config principal du serveur est server.properties, genere automatiquement au premier demarrage. Voici les parametres les plus importants a verifier pour un serveur modde :

Apres chaque modification du fichier de config, arretez puis redemarrez le serveur pour appliquer les changements. Les mods NeoForge et Fabric generent aussi leurs propres fichiers de config dans le repertoire config/ du serveur.

Connecter un nom de domaine au serveur

Par defaut, les joueurs se connectent a votre serveur en saisissant l'adresse IP publique du VPS dans le client Minecraft (par exemple 203.0.113.10:25565). Pour utiliser un nom de domaine plus simple a retenir (comme play.monserveur.fr), configurez un enregistrement DNS de type A chez votre registrar ou votre hebergeur DNS.

Creez un enregistrement DNS A qui pointe le sous-domaine vers l'adresse IP de votre serveur virtuel :

Si votre serveur utilise un port different de 25565, ajoutez un enregistrement DNS SRV pour que les joueurs n'aient pas a saisir le port manuellement :

La propagation DNS peut prendre quelques minutes a quelques heures. Verifiez que l'enregistrement est actif avec la commande suivante dans votre shell :

dig play.monserveur.fr +short

La commande doit renvoyer l'adresse IP de votre VPS. Les joueurs peuvent ensuite se connecter avec play.monserveur.fr directement dans le client Minecraft.

Gerer les mises a jour de mods

Les mods evoluent a chaque mise a jour de Minecraft. Une mise a jour du mod loader ou du jeu peut casser la compatibilite des mods installes. Voici la procedure pour mettre a jour sans perdre votre config et vos donnees :

1. Faites un backup complet du repertoire du serveur avant toute mise a jour. Sauvegardez le monde, les fichiers de config et le repertoire mods/ sur un emplacement distant (backup rsync distant). Un script de sauvegarde automatique sur un VPS distant garantit que vous pouvez restaurer l'etat precedent ;
2. Verifiez sur Modrinth ou CurseForge que chaque mod est compatible avec la nouvelle version du jeu et du mod loader ;
3. Mettez a jour le mod loader en premier (NeoForge : relancez l'executable de l'installeur avec --installServer ; Fabric : relancez l'installeur avec la nouvelle -mcversion) ;
4. Remplacez les fichiers JAR dans mods/ par les nouvelles versions. Supprimez les anciens fichiers pour eviter les conflits de versions ;
5. Redemarrez le serveur et consultez les logs dans logs/latest.log pour verifier qu'aucun mod ne signale d'erreur de compatibilite.

Pour automatiser le redemarrage de votre serveur apres une mise a jour ou un crash, creez un service systemd dedie. Pour des conseils generaux sur la mise a jour d'un serveur de jeu Linux, consultez notre guide de mise a jour sans perdre la configuration.

Securiser le serveur

Un serveur Minecraft modde accessible sur Internet doit etre protege comme tout service expose. Voici les mesures essentielles pour l'admin du serveur :

• Firewall : n'ouvrez que le port 25565/TCP (Minecraft) et le port 22/TCP (SSH) dans votre firewall. Bloquez tout le reste avec UFW (guide UFW pour serveurs de jeu). Verifiez les regles actives avec sudo ufw status ;
• SSH : desactivez l'authentification par mot de passe et utilisez une cle SSH. Configurez Fail2ban pour bloquer les tentatives de connexion SSH en force brute sur votre serveur distant ;
• Utilisateur dedie : ne lancez pas le serveur Minecraft en root. Creez un utilisateur Unix dedie (sudo adduser minecraft) et executez le serveur sous ce compte pour limiter les privileges ;
• Mises a jour systeme : maintenez a jour les paquets de securite du systeme d'exploitation avec sudo apt update && sudo apt upgrade regulierement.

Pour un durcissement complet de l'acces SSH a votre serveur, suivez notre guide pour securiser SSH sur VPS Linux.

Dimensionner le VPS selon les joueurs et les mods

Un serveur modde consomme plus de RAM et de CPU qu'un serveur vanilla. Chaque mod charge du code supplementaire dans la JVM, et certains mods (generation de terrain, mobs ajoutes, systemes de machines) augmentent significativement le temps de calcul par tick. Le dimensionnement depend du nombre de joueurs, du nombre de mods et du type de modpack installe.

La frequence d'horloge du processeur (GHz) compte plus que le nombre de coeurs : la boucle de jeu de Minecraft est principalement mono-threadee. Un SSD NVMe reduit les temps de chargement des chunks et des sauvegardes automatiques du monde. Prevoyez suffisamment d'espace disque sur la partition de stockage : un modpack lourd avec un monde genere peut occuper plusieurs dizaines de Go. Pour estimer le cout de votre serveur, consultez notre guide sur le prix d'un serveur Minecraft.

Au-dela de 30 joueurs sur un modpack lourd, un serveur dedie offre des ressources garanties et une frequence CPU plus elevee qu'un serveur virtuel partage. ElypseCloud, hebergeur francais specialise dans les serveurs de jeu, propose des VPS et des serveurs dedies avec un acces root complet pour ce type d'usage.

Conclusion

Installer un serveur Minecraft modde sur un VPS Linux se resume a quelques etapes cles : choisir le mod loader adapte (NeoForge pour les modpacks lourds, Fabric pour la performance), installer Java 25 et les paquets necessaires, appliquer les flags JVM d'Aikar pour minimiser les pauses du ramasse-miettes, et ajouter des mods d'optimisation comme Lithium pour reduire le temps par tick. Lancez le serveur en arriere-plan avec screen ou un service systemd, securisez l'acces avec un firewall et une connexion SSH par cle, et faites un backup regulier avant chaque mise a jour de mod.

Avec un serveur Minecraft chez ElypseCloud, vous disposez d'un acces SSH root complet sur votre machine virtuelle pour installer le mod loader de votre choix, configurer chaque parametre et administrer votre serveur modde depuis un shell distant.