Comment installer des plugins sur votre serveur Minecraft Paper, Spigot ou Purpur

Les plugins sont le moyen d'étendre un serveur Paper, Spigot ou Purpur avec de nouvelles commandes, des mini-jeux, la génération de monde, des outils anti-grief, des systèmes économiques et presque tout ce que vous pouvez imaginer. Le processus d'installation est le même pour les trois : déposez un fichier .jar dans le dossier plugins/, redémarrez le serveur et configurez-le. Ce guide vous explique le flux de travail sur ServerPrism et signale les pièges qui déroutent les nouveaux propriétaires de serveurs.

Assurez-vous que votre serveur peut exécuter des plugins

Les plugins ne fonctionnent qu'avec les logiciels de serveur qui implémentent l'API Bukkit. Cela inclut Paper, Spigot, Purpur et Folia — mais pas Minecraft vanilla, Forge, NeoForge ou Fabric. Ces serveurs de chargement de mods utilisent des mods (fichiers .jar dans mods/), ce qui est un système différent.

Sur ServerPrism, ouvrez l'onglet Startup de votre serveur dans le tableau de bord et confirmez que la ligne Server Jar indique quelque chose comme paper-X.X.jar, spigot-X.X.jar ou purpur-X.X.jar. Si vous voyez vanilla, forge ou fabric à la place, les plugins ne se chargeront pas — vous devrez d'abord réinstaller en tant que Paper (Paramètres → Réinstaller après avoir changé l'œuf).

Vérifiez également que le plugin que vous souhaitez prend en charge votre version exacte de Minecraft. Un plugin conçu pour la version 1.20 ne fonctionnera pas toujours sur la version 1.21.

Trouver un plugin

Voici les principaux endroits où chercher :

• Modrinth — interface utilisateur claire, filtrage par version, la référence moderne.
• Hangar — le dépôt officiel de PaperMC.
• SpigotMC — le plus grand catalogue, mais la qualité varie. Lisez les avis.
• BukkitDev — plus ancien, mais héberge toujours des plugins non republiés ailleurs.

Sur chaque site, filtrez par votre version de Minecraft et téléchargez le .jar (ou .zip s'il contient des configurations — extrayez d'abord, vous voulez le .jar).

Télécharger et charger le plugin

1. Connectez-vous à votre tableau de bord ServerPrism et ouvrez votre serveur.
2. Cliquez sur File Manager dans la barre latérale.
3. Ouvrez le dossier plugins/.
4. Faites glisser le .jar dans le dossier, ou cliquez sur Upload.
5. Redémarrez le serveur depuis l'onglet Console. Les plugins ne sont découverts qu'au démarrage.

Vous pouvez installer plusieurs plugins à la fois — il suffit de déposer plusieurs fichiers .jar avant le redémarrage.

Vérifier qu'il est chargé

Après le démarrage du serveur, exécutez plugins dans le chat du jeu ou dans l'onglet Console du tableau de bord. Le nom du plugin devrait apparaître en vert. S'il est rouge, le plugin n'a pas réussi à se charger — ouvrez le dernier journal dans logs/latest.log et recherchez la première ligne ERROR. Elle indique généralement si vous avez la mauvaise version, une dépendance manquante ou un type de serveur incompatible.

Le configurer

La plupart des plugins génèrent un config.yml à l'intérieur de plugins/<plugin-name>/ lors du premier démarrage. Modifiez-le via le File Manager et redémarrez le serveur pour que les modifications prennent effet.

Certains plugins prennent en charge /reload <plugin-name> pour appliquer les modifications sans redémarrage complet. Utilisez-le uniquement lorsque la documentation du plugin le recommande explicitement — reload est connu pour causer des bugs subtils (gestionnaires d'événements cassés, tâches qui fuient) sur les plugins qui ne s'y attendent pas.

Problèmes courants

• Le plugin n'apparaît pas dans /plugins : le logiciel du serveur n'est pas compatible Bukkit (vous avez Forge/Fabric/vanilla), ou le .jar est corrompu ou incomplet — téléchargez-le à nouveau.
• UnsupportedClassVersionError dans la console : le plugin a été compilé pour une version de Java plus récente que celle que votre serveur exécute. Vérifiez la version de Java requise par le plugin et changez l'image Docker de votre serveur dans l'onglet Startup (java_17, java_21).
• NoClassDefFoundError : un plugin de dépendance est manquant. La plupart des plugins listent leurs dépendances sur leur page de téléchargement — installez-les également.
• Avertissements d'incompatibilité de version : un plugin 1.20 sur 1.21 pourrait « fonctionner » mais se casser aléatoirement. Utilisez la version conçue pour votre version de Minecraft.
• Le serveur lag après l'installation : certains plugins sont lourds. Désactivez-les un par un (déplacez le .jar hors de plugins/, redémarrez) pour trouver le coupable.

Plugins populaires pour commencer

• LuckPerms — permissions et rangs, utilisé par presque tous les serveurs.
• EssentialsX — maisons, warps, kits, bases économiques. La boîte à outils classique.
• CoreProtect — journalisation des blocs et restauration, sauveur en cas de grief.
• WorldEdit + WorldGuard — protection de région et édition de monde en masse.
• ViaVersion — permet aux joueurs utilisant d'anciens clients Minecraft de rejoindre votre nouveau serveur.

Prochaines étapes

Une fois que vous êtes à l'aise avec l'installation de plugins, configurez un système de permissions avec LuckPerms, et prenez l'habitude de sauvegarder votre répertoire plugins/ avant d'ajouter quoi que ce soit de nouveau — un plugin mal configuré peut effacer les configurations à l'arrêt. Les sauvegardes sont accessibles en un clic depuis l'onglet Backups de votre tableau de bord.