Comment installer des plugins sur Paper, Spigot et Purpur

Les plugins ajoutent des fonctionnalités à votre serveur, comme des homes, des claims, des grades ou des minijeux, et ils ne tournent que sur le serveur. Vos joueurs rejoignent avec le jeu normal et n’installent rien. Les plugins fonctionnent sur Paper, Purpur, Spigot et, pour le petit nombre qui le gère, Folia. Si votre serveur utilise Fabric, Forge ou NeoForge, il vous faut plutôt des mods. Consultez Comment installer des mods sur Forge, Fabric et NeoForge. Pour comparer les deux, lisez Les types de serveur Minecraft expliqués.

Les plugins ont un accès complet à votre serveur. N’installez que des plugins issus de sources de confiance, et faites d’abord un backup. Consultez Comment sauvegarder, restaurer et réinitialiser votre monde Minecraft.

Installer un plugin depuis l’onglet Modding

L’onglet Modding recherche dans plusieurs catalogues de plugins à la fois et place le fichier dans le bon dossier pour vous.

1. Ouvrez votre serveur dans le panel et cliquez sur Modding.
2. Cliquez sur l’onglet Plugins. Si vous ne le voyez pas, votre type de serveur ne fait pas tourner de plugins. L’onglet l’explique et nomme les types qui le font.
3. Saisissez le nom du plugin dans Rechercher des plugins et appuyez sur Entrée. Le menu Trier par peut ordonner les résultats par Plus téléchargés ou Mis à jour récemment.
4. Utilisez les filtres à gauche si vous en avez besoin. Source peut être Toutes les sources, Modrinth, CurseForge, Hangar, SpigotMC ou Polymart. Version de Minecraft démarre sur la version de votre propre serveur.
5. Cliquez sur Installer sur la ligne voulue. Le panel installe la build la plus récente pour la version affichée dans le filtre Version de Minecraft, qui démarre sur la version de votre serveur. Pour obtenir une build plus ancienne, changez ce filtre, ou téléchargez vous-même le jar et téléversez-le, comme décrit plus bas. Ne choisissez qu’une version que votre serveur peut charger.
6. Si le plugin a besoin d’autres plugins pour fonctionner, une fenêtre s’ouvre pour les lister, et son bouton indique Installer 2 fichiers ou similaire. Cliquez dessus pour installer le plugin avec ce dont il a besoin.
7. Redémarrez le serveur pour qu’il charge le plugin. Le panel ne le redémarre pas pour vous après une installation isolée. Consultez Comment démarrer, arrêter, redémarrer et forcer l’arrêt de votre serveur.

Les plugins ne sont lus qu’au démarrage du serveur : un plugin que vous avez installé ne fait donc rien avant le redémarrage.

Le sens des badges

Un plugin dont la fiche ne nomme pas votre version de Minecraft s’installe simplement, sans avertissement. Il fonctionne souvent quand même, mais vérifiez la Console après le redémarrage.

Un serveur Paper accepte les plugins listés pour Paper, Spigot ou Bukkit. Un serveur Purpur les accepte aussi, ainsi que les plugins listés pour Purpur. Un serveur Spigot accepte les plugins listés pour Spigot ou Bukkit : un plugin conçu uniquement pour Paper ne s’y installera donc pas.

Installer un plugin en téléversant le fichier

Utilisez cette méthode pour un plugin que vous avez téléchargé vous-même, par exemple un plugin absent des catalogues.

1. Téléchargez le fichier .jar du plugin depuis sa page officielle. Hangar, le site de plugins propre à Paper, est l’endroit que recommande la documentation de Paper. Modrinth en est un autre bon.
2. Ouvrez votre serveur et cliquez sur Files.
3. Ouvrez le dossier plugins.
4. Cliquez sur Téléverser et choisissez le fichier .jar. Pour de nombreux fichiers, utilisez SFTP. Consultez Comment se connecter aux fichiers de votre serveur avec SFTP.
5. Redémarrez le serveur.

