Sous Paper et Spigot, un plugin est un simple fichier JAR (une archive Java) placé dans le dossier plugins. Si ce fichier est endommagé, vide, en double ou s'il s'agit en réalité d'un mod ou d'une bibliothèque, le serveur ne charge pas le plugin ou plante au démarrage. Chaque section ci-dessous traite l'un de ces messages. Avec « En savoir plus » dans Santé du serveur, tu arrives directement à la bonne section.

Tu trouveras le texte complet dans la Console ou sous Fichiers dans logs/latest.log. Les lignes importantes sont généralement celles juste sous le message, car c'est là que se trouve la vraie raison. Ne remplace des fichiers de plugin que lorsque le serveur est arrêté. Crée d'abord une sauvegarde sous Sauvegardes, surtout si des fichiers de monde ou de configuration risquent aussi d'être touchés.

« Error occurred while enabling … » : le plugin ne démarre pas

Voici à quoi ressemble le message :

Error occurred while enabling EssentialsSpawn v<Version> (Is it up to date?)
Error occurred while enabling WorldEditDisplay v<Version> (Is it up to date?)
Error occurred while disabling FurnitureLib v<Version>

Ce qui se cache derrière : le serveur a chargé le plugin, mais celui-ci a planté lors de son activation et a été désactivé. Le serveur continue de tourner, mais les fonctions de ce plugin manquent entièrement. S'il s'agit d'un plugin de protection, de permissions ou de connexion, cette protection fait elle aussi défaut. La plupart du temps, le plugin ne correspond pas à la version du serveur ou à celle d'un autre plugin installé.

Voici comment le corriger :

  1. La ligne d'erreur indique le plugin et sa version. Vérifie sur la page du plugin quelle version prend en charge la version de ton serveur, puis effectue la mise à jour serveur arrêté.
  2. Si NoSuchMethodError (une méthode est introuvable) ou NoClassDefFoundError (un composant du programme est introuvable) apparaît en dessous, vérifie les dépendances mentionnées. EssentialsSpawn et EssentialsX doivent par exemple être compatibles entre eux ; une référence à Bukkit peut concerner l'interface du serveur.
  3. En cas d'erreur de base de données comme Communications link failure, vérifie les identifiants dans la configuration du plugin et sous Bases de données.
  4. Redémarre et vérifie dans la Console que le plugin s'active correctement.

Bon à savoir : « Error occurred while disabling » concerne la désactivation. Si ce message apparaît après une erreur d'activation, examine d'abord cette erreur antérieure. Plus d'informations : Le plugin ne correspond pas à la version du serveur.

Fichier de plugin ignoré (« Could not load 'plugins/…jar' »)

Voici à quoi ressemble le message :

[ModernPluginLoadingStrategy] Could not load 'plugins/<Plugin>.jar' in 'plugins'
org.bukkit.plugin.UnknownDependencyException: Unknown/missing dependency plugins: [ProtocolLib]. Please download and install these plugins to run '<Plugin>'.

Ce qui se passe : Le serveur n'a pas pu charger le JAR indiqué en tant que plugin et l'ignore. Un JAR (archive Java) est le fichier qui contient un plugin. Le reste du serveur peut continuer à tourner, mais ce plugin est totalement absent. La cause est un fichier endommagé ou invalide, ou un JAR sans plugin.yml lisible, le fichier de description grâce auquel le serveur reconnaît un plugin. Avec « Failed to run bootstrapper », un plugin Paper a échoué dès la toute première phase de démarrage.

Comment le corriger :

  1. Lis la ligne sous le message. Si tu y vois UnknownDependencyException, un autre plugin est manquant : installe le plugin indiqué entre crochets.
  2. Sinon, arrête le serveur et supprime le JAR concerné sous Fichiers, dans le dossier plugins.
  3. Télécharge une version depuis une source fiable qui correspond à ton type de serveur (Paper, Spigot) et à ta version de Minecraft, puis envoie-la sur le serveur.
  4. Redémarre le serveur.

Bon à savoir : Si le chemin pointe vers plugins/.paper-remapped, il s'agit d'une copie que Paper crée pour les plugins Spigot. Remplace le JAR d'origine dans plugins ; Paper recréera la copie au prochain démarrage. Au sujet des plugins manquants : Le plugin a besoin d'un autre plugin.

