Installer un modpack CurseForge sur son serveur Minecraft
Un modpack, c'est des dizaines voire des centaines de mods déjà assemblés et testés ensemble. Voici comment déployer le vôtre sur votre serveur, proprement, sans erreur de version.
Qu’est-ce qu’un modpack Minecraft ?
Installer un modpack Minecraft consiste à déployer un ensemble complet de mods, de dépendances et de fichiers de configuration déjà assemblés pour fonctionner ensemble. Contrairement à l’ajout d’un mod isolé, un modpack peut modifier presque tous les aspects du jeu : génération du monde, progression, machines, magie, exploration, interface ou performances.
Un modpack contient généralement :
- plusieurs dizaines ou centaines de mods ;
- un chargeur comme Forge, Fabric ou NeoForge ;
- des bibliothèques et dépendances ;
- des fichiers de configuration ;
- parfois des scripts, quêtes ou recettes personnalisées ;
- une version précise de Minecraft.
Il ne suffit donc pas de copier quelques fichiers .jar au hasard dans le dossier mods/. Le serveur et les joueurs doivent utiliser la même version du pack, avec les mêmes composants essentiels.
Si vous souhaitez seulement ajouter une extension précise, consultez plutôt le guide pour installer un mod sur un serveur Minecraft.
Le modpack doit être considéré comme un ensemble cohérent. Mettre à jour ou supprimer un seul mod sans vérifier les autres composants peut empêcher le serveur de démarrer ou les joueurs de se connecter.
Installer un modpack Minecraft en un clic depuis le panel
La méthode la plus simple consiste à utiliser le catalogue de modpacks disponible depuis le panel de gestion TalCloud.
Commencez par arrêter votre serveur s’il est déjà en fonctionnement. Accédez ensuite à la section d’installation ou de réinstallation du serveur, puis recherchez le nom du modpack souhaité.
Si le pack est disponible dans le catalogue :
- sélectionnez le modpack ;
- choisissez la version voulue ;
- lancez l’installation ;
- attendez la fin du déploiement ;
- démarrez le serveur et surveillez la console.
Le panel configure automatiquement les principaux éléments nécessaires, notamment la version de Minecraft, le chargeur compatible et les fichiers serveur du pack.
Cette méthode réduit fortement les risques d’erreur liés à une mauvaise version de Forge, Fabric ou NeoForge. Elle évite aussi d’avoir à identifier manuellement le bon fichier de démarrage.
Vérifiez toujours la version exacte installée par le panel. Les joueurs devront sélectionner cette même version dans leur launcher pour rejoindre le serveur.
Une réinstallation peut remplacer les fichiers déjà présents. Avant toute opération importante, exportez votre monde et les configurations que vous souhaitez conserver. Des sauvegardes automatiques sont incluses pour vous aider à restaurer. Conservez aussi vos propres exports réguliers : vous restez responsable de vos données.
Si le modpack ou la version souhaitée n’est pas proposé dans le catalogue, utilisez la méthode manuelle.
Méthode 2 : installer manuellement le « server pack »
L’installation manuelle repose sur le téléchargement du server pack Minecraft fourni par l’auteur du modpack.
Le point essentiel est de ne pas confondre le pack client et le server pack.
Le pack client est destiné au launcher du joueur. Il peut contenir des éléments inutiles ou incompatibles avec un serveur dédié, comme certains mods graphiques, shaders, fichiers d’interface ou paramètres locaux.
Le server pack contient les fichiers adaptés à l’hébergement du modpack :
- les mods nécessaires côté serveur ;
- les configurations ;
- les scripts de lancement ;
- les bibliothèques éventuelles ;
- les fichiers spécifiques au chargeur.
Télécharger le bon fichier sur CurseForge
Ouvrez la page officielle du modpack sur CurseForge, puis recherchez une section nommée « Additional Files », « Server Files » ou « Server Pack ».
Assurez-vous que la version du server pack correspond exactement à la version du modpack que les joueurs installeront.
Par exemple :
Modpack : ExemplePack
Version du pack : 2.4.1
Minecraft : 1.20.1
Chargeur : Forge 47.x
Server pack attendu : ExemplePack-2.4.1-Server.zip
Ne téléchargez pas un server pack plus ancien en pensant qu’il sera automatiquement compatible. Même avec une version identique de Minecraft, les mods ou configurations peuvent avoir changé.
Le piège le plus fréquent consiste à envoyer l’archive client complète sur le serveur. Recherchez explicitement la mention « Server Pack » ou « Server Files ».
Envoyer les fichiers sur le serveur
Téléchargez l’archive du server pack sur votre ordinateur, puis décompressez-la localement. Vous devez ensuite envoyer son contenu dans le répertoire principal du serveur à l’aide du gestionnaire de fichiers du panel.
Selon le modpack, vous pouvez obtenir une structure similaire à celle-ci :
serveur-minecraft/
├── config/
├── defaultconfigs/
├── kubejs/
├── libraries/
├── mods/
├── scripts/
├── start.sh
├── startserver.sh
├── server.properties
└── user_jvm_args.txt
Envoyez le contenu de l’archive, et non le dossier parent qui le contient. Le dossier mods/, le dossier config/ et les scripts doivent se trouver directement à la racine attendue par le serveur.
Identifier le script de démarrage
Certains server packs contiennent un script comme :
start.sh
run.sh
startserver.sh
ServerStart.sh
Ce script télécharge parfois le chargeur ou les bibliothèques nécessaires avant le premier lancement.
Sur un environnement Linux, une commande de lancement peut ressembler à :
bash start.sh
Le nom exact dépend du modpack. Consultez le fichier README, les instructions CurseForge ou le contenu du script avant de modifier la commande de démarrage.
Vous devrez aussi accepter le contrat de licence Minecraft en remplaçant la valeur correspondante dans eula.txt :
eula=true
Démarrez ensuite le serveur et observez la console. Le premier lancement peut durer plus longtemps qu’un démarrage normal, car le modpack génère ses configurations, prépare les bibliothèques et initialise le monde.
Faire correspondre la version du modpack côté client
Chaque joueur doit installer exactement le même modpack et la même version que le serveur.
La solution la plus directe consiste à utiliser le launcher CurseForge :
- installez l’application CurseForge ;
- recherchez le modpack ;
- ouvrez la liste des versions ;
- sélectionnez la version installée sur le serveur ;
- lancez le jeu depuis le profil créé.
Des launchers comme Prism Launcher ou ATLauncher peuvent aussi gérer des instances modifiées. Ils doivent toutefois importer la bonne version du pack avec le chargeur attendu.
Avant de vous connecter, comparez les informations suivantes :
| Élément | Serveur | Client |
|---|---|---|
| Version Minecraft | Identique | Identique |
| Version du modpack | Identique | Identique |
| Chargeur | Forge, Fabric ou NeoForge | Même chargeur |
| Mods requis | Installés | Installés |
| Configurations importantes | Version du pack | Version du pack |
Une différence de version du modpack suffit à provoquer un refus de connexion, même si les deux côtés utilisent la même version de Minecraft.
Ne mettez pas automatiquement à jour votre instance cliente. Vérifiez d’abord que le serveur a lui aussi été migré vers la nouvelle version du pack.
Dimensionner la RAM pour héberger un modpack
Les modpacks consomment généralement plus de mémoire qu’un serveur Vanilla ou Paper. La quantité nécessaire dépend du nombre de mods, du nombre de joueurs, de la génération du monde et de la complexité des machines ou automatisations utilisées.
Voici des ordres de grandeur indicatifs :
| Type de modpack | Nombre approximatif de mods | RAM de départ conseillée |
|---|---|---|
| Léger | Moins de 50 | 4 à 6 Go |
| Intermédiaire | 50 à 150 | 6 à 8 Go |
| Lourd | 150 à 300 | 8 à 12 Go |
| Très lourd | Plus de 300 | 12 Go ou plus |
Ces valeurs ne constituent pas une garantie. Un petit pack mal optimisé peut consommer davantage qu’un pack plus volumineux mais correctement configuré.
Prévoyez aussi une marge lorsque plusieurs joueurs explorent simultanément de nouvelles zones. La génération de chunks, les dimensions supplémentaires et les machines complexes peuvent créer des pics de consommation.
Pour limiter les ralentissements, réduisez si nécessaire la distance de vue, la distance de simulation ou le nombre d’entités chargées. Consultez également le guide pour réduire le lag et améliorer les TPS.
Dépannage
Le serveur crash au démarrage
Consultez les dernières lignes de la console et le fichier latest.log. Recherchez le premier message d’erreur, et non uniquement la dernière ligne.
Les causes fréquentes sont :
Missing dependency
Mod loading error
Incompatible mod set
OutOfMemoryError
Failed to load mod
Vérifiez que vous avez utilisé le server pack officiel, que tous ses dossiers ont été transférés et que la commande de démarrage appelle le bon fichier.
La version client ne correspond pas au serveur
Si le joueur reçoit un message signalant une liste de mods incompatible, comparez la version du pack installée dans le launcher avec celle du serveur.
Une version 1.8.2 du pack n’est pas nécessairement compatible avec la version 1.8.3, même si Minecraft et Forge restent identiques.
Réinstallez la version exacte ou créez une nouvelle instance dans le launcher pour éviter de mélanger d’anciens fichiers.
Le serveur manque de RAM
Un arrêt accompagné de OutOfMemoryError, de longues pauses ou d’un redémarrage en boucle peut indiquer un manque de mémoire.
Augmentez la RAM disponible si possible, réduisez la distance de simulation et vérifiez qu’aucun mod ne provoque une consommation anormale. Évitez d’attribuer toute la mémoire de la machine à Java : le système et les autres services ont aussi besoin de ressources.
Des mods ou dépendances sont manquants
Un transfert incomplet peut laisser de côté un fichier .jar, un dossier de configuration ou une bibliothèque.
Comparez le contenu du serveur avec l’archive originale du server pack. Ne copiez pas simplement le dossier mods/ : certains packs dépendent aussi de config/, defaultconfigs/, kubejs/, scripts/ ou libraries/.
Dans la majorité des cas, un échec vient du mauvais pack téléchargé, d’une différence de version entre le client et le serveur, d’un transfert incomplet ou d’un manque de RAM.
En résumé
- Pour installer un modpack Minecraft, utilisez l’installation en un clic du panel lorsqu’elle est disponible.
- Pour une installation manuelle, téléchargez impérativement le server pack, et non l’archive destinée au client.
- Faites correspondre exactement la version de Minecraft, le chargeur et la version du modpack.
- Envoyez tous les dossiers du server pack à la racine du serveur.
- Configurez la bonne commande de démarrage et acceptez le fichier
eula.txt. - Installez la même version du pack dans le launcher de chaque joueur.
- Dimensionnez la RAM selon la taille du pack, le nombre de joueurs et la charge réelle.
- En cas d’erreur, vérifiez d’abord les logs, les versions, les fichiers manquants et la mémoire disponible.
- Pour héberger un modpack avec stockage NVMe, panel de gestion, Anti-DDoS L3/L4/L7 inclus et support francophone, consultez l’offre serveur Minecraft TalCloud.