Installer des mods et plugins Minecraft – Guide simple

Dernière vérification : 26 septembre 2026. Les mods et plugins étendent ton serveur Minecraft, mais ils ne fonctionnent pas de la même façon : les plugins sont conçus pour Paper ou Spigot et tournent en général sans installation côté client, alors que les mods avec Forge, NeoForge ou Fabric doivent souvent être présents à l'identique sur le serveur et sur le PC des joueurs. Ce qui compte, ce sont la version de Minecraft, le logiciel serveur, les dépendances et un test propre après chaque redémarrage.

Plugins ou mods : choisir la bonne base

Avant d'envoyer des fichiers, définis ton objectif. Si tu veux ajouter des permissions, des points de home, des zones protégées, une économie, de la modération ou des outils d'administration, les plugins Paper/Spigot sont le plus souvent la bonne voie. Si tu veux intégrer de nouveaux blocs, biomes, systèmes techniques, mobs ou des mécaniques de jeu plus profondes, il te faut en général des mods Forge, NeoForge ou Fabric.

La documentation officielle de Paper décrit Paper comme un logiciel serveur pour Minecraft: Java Edition et renvoie pour les plugins, entre autres, à l'écosystème PaperMC. Une source primaire évidente pour les plugins Paper est donc Hangar de PaperMC ; le guide officiel d'intégration se trouve dans la documentation Paper, qui cite aussi Modrinth en plus de Hangar. Pour une gestion plus poussée des plugins, le guide interne approfondi Installer et gérer les plugins Minecraft dans le panneau est également utile.

Prérequis avant l'installation

Vérifie d'abord la version de Minecraft installée sur ton serveur. Un plugin ou un mod doit correspondre à cette version et au logiciel serveur choisi. Un fichier prévu pour une autre version majeure peut parfois démarrer, mais il ne faut pas le considérer comme stable. Depuis mars 2026, Minecraft se compte par année et drop (26.1, 26.2, 26.3 …) au lieu de 1.21.x ; la dernière ancienne version était la 1.21.11. Beaucoup de mods et de plugins affichent donc les deux notations dans leur liste de versions – compare précisément.

Vérifie aussi la version de Java de ton serveur. Minecraft 1.18 à 1.20.4 tourne avec Java 17, 1.20.5 à 1.21.11 nécessite Java 21, et depuis Minecraft 26.1 (mars 2026), Java 25 est obligatoire – Paper, NeoForge et Fabric l'exigent également. Un mod ou un plugin pour une nouvelle version du jeu ne démarre tout simplement pas avec une version de Java trop ancienne. Ne monte pas non plus la version de Minecraft d'un serveur de mods avant que chaque mod installé ne mentionne la nouvelle version dans sa liste de versions – les gros mods de contenu ont souvent besoin de plusieurs semaines à plusieurs mois après un nouveau drop.

Arrête le serveur avant de remplacer des fichiers JAR. Crée ou vérifie une sauvegarde récente du monde, de la configuration et du dossier de plugins ou de mods. Surtout avec les configurations Forge, NeoForge et Fabric, un simple conflit de version peut empêcher le serveur de démarrer complètement.

Fais aussi attention aux dépendances. Certains plugins ont besoin de bibliothèques supplémentaires ou de plugins de base comme Vault. Certains mods nécessitent Fabric API, Cloth Config ou d'autres bibliothèques de mods. Ces indications figurent normalement sur la page du projet de l'extension concernée.

Installer des plugins avec Paper ou Spigot

1. Télécharge le plugin depuis Hangar ou Modrinth – fais attention à la plateforme (Paper, Spigot, Purpur) et à la version de Minecraft dans la liste des versions. Sur Modrinth, tu peux filtrer par plateforme sur la gauche ; certains projets proposent la même fonction en plus comme mod Fabric, et celui-ci se retrouve à tort dans le dossier des plugins.
2. Va dans le tableau de bord de ton serveur sur game-serverhosting.
3. Navigue vers l'onglet Mods & Plugins.
4. Cherche le plugin souhaité et clique sur Installer, s'il est disponible dans le panneau.
5. Redémarre le serveur.

