Comment installer un plugin Minecraft

Étape par étape

1. 1.Vérifiez que votre serveur peut faire tourner des plugins

   Les plugins nécessitent un logiciel de serveur basé sur Bukkit : Paper, Spigot, Purpur ou Folia pour les serveurs de jeu, BungeeCord ou Velocity pour les proxys. Un serveur vanilla, ou un serveur Fabric ou Forge, ne charge pas de plugins.

2. 2.Vérifiez la version du plugin

   La page ou le fichier du plugin indique les versions de Minecraft prises en charge. Un plugin compilé pour une version plus récente que celle de votre serveur refuse généralement de se charger.

3. 3.Arrêtez le serveur et copiez le .jar

   Placez le fichier .jar dans le dossier plugins/, à côté du .jar du serveur. Sur un panneau d'hébergement, envoyez-le avec le gestionnaire de fichiers ou en SFTP. Ne le décompressez pas.

4. 4.Installez ses dépendances

   Si le plugin a besoin d'autres plugins (Vault, PlaceholderAPI, ProtocolLib, LuckPerms), placez aussi leurs fichiers .jar dans plugins/.

5. 5.Démarrez le serveur et lisez la console

   Cherchez le nom du plugin dans le journal de démarrage. « Enabling <Plugin> » sans erreur ensuite signifie qu'il s'est chargé.

6. 6.Vérifiez-le en jeu et configurez-le

   Lancez /plugins : les plugins chargés sont en vert, ceux qui n'ont pas pu s'activer sont en rouge. Ses paramètres se trouvent dans plugins/<PluginName>/config.yml ; modifiez-les et redémarrez.

Où vont les fichiers

Voici à quoi ressemble un dossier de serveur typique après le premier démarrage avec un plugin :

• paper.jar (ou spigot.jar) : le serveur lui-même.
• plugins/MyPlugin.jar : le plugin que vous avez ajouté.
• plugins/MyPlugin/ : un dossier créé par le plugin, avec config.yml, les messages et ses données sauvegardées.
• logs/latest.log : le journal de l'exécution en cours, où sont écrites les erreurs de chargement.

Redémarrez, n'utilisez pas /reload

/reload décharge et recharge tous les plugins sans redémarrer le serveur. Beaucoup de plugins ne le supportent pas : les écouteurs s'enregistrent deux fois, des données sont perdues ou la mémoire fuit. Redémarrez toujours le serveur après avoir ajouté, retiré ou mis à jour un plugin. Certains plugins ont leur propre commande de rechargement (par exemple /myplugin reload) pour leur config uniquement : celle-là peut être utilisée sans risque.

Avant d'installer sur le serveur en production

• Sauvegardez le dossier du serveur, ou au moins plugins/ et les mondes.
• Essayez d'abord sur une copie : même logiciel, même version et mêmes autres plugins que le vrai serveur. Voir comment tester un plugin.
• Un plugin à la fois : si quelque chose casse, vous savez lequel en est la cause.
• Téléchargez depuis la page de l'auteur (SpigotMC, Hangar, Modrinth, GitHub), pas depuis des réuploads.

Les plugins créés avec Codexe

Un plugin créé sur Codexe est livré sous forme de .jar compilé portant le nom du projet, vérifié avant que vous le receviez : il doit contenir les classes compilées et un plugin.yml. Vous pouvez l'essayer sur un serveur de test privé avant de l'installer où que ce soit, gratuitement sur toutes les offres ; le serveur de test installe pour vous les plugins listés comme dépendances. Télécharger le .jar pour votre propre serveur nécessite une offre ou un pack de téléchargements.

Questions