Installer un mod sur un serveur Minecraft (Forge, Fabric, NeoForge)

Mod ou plugin : quelle différence ?

Installer un mod sur un serveur Minecraft permet d’ajouter de nouvelles mécaniques, des blocs, des créatures ou des systèmes complets. L’installation reste accessible à condition de respecter trois éléments essentiels : le bon chargeur, les bonnes versions et toutes les dépendances nécessaires.

Un mod modifie directement le fonctionnement de Minecraft. Il nécessite généralement un chargeur comme Forge, Fabric ou NeoForge et doit souvent être installé à la fois sur le serveur et sur l’ordinateur de chaque joueur.

Un plugin fonctionne différemment : il s’exécute uniquement sur un serveur compatible, le plus souvent Paper ou Spigot. Les joueurs peuvent alors se connecter avec un client Minecraft classique, sans installer de fichier supplémentaire.

Critère	Mod	Plugin
Chargeur requis	Forge, Fabric ou NeoForge	Paper, Spigot ou dérivé
Installation serveur	Oui	Oui
Installation côté client	Souvent nécessaire	Non
Portée	Modifie profondément le jeu	Ajoute des fonctions serveur
Usages courants	Modpacks, machines, dimensions, nouveaux objets	Permissions, commandes, modération, mini-jeux

Avant de continuer, vérifiez donc que le fichier choisi est bien un mod. Si vous souhaitez seulement ajouter une fonctionnalité côté serveur, consultez le guide pour installer un plugin Minecraft.

Choisir son chargeur : Forge, Fabric ou NeoForge

Le chargeur de mods est le composant qui permet à Minecraft de détecter et d’exécuter les fichiers placés dans le dossier mods/.

Forge est historiquement très utilisé pour les gros modpacks, les mods techniques et les extensions qui modifient fortement le jeu.

Fabric privilégie une architecture légère et des mises à jour rapides. Il est souvent choisi pour les mods de performance, les améliorations visuelles ou les configurations plus simples.

NeoForge est un fork moderne de Forge. Il peut être demandé par certains mods et modpacks récents.

Vous ne pouvez pas mélanger les chargeurs. Un mod Fabric ne fonctionne pas sur Forge, et un mod NeoForge ne doit pas être placé sur un serveur Forge sauf indication explicite de son développeur.

Le choix dépend donc d’abord du mod ou du modpack que vous souhaitez utiliser.

La règle d’or : faire correspondre les versions

Pour qu’un mod fonctionne, trois versions doivent correspondre :

• la version de Minecraft ;
• la version du chargeur ;
• la version du mod.

Par exemple, un mod prévu pour Minecraft 1.21 avec Fabric ne fonctionnera pas forcément sur Minecraft 1.21.1 avec NeoForge. Une différence qui paraît mineure peut suffire à empêcher le serveur de démarrer.

Dans le panel TalCloud, vérifiez la version actuellement installée sur votre serveur. Si celui-ci utilise Vanilla, Paper ou Spigot, vous devez d’abord installer Forge, Fabric ou NeoForge avant d’ajouter des mods.

Notez la version exacte du serveur avant tout changement. Cela vous évitera de télécharger plusieurs variantes incompatibles d’un même mod.

Les joueurs devront utiliser la même version de Minecraft et, lorsque le mod l’exige, le même chargeur et les mêmes fichiers.

Télécharger un mod depuis une source fiable

Téléchargez vos mods depuis CurseForge ou Modrinth. Ces plateformes permettent de filtrer les fichiers selon la version de Minecraft et le chargeur utilisé.

Avant de récupérer un fichier, contrôlez :

• la version exacte de Minecraft ;
• le chargeur compatible : Forge, Fabric ou NeoForge ;
• la date et le statut de la version ;
• la liste des dépendances obligatoires ;
• les éventuelles instructions du développeur.

Le fichier obtenu est généralement au format .jar. Ne le décompressez pas : il doit être envoyé tel quel dans le dossier mods/.

Évitez les sites de republication qui proposent des téléchargements sans page officielle, changent le nom des fichiers ou ajoutent des installateurs. Vous réduisez ainsi les risques de fichier obsolète, modifié ou malveillant.

Gérer les dépendances du mod

Une dépendance est un autre mod ou une bibliothèque nécessaire au fonctionnement du fichier principal. Fabric API est un exemple fréquent pour les mods Fabric, mais chaque projet peut demander ses propres composants.

Les dépendances sont généralement indiquées dans l’onglet consacré aux relations, aux prérequis ou aux fichiers requis sur CurseForge et Modrinth. Téléchargez-les avec les mêmes critères que le mod principal : même version de Minecraft et même chargeur.

Si une dépendance manque, le serveur peut refuser de démarrer et afficher une erreur comme Missing dependency.

Une dépendance peut elle-même avoir une autre dépendance. Vérifiez toute la chaîne avant de redémarrer le serveur.

Installer un mod sur un serveur Minecraft dans le dossier mods/

Arrêtez complètement le serveur avant d’ajouter, de supprimer ou de remplacer un mod. Modifier les fichiers pendant son fonctionnement peut provoquer des erreurs ou endommager les données en cours d’écriture.

