Les mods et plugins étendent ton serveur Minecraft, mais ils ne fonctionnent pas de la même manière : les plugins sont prévus pour Paper ou Spigot et tournent généralement sans installation côté client, tandis que chaque mod Forge ou Fabric déclare son environnement. Les mods uniquement serveur restent sur le serveur ; les mods requis côté client doivent être installés dans une version compatible sur les PC concernés. Les points décisifs sont la version Minecraft, le logiciel serveur, les dépendances et un test propre après chaque redémarrage.
Plugins ou mods : choisir la bonne base
Avant de téléverser des fichiers, définis l’objectif que tu poursuis. Si tu veux ajouter des droits, des points home, des régions protégées, une economy, de la modération ou des outils admin, les plugins Paper/Spigot sont généralement la bonne voie. Si tu veux ajouter de nouveaux blocs, biomes, systèmes techniques, mobs ou mécaniques de jeu plus profondes, tu as en général besoin de mods Forge ou Fabric.
| Fonction | Plugins (Paper/Spigot) | Mods (Forge/Fabric) |
|---|---|---|
| Installation | Simple : JAR dans /plugins | JAR dans /mods |
| Client nécessaire ? | Non | Selon l’environnement du mod |
| Performance | Meilleure | Variable |
| Compatibilité | Élevée | Peut entrer en conflit |
| Exemples | EssentialsX, WorldEdit | OptiFine, Biomes O Plenty |
La documentation officielle 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. Pour une gestion supplémentaire des plugins, le guide interne approfondi installer et gérer des plugins Minecraft dans le panel convient aussi.
Prérequis avant l’installation
Vérifie d’abord la version Minecraft installée sur ton serveur. Un plugin ou un mod doit correspondre à cette version et au logiciel serveur choisi. Un fichier pour une autre version majeure peut parfois démarrer, mais ne doit pas être considéré comme stable.
Arrête le serveur avant de remplacer des fichiers JAR. Crée ou vérifie une sauvegarde actuelle du monde, de la configuration et du dossier de plugins ou de mods. Surtout avec les setups Forge et Fabric, un seul conflit de version peut empêcher le serveur de démarrer complètement.
Fais aussi attention aux dépendances. Certains plugins nécessitent des libraries supplémentaires ou des plugins de base comme Vault. Certains mods nécessitent Fabric API, Cloth Config ou d’autres libraries de mods. Ces indications se trouvent normalement sur la page du projet de l’extension concernée.
Installer des plugins avec Paper ou Spigot
- Télécharge le plugin depuis Hangar ou Modrinth.
- Va dans ton dashboard serveur sur game-serverhosting.
- Navigue vers l’onglet Mods & Plugins.
- Recherche le plugin souhaité et clique sur Installer s’il est disponible dans le panel.
- Redémarre le serveur.
Tu peux aussi téléverser 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. Ouvre ce fichier seulement après que le serveur a démarré une fois avec le plugin, sinon des valeurs par défaut manquent souvent.
Les plugins recommandés pour débuter restent des outils de base typiques, mais installe seulement ce dont tu as vraiment besoin :
EssentialsX – Fonctions de base (Home, Warp, Kits)
LuckPerms – Système de permissions
WorldGuard – Protection de régions
Vault – Système economy
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 de plugin, l’attribution des droits et la sortie de la console. Si un plugin est chargé mais que les commandes sont bloquées, le problème vient souvent des permissions ou de dépendances manquantes.
Installer des mods avec Forge ou Fabric
- Assure-toi que ton serveur tourne avec Forge ou Fabric.
- Télécharge le mod depuis Modrinth ou CurseForge.
- Téléverse le JAR dans le dossier
/mods. - Important : vérifie l’environnement de chaque mod. Les mods uniquement serveur restent sur le serveur ; les mods requis côté client doivent être installés dans une version compatible sur les PC concernés.
- Redémarre le serveur.
Avec les mods requis côté client, la compatibilité des versions est particulièrement importante. Le serveur, les clients concernés, le modloader et les fichiers de mods partagés doivent correspondre. Si un joueur voit une liste de mods ou un message d’erreur de registry lors de la connexion, il manque généralement un mod sur le client, un mod est installé dans une autre version ou 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 trouves 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 processus similaires t’aident aussi pour 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 les interruptions de démarrage, les plugins désactivés et les classes manquantes doivent être corrigés.
En jeu, vérifie ensuite des fonctions concrètes : le monde se charge-t-il correctement ? Les joueurs peuvent-ils rejoindre ? Les nouvelles commandes fonctionnent-elles ? Les nouveaux blocs, items ou menus s’affichent-ils ? Pour les plugins, teste aussi les droits et les groupes. Pour les mods, au moins un joueur avec exactement le même modpack doit pouvoir se connecter.
Dépannage des erreurs fréquentes
Le plugin ne se charge pas : vérifie la version Minecraft et si le plugin est adapté à 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 : vérifie la console pour les messages d’erreur. Souvent, des dépendances manquent, un fichier est conçu pour une autre version Minecraft ou deux extensions écrasent la même fonction.
Conflit de mod : supprime des 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 Minecraft et les fichiers de mods entre serveur et client. Avec Forge/Fabric, vérifie l’environnement déclaré de chaque mod ; seuls les mods requis côté client doivent être installés chez les joueurs.
Lag après installation : utilise /spark profiler si Spark est installé afin de vérifier si un plugin ou un mod consomme anormalement beaucoup de temps. Désactive les extensions dont tu n’as pas besoin et teste à nouveau avec des actions de joueurs réalistes.
Vérification, limites et retour sûr
Le guide « Installer des mods et plugins Minecraft – Guide simple » s’applique au type de serveur décrit dans l’article et à l’état des versions 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 changer après des mises à jour. Ne transfère donc aucune valeur sans vérification vers une autre version du jeu, du loader ou du serveur.
Avant de modifier le monde, la sauvegarde, la configuration ou les extensions, crée une sauvegarde des fichiers concernés. Modifie ensuite seulement une étape cohérente et vérifie-la avec la même version client et serveur que celle avec laquelle tu veux jouer plus tard.
| Point de contrôle | Résultat attendu | Arrêt et retour |
|---|---|---|
| Démarrage du serveur | Le serveur atteint l’état prêt à fonctionner sans nouveau message d’erreur. | En cas d’erreurs de démarrage, annuler la modification et restaurer la dernière sauvegarde. |
| Test de connexion | Un compte de test peut se connecter via l’adresse affichée dans le panel. | En cas d’erreurs de version ou de connexion, revérifier la version, le port et les autorisations. |
| Test fonctionnel | La fonction concrètement modifiée fonctionne sans endommager les données existantes du monde ou du jeu. | En cas d’effets secondaires, arrêter le serveur et restaurer les fichiers sauvegardés. |
Un test individuel réussi ne constitue pas une garantie de performance ou de disponibilité. La taille du monde, les mods, les plugins, le nombre de joueurs, le trajet 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 comprendre les écarts ultérieurs.
FAQ
Puis-je utiliser des plugins Paper et des mods Forge en même temps ?
Pas dans un setup standard normal. Les plugins Paper/Spigot et les mods Forge/Fabric appartiennent à des écosystèmes serveur différents. Choisis la plateforme qui correspond à ton objectif.
Les joueurs doivent-ils installer les plugins ?
Avec les plugins Paper ou Spigot classiques, normalement non. Les joueurs se connectent avec un client Minecraft normal. Des exceptions peuvent être des fonctions supplémentaires côté client ou des resourcepacks qu’un plugin utilise optionnellement.
Pourquoi mon serveur ne démarre-t-il plus après un mod ?
La plupart du temps, une version ne correspond pas, une dépendance manque ou deux mods sont incompatibles. Lis le premier message d’erreur pertinent dans la console et retire temporairement le mod installé en dernier.
Où vont 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/Fabric utilise des mods.
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 compréhensibles et évite de devoir vérifier tous les fichiers en même temps en cas de conflit.