ACLClouds
ACLClouds

Comment installer un plugin Minecraft ?

Télécharger un fichier JAR compatible, l’envoyer dans plugins et contrôler son chargement. Ils ne se placent pas dans le dossier mods.

Les plugins fonctionnent avec Paper, Purpur et les logiciels compatibles Bukkit/Spigot. Ils ne se placent pas dans le dossier mods.

Procédure étape par étape

  1. Vérifier le logiciel

    Assurez-vous que le serveur utilise Paper ou Purpur et que le plugin prend en charge votre version de Minecraft.

  2. Arrêter le serveur

    Un arrêt propre évite qu’un fichier soit lu pendant son transfert.

  3. Importer le JAR

    Ouvrez Plugins ou Fichiers, puis envoyez le fichier .jar dans /plugins.

  4. Redémarrer et lire la console

    Le plugin crée son dossier de configuration au premier démarrage. Corrigez toute dépendance manquante signalée dans les logs.

  5. Configurer

    Éditez les fichiers YAML ou JSON générés, puis utilisez la commande de rechargement du plugin uniquement si sa documentation l’autorise.

Contrôler les plugins dans la console

plugins
version LuckPerms

Installer depuis la page Plugins

La page « Plugins » du panel recherche les plugins sur Modrinth et n’affiche que ceux qui déclarent votre logiciel serveur : Paper, Purpur, Spigot, Bukkit ou Folia. Cliquez sur « Installer » : le panel télécharge la version la plus récente compatible avec votre version de Minecraft, directement dans /plugins.

Si l’auteur n’a publié aucune version pour votre version exacte de Minecraft, le panel peut installer la dernière version publiée pour votre logiciel serveur. Vérifiez alors la compatibilité sur la page officielle du plugin avant de redémarrer.

Pour un plugin publié ailleurs (SpigotMC, Hangar, GitHub), utilisez « Importer .jar » ou glissez le fichier sur la page. Seuls les fichiers .jar sont acceptés, et ils ne sont actifs qu’après un redémarrage du serveur.

Vérifier que le plugin est chargé

Après le redémarrage, tapez plugins dans la console. Les plugins actifs apparaissent en vert ; un nom en rouge signale un plugin désactivé à cause d’une erreur. Cherchez ensuite dans le log la ligne de chargement, par exemple [LuckPerms] Enabling LuckPerms, ou l’erreur qui la remplace.

Bonnes pratiques

Quelques habitudes évitent la plupart des pannes après une installation.

  • Ajoutez les plugins un par un : si le serveur ne démarre plus, vous savez lequel retirer.
  • Lors d’une mise à jour, supprimez l’ancien .jar : deux versions du même plugin dans /plugins provoquent l’erreur Ambiguous plugin name.
  • Évitez la commande reload : beaucoup de plugins ne la supportent pas et Paper la déconseille. Un redémarrage complet est plus sûr.

Vérification rapide

  • Source du plugin fiable
  • Version compatible
  • Dépendances installées
  • Sauvegarde disponible

Questions fréquentes

Pourquoi mon plugin n’apparaît pas dans la liste de la commande plugins ?

Le fichier n’est pas au bon endroit ou n’a pas été lu. Vérifiez qu’il se trouve directement dans /plugins, pas dans un sous-dossier ni dans /mods, que son nom se termine par .jar et que le serveur tourne sous Paper ou Purpur. Un serveur Vanilla, Forge ou Fabric ignore ce dossier.

Que signifie UnknownDependencyException dans la console ?

Le message UnknownDependencyException indique que le plugin a besoin d’un autre plugin absent du serveur. Son nom figure entre crochets, par exemple [Vault]. Installez cette dépendance dans /plugins depuis sa source officielle, puis redémarrez.

Pourquoi la console affiche Invalid plugin.yml ?

Le .jar ne contient pas de plugin.yml lisible : ce n’est pas un plugin Bukkit. Il s’agit souvent d’un mod Forge ou Fabric, ou d’une archive de code source. Téléchargez la version prévue pour Paper ou Spigot, ou placez le mod sur un serveur qui utilise le bon loader.

Peut-on installer un plugin sans redémarrer le serveur ?

Les plugins sont lus au démarrage. Certains outils chargent un plugin à chaud, mais ils laissent souvent des données en mémoire et rendent le serveur instable. Prévenez les joueurs et redémarrez : c’est la méthode fiable.