Comment ajouter des mods à votre serveur Minecraft

Votre serveur doit d'abord être sur un mod loader — Fabric, Forge, NeoForge ou Quilt. S'il est encore sur Vanilla ou Paper, commencez par Comment créer un serveur Minecraft modifié, puis revenez ici.

Option 1 : installer depuis le panneau

L'onglet Modifications intègre le catalogue CurseForge, donc pour la plupart des mods, vous n'aurez jamais besoin de quitter le panneau ou de gérer des fichiers. Un mod publié uniquement ailleurs — Modrinth, ou le site de l'auteur — s'installe via l'option 2.

1. Ouvrez l'onglet Modifications sur la page du serveur.
2. Recherchez le mod par son nom.
3. Vérifiez que le mod supporte votre version Minecraft et votre loader — un mod Fabric ne fonctionnera pas sur Forge, et un mod 1.20 ne fonctionnera pas sur 1.21.
4. Cliquez sur Installer. Le mod est placé dans le dossier mods du serveur.
5. Redémarrez le serveur pour qu'il détecte le nouveau fichier.

Option 2 : importer un jar

Pour un mod qui n'est pas sur CurseForge, ou une version spécifique que vous avez déjà :

1. Téléchargez le jar du mod pour votre version exacte de Minecraft et votre loader depuis le site de l'auteur.
2. Ouvrez l'onglet Fichiers et accédez au dossier mods.
3. Utilisez Importer et sélectionnez le jar.
4. Redémarrez le serveur.

Mods ou plugins ?

Les mods et les plugins ne sont pas interchangeables. Les mods (Fabric, Forge, NeoForge, Quilt) modifient le jeu lui-même et peuvent ajouter des blocs, des objets et des créatures — ce qui signifie généralement que les joueurs doivent les installer aussi. Les plugins (Paper, Purpur) s'exécutent uniquement sur le serveur et fonctionnent avec un client Minecraft inchangé, donc n'importe qui peut rejoindre sans rien installer. Si vous voulez seulement des outils serveur — réclamations de terrain, maisons, une économie — un serveur plugin est plus simple pour tous. Fabric, Forge, NeoForge ou Paper ? les compare.

Mods clients vs mods serveur

Certains mods doivent être installés sur le Minecraft de chaque joueur et sur le serveur — la plupart des mods de contenu qui ajoutent des blocs, des objets ou des créatures fonctionnent ainsi. D'autres sont purement côté serveur. La page du mod l'indique ; s'il est « requis sur les deux », chacun doit avoir le même mod et la même version, sinon il sera déconnecté avec un message d'erreur de mods incompatibles ou manquants.

Un troisième type est client uniquement : les mods de performance et visuels comme Sodium, Iris ou les shaders style OptiFine. Ils ne font rien sur un serveur et certains le plantent. Installez-les dans votre propre jeu, pas sur le serveur.

Maintenir les mods de tout le monde synchronisés

Le plus simple est de partager une liste : les noms des mods et les versions exactes des fichiers du dossier mods du serveur. Mieux encore, créez l'ensemble en tant que profil CurseForge ou utilisez un modpack publié, afin que tout le monde installe la même chose en un clic — voir Comment installer un modpack.

Mise à jour et suppression des mods

Pour mettre à jour un mod, arrêtez le serveur, supprimez l'ancien jar du dossier mods dans l'onglet Fichiers, et installez le nouveau. Ne gardez pas les deux : deux versions du même mod empêchent le serveur de démarrer avec une erreur « mods dupliqués ».

Supprimer un mod qui a ajouté des blocs ou des objets supprime aussi ces blocs et objets du monde au prochain chargement — ils ne peuvent pas être restaurés en réinstallant. Téléchargez une copie du monde depuis l'onglet Monde avant de supprimer un mod de contenu, au cas où vous changeriez d'avis.

Taille et mods à éviter

Les fichiers mod jusqu'à 256 MB peuvent être installés pendant que le serveur est arrêté. Voici deux mods importants à connaître avant de les installer :

• spark — le profileur ne peut pas s'exécuter dans le conteneur verrouillé que les serveurs gratuits utilisent, et plante le serveur au démarrage.
• Générateurs de monde et rendeurs de carte — utiles, mais lourds. Lancez-les quand personne ne joue et supprimez-les ou mettez-les en pause ensuite.

Si le serveur ne démarre pas après l'ajout d'un mod

Ouvrez l'onglet Console et lisez la première erreur dans la pile de trace. Les causes les plus courantes :

• Mauvaise version — le mod est compilé pour une version ou un loader Minecraft différent.
• Dépendance manquante — le mod a besoin d'un mod de dépendance (souvent Fabric API, ou un mod principal spécifique) qui n'est pas installé.
• Mod client uniquement — il n'a jamais été conçu pour s'exécuter sur un serveur ; supprimez-le.
• Deux mods en conflit — supprimez le dernier que vous avez ajouté et réessayez pour identifier lequel pose problème.

Supprimez le jar fautif du dossier mods dans l'onglet Fichiers et le serveur redémarrera. La liste complète des messages d'erreur et leur signification se trouve dans Pourquoi mon serveur Minecraft ne démarre-t-il pas ?.