Ouvrez le gestionnaire de fichiers depuis le panel TalCloud, puis accédez au dossier mods/. S’il n’existe pas après l’installation du chargeur, démarrez une première fois le serveur, arrêtez-le, puis vérifiez à nouveau.

Déposez dans ce dossier le fichier .jar du mod et toutes ses dépendances :

serveur-minecraft/
├── config/
├── logs/
├── mods/
│   ├── mod-principal-1.21.jar
│   ├── fabric-api-1.21.jar
│   └── autre-dependance-1.21.jar
├── server.properties
└── world/

Ne placez pas les fichiers dans un sous-dossier, sauf si la documentation du mod le demande précisément. Vérifiez également qu’aucune ancienne version du même mod n’est encore présente.

Avant toute modification importante, gardez une copie de votre monde et de vos configurations. Des sauvegardes automatiques sont incluses pour vous aider à restaurer. Conservez aussi vos propres exports réguliers : vous restez responsable de vos données.

Redémarrez ensuite le serveur depuis le panel. Le premier lancement peut être plus long, car certains mods créent leurs fichiers de configuration.

Installer le mod côté client

De nombreux mods doivent également être installés sur l’ordinateur de chaque joueur. C’est notamment le cas lorsqu’ils ajoutent des blocs, des objets, des interfaces, des textures ou des mécaniques visibles.

Installez d’abord le même chargeur que sur le serveur, puis placez les mêmes fichiers .jar dans le dossier mods du client Minecraft.

Les chemins habituels sont :

Windows : %appdata%\.minecraft\mods
Linux   : ~/.minecraft/mods
macOS   : ~/Library/Application Support/minecraft/mods

Lancez ensuite Minecraft avec le profil Forge, Fabric ou NeoForge correspondant. Vérifiez que le numéro de version affiché dans le lanceur est identique à celui du serveur.

Certains mods sont exclusivement côté serveur ou exclusivement côté client. Lisez leur description avant de les copier partout : un mod d’interface client n’a pas forcément sa place sur le serveur.

Vérifier les logs au démarrage

Après le redémarrage, ouvrez la console ou le fichier de logs le plus récent. Le chargeur doit détecter les mods et terminer le démarrage sans erreur critique.

Recherchez notamment le nom du mod ou des messages comme :

Missing dependency
Incompatible mod set
Failed to load mod

Missing dependency indique qu’un fichier requis manque. Incompatible mod set signale généralement un conflit de versions ou de chargeurs. Failed to load mod demande une lecture plus attentive des lignes suivantes, qui précisent souvent le fichier en cause.

Lisez toujours les premières erreurs du journal. Les messages affichés ensuite sont parfois de simples conséquences du problème initial.

Dépannage

Le serveur ne démarre plus

Retirez le dernier mod ajouté, puis redémarrez. Si le serveur fonctionne à nouveau, vérifiez la version du fichier, son chargeur et ses dépendances. Réintroduisez ensuite les fichiers un par un afin d’identifier précisément l’élément défaillant.

Contrôlez aussi qu’il n’existe pas deux versions du même mod dans mods/.

Le joueur ne peut pas rejoindre

Une erreur de connexion après l’ajout d’un mod signifie souvent que le client ne possède pas le même fichier, la même version ou le même chargeur que le serveur.

Comparez les dossiers mods/ des deux côtés. Pour un modpack, le plus simple est de distribuer une liste exacte des fichiers et versions attendus.

Le mod est côté client mais pas sur le serveur

Un joueur peut parfois lancer Minecraft avec un mod installé localement, mais être refusé à la connexion si ce mod est aussi requis côté serveur. À l’inverse, certains mods purement visuels ou ergonomiques ne doivent être installés que sur le client.

Consultez la description officielle du mod pour connaître son environnement : client, serveur ou les deux.

Le serveur manque de RAM

Les gros modpacks, la génération de nouvelles dimensions et certains mods techniques augmentent l’utilisation de la mémoire. Si le serveur s’arrête avec une erreur de mémoire, réduisez le nombre de mods, ajustez la distance de simulation ou choisissez une offre disposant de davantage de RAM.

Surveillez également les performances après l’installation. Le guide pour réduire le lag et améliorer les TPS vous aidera à identifier les réglages les plus utiles.

Dans la majorité des cas, l’échec vient d’une incompatibilité de version, d’une dépendance manquante ou d’une configuration serveur différente de celle du client.

En résumé

• Pour installer un mod sur un serveur Minecraft, utilisez Forge, Fabric ou NeoForge selon la compatibilité du fichier.
• Ne mélangez jamais les chargeurs et faites correspondre exactement les versions de Minecraft, du chargeur et des mods.
• Téléchargez les fichiers .jar depuis CurseForge ou Modrinth, sans les décompresser.
• Installez aussi toutes les dépendances demandées, dans la bonne version.
• Arrêtez le serveur, placez les fichiers dans mods/, puis vérifiez les logs après le redémarrage.
• Installez les mods requis côté client avec le même chargeur et les mêmes versions.
• En cas d’erreur, testez les fichiers un par un et contrôlez d’abord les versions, les dépendances et la configuration client.
• Pour démarrer sur une infrastructure hébergée en France avec stockage NVMe, panel de gestion et Anti-DDoS L3/L4/L7 inclus, consultez l’offre serveur Minecraft TalCloud.