« Error initializing plugin … » : le plugin échoue au démarrage

Voici à quoi ressemble le message :

[<Plugin>] Error initializing plugin '<Plugin>-<Version>.jar' in folder '<Folder>' (Is it up to date?)
java.lang.ExceptionInInitializerError
java.lang.ArrayIndexOutOfBoundsException: Index <Index> out of bounds for length <Length>

Ce qui se passe : le plugin a planté pendant que le serveur le préparait, donc avant même d'être activé. Il reste désactivé, ses commandes et ses fonctions sont absentes, et le serveur continue de tourner sans lui. Le plus souvent, la version du plugin ne correspond pas à la version du serveur. La ligne d'erreur située en dessous indique souvent la version ou une classe manquante, c'est-à-dire un élément de programme que le plugin attend dans le serveur.

Comment le corriger :

  1. Lis d'abord les lignes qui suivent dans logs/latest.log sous Fichiers, en particulier Caused by. Elles indiquent la véritable cause.
  2. Installe la version du plugin adaptée à ta version du serveur ou mets le plugin à jour. La page du plugin indique les versions prises en charge.
  3. S'il n'existe pas encore de version adaptée à ta version du serveur, attends une mise à jour du plugin ou reste pour l'instant sur une version prise en charge sous Version.
  4. Si cela n'aide pas, retire le plugin à titre de test et signale l'erreur à l'auteur du plugin, avec le message complet.
  5. Redémarre le serveur.

Bon à savoir : si Geyser signale « English locale not found », le fichier est incomplet. Télécharge à nouveau Geyser depuis la page officielle du projet. Plus d'informations : Le plugin ne correspond pas à la version du serveur.

Paper ne charge pas un plugin (« Could not load plugin … in folder »)

Voici à quoi ressemble le message :

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>-<Version>.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.ExceptionInInitializerError

Ce qui se passe : Paper n'a pas pu charger le plugin indiqué au démarrage. Le plugin est totalement absent, le reste du serveur démarre. La raison figure sur la ligne juste en dessous : le plus souvent un plugin.yml défectueux, une dépendance manquante ou une version conçue pour une autre version du serveur. Un message concernant « API version string » signifie par exemple que l'indication de version dans le plugin.yml a un format que ta version du serveur ne comprend pas.

Comment le corriger :

  1. Lis la ligne juste sous le message.
  2. Télécharge à nouveau le plugin en choisissant la version qui correspond à ta version du serveur.
  3. Arrête le serveur, supprime l'ancien JAR du dossier plugins sous Fichiers et envoie le nouveau.
  4. Redémarre le serveur et vérifie dans la Console que le plugin se charge maintenant.

Bon à savoir : Si la ligne en dessous mentionne un plugin manquant, le problème ne vient pas du fichier lui-même. Dans ce cas, consulte Le plugin a besoin d'un autre plugin.

« Ambiguous plugin name … » : le plugin est installé en double

Voici à quoi ressemble le message :

[ModernPluginLoadingStrategy] Ambiguous plugin name 'ViaVersion' for files 'plugins/ViaVersion.jar' and 'plugins/ViaVersion-<Version>.jar' in 'plugins'
[ModernPluginLoadingStrategy] Ambiguous plugin name 'LPC' for files 'plugins/.paper-remapped/LPC-<Version>.jar' and 'plugins/.paper-remapped/LPC-<AutreVersion>.jar' in 'plugins/.paper-remapped'
[ModernPluginLoadingStrategy] Ambiguous plugin name 'Slimefun' for files 'plugins/.paper-remapped/<Fichier>.jar' and 'plugins/.paper-remapped/<AutreFichier>.jar' in 'plugins/.paper-remapped'

Ce qui se cache derrière : deux fichiers JAR déclarent le même nom de plugin interne, même si leurs noms de fichier sont différents. Il s'agit typiquement d'une ancienne et d'une nouvelle version, ou de deux variantes du même plugin. Le serveur n'en charge qu'un seul et tourne peut-être avec la version non souhaitée.