Placez le jar directement dans plugins. La documentation de Paper indique que les plugins situés dans des sous-dossiers de plugins ne sont pas chargés. Certains plugins sont vendus sur des sites qui n’autorisent pas les téléchargements automatiques. Ceux-là, vous devez les télécharger dans votre navigateur et les téléverser vous-même.

Vérifier que le plugin s’est chargé

1. Ouvrez l’onglet Console et surveillez le démarrage. Cherchez le nom du plugin et les lignes marquées comme des erreurs. Le filtre Erreurs n’affiche que celles-ci.
2. Quand le serveur est En ligne, saisissez plugins dans la Console et appuyez sur Entrée. La commande liste les plugins que le serveur connaît. Consultez Comment utiliser la console et exécuter des commandes.

Si le plugin est absent ou si la Console affiche une erreur qui le nomme, il est probablement conçu pour une autre version de Minecraft ou a d’abord besoin d’un autre plugin. Lisez la page du plugin pour savoir ce qu’il demande.

Modifier les réglages d’un plugin

La plupart des plugins créent un dossier à leur nom dans plugins lors de leur premier lancement, contenant généralement un config.yml. Ouvrez-le depuis Files, modifiez-le, enregistrez, et redémarrez le serveur. La page Paramètres du panel ne liste pas les fichiers des plugins. Elle liste les fichiers propres au serveur, comme Bukkit Settings, Spigot Settings et Purpur Settings, quand ils existent.

Mettre à jour et retirer des plugins

1. Ouvrez Modding, puis Plugins, puis la vue Installés.
2. Un plugin avec une build plus récente affiche les deux versions, comme 2.9.1 → 2.12.1, et un bouton Mettre à jour. Une barre en haut propose de tous les mettre à jour d’un coup. La mise à jour remplace uniquement le fichier du plugin et laisse ses réglages intacts. L’ancien fichier est retiré une fois le nouveau en place.
3. Pour en retirer un, ouvrez son menu ... et cliquez sur Désinstaller. Cochez Supprimer aussi sa configuration et ses données uniquement si vous n’utiliserez plus le plugin. Cela supprime le dossier propre au plugin, qui contient ses réglages et ce qu’il a enregistré, comme des homes ou des claims.
4. Redémarrez le serveur pour que le changement s’applique.

Ne gardez jamais deux versions du même plugin dans plugins. Le serveur risque de refuser de charger l’une comme l’autre. Le panel retire l’ancien fichier pour vous quand vous mettez à jour, mais un fichier que vous avez téléversé à la main, c’est à vous de le retirer.

Si le serveur ne démarre pas après un plugin

1. Ouvrez Files, puis plugins, et supprimez le plugin le plus récent que vous avez ajouté. Laissez son dossier de réglages tranquille au cas où vous voudriez le récupérer.
2. Démarrez le serveur. S’il démarre, le plugin était la cause.
3. S’il échoue encore, restaurez le backup fait avant. Consultez Comment créer, télécharger et restaurer des backups.

Pour une liste de contrôle complète, lisez Comment réparer un serveur qui ne démarre pas. Les plugins et le lag sont traités dans Comment réduire le lag de votre serveur Minecraft.

De bons plugins pour commencer

Ce sont des plugins anciens et très utilisés, chacun avec sa propre page sur Modrinth ou Hangar :

• LuckPerms gère les grades et les permissions. Consultez Comment vous donner le statut d’op et gérer les permissions.
• EssentialsX ajoute les commandes du quotidien, comme les homes et les warps. Certains plugins ont besoin d’un autre plugin installé à côté. Le panel les liste avant l’installation.
• WorldEdit modifie rapidement de grandes parties du monde, pour les bâtisseurs.

Lisez la page de chaque plugin pour connaître les versions de Minecraft qu’il gère avant de l’installer.