Sinon, tu peux envoyer manuellement le fichier JAR dans le dossier /plugins. Après le redémarrage, le plugin crée généralement automatiquement un fichier de configuration dans son propre sous-dossier. N'ouvre ce fichier qu'après avoir démarré le serveur une fois avec le plugin, sinon les valeurs par défaut manquent souvent.

Les plugins recommandés pour débuter restent des outils de base classiques, mais n'installe que ce dont tu as vraiment besoin :

EssentialsX     – Fonctions de base (Home, Warp, Kits)
LuckPerms       – Système de permissions
WorldGuard      – Protection de régions
Vault           – Pont API pour Economy/Permissions (nécessite un plugin d'économie, p. ex. EssentialsX)
CoreProtect     – Journalisation des blocs / anti-grief

Après l'installation, ne teste pas seulement si le serveur démarre. Vérifie en jeu au moins une commande du plugin, l'attribution des droits et la sortie de la console. Si un plugin se charge mais que des commandes sont bloquées, le problème vient souvent des permissions ou de dépendances manquantes.

Installer des mods avec Forge, NeoForge ou Fabric

Petit rappel de contexte : NeoForge est depuis 2023 le fork de Forge, sur lequel travaille presque toute l'équipe d'origine. Pour Minecraft 1.21 et plus récent, la plupart des anciens mods Forge ne publient plus que des builds NeoForge ; Forge reste le bon choix pour les modpacks plus anciens (par exemple 1.12.2, 1.16.5 ou 1.20.1). Fabric est un écosystème à part, léger – les mods Fabric ne tournent ni sur Forge ni sur NeoForge.

1. Assure-toi que ton serveur tourne avec Forge, NeoForge ou Fabric – et plus précisément avec le loader pour lequel le mod a été conçu. Pour Minecraft 1.21 et plus récent, NeoForge est le successeur habituel de Forge ; depuis la 1.20.2, les fichiers Forge et NeoForge ne sont plus interchangeables.
2. Télécharge le mod depuis Modrinth ou CurseForge – en fonction du loader (Forge, NeoForge ou Fabric) et de la version de Minecraft. Un fichier NeoForge ne tourne pas sur un serveur Forge et inversement.
3. Envoie le JAR dans le dossier /mods.
4. Important : vérifie l’environnement de chaque mod. Les mods uniquement serveur restent sur le serveur ; installe les mods côté client ou des deux côtés chez les joueurs seulement si le mod le demande.
5. Redémarre le serveur.

Avec les mods, l'identité des versions est particulièrement importante. Le serveur, le client du joueur, le modloader et les fichiers de mods doivent correspondre. Si un joueur voit une liste de mods ou un message d'erreur de registre lors de la connexion, c'est en général qu'un mod manque côté client, qu'il est installé dans une autre version ou que le client utilise le mauvais loader.

Installe les nouveaux mods progressivement. Démarre le serveur après quelques modifications et vérifie la console. Tu trouveras ainsi les conflits plus vite, au lieu de ne plus savoir, après 30 nouveaux fichiers, quel mod empêche le démarrage. Si tu travailles souvent avec des modloaders, des méthodes similaires t'aident aussi dans d'autres jeux, par exemple dans le guide Installer des mods Valheim avec BepInEx ou pour les mods V Rising avec BepInEx.

Vérifier le résultat

Après le redémarrage, la console est ton premier point de contrôle. Cherche des messages comme ERROR, WARN, Could not load, Missing dependency ou des indications de version. Tous les avertissements ne sont pas critiques, mais tu dois corriger les échecs de démarrage, les plugins désactivés et les classes manquantes.

En jeu, tu vérifies ensuite des fonctions concrètes : le monde se charge-t-il correctement ? Les joueurs peuvent-ils se connecter ? Les nouvelles commandes fonctionnent-elles ? Les nouveaux blocs, objets ou menus s'affichent-ils ? Pour les plugins, teste en plus les droits et les groupes. Pour les mods, au moins un joueur doit se connecter avec exactement le même modpack.

Dépannage des erreurs courantes

Le plugin ne se charge pas : vérifie la version de Minecraft et si le plugin convient à Paper/Spigot. Un mod Forge ne fonctionne pas comme plugin Paper, même si les deux fichiers sont des JAR.

Le serveur ne démarre pas : examine la console pour repérer les messages d'erreur. Souvent, des dépendances manquent, un fichier est conçu pour une autre version de Minecraft ou deux extensions écrasent la même fonction.

Conflit de mods : retire les mods un par un ou par petits groupes pour trouver le conflit. Commence par les fichiers installés en dernier et redémarre après chaque modification.

Les joueurs ne peuvent pas se connecter : compare le modloader, la version de Minecraft et les fichiers de mods entre le serveur et le client. Avec Forge, NeoForge et Fabric, le côté client doit en général utiliser les mêmes mods et le même loader.

Lag après l'installation : utilise /spark profiler start puis, après quelques minutes de jeu, /spark profiler stop, si spark est installé, pour vérifier si un plugin ou un mod consomme un temps anormal. Désactive les extensions dont tu n'as pas besoin et reteste avec des actions de joueurs réalistes.

Vérification, limites et retour arrière sûr

Le guide « Installer des mods et plugins Minecraft – Guide simple » s'applique au type de serveur décrit dans l'article et à la version visible au moment de la vérification. Les noms de menus, les versions disponibles, la compatibilité des mods ou plugins et les ressources nécessaires peuvent différer après des mises à jour. Ne transpose donc pas des valeurs sans vérification vers une autre version de jeu, de loader ou de serveur.

Avant toute modification du monde, de la sauvegarde, de la configuration ou des extensions, crée une sauvegarde des fichiers concernés. Ne modifie ensuite qu'une seule étape cohérente à la fois et teste-la avec la même version de client et de serveur que celle avec laquelle tu voudras jouer plus tard.

Un test individuel réussi n'est pas une garantie de performance ou de disponibilité. La taille du monde, les mods, les plugins, le nombre de joueurs, le chemin réseau et la charge simultanée peuvent modifier le résultat. Documente la version, la modification et le résultat du test, afin de pouvoir retracer plus tard d'éventuels écarts.

FAQ

Puis-je utiliser en même temps des plugins Paper et des mods Forge ?

Pas dans une configuration standard normale. Les plugins Paper/Spigot et les mods Forge/NeoForge/Fabric appartiennent à des écosystèmes de serveurs différents ; l'équipe PaperMC est claire là-dessus : soit des mods, soit des plugins. Les serveurs hybrides comme Mohist ou Arclight promettent les deux, mais sont considérés comme instables et ne sont pas pris en charge par les développeurs de Paper et de plugins. Choisis la plateforme qui correspond à ton objectif.

Les joueurs doivent-ils installer les plugins ?

Pour les plugins Paper ou Spigot classiques, normalement non. Les joueurs se connectent avec un client Minecraft normal. Les exceptions peuvent être des fonctions supplémentaires côté client ou des packs de ressources qu'un plugin utilise en option.

Pourquoi mon serveur ne démarre-t-il plus après l'ajout d'un mod ?

En général, une version ne convient pas, une dépendance manque ou deux mods sont incompatibles. Lis le premier message d'erreur pertinent dans la console et retire à titre de test le dernier mod installé.

Où placer les fichiers JAR ?

Les plugins vont dans /plugins, les mods dans /mods. Le bon dossier ne dépend pas seulement du type de fichier, mais du logiciel serveur : Paper/Spigot utilise des plugins, Forge/NeoForge/Fabric utilise des mods. Avec Paper, le JAR doit se trouver directement dans /plugins – les sous-dossiers ne sont pas parcourus.

Dois-je installer beaucoup d'extensions à la fois ?

Non. Installe-les par petites étapes et teste après chaque redémarrage. Cela rend les erreurs traçables et t'évite de devoir vérifier tous les fichiers en même temps en cas de conflit.