Minecraft Java

Comment installer un plugin sur son serveur Minecraft (Paper / Spigot) ?

Installez un plugin sur votre serveur Minecraft Paper ou Spigot Winheberg avec l'installateur Plugins du panel, ou à la main via le dossier plugins.

1 novembre 2026 Winheberg
Documentation›Minecraft Java›Comment installer un plugin sur son serveur Minecraft (Paper / Spigot) ?

Contexte

Les plugins sont la façon la plus simple d'enrichir un serveur Minecraft Java sans toucher au client des joueurs. Gestion des permissions, téléportation, économie, protection de zones ou mini-jeux, tout passe par un fichier .jar placé dans le dossier plugins du serveur. Paper étant basé sur Spigot, la grande majorité des plugins Bukkit et Spigot fonctionnent sur les deux logiciels.

Sur un serveur Minecraft Winheberg, le panel intègre un installateur de plugins qui cherche directement chez les principaux fournisseurs et dépose le fichier au bon endroit. Ce guide vous montre comment l'utiliser, puis comment ajouter un plugin à la main quand il n'est pas proposé.

Prérequis

Si votre serveur tourne encore en Vanilla, l'onglet Versions de la section CONFIGURATION permet d'installer Paper ou Spigot. Laissez l'option Wipe Server Files désactivée, sans quoi tous les fichiers du serveur sont supprimés avant l'installation.

Un plugin s'exécute avec un accès complet à votre serveur. Installez uniquement des plugins connus, publiés par des fournisseurs reconnus ou par la page officielle de leur auteur.

1. Ouvrir l'installateur de plugins

Connectez-vous au panel Winheberg et sélectionnez votre serveur. Dans le menu latéral, section CONFIGURATION, cliquez sur Plugins.

La page affiche une liste de plugins et plusieurs filtres en haut.

Page Plugins du panel Winheberg avec les filtres Provider, Page size, Plugin loader et Minecraft version
Filtre Rôle
Provider Fournisseur dans lequel chercher, parmi CurseForge, Hangar, Modrinth, Polymart et SpigotMC (Modrinth par défaut)
Page size Nombre de résultats affichés (10, 25 ou 50)
Plugin loader Logiciel visé, par exemple Paper, Spigot, Bukkit ou Purpur
Minecraft version Version du jeu de votre serveur
Search query Nom du plugin recherché

2. Rechercher le plugin

Réglez Plugin loader sur le logiciel de votre serveur, par exemple Paper, choisissez votre version dans Minecraft version, puis tapez le nom du plugin dans Search query. Dans l'exemple ci-dessous, on cherche LuckPerms pour un serveur Paper 26.3.

Cliquez ensuite sur l'icône de téléchargement de la carte du plugin.

Recherche de LuckPerms filtrée sur Paper et 26.3, icône de téléchargement encadrée

Si un plugin n'apparaît pas, changez de fournisseur dans Provider. Un même plugin n'est pas forcément publié partout.

3. Choisir la version et installer

La fenêtre Install plugin s'ouvre. Sélectionnez la version voulue dans la liste Plugin version, en général la plus récente, puis cliquez sur Install plugin.

Fenêtre Install plugin avec la liste Plugin version et le bouton Install plugin

Une notification confirme que le fichier a été déposé dans le dossier plugins du serveur.

Plugin "LuckPerms" successfully installed in /home/container/plugins.

La liste peut proposer une version marquée (Bukkit). Les plugins Bukkit se chargent aussi sur Paper et Spigot.

4. Redémarrer le serveur et vérifier

Le plugin n'est chargé qu'au démarrage. Dans Console, redémarrez le serveur avec le bouton Restart et surveillez les journaux, une ligne confirme son activation.

[LuckPerms] Successfully enabled. (took 2167ms)

Une fois le serveur lancé, tapez la commande suivante dans la console du panel, sans / devant.

plugins

Elle liste les plugins chargés. En jeu, l'équivalent est /plugins, où un plugin affiché en vert est actif et un plugin affiché en rouge n'a pas pu s'activer.

Résultat de la commande plugins dans la console, LuckPerms listé dans Bukkit Plugins

Après l'ajout ou la suppression d'un plugin, redémarrez complètement le serveur plutôt que d'utiliser /reload. Paper affiche lui-même un avertissement sur cette commande, qui peut provoquer des bugs et des fuites de mémoire.

