Pourquoi votre plugin CounterStrikeSharp ne se charge pas
Une compilation réussie prouve seulement que le code est valide. Que le serveur charge ou non le plugin dépend du serveur lui-même : Metamod, la version de CounterStrikeSharp, l’endroit où vous avez copié les fichiers et ce dont le plugin a besoin pour fonctionner. Passez les vérifications ci-dessous dans l’ordre, car les premières sont les plus courantes.
Vérifiez que CounterStrikeSharp tourne
Avant d’accuser le plugin, assurez-vous que le framework est bien vivant. Tapez meta list dans la console du serveur. CounterStrikeSharp doit apparaître dans la liste. S’il manque, le problème vient de l’installation de Metamod ou de CounterStrikeSharp, pas de votre plugin. Notre guide d’installation de Metamod couvre cette partie.
meta list
Lisez l’erreur dans la console
Quand un plugin échoue, la console indique lequel et pourquoi. Une entrée <ERROR> dans la liste des plugins signifie que le fichier a été trouvé mais n’a pas pu être chargé. Copiez le message en entier, pas seulement la première ligne, car la vraie raison se trouve souvent quelques lignes plus bas.
[META] Failed to load plugin addons/counterstrikesharp/bin/linuxsteamrt64/counterstrikesharp
Listing 1 plugin:
[01] <ERROR>
Le serveur a été mis à jour et plus rien ne marche
Après une mise à jour de Counter-Strike 2, CounterStrikeSharp et Metamod doivent souvent être mis à jour eux aussi, car les fichiers du jeu auxquels ils se branchent ont changé. Si tous les plugins sont tombés en même temps, c’est la cause. Mettez CounterStrikeSharp et Metamod à la dernière version, puis redémarrez le serveur. Notre guide sur la mise à jour de CounterStrikeSharp montre la méthode sûre.
Regardez ce que le serveur pense avoir installé
Exécutez css_plugins list dans la console. La commande affiche chaque plugin trouvé par le framework, avec son état. Si votre plugin n’apparaît pas du tout, les fichiers sont au mauvais endroit ou le nom du dossier ne correspond pas à celui de la DLL. S’il apparaît avec une erreur, retournez à l’étape deux et lisez le message.
css_plugins list
Vérifiez l’arborescence
Chaque plugin a besoin de son propre dossier dans plugins, et la DLL principale doit porter exactement le même nom que ce dossier. Les fichiers à côté, comme deps.json, doivent rester avec la DLL.
Copiez uniquement le dossier du plugin, pas dependencies
Notre compilateur place deux éléments dans le zip : le dossier du plugin et un dossier dependencies. Ne copiez sur votre serveur que le dossier du plugin. Le dossier dependencies contient des fichiers que CounterStrikeSharp fournit déjà, et les copier peut provoquer des conflits de version.
Plugins avec des frameworks lourds ou une autre version de l’API
Un plugin écrit pour une ancienne CounterStrikeSharp.API peut compiler et pourtant échouer sur un serveur plus récent, ou l’inverse. Si la console mentionne une méthode ou un type introuvable, les versions de l’API ne correspondent pas. Notre guide sur l’incompatibilité de version explique quelle option de compilation choisir. Gardez aussi en tête que les gros frameworks comme ASP.NET ne sont pas pris en charge dans un plugin de serveur de jeu.
Quoi joindre quand vous demandez de l’aide
Si vous bloquez toujours, demandez à l’auteur du plugin ou à la communauté CounterStrikeSharp, en précisant : le résultat de meta list et de css_plugins list, l’erreur complète de la console, la version de CounterStrikeSharp et la façon dont vous avez compilé le plugin. Avec ces éléments, la plupart des problèmes se règlent en une seule réponse.
Ce tutoriel vous a-t-il été utile ?
Barlap pour la communauté.
