Installer des plugins sur un serveur Minecraft
Les plugins ajoutent des fonctions à votre serveur sans que les joueurs aient quoi que ce soit à installer : protections de terrain, permissions, économie, commandes d'administration. Ce guide concerne les serveurs Paper et Purpur, qui chargent les plugins Bukkit, Spigot et Paper.
Plugins ou mods ?
| Votre formule | Ce qu'elle charge | Dossier |
|---|---|---|
| Paper, Purpur | Plugins (.jar Bukkit, Spigot, Paper) |
plugins/ |
| Fabric, Forge, NeoForge, modpacks | Mods (.jar du chargeur correspondant) |
mods/ |
| Vanilla | Ni plugins ni mods | — |
Un plugin ne fonctionne pas sur un serveur Fabric ou Forge, et un mod ne fonctionne pas sur Paper. Les mods demandent en général que les joueurs installent les mêmes mods de leur côté ; les plugins, non.
Le type de serveur est fixé par la formule commandée.
1. Choisir ses plugins
Téléchargez vos plugins sur des sites reconnus :
Avant de télécharger, vérifiez :
- la version de Minecraft prise en charge, qui doit correspondre à celle de votre serveur (affichée au démarrage dans la console) ;
- la plateforme : un plugin « Paper » ou « Spigot » convient, un plugin « Folia » seulement n'est pas fait pour Paper ;
- les dépendances : beaucoup de plugins ont besoin d'un autre plugin pour fonctionner (Vault, ProtocolLib, PlaceholderAPI…). La page du plugin les liste ;
- la date de la dernière mise à jour : un plugin abandonné depuis plusieurs versions de Minecraft posera problème tôt ou tard.
Évitez les .jar trouvés sur des sites de téléchargement inconnus ou des versions « crackées » de plugins payants : un plugin a accès à tout votre serveur.
2. Installer le plugin
- Faites une sauvegarde depuis l'onglet Sauvegardes du panel de jeu (voir Sauvegarder et restaurer son monde).
- Arrêtez le serveur depuis la console.
- Ouvrez l'onglet Fichiers, entrez dans le dossier
plugins/et envoyez le fichier.jar(bouton d'envoi ou glisser-déposer). Pour plusieurs fichiers, le SFTP est plus pratique : les identifiants figurent dans le panel. - Démarrez le serveur et suivez la console : le plugin annonce son chargement (
[NomDuPlugin] Enabling NomDuPlugin v…). - Vérifiez en jeu ou dans la console :
pluginsLa liste affiche les plugins actifs en vert et ceux qui n'ont pas pu se charger en rouge.
N'utilisez pas /reload pour charger un plugin sur un serveur en marche : la commande est déconseillée par Paper lui-même et provoque fuites de mémoire et comportements imprévisibles. Redémarrez le serveur.
3. Configurer le plugin
Au premier démarrage, la plupart des plugins créent un dossier plugins/NomDuPlugin/ avec un fichier config.yml.
- Arrêtez le serveur, ou utilisez la commande de rechargement propre au plugin si elle existe (
/lp reload,/essentials reload…). - Modifiez
config.ymldans l'éditeur du panel. - Respectez l'indentation YAML : des espaces, jamais de tabulations, et le même nombre d'espaces à chaque niveau. Une erreur d'indentation empêche le plugin de lire sa configuration ; la console l'indique au démarrage.
- Redémarrez et vérifiez la console.
Un socle de plugins courant
Pour un serveur communautaire, quelques plugins reviennent souvent :
| Besoin | Exemples |
|---|---|
| Permissions et grades | LuckPerms |
Commandes de base (/home, /spawn, /tpa) |
EssentialsX |
| Protection de zones | WorldGuard (avec WorldEdit) |
| Réclamation de terrains par les joueurs | GriefPrevention |
| Journal des actions, retour arrière après un vol ou une destruction | CoreProtect |
Ce ne sont que des exemples. Installez les plugins un par un, en redémarrant à chaque fois : si quelque chose casse, vous savez lequel.
Mettre à jour un plugin
- Lisez le journal des modifications : certaines mises à jour changent le format de configuration.
- Sauvegardez, arrêtez le serveur.
- Remplacez l'ancien
.jarpar le nouveau dansplugins/. Ne gardez pas les deux : deux versions du même plugin entrent en conflit. - Démarrez et vérifiez la console.
Paper gère aussi un dossier plugins/update/ : un .jar qui y est déposé remplace celui du même nom au prochain démarrage.
Plugins et performances
Chaque plugin consomme de la mémoire et du temps de calcul. Si le serveur ralentit (TPS en baisse), un plugin est souvent en cause : le guide Optimiser un serveur Minecraft Paper explique comment le repérer avec un profileur. Si la mémoire manque, voir Combien de RAM pour un serveur Minecraft ; le bouton « Mettre à niveau » de la fiche du service fait passer à une formule supérieure.
Problèmes fréquents
| Message dans la console | Cause probable |
|---|---|
Could not load 'plugins/X.jar' + UnknownDependencyException |
Une dépendance manque : installez le plugin indiqué. |
Unsupported API version |
Plugin prévu pour une version de Minecraft plus récente que celle du serveur. |
UnsupportedClassVersionError |
Plugin compilé pour une version de Java plus récente que celle du serveur. |
Ambiguous plugin name |
Deux fichiers du même plugin dans plugins/ : supprimez l'ancien. |
Erreur YAML (while scanning, mapping values are not allowed) |
Indentation ou caractère invalide dans config.yml. |
Besoin d'aide ?
Ouvrez un ticket depuis votre espace client avec l'adresse du serveur, le nom et la version du plugin, et les lignes de la console au démarrage. Pour une question sur le fonctionnement d'un plugin lui-même, sa documentation et son auteur restent la meilleure source.