Méthode alternative, envoyer le fichier .jar à la main

Si le plugin n'est proposé par aucun fournisseur de l'installateur, ou si vous avez un fichier fourni par son auteur, vous pouvez l'ajouter vous-même.

  1. Téléchargez le fichier .jar depuis une source fiable, par exemple Hangar, Modrinth ou SpigotMC, en vérifiant qu'il correspond à votre version de Minecraft
  2. Dans le panel, ouvrez Files puis le dossier plugins
  3. Cliquez sur Upload et sélectionnez le fichier .jar
  4. Redémarrez le serveur et vérifiez avec la commande plugins

Le fichier doit se trouver directement dans plugins, un .jar placé dans un sous-dossier n'est pas lu. Si le plugin est livré dans une archive .zip, décompressez-la sur votre ordinateur et n'envoyez que le .jar.

L'envoi depuis le gestionnaire de fichiers du panel est limité à 100 Mo par fichier. Au-delà, passez par le SFTP avec FileZilla ou WinSCP en suivant notre guide « Comment se connecter en SFTP à son serveur gaming ? ». Les identifiants se trouvent dans Settings, le mot de passe est celui de votre compte panel.

En cas de problème

Le premier réflexe est d'ouvrir le fichier logs/latest.log depuis Files. Les messages de chargement des plugins apparaissent au début du fichier.

❌ Le plugin n'apparaît pas dans la liste après installation

  • Vérifiez que le serveur a bien été redémarré après l'installation
  • En cas d'envoi manuel, vérifiez que le fichier est directement dans plugins et que son nom se termine par .jar
  • Cherchez le nom du plugin dans logs/latest.log pour repérer une éventuelle erreur

❌ Il manque une dépendance

Le plugin a besoin d'un autre plugin pour fonctionner. La console affiche une ligne de ce type.

Unknown/missing dependency plugins: [Vault]
  • Installez le plugin nommé entre crochets avec l'installateur Plugins ou depuis sa page officielle
  • Redémarrez le serveur

❌ Le plugin n'est pas compatible avec la version du serveur

Un message Unsupported API version indique que le plugin a été conçu pour une version de Minecraft plus récente que celle de votre serveur.

  • Réinstallez le plugin en réglant le filtre Minecraft version sur la version de votre serveur
  • Consultez la page du plugin pour connaître les versions prises en charge

❌ Le fichier plugin.yml est invalide

  • Le fichier est peut-être un mod Forge ou Fabric, qui ne fonctionne pas sur Paper ni sur Spigot
  • Le téléchargement est peut-être corrompu, réinstallez le plugin

❌ Deux versions du même plugin sont installées

Un avertissement Ambiguous plugin name signale que deux fichiers contiennent le même plugin, souvent après une mise à jour.

  • Supprimez l'ancien .jar dans plugins depuis Files et gardez uniquement le plus récent
  • Redémarrez le serveur

Bonnes pratiques

  • Créez une sauvegarde depuis l'onglet Backups avant d'installer ou de mettre à jour un plugin, comme expliqué dans notre guide « Comment créer et restaurer une sauvegarde de son serveur gaming ? »
  • Ajoutez les plugins un par un et redémarrez entre chaque ajout, il est ainsi beaucoup plus simple d'identifier celui qui pose problème
  • Gardez une liste de vos plugins avec leur version et leur fournisseur, pratique au moment de mettre à jour Minecraft
  • Supprimez les plugins inutilisés, chaque plugin chargé consomme des ressources au démarrage et en jeu
  • Testez vos permissions avec un compte non opérateur, comme dans notre guide « Comment installer et configurer EssentialsX sur un serveur Minecraft ? »

Besoin d'aide ?

Si un plugin refuse de se charger malgré ces vérifications, notre équipe peut vous aider à lire les journaux. Ouvrez un ticket dans le département Technique depuis votre espace client, renseignez le champ Produit lié avec le serveur concerné, et indiquez le nom du plugin, sa version ainsi que l'erreur affichée dans logs/latest.log.

Votre serveur Minecraft est prêt à accueillir ses premiers plugins 📦

Besoin d'un serveur Minecraft Java ?

Découvrez nos offres adaptées à vos besoins et lancez-vous dès maintenant.

Voir les offres