Plugins sur les serveurs Minecraft ; Il gère le système d'autorisation, l'économie, la protection, le marché, l'événement, la réclamation, l'anti-triche et de nombreux systèmes spéciaux. Si l'un des plugins n'est pas installé, une partie importante du serveur risque de ne pas fonctionner.

Les erreurs de plugin se produisent généralement dans la console ou logs/dernier.log apparaît dans le fichier. Les erreurs les plus courantes ; Impossible de charger le plugin, Version d'API non prise en charge, dépendance inconnue, Plugin.yml invalide et incompatibilités de version Java.

1. Où pouvez-vous voir l’erreur du plugin ?

Si le plugin ne se charge pas, le premier endroit à consulter est la console du serveur et le fichier last.log.

tail -n 200 logs/latest.log

Pour le suivi en direct :

tail -f logs/latest.log

Pour rechercher par nom de plugin :

grep -i "pluginadi" logs/latest.log

2. Erreur de version d'API non prise en charge

Cette erreur indique que la version de l'API Minecraft prise en charge par le plugin est incompatible avec la version du serveur.

Unsupported API version 1.20

Par exemple, le plugin peut être préparé pour la version 1.20, mais votre serveur peut exécuter la version 1.16.5. Dans ce cas, le plugin peut ne pas être chargé ou fonctionner incorrectement.

Solution :

• Vérifiez la version de Minecraft prise en charge par le plugin.
• Téléchargez la version du plugin compatible avec la version de votre serveur.
• Ne vous attendez pas à ce que les nouveaux plugins fonctionnent sur de très anciens serveurs.
• Si nécessaire, recherchez la version appropriée dans l’archive de l’ancienne version du plugin.

3. Erreur de dépendance inconnue

Certains plugins ne fonctionnent pas seuls. Il demande qu’un autre plugin soit installé en premier. C'est ce qu'on appelle la dépendance.

Unknown dependency Vault
Could not load plugin because dependency LuckPerms was not found

Par exemple, les plugins économiques sont souvent Coffre-fort veut. Les plugins d'autorisation ou de marché peuvent également nécessiter d'autres plugins de bibliothèque.

Solution :

• Lisez les exigences sur la page du plugin.
• Téléchargez le plugin de dépendance manquant.
• Assurez-vous que le plugin de dépendance est également compatible avec la version de votre serveur.
• Redémarrez complètement le serveur.

4. Erreur plugin.yml invalide

Dans le fichier jar du plugin plugin.yml Si le fichier est corrompu, manquant ou incorrect, le plugin ne peut pas être installé.

Invalid plugin.yml
Plugin does not contain a plugin.yml

Cela se produit généralement lorsque :

• Le mauvais fichier a été téléchargé.
• Au lieu du plugin, le zip du code source a été placé dans le dossier plugins.
• Le fichier Jar est corrompu.
• Le plugin a été mal emballé par le développeur.

Comme solution, le plugin est correct. .jar Le fichier doit être téléchargé. Le source-code.zip téléchargé depuis GitHub ne doit pas être placé directement dans le dossier plugins.

5. Incompatibilité des versions Java

La version et les plugins de Minecraft nécessitent des versions Java spécifiques. Si une mauvaise version de Java est utilisée, le plugin ou le serveur risque de ne pas s'ouvrir du tout.

java -version

Erreur courante :

UnsupportedClassVersionError

Cette erreur indique que le plugin a été compilé avec un Java plus récent, mais qu'un Java plus ancien est utilisé sur le serveur.

Logique générale :

• Les anciennes versions de Minecraft nécessitent souvent une ancienne version de Java.
• Les versions plus récentes de Minecraft nécessitent un Java plus récent.
• L'exigence Java dans la description du plugin doit être vérifiée.
• La version Java sélectionnée dans le panneau d'hébergement doit être vérifiée.

6. Le fichier du plugin se trouve-t-il dans le bon dossier ?

Fichiers plugin sur les serveurs Bukkit, Spigot et Paper plugins est jeté dans le dossier.

ls plugins/

Le fichier du plugin devrait ressembler à ceci :

plugins/PluginAdi.jar

Les plugins laissés dans zip, rar, code source ou dossiers ne fonctionnent souvent pas.

7. Conflits de plugins

Deux plugins qui font le même travail peuvent entrer en conflit. Par exemple, deux plugins de chat différents, deux plugins d'économie différents ou deux systèmes de réclamation différents peuvent tenter de gérer les mêmes événements.

Symptômes de conflit :

• Le plugin est installé mais ses commandes ne fonctionnent pas.
• Un plugin submerge les paramètres d'un autre.
• Un conflit d'événements ou une exception se produit dans la console.
• Les joueurs ne peuvent pas utiliser de commandes même s'ils en ont la permission.
• Le serveur se comporte différemment après le redémarrage.

Pour trouver une solution, les plugins peuvent être testés en les désactivant un par un. Cependant, avant de faire cela sur le serveur live, une sauvegarde doit être effectuée et les faibles heures de joueur sont à privilégier.

8. Une erreur de configuration peut empêcher l'ouverture du plugin

Certains plugins ne s'ouvriront pas s'il y a une erreur YAML dans le fichier de configuration. Les indentations d’espaces sont particulièrement importantes dans les fichiers YAML.

Erreurs courantes :

• Utilisation du caractère de tabulation
• Ne laissez pas d'espace après le côlon
• Écrire un texte qui nécessite des guillemets sans guillemets
• Corruption de fichier due à un caractère turc ou à un symbole spécial
• Sauvegarde du fichier de configuration manquant

S'il existe un fichier de configuration incorrect, le dossier du plugin peut être temporairement renommé pour sauvegarder le dossier du plugin et recréer la configuration.

Erreurs courantes

• Installation de plugins non compatibles avec la version du serveur
• Ne pas installer les plugins de dépendances manquants
• Confondre le fichier zip source GitHub avec un plugin
• Ne pas vérifier la version Java
• Essayer d'installer un plugin avec /reload
• Utiliser les onglets dans les fichiers de configuration YAML

FAQ

Le plugin est dans le dossier plugins mais il ne fonctionne pas, pourquoi ?
Il peut s'agir d'une incompatibilité de version, d'une dépendance manquante, d'une incompatibilité Java ou d'une erreur de configuration. Le fichier last.log doit être examiné.

Que signifie UnsupportedClassVersionError ?
Le plugin vient d'être compilé avec Java. La version Java utilisée sur le serveur est obsolète.

Est-il sécuritaire d’utiliser /reload ?
Ce n’est pas recommandé pour de nombreux plugins. Un redémarrage complet est plus sûr pour l’installation, la suppression et les modifications majeures de la configuration du plugin.

Recommandations en matière de sécurité et d'exploitation

• Téléchargez des plugins à partir de sources fiables.
• Avant d'ajouter le plugin au serveur live, essayez-le sur le serveur de test.
• Sauvegardez le dossier des plugins avant chaque mise à jour du plugin.
• Réduisez la surface d’attaque en supprimant les plugins inutiles.
• Vérifiez régulièrement les journaux du plugin.

Cet article est spécialement préparé pour PvPServer.