Voici comment le corriger :

  1. Arrête le serveur et ouvre le dossier plugins sous Fichiers.
  2. Associe les deux fichiers mentionnés à leurs JAR d'origine. plugins/.paper-remapped contient des copies adaptées par Paper ; supprime le JAR d'origine non souhaité dans plugins, et pas seulement sa copie.
  3. Conserve exactement une version, celle qui correspond à la version de ton serveur. Ne supprime aucun dossier de données de plugin.
  4. Redémarre. Vérifie la présence du message dans la Console ; la commande plugins affiche les plugins chargés.

Bon à savoir : mets à jour les plugins serveur arrêté et supprime l'ancien JAR avant d'envoyer le nouveau.

« does not contain a paper-plugin.yml or plugin.yml » : le fichier n'est pas un plugin

Voici à quoi ressemble le message :

Directory 'plugins/<Mod>-fabric-<Version>.jar' does not contain a paper-plugin.yml or plugin.yml!
Directory 'plugins/<Mod>-neoforge-<Version>.jar' does not contain a paper-plugin.yml or plugin.yml!

Ce qui se passe : le dossier plugins contient un fichier JAR sans plugin.yml et sans paper-plugin.yml, donc sans l'un des fichiers de description des plugins. Il s'agit le plus souvent d'un mod pour Fabric, Forge ou NeoForge ; parfois, c'est une bibliothèque Java comme un pilote de base de données. Paper et ses variantes ne peuvent pas charger ce fichier comme plugin et l'ignorent. Le serveur continue de tourner, mais la fonction espérée est absente.

Comment le corriger :

  1. Arrête le serveur et retire le fichier mentionné de plugins/ sous Fichiers.
  2. Cherche sur la page du projet une version pour Paper ou Spigot, correspondant à ta version de Minecraft.
  3. S'il n'existe qu'un mod, vérifie d'abord s'il a vraiment sa place sur le serveur. Certains mods fonctionnent uniquement dans le client du jeu.
  4. Si tu veux passer à un serveur de mods, crée d'abord une sauvegarde sous Sauvegardes. Sous Changer de logiciel / chargeur, choisis exactement le chargeur que demande le mod. Tes plugins Paper ne fonctionneront alors plus.
  5. Redémarre et vérifie la Console.

Le changement de logiciel est décrit dans Changer le logiciel et la version du serveur dans le panel.

« zip file closed » : fichier de plugin remplacé pendant que le serveur tourne

Voici à quoi ressemble le message :

java.lang.IllegalStateException: zip file closed
java.lang.IllegalStateException: The plugin classloader for <Plugin> has thrown a zip file error.
io.netty.handler.codec.EncoderException: java.lang.BootstrapMethodError: java.lang.IllegalStateException: zip file closed

Ce qui se cache derrière : un JAR de plugin, c'est-à-dire le fichier programme d'un plugin, a été écrasé ou supprimé pendant que le serveur tournait, ou quelqu'un a utilisé /reload. Le plugin tente ensuite de recharger des parties du programme depuis son fichier déjà fermé et génère des erreurs. Des fonctions du plugin peuvent ne plus marcher jusqu'au prochain redémarrage du serveur. Le message peut aussi apparaître à l'arrêt.

Voici comment le corriger :

  1. Redémarre complètement le serveur. Si le JAR du plugin concerné est manquant, restaure-le au préalable, serveur arrêté, dans Fichiers.
  2. À l'avenir, ne remplace les fichiers de plugin que lorsque le serveur est arrêté : arrête, remplace le JAR dans Fichiers, puis démarre.
  3. Évite /reload. Cette commande recharge les plugins pendant que le serveur tourne, et beaucoup de plugins ne le supportent pas.
  4. Si le message apparaît sans remplacement de fichier préalable, lis les lignes qui le précèdent dans la Console. Elles t'aident à trouver le plugin concerné.

Bon à savoir : les modifications que le plugin n'avait pas encore enregistrées au moment de l'erreur peuvent être perdues.

« duplicate plugin identifier » : deux fichiers de plugin revendiquent le même nom

Voici à quoi ressemble le message :

[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins'
[ModernPluginLoadingStrategy] Could not load plugin '<Plugin>.jar' in folder 'plugins/.paper-remapped'
java.lang.IllegalStateException: … attempted to add duplicate plugin identifier <Plugin> …

Ce qui se passe : deux fichiers JAR fournissent le même nom de plugin ; Paper n'en charge qu'un seul et rejette l'autre. Le plus souvent, l'ancienne et la nouvelle version d'un plugin se trouvent côte à côte dans le dossier plugins. Ou alors, deux plugins revendiquent le même nom : FastAsyncWorldEdit (FAWE en abrégé) contient déjà WorldEdit, donc un fichier JAR WorldEdit supplémentaire entre en conflit avec lui. Le serveur continue de tourner, mais Paper avertit expressément que des erreurs en cascade sont possibles.

Comment le résoudre :

  1. Arrête le serveur.
  2. Dans Fichiers, supprime dans le dossier plugins le JAR le plus ancien ou superflu. Pour FAWE, il s'agit du JAR séparé worldedit-bukkit.
  3. Si le message mentionne plugins/.paper-remapped, vérifie d'abord les fichiers JAR d'origine dans le dossier plugins pour repérer les doublons.
  4. Démarre le serveur et vérifie dans la Console que l'avertissement a disparu et que le plugin souhaité se charge.

Bon à savoir : les commandes WorldEdit habituelles continuent de fonctionner avec FAWE. Pour savoir comment construire avec et annuler des erreurs, consulte WorldEdit : sélectionner des zones, construire et annuler.

ProtocolLib avertit à propos d'un plugin de rechargement

Voici à quoi ressemble le message :

*** ProtocolLib does not support plugin reloaders! ***
*** Please use the built-in reload command!        ***

Ce qui se cache derrière : ProtocolLib intervient en profondeur dans la connexion réseau entre le serveur et les joueurs. Les plugins de rechargement sont des plugins comme PlugMan ou PlugManX, qui chargent ou déchargent des plugins individuels pendant l'exécution. ProtocolLib ne le supporte pas et avertit d'un état incohérent. ProtocolLib et tous les plugins qui s'appuient dessus peuvent alors mal fonctionner, par exemple les plugins anti-triche ou d'affichage.

Voici comment le corriger :

  1. Ne recharge pas ProtocolLib ni les plugins qui l'utilisent avec un plugin de rechargement.
  2. Après toute modification de plugins, redémarre complètement le serveur entier.
  3. Si tu n'as pas besoin du plugin de rechargement, retire-le du dossier plugins dans Fichiers, pour qu'il ne soit pas utilisé par erreur.
  4. Si tu viens d'utiliser un plugin de rechargement, effectue maintenant un redémarrage complet, afin que tout soit de nouveau chargé proprement.

Bon à savoir : Le message recommande la commande de rechargement intégrée. Elle recharge elle aussi tous les plugins pendant l'exécution. La méthode la plus sûre reste un redémarrage complet.

« Error loading plugin » : fichier de plugin ou nom de plugin invalide

Voici à quoi ressemble le message :

[DirectoryProviderSource] Error preparing plugin context: Directory 'plugins/<Fichier>.jar' failed to update!
[DirectoryProviderSource] Error loading plugin: Directory 'plugins/<Fichier>.jar' failed to load!
[DirectoryProviderSource] Error loading plugin: Restricted name, cannot use 0x20 (space character) in a plugin name.

Ce qui se passe : un fichier du dossier plugins ne peut pas être chargé ; le plugin ne démarre pas. Il s'agit souvent du code source (-sources.jar), de la documentation (-javadoc.jar), d'un téléchargement incomplet ou d'une version prévue pour une autre plateforme. « Invalid plugin.yml » et « only DEFLATED entries can have EXT descriptor » indiquent également un fichier inadapté. « Restricted name » avec « 0x20 » signifie que le nom du plugin défini dans plugin.yml contient un espace.

Comment le résoudre :

  1. Arrête le serveur et supprime le JAR concerné du dossier plugins via Fichiers.
  2. Télécharge le véritable JAR du plugin depuis le site officiel, adapté à Paper ou Spigot. Les mods Fabric ou Forge n'ont pas leur place dans le dossier plugins.
  3. Si le téléchargement est un ZIP, décompresse-le sur ton ordinateur et envoie le JAR approprié.
  4. En cas de « Restricted name », utilise une version corrigée par le développeur. Le nom du plugin défini doit être corrigé ; un autre nom de fichier ne résout pas cette erreur.
  5. Redémarre et vérifie la Console.

Bon à savoir : conserve les données et les configurations existantes du plugin lorsque tu remplaces le JAR.

Une bibliothèque Java se trouve comme plugin dans le dossier plugins

Voici à quoi ressemble le message :

[DirectoryProviderSource] Error preparing plugin context: Directory 'plugins/asm-util-<Version>.jar' failed to update!

Ce qui se cache derrière : Une bibliothèque Java comme ASM ou Nashorn se trouve en tant que fichier distinct dans le dossier plugins. Les bibliothèques sont des briques que les plugins utilisent en interne, ce ne sont pas des plugins en elles-mêmes. Paper ne peut ni charger ce JAR comme plugin ni le mettre à jour, et l'ignore. Le serveur continue de tourner. De tels fichiers arrivent là par exemple lorsqu'une archive contenant plusieurs fichiers a été téléversée en entier.

Voici comment le corriger :

  1. Supprime le JAR de bibliothèque indiqué de plugins dans Fichiers.
  2. N'installe que le véritable plugin. Il apporte lui-même ses bibliothèques ou les télécharge au démarrage.
  3. Redémarre le serveur et vérifie la Console.
  4. Si un plugin signale ensuite qu'il lui manque quelque chose, lis son guide d'installation au lieu d'ajouter des bibliothèques à la main.

Bon à savoir : Si un plugin a vraiment besoin d'un second plugin, il l'indique explicitement. Pour savoir comment le repérer : Un plugin a besoin d'un autre plugin.

Le fichier de plugin est vide (« zip file is empty »)

Voici à quoi ressemble le message :

[DirectoryProviderSource] Error loading plugin: zip file is empty

Ce qui se cache derrière : Un fichier du dossier plugins fait 0 octet ou son téléversement a été interrompu. Paper ne peut pas l'ouvrir et l'ignore. Le plugin est absent, le serveur continue de tourner. Cela arrive souvent lorsque la connexion est coupée pendant le téléversement ou que le téléchargement était déjà incomplet sur ton ordinateur.

Voici comment le corriger :

  1. Dans Fichiers, ouvre le dossier plugins et cherche le fichier de 0 octet ou de taille anormalement petite.
  2. Supprime-le.
  3. Télécharge à nouveau le plugin depuis une source fiable et téléverse-le lorsque le serveur est arrêté. Attends que le téléversement soit entièrement terminé.
  4. Redémarre le serveur et vérifie dans la Console que le plugin se charge.

Bon à savoir : Pour des fichiers volumineux ou nombreux, SFTP est souvent plus fiable que le téléversement dans le navigateur, voir Modifier les fichiers du serveur dans le panel et se connecter via SFTP.

PlaceholderAPI : le fichier d'extension ne contient aucune classe d'extension chargeable

Voici à quoi ressemble le message :

[PlaceholderAPI] Failed to load expansion <File>.jar, as it does not have a class which extends PlaceholderExpansion

Ce qui se passe : Une extension PlaceholderAPI fournit des variables de texte supplémentaires. Le fichier JAR est analysé, mais la classe d'extension nécessaire est introuvable ou ne peut pas être chargée. Cette extension reste désactivée. Le serveur continue de fonctionner ; ses variables ne renvoient pas les valeurs prévues.

Voici comment corriger le problème :

  1. Dans la Console, lis les messages qui précèdent cette erreur. D'autres erreurs de chargement peuvent signaler une dépendance manquante.
  2. Dans Fichiers, vérifie que le fichier mentionné est bien l'extension PlaceholderAPI souhaitée. Fais-en une sauvegarde avant de le remplacer.
  3. Télécharge à nouveau, depuis sa source officielle, l'extension correspondant à la version de PlaceholderAPI installée. Remplace le fichier concerné et supprime les doublons de cette même extension.
  4. Redémarre complètement le serveur. Vérifie ensuite le message de démarrage et une variable fournie par l'extension.

Ton message n'y figure pas ?

Lis le message en entier dans la Console ou dans logs/latest.log, y compris les lignes avant et après. Tu trouves le nom du fichier de plugin dans le message lui-même ou dans la stacktrace, la liste de lignes at indentées : le JAR s'y trouve avant la double barre oblique, par exemple <Plugin>.jar//. Les noms de dossiers comme plugins/<Plugin>/ indiquent aussi quel plugin est concerné. Crée une sauvegarde avant de remplacer des fichiers. Si tu n'arrives pas à avancer, ouvre un ticket et indique l'heure du message.