Comment installer un plugin sur mon serveur Minecraft ?

Les plugins ajoutent des fonctionnalités à ton serveur sans que les joueurs aient quoi que ce soit à installer : protection, économie, permissions, mini-jeux, mise en forme du chat. Ils fonctionnent sur Paper, Purpur et Spigot (pas sur vanilla, Fabric ou Forge ; ceux-là utilisent des mods). L'installation se fait en deux étapes : mettre le fichier .jar dans le dossier plugins et redémarrer.

Étape 1 : vérifier le logiciel serveur

Tape about dans la console ; la réponse doit mentionner Paper, Purpur ou Spigot. Si elle dit vanilla, passe d'abord à Paper via le sélecteur de version du panel. Un monde créé sur vanilla fonctionne sur Paper sans modification. Lequel choisir est expliqué dans notre article mods ou plugins.

Option A : le Plugin installer du panel

1. Va dans le panel de jeu et clique sur ton serveur.
2. Ouvre la page Plugin installer.
3. Cherche le plugin par son nom, choisis la version qui correspond à ta version de Minecraft et clique sur Installer.
4. Redémarre le serveur.

L'installateur télécharge le fichier directement depuis les sources officielles dans ton dossier plugins, donc tu ne peux pas te retrouver avec un mauvais fichier ou un fichier malveillant.

Option B : envoyer le .jar toi-même

1. Télécharge le plugin depuis une source de confiance : Hangar (le site de Paper), SpigotMC, Modrinth ou le GitHub du développeur. Vérifie que la version supporte ta version de Minecraft.
2. Ouvre le Gestionnaire de fichiers dans le panel et va dans le dossier plugins.
3. Clique sur Envoyer et sélectionne le fichier .jar. Ne décompresse rien ; le jar entre tel quel.
4. Redémarre le serveur. Les gros fichiers s'envoient plus vite via SFTP.

Étape 3 : vérifier qu'il a chargé

Tape plugins dans la console. Les plugins chargés apparaissent en vert ; un nom en rouge signifie un échec. Au premier démarrage, le plugin crée un dossier plugins/NomDuPlugin/ avec un config.yml dans lequel tu ajustes ses réglages. Après avoir modifié une config, redémarre ou utilise la commande de rechargement propre au plugin ; évite le /reload général, qui provoque souvent des erreurs.

Dépendances

Certains plugins ont besoin d'un autre plugin pour fonctionner : beaucoup nécessitent Vault (économie et permissions), ProtocolLib ou PlaceholderAPI. La console te le dit au démarrage : Could not load 'X': Unknown dependency: Vault. Installe le plugin manquant de la même façon.

Un plugin ne charge pas

• « Unsupported API version » : le plugin est trop récent pour ta version de serveur, ou l'inverse. Choisis une version compatible.
• « UnsupportedClassVersionError » : le plugin a besoin d'un Java plus récent ; voir changer la version de Java.
• Erreur dans config.yml : le YAML est pointilleux sur l'indentation et les deux-points. Colle le fichier dans un validateur YAML en ligne pour trouver la ligne.
• Deux plugins entrent en conflit : retire-les un par un pour trouver le coupable.
• Rien ne change : le fichier a atterri dans le mauvais dossier, ou a une extension .zip. Ce doit être un .jar dans plugins.

Par où commencer

Recommandés pour presque tous les serveurs : EssentialsX (homes, warps, kits), LuckPerms (permissions), WorldGuard (protection), CoreProtect (rollbacks) et Vault. Notre article sur les plugins de modération en liste d'autres. Bloqué ? Ouvre un ticket avec l'erreur de la console.