Le plugin exige une licence, un token ou un port : corriger les messages du log

Beaucoup de plugins ne fonctionnent pas de manière isolée. Les plugins premium vérifient une clé de licence au démarrage, les connexions à Discord, Telegram ou VK nécessitent un token (une sorte de mot de passe pour un bot ou une interface), les plugins de chat vocal ouvrent leur propre port réseau, et certains téléchargent des bibliothèques ou des bases de données depuis Internet. Si l'un de ces éléments manque ou est refusé, le plugin écrit un message dans le log. Le plus souvent, seule la fonction de ce plugin cesse de marcher ; dans un cas, le plugin arrête volontairement le serveur.

Chaque section ci-dessous traite d'un message. Tu trouves le message complet dans la Console ou sous Fichiers dans logs/latest.log, et la configuration des plugins dans plugins/<Plugin>/. Avant de modifier quoi que ce soit, crée une sauvegarde sous Sauvegardes. Les clés et les tokens sont secrets : ne les montre à personne et masque-les sur tes captures d'écran.

DonutShop refuse la clé de licence

Voici à quoi ressemble le message :

[DonutShop]             DONUTSHOP ERROR
[DonutShop] The licensing server rejected this key.

Ce qui se cache derrière : DonutShop est un plugin de boutique qui vérifie sa clé de licence auprès du serveur de licences de l'auteur au démarrage. Cette vérification a échoué lors du dernier démarrage. Même une valeur renseignée et non vide peut être invalide, expirée ou émise pour une autre installation. Le serveur Minecraft peut continuer à tourner, mais DonutShop n'est pas disponible de manière fiable : les joueurs ne peuvent pas compter sur la boutique.

Voici comment corriger le problème :

1. Obtiens ou vérifie la clé de licence gratuite via la page du projet DonutShop sur Modrinth officielle.
2. Dans Fichiers, ouvre la configuration de DonutShop (plugins/DonutShop/config.yml) et saisis la clé à l'entrée license-key. Mets-la entre guillemets, sans espace avant ni après.
3. Enregistre le fichier et redémarre le serveur.
4. Consulte la Console : l'erreur n'est corrigée que lorsque la bannière « DONUTSHOP ERROR » n'apparaît plus au nouveau démarrage.

Bon à savoir : si tu as repris la clé d'un autre serveur, procure-toi-en une propre à ce serveur.

LibreLogin arrête le serveur : impossible de charger une bibliothèque

Voici à quoi ressemble le message :

[LibreLogin] Failed to load libraries, stopping server to prevent damage
… Failed to download library <Library>

Ce qui se cache derrière : LibreLogin est un plugin d'authentification qui permet aux joueurs de se connecter avec un mot de passe. Au démarrage, il télécharge des bibliothèques, c'est-à-dire des composants qu'il n'embarque pas lui-même, dont PacketEvents. Si ce téléchargement échoue, LibreLogin arrête volontairement le serveur plutôt que de continuer à tourner à moitié fonctionnel. Le serveur ne démarre donc pas tant que le problème n'est pas résolu.

Voici comment corriger le problème :

1. Redémarre le serveur une fois. Si la source de téléchargement était simplement injoignable un court instant, cela fonctionne souvent à la tentative suivante.
2. Dans Plugins, mets à jour LibreLogin vers la dernière version pour ton logiciel de serveur. Si PacketEvents est installé chez toi comme plugin à part, mets-le aussi à jour.
3. Redémarre et vérifie dans la Console si les bibliothèques sont maintenant chargées.
4. Si le message apparaît à chaque démarrage, le serveur n'atteint pas l'adresse de téléchargement. Cela peut venir de l'accès à Internet, de la résolution de noms (DNS, qui traduit les adresses en numéros IP) ou de l'adresse elle-même. Si tu n'avances pas, ouvre un ticket et indique l'heure du message.

Bon à savoir : pour savoir comment mettre à jour et remplacer des plugins, consulte Installer et gérer des plugins Minecraft.

Simple Voice Chat abandonne des paquets vocaux

Voici à quoi ressemble le message :

[voicechat] Packet queue has <Count> packets
[voicechat] Dropping voice chat packets!

Ce qui se cache derrière : Simple Voice Chat transmet la voix entre les joueurs qui sont proches en jeu. Le message signifie que le chat vocal n'arrive pas à suivre le traitement : les paquets vocaux s'accumulent dans une file d'attente ou sont abandonnés. La cause est un serveur actuellement surchargé, avec des TPS bas (ticks par seconde, la cadence de Minecraft ; la normale est de 20) ou une charge CPU élevée. Les joueurs entendent alors une voix hachée ou absente. Le serveur lui-même continue de tourner.

Voici comment corriger le problème :

1. Trouve ce qui génère la charge, par exemple avec spark : spark : trouver et comprendre le lag sur le serveur Minecraft.
2. Réduis la distance d'affichage (view-distance) et la distance de simulation (simulation-distance) dans les Paramètres ou dans server.properties. Ainsi, le serveur charge moins de chunks, c'est-à-dire de sections de monde de 16 × 16 blocs.
3. Réduis le nombre d'entités (créatures, animaux, objets au sol) à certains endroits et vérifie les plugins qui génèrent beaucoup de charge.
4. Si cela ne suffit pas, passe à plus de puissance dans Paramètres et abonnement → Plan.

Bon à savoir : quelques messages isolés juste après le démarrage ou lors de l'exploration de nouvelles zones sont sans danger, tant qu'ils cessent ensuite.

Simple Voice Chat n'obtient pas son port UDP

Voici à quoi ressemble le message :

[voicechat] Failed to run voice chat at UDP port <Port>
[voicechat] Disabling Simple Voice Chat

Ce qui se cache derrière : Simple Voice Chat transmet la voix via un port UDP dédié. UDP est le protocole réseau pour les données rapides en temps réel comme la voix. Le port configuré n'appartient pas à ton serveur ou est déjà occupé, par exemple parce que la valeur par défaut du guide du plugin est encore renseignée. Sans port, le chat vocal se désactive ; le jeu lui-même continue de fonctionner normalement.

Voici comment corriger le problème :

1. Dans Fichiers, ouvre le fichier plugins/voicechat/voicechat-server.properties. Si Simple Voice Chat tourne chez toi en tant que mod, il se trouve dans config/voicechat/voicechat-server.properties.
2. Règle port sur le numéro de port de ton serveur. Ton port de jeu est ouvert pour TCP et UDP.
3. Enregistre le fichier et redémarre le serveur.
4. Vérifie dans la Console que le message n'apparaît plus, et teste le chat vocal en jeu.

En détail : Configurer Simple Voice Chat sur le serveur Minecraft.

Bon à savoir : un port UDP ne peut être ouvert que par un seul programme à la fois. Si un autre plugin utilise déjà le même port, par exemple Geyser pour les joueurs Bedrock, l'un des deux a besoin d'un autre port attribué à ton serveur.

Le plugin Discord n'a pas de jeton de bot valide

Voici à quoi ressemble le message :

[DiscordSRV] No bot token has been set in the config; a bot token is required to connect to Discord.
[DiscordSRV] The bot token is invalid
[EssentialsDiscord] An error occurred while logging into Discord

Ce qui se cache derrière : Les plugins Discord comme DiscordSRV ou EssentialsX Discord se connectent à Discord avec leur propre bot. Pour cela, ils ont besoin du jeton du bot, une longue chaîne de caractères qui ressemble à un mot de passe. Dans la configuration, il n'y en a pas, ou Discord refuse celui qui est saisi, par exemple parce qu'il a entre-temps été réinitialisé. La liaison avec Discord reste alors désactivée, le serveur Minecraft continue de tourner normalement.

Voici comment corriger le problème :

1. Dans le Discord Developer Portal, crée une application avec un bot ou choisis ton bot existant. Dans la section « Bot », copie le jeton ou génères-en un nouveau.
2. Dans Fichiers, ouvre le config.yml du plugin, par exemple plugins/DiscordSRV/config.yml, et saisis le jeton (pour DiscordSRV, dans le champ BotToken).
3. Invite le bot sur ton serveur Discord si ce n'est pas encore fait.
4. Enregistre le fichier et redémarre le serveur.

Bon à savoir : si « could not connect to Discord because: » est suivi d'une indication sur les intents, active dans le Developer Portal les « Privileged Gateway Intents » demandés pour le bot. Si un jeton est devenu public, réinitialise-le là-bas et saisis le nouveau.

Le plugin ne peut pas télécharger la base de données des pays

Voici à quoi ressemble le message :

[AuthMe] Could not download GeoLiteAPI database [FileNotFoundException]: plugins/AuthMe/GeoLite2-Country.mmdb (No such file or directory)

Ce qui se cache derrière : Certains plugins, comme AuthMe, associent les adresses IP à un pays. Pour cela, ils téléchargent une base de données des pays, le plus souvent GeoLite2 du fournisseur MaxMind. Ce téléchargement a échoué. Le plugin continue de fonctionner ; seules les fonctions dépendant du pays, comme les blocages par pays, restent inactives tant que la base de données manque.

Voici comment corriger le problème :

1. Il s'agit généralement d'un problème temporaire du côté distant. Le prochain redémarrage retente le téléchargement ; tu n'as rien à faire tout de suite.
2. Si le message persiste sur plusieurs démarrages, consulte la configuration du plugin dans plugins/<Plugin>/. Souvent, le plugin a besoin de sa propre clé de licence pour le téléchargement, et la configuration indique le champ prévu à cet effet.
3. Saisis la clé, enregistre et redémarre le serveur.

Bon à savoir : si tu n'utilises aucune fonction dépendant du pays, tu peux ignorer le message. La connexion et toutes les autres fonctions du plugin fonctionnent malgré tout.

DonutShop est verrouillé sans clé de licence

Voici à quoi ressemble le message :

[DonutShop]             DONUTSHOP LOCKED
[DonutShop] No license key is set in config.yml.
[DonutShop] Then run: /link <your-key>

Ce que cela signifie : DonutShop ne démarre qu'avec une clé de licence. Aucune n'est renseignée dans son fichier config.yml, c'est pourquoi la boutique reste verrouillée. La clé est gratuite, mais tu dois la récupérer une fois auprès de l'auteur. Le serveur Minecraft lui-même n'est pas affecté.

Comment résoudre le problème :

1. Récupère la clé gratuite auprès de l'auteur du plugin. Le moyen d'y accéder, un lien Discord, est indiqué dans les lignes autour de la bannière du message.
2. Exécute /link <ta-clé> comme l'indique le message, ou saisis la clé dans plugins/DonutShop/config.yml.
3. Redémarre le serveur.
4. Vérifie dans la Console que la bannière « DONUTSHOP LOCKED » a disparu.

Bon à savoir : Si « DONUTSHOP ERROR » apparaît ensuite, la clé a été refusée. Dans ce cas, la section sur la licence DonutShop refusée t'aidera.

Le jeton VK du plugin est refusé

Voici à quoi ressemble le message :

com.vk.api.sdk.exceptions.ApiAuthException: User authorization failed (5): User authorization failed: invalid access_token (4).

Ce que cela signifie : Certains plugins se connectent à VK, le réseau social VKontakte. Pour cela, ils ont besoin d'un jeton d'accès, une sorte de mot de passe pour l'interface. VK a refusé le jeton renseigné (« invalid access_token ») : il est donc invalide, expiré ou révoqué. Les fonctions VK du plugin sont désactivées, le reste du serveur fonctionne normalement.

Comment résoudre le problème :

1. Génère chez VK un nouveau jeton d'accès avec les droits exigés par le plugin. Ils sont indiqués dans la documentation du plugin.
2. Dans Fichiers, ouvre la configuration du plugin dans plugins/<Plugin>/ et remplace l'ancien jeton par le nouveau.
3. Enregistre le fichier et redémarre le serveur.
4. Vérifie dans la Console que le message n'apparaît plus.

Bon à savoir : Le plugin concerné est indiqué par la stacktrace en dessous, c'est-à-dire les lignes indentées avec at …. À côté de com.vk.api, tu y verras le nom de package du plugin.

Le plugin ne parvient pas à fournir son pack de ressources

Voici à quoi ressemble le message :

java.io.IOException: HTTP 403 dla http://<Address>/<Pack>.zip
Failed to start resourcepack server: Server is not publicly reachable on <Address>:<Port>

Ce que cela signifie : Certains plugins distribuent un pack de ressources personnalisé aux joueurs. Pour cela, ils le téléchargent depuis une adresse, le construisent eux-mêmes ou démarrent un petit serveur web intégré depuis lequel les joueurs le récupèrent. L'une de ces étapes a échoué. Les joueurs ne reçoivent alors pas le pack, et les textures ou fonctions qui en dépendent sont absentes. Le serveur continue de fonctionner.

Comment résoudre le problème :

1. Lis le statut HTTP dans le message : 403 signifie accès refusé, 404 signifie fichier introuvable.
2. Ouvre dans le navigateur l'adresse du pack indiquée dans la configuration du plugin. Elle doit télécharger directement le fichier ZIP et ne doit pas afficher de page d'aperçu ou de connexion.
3. Corrige l'adresse ou téléverse le pack à un endroit qui le distribue publiquement.
4. Si le plugin utilise un serveur web intégré, indique uniquement un port attribué à ton serveur dans le panel et accessible publiquement.
5. Redémarre le serveur.

Le plugin a besoin d'une clé API pour un service tiers

Voici à quoi ressemble le message :

Please set your <Service> API key
Get your API key from: https://<Provider>/…
accessToken=MISSING

Ce que cela signifie : Le plugin fonctionne avec un service tiers, par exemple pour des statistiques ou une liaison avec un site web. Pour cela, il a besoin d'une clé API ou d'identifiants. Une clé API est un identifiant avec lequel le plugin s'authentifie auprès du service. Elle est absente de la configuration. Tant qu'elle n'est pas renseignée, le plugin ne fonctionne pas ; le reste du serveur continue de tourner.

Comment résoudre le problème :

1. Lis le message : il indique généralement le service, le fichier et le champ, et souvent aussi l'adresse où obtenir la clé (« Get your API key from: »).
2. Crée un compte chez le service et génères-y la clé.
3. Dans Fichiers, ouvre le fichier indiqué dans plugins/<Plugin>/ et saisis la clé. Le fichier est généralement au format YAML, où l'indentation avec des espaces détermine la structure ; ne la modifie pas et mets la valeur entre guillemets.
4. Enregistre le fichier et redémarre le serveur.

Bon à savoir : Si le plugin signale ensuite qu'il ne peut pas lire le fichier, Le fichier de configuration d'un plugin est défectueux t'aidera.

Le plugin premium ne trouve aucune clé de licence valide

Voici à quoi ressemble le message :

No License Key Found!
Please enter a valid key in license.yml
Authentication failed! API key is invalid

Ce que cela signifie : Le plugin est un plugin premium ou nécessite une clé de l'éditeur, et n'en trouve aucune de valide dans sa configuration. Il se désactive alors entièrement ou coupe certaines fonctions. Le serveur continue de tourner, simplement sans les fonctions de ce plugin.

Comment résoudre le problème :

1. Retrouve la clé de ton achat, par exemple dans ton compte sur le site où tu as acheté le plugin, ou demande-la à l'éditeur.
2. Dans Fichiers, ouvre le fichier indiqué par le message, généralement plugins/<Plugin>/license.yml ou plugins/<Plugin>/config.yml, et saisis la clé.
3. Enregistre le fichier et redémarre le serveur.
4. Si tu n'as pas de clé, supprime le plugin dans Plugins plutôt que de le laisser tourner en permanence avec des erreurs.

Bon à savoir : Ne télécharge les plugins premium que depuis le site de vente officiel. Les versions provenant de sources non officielles, dont la vérification de licence a été supprimée, contiennent assez souvent des logiciels malveillants.

Le bot Telegram du plugin ne démarre pas

Voici à quoi ressemble le message :

Error removing old webhook

Ce que cela signifie : Un plugin doté d'une liaison Telegram se connecte à Telegram avec un bot au démarrage. Il commence alors par supprimer un ancien webhook, c'est-à-dire une adresse enregistrée à laquelle Telegram enverrait les nouveaux messages. Cette étape a échoué, le plus souvent parce que le jeton du bot est invalide ou que Telegram était momentanément inaccessible. La fonction Telegram reste désactivée, le serveur Minecraft continue de fonctionner normalement.

Comment résoudre le problème :

1. Ouvre dans Telegram la discussion avec @BotFather et fais-toi afficher le jeton de ton bot ou génères-en un nouveau.
2. Dans Fichiers, ouvre la configuration du plugin dans plugins/<Plugin>/ et remplace le jeton. Copie-le en entier : un jeton de bot commence par un nombre suivi de deux-points.
3. Enregistre le fichier et redémarre le serveur.
4. Vérifie dans la Console que le message n'apparaît plus.

Bon à savoir : Si le message n'apparaît qu'une seule fois et plus au démarrage suivant, Telegram était brièvement inaccessible. Dans ce cas, tu n'as rien à modifier.

Le plugin n'obtient pas de port réseau dédié

Voici à quoi ressemble le message :

Failed to bind to /<Address>:<Port>
[PlasmoVoice] Failed to start the udp server

Ce qui se passe : Certains plugins ouvrent leur propre port réseau, par exemple pour un chat vocal comme Plasmo Voice ou pour un site web avec carte ou statistiques. L'adresse ou le port configuré n'est pas disponible sur ton serveur : le port ne lui est pas attribué, il est déjà utilisé, ou la configuration contient une adresse IP fixe que le serveur ne peut pas utiliser telle quelle. La fonction du plugin reste désactivée, le reste du serveur continue de tourner.

Comment le résoudre :

1. Dans Fichiers, ouvre la configuration du plugin sous plugins/<Plugin>/ et cherche les entrées pour le port et l'adresse.
2. Indique un port qui est attribué à ton serveur dans le panel et qui est encore libre.
3. Laisse l'adresse vide ou mets 0.0.0.0. Cela signifie : accessible sur toutes les interfaces réseau du serveur.
4. Enregistre le fichier, redémarre le serveur et vérifie dans la Console que le message n'apparaît plus.

Bon à savoir : Un port ne peut être ouvert que par un seul programme à la fois. Si deux plugins utilisent le même, chacun a besoin de son propre port. Plus d'informations sur les ports : Vérifier les ports Minecraft et les erreurs de connexion.

Un plugin ou un service annexe n'obtient pas son port

Voici à quoi ressemble le message :

[<Plugin>] Failed to start HTTP server: Address already in use
java.net.BindException: Address already in use

Ce qui se cache derrière : Un plugin ou un service annexe, comme le chat vocal, un site web dédié, Query ou RCON, veut ouvrir son propre port, mais celui-ci est déjà occupé. Souvent, sa configuration contient le port du jeu, que le serveur a déjà ouvert lui-même au démarrage. Le serveur continue de fonctionner normalement et les joueurs peuvent le rejoindre, seule cette fonction reste désactivée.

Voici comment le résoudre :

1. Dans la Console, lis le nom entre crochets avant le message, par exemple [<Plugin>]. Dans Santé du serveur, il figure sous « Plugin ou service concerné ».
2. Ouvre dans Fichiers la configuration située dans plugins/<Plugin>/ et cherche l'entrée du port. Pour Query et RCON, il s'agit de query.port et rcon.port dans le fichier server.properties.
3. Indique un port qui n'est pas le port du jeu et qu'aucun autre plugin n'utilise. L'onglet Ports affiche tous les ports de ton serveur.
4. Pour Simple Voice Chat et d'autres plugins connus, les assistants sous Plugins configurent automatiquement un port libre.
5. Enregistre le fichier, redémarre le serveur et vérifie dans la Console que le message n'apparaît plus.

Bon à savoir : Un simple redémarrage ne suffit pas tant que la configuration contient le même port. Plus d'informations sur les ports : Vérifier les ports Minecraft et les erreurs de connexion.

Ton message n'est pas dans la liste ?

Lis le message en entier dans la Console ou dans logs/latest.log, y compris les lignes qui le précèdent. Le nom entre crochets au début de la ligne, par exemple [DiscordSRV], indique généralement le plugin. S'il manque, la stacktrace peut t'aider : dans les lignes en retrait avec at …, on trouve des noms de paquets et de dossiers qui renvoient au plugin ou au mod. La page du projet d'un plugin explique quelles clés, quels tokens ou quels ports il requiert. Avant de modifier la configuration, crée une sauvegarde. Si tu es bloqué, ouvre un ticket et indique l'heure du message.