Aller au contenu
+90 850 303 07 52 [email protected]
Assistance Espace client
Sur une sélection d'offres d'hébergement annuelles et de VDS sur 3 mois, nom de domaine .com / .com.tr offert la première année · Voir les offres

Guides

Des guides pas à pas pour installer et gérer votre propre serveur, serveur de jeu ou site web, rédigés par l'équipe qui exploite notre infrastructure à Istanbul.

Counter-Strike 2

Comment installer un plugin sur un serveur CS2 ? CS# et Metamod

26 août 2026 17 min de lecture Mis à jour :
Partager cet article

En installant des plugins sur votre serveur Counter-Strike 2 (CS2), vous pouvez ajouter des fonctions comme un menu d'administration, un système VIP, des statistiques ou de nouveaux modes de jeu. Ce guide couvre deux types : les plugins pour CounterStrikeSharp (CS#), écrits en C# et distribués sous forme de fichiers .dll, et les plugins natifs chargés directement par Metamod:Source. Vous verrez pas à pas, pour Windows et Linux, comment placer les uns et les autres dans le bon dossier, les charger et les décharger depuis la console, modifier leurs fichiers de configuration et réparer les plugins qui ne fonctionnent plus après une mise à jour de CS2. Pour les autres sujets, consultez la page Guides Counter-Strike 2.

Avant de commencer

  • Metamod:Source et CounterStrikeSharp doivent être installés : ce guide suppose que les deux frameworks sont installés et fonctionnent ; leur installation n'est pas répétée ici. Si ce n'est pas encore fait, suivez d'abord le guide d'installation de Metamod et CounterStrikeSharp. Lorsque vous tapez meta list dans la console du serveur et que CounterStrikeSharp apparaît dans la liste, vous êtes prêt.
  • Dossiers : les exemples utilisent les chemins du guide d'installation d'un serveur CS2 : C:\cs2-ds sous Windows ; sous Linux, l'utilisateur steam et son dossier /home/steam/cs2-ds. Lorsque le texte indique simplement game/csgo, il s'agit du dossier game/csgo situé dans ces dossiers.
  • Accès à la console : sous Windows, vous taperez les commandes dans la fenêtre du serveur ; sous Linux, dans la session que vous rejoignez avec tmux attach -t cs2. Pour gérer le serveur à distance, consultez le guide RCON pour CS2.
  • Votre version de CS# : tapez css dans la console ; vous verrez une ligne de la forme Current API Version: v378 (...). Ce nombre correspond à la dernière partie de l'étiquette de version de CS# (378 pour v1.0.378). Si la version minimale de l'API que le développeur a indiquée dans le code du plugin avec MinimumApiVersion est supérieure à ce nombre, le plugin ne se charge pas.
  • Sauvegarde : sauvegardez les dossiers addons/counterstrikesharp/plugins et addons/counterstrikesharp/configs. Les services VDS n'incluent pas de sauvegarde automatique ; la sauvegarde relève de votre responsabilité.

Si vous n'avez pas encore de serveur, vous trouverez les offres sur la page Location de serveur Counter-Strike 2.

1. Téléchargez le plugin depuis une source fiable

Les plugins CS# (bibliothèques .NET) comme les plugins Metamod s'exécutent dans le même processus que le serveur de jeu, avec les droits de l'utilisateur qui exécute le serveur. Le plugin peut donc accéder à tous les fichiers et au réseau auxquels cet utilisateur a accès ; un seul fichier .dll ou .so modifié suffit à compromettre votre serveur. Lors du téléchargement, respectez ces règles :

  • Téléchargez le plugin dans la section Releases (versions publiées) du dépôt GitHub du développeur. N'installez pas de fichiers .dll repartagés sur des forums, des serveurs Discord ou des sites de partage de fichiers, et en particulier pas de copies « crackées » de plugins payants.
  • Vérifiez que le dépôt contient le code source, à quand remonte la dernière version et quels rapports de bug (issues) sont ouverts. Les plugins qui ne sont plus mis à jour depuis longtemps peuvent ne pas fonctionner avec les nouvelles versions de CS2.
  • Sous Linux, n'exécutez pas le serveur en root, mais avec l'utilisateur steam, comme dans le guide d'installation ; ainsi, les dégâts qu'un plugin peut causer restent limités aux fichiers de cet utilisateur.
  • Des fonctions contraires aux règles de Valve pour les serveurs peuvent entraîner le bannissement de vos jetons GSLT ; les détails figurent dans le guide GSLT pour CS2.

Avant l'installation, lisez le fichier README (description) du plugin et notez quatre informations : la version minimale de CS# requise, les dépendances (autres plugins ou bibliothèques dont le plugin a besoin pour fonctionner), le dossier dans lequel extraire l'archive et l'emplacement du fichier de configuration. Les plugins basés sur Metamod proposent des paquets distincts pour Windows et Linux ; téléchargez celui qui correspond à votre système d'exploitation.

2. Placez les fichiers dans le bon dossier

Les plugins CS# se trouvent dans le dossier game/csgo/addons/counterstrikesharp/plugins. Chaque plugin a son propre dossier, dont le nom doit être identique à celui du fichier .dll principal qu'il contient ; au démarrage, CS# cherche dans chaque dossier le fichier .dll qui porte le nom de ce dossier. Déposé directement dans le dossier plugins, un .dll n'est pas chargé. D'après l'exemple de la documentation CS# et le code source, la structure attendue est la suivante :

game/csgo/addons/counterstrikesharp
├── plugins
│   ├── disabled
│   └── MonPlugin
│       ├── MonPlugin.dll
│       ├── MonPlugin.deps.json
│       └── (autres fichiers .dll utilisés par le plugin)
├── shared
│   └── MonApi
│       └── MonApi.dll
└── configs
    └── plugins
        └── MonPlugin
            └── MonPlugin.json

Les fichiers .dll des paquets NuGet utilisés par le plugin se placent dans le dossier du plugin, à côté du fichier principal. Les bibliothèques d'API partagées (shared API), écrites pour être utilisées par d'autres plugins, se placent quant à elles, selon la documentation CS#, avec la même organisation, sous la forme shared/MonApi/MonApi.dll, dans le dossier shared. Si le README indique en plus un plugin à installer, ajoutez-le lui aussi, avec son propre dossier, sous plugins.

Les développeurs empaquettent leurs archives avec des racines différentes. Si le README indique dans quel dossier extraire l'archive, suivez-le ; sinon, extrayez l'archive dans un dossier temporaire et regardez le dossier de plus haut niveau :

En haut de l'archiveOù le copier
Dossier addonsgame/csgo
Dossier plugins (et, le cas échéant, configs, shared)game/csgo/addons/counterstrikesharp
Dossier propre au plugin (p. ex. MonPlugin)game/csgo/addons/counterstrikesharp/plugins
Uniquement des fichiers .dll et .jsonUn nouveau dossier sous plugins, portant le même nom que le .dll principal

Si vous mettez à jour un plugin et que l'archive contient un dossier configs, sauvegardez votre fichier de configuration actuel avant de copier ; sinon, les réglages que vous avez modifiés risquent d'être écrasés.

Windows

  1. Connectez-vous au serveur en RDP et téléchargez le fichier .zip du plugin depuis la page Releases.
  2. Faites un clic droit sur le fichier, choisissez « Extract All » (Extraire tout) pour l'extraire dans un dossier temporaire, puis regardez le dossier de plus haut niveau.
  3. Copiez le dossier à l'emplacement indiqué dans le tableau. Par exemple, si vous obtenez le dossier propre au plugin, collez-le dans C:\cs2-ds\game\csgo\addons\counterstrikesharp\plugins\.

Linux

Exécutez les commandes avec l'utilisateur steam. Pour obtenir l'adresse de téléchargement, copiez le lien du fichier sur la page Releases ; remplacez les parties en majuscules de l'exemple par vos propres valeurs :

sudo -iu steam
curl -sLO "https://github.com/AUTEUR/DEPOT/releases/download/VERSION/FICHIER.zip"
mkdir -p ~/plugin/FICHIER
unzip -o FICHIER.zip -d ~/plugin/FICHIER
find ~/plugin/FICHIER -maxdepth 3

Regardez la sortie de find et copiez à l'emplacement indiqué dans le tableau. Par exemple, si l'archive contient addons à son plus haut niveau :

cp -r ~/plugin/FICHIER/addons ~/cs2-ds/game/csgo/

Linux distingue majuscules et minuscules : monplugin/MonPlugin.dll n'est pas chargé ; le nom du dossier doit être identique au nom du fichier, lettre pour lettre. Si vous avez copié les fichiers en root ou si vous les avez envoyés par SFTP avec le compte root, corrigez le propriétaire :

sudo chown -R steam:steam /home/steam/cs2-ds/game/csgo/addons

3. Chargez le plugin et vérifiez qu'il fonctionne

Au démarrage, CS# charge automatiquement les plugins situés sous plugins (lorsque, dans core.json, PluginAutoLoadEnabled est activé ; c'est la valeur par défaut). En revanche, un nouveau plugin ajouté pendant que le serveur tourne n'est pas chargé automatiquement ; redémarrez le serveur ou tapez ceci dans la console :

css_plugins load MonPlugin
css_plugins list

Vous pouvez passer à la commande load le nom du dossier ou un chemin comme plugins/MonPlugin/MonPlugin.dll. Si le plugin ne peut pas être chargé, le message Could not load plugin apparaît dans la console. La sortie de list contient une ligne par plugin :

  List of all plugins currently loaded by CounterStrikeSharp: 1 plugins loaded.
  [#1:LOADED]: "Mon Plugin" (1.0.0) by Auteur

Le nombre entre crochets est le numéro d'identification (ID) du plugin, le mot après les deux-points est son état. Le nom entre guillemets est le nom du plugin que le développeur a écrit dans le code ; il peut différer du nom du dossier. Pour recharger ou arrêter le plugin, utilisez le numéro :

css_plugins reload 1
css_plugins unload 1

Bien que l'exemple du texte d'aide de la commande reload indique #1, le code source actuel de CS# compare la valeur saisie au numéro du plugin sans retirer le signe # ; saisissez donc uniquement le nombre. À la place du numéro, vous pouvez aussi saisir le nom entre guillemets (p. ex. css_plugins reload "Mon Plugin") ; le nom est sensible à la casse.

Lorsque PluginHotReloadEnabled est activé (par défaut) et que vous remplacez le fichier .dll d'un plugin par une nouvelle version, CS# recharge automatiquement le plugin ; c'est ce qu'on appelle le rechargement à chaud (hot reload). Un plugin arrêté avec unload est en revanche rechargé depuis son dossier au redémarrage du serveur. Pour désactiver durablement un plugin sans le supprimer, déplacez son dossier dans le dossier plugins/disabled (fourni avec le paquet CS# ; créez-le s'il n'existe pas) ; CS# ne parcourt pas ce dossier.

4. Modifiez les réglages du plugin

Les plugins qui utilisent le système de configuration de CS# enregistrent leurs réglages dans le fichier addons/counterstrikesharp/configs/plugins/MonPlugin/MonPlugin.json ; le nom du dossier et du fichier correspond au nom du dossier du plugin sous plugins. D'après le code source de CS#, le fichier est créé au premier chargement : si MonPlugin.example.json existe dans le même dossier, il est copié ; sinon, un nouveau fichier est écrit avec les valeurs par défaut du plugin. Si un fichier de même nom avec l'extension .toml existe, c'est lui qui est lu en premier. Chargez donc d'abord le plugin une fois, puis modifiez le fichier créé.

Ouvrez le fichier avec « Notepad » sous Windows, avec nano sous Linux. Le contenu varie selon le plugin ; les clés ci-dessous ne sont que des exemples :

{
  "ConfigVersion": 1,
  "ChatPrefix": "[MonServeur]",
  "EnableFeature": true
}
  • La clé ConfigVersion est présente dans les plugins qui utilisent le système de configuration de CS#. D'après le code source de CS#, le noyau ne vérifie pas cette valeur ; elle sert au contrôle propre du plugin. Ne la modifiez pas, sauf indication contraire du README.
  • Respectez les règles JSON : les clés et les valeurs texte s'écrivent entre guillemets doubles, et aucune virgule ne suit le dernier élément. La ligne de commentaire commençant par // en tête du fichier créé par CS# est normale ; CS# ignore les lignes de commentaire.
  • Modifiez le vrai fichier, pas le fichier d'exemple (.example.json). Sous Windows, assurez-vous que « Notepad » n'enregistre pas le fichier avec l'extension .json.txt.

Après l'enregistrement, rechargez le plugin avec css_plugins reload et son numéro d'ID ; le fichier de configuration est lu au chargement du plugin. Certains plugins proposent leur propre commande de rechargement, d'autres conservent leurs réglages dans game/csgo/cfg, sous forme de fichiers .cfg ; référez-vous au README sur ce point.

5. Installez les plugins basés sur Metamod

Certains plugins, comme CS2Fixes ou MovementUnlocker, n'utilisent pas CS# ; ce sont des plugins C++ chargés directement par Metamod:Source. Ils ne se placent pas dans le dossier plugins de CS#. Les README de ces deux projets demandent d'extraire le paquet adapté à votre système d'exploitation dans le dossier game/csgo.

Metamod parcourt le dossier addons/metamod, lit ses fichiers .vdf et charge les plugins qu'ils indiquent ; CS# lui-même est chargé de cette façon, avec le fichier counterstrikesharp.vdf. Selon la documentation VDF d'AlliedModders, l'extension du fichier doit être .vdf, le contenu doit être écrit au format KeyValues de Valve et la clé file doit être présente ; alias (alias) est facultatif. Si le paquet ne fournit pas de fichier .vdf, vous pouvez le créer vous-même en suivant la structure produite par le plugin d'exemple Source 2 de Metamod (p. ex. addons/metamod/monplugin.vdf) :

"Metamod Plugin"
{
	"alias"	"monplugin"
	"file"	"addons/monplugin/bin/win64/monplugin"
}

Sous Linux, remplacez win64 par linuxsteamrt64. Inutile d'écrire l'extension du fichier : selon la documentation de Metamod, l'extension est trouvée automatiquement et les séparateurs de chemin sont adaptés au système d'exploitation. Redémarrez le serveur et tapez meta list ; le nouveau plugin doit apparaître à côté de CounterStrikeSharp.

Pour faire un essai sans arrêter le serveur, vous pouvez utiliser la commande meta load addons/monplugin/bin/win64/monplugin ; selon la documentation, certains plugins exigent ensuite un changement de map. meta retry, suivi du numéro affiché par meta list, retente le chargement d'un plugin qui avait échoué. La liste complète des commandes se trouve sur la page des commandes du wiki AlliedModders.

6. Gérez les mises à jour et les changements de version de CS2

Les plugins s'appuient sur la structure interne du jeu (signatures, offsets, définitions de schéma), et les mises à jour de CS2 peuvent modifier cette structure. CS# s'adapte à ces changements par de nouvelles versions ; les notes de version de la page Releases de CS# mentionnent les mises à jour du jeu (Game Update) et les corrections de signatures et d'offsets. Dans core.json, le réglage AutoUpdateEnabled ne met à jour que le fichier de données de jeu gamedata.json ; la mise à jour de CS# et des plugins reste à votre charge.

Après chaque mise à jour de CS2, vérifiez dans cet ordre :

  1. meta version : si la commande n'est pas reconnue, Metamod n'est pas chargé et aucun plugin ne fonctionne. La cause la plus fréquente : la mise à jour a remplacé le fichier gameinfo.gi et supprimé la ligne de Metamod ; ajoutez de nouveau cette ligne comme à l'étape 2 du guide d'installation.
  2. meta list : CounterStrikeSharp et vos plugins Metamod figurent-ils dans la liste ? Pour un plugin Metamod absent, vérifiez si le développeur a publié une nouvelle compilation.
  3. css et la page Releases : si une nouvelle version de CS# existe, installez-la avec la méthode de mise à jour du guide d'installation.
  4. css_plugins list : pour les plugins dont l'état n'est pas LOADED ou qui n'apparaissent pas dans la liste, consultez dans le dossier addons/counterstrikesharp/logs le fichier journal (log) dont le nom commence par log-cssharp, et vérifiez s'il existe une nouvelle version du plugin.

Pour mettre à jour un plugin, sauvegardez le fichier de configuration, arrêtez le serveur avec quit, remplacez les fichiers du dossier du plugin par ceux de la nouvelle version, puis démarrez le serveur. Si la nouvelle version exige une version plus récente de CS#, le plugin ne se charge pas ; dans le message requires a newer version of CounterStrikeSharp du journal, la version d'API attendue par le plugin et la vôtre sont indiquées entre crochets.

Récapitulatif des commandes

CommandeCoucheRôle
cssCS#Affiche la version de l'API CS#
css_plugins listCS#Liste les plugins C# chargés avec leur ID, leur état, leur nom et leur version
css_plugins load MonPluginCS#Charge un plugin qui n'est pas chargé ; identique à start
css_plugins unload 1CS#Arrête un plugin chargé ; identique à stop
css_plugins reload 1CS#Décharge puis recharge le plugin et relit son fichier de configuration ; identique à restart
meta versionMetamodIndique si Metamod est chargé et affiche sa version
meta listMetamodListe les plugins Metamod
meta load <fichier>MetamodCharge un plugin Metamod
meta unload <ID>MetamodTente de décharger un plugin Metamod ; le plugin peut refuser
meta retry <ID>MetamodRetente le chargement d'un plugin qui avait échoué

Erreurs fréquentes

  • Le plugin n'apparaît pas du tout dans la sortie de css_plugins list : le .dll principal n'est pas dans son propre dossier, le nom du dossier ne correspond pas au nom du fichier (casse comprise sous Linux) ou le dossier se trouve sous plugins/disabled. Si vous avez ajouté le plugin pendant que le serveur tournait, chargez-le avec css_plugins load.
  • requires a newer version of CounterStrikeSharp dans le journal : le plugin exige une version de l'API CS# plus récente que celle qui est installée. Mettez CS# à jour ou utilisez une ancienne version du plugin compatible avec la vôtre.
  • Erreur de bibliothèque manquante dans le journal : lorsque .NET ne trouve pas une bibliothèque (assembly) dont le plugin a besoin, il affiche généralement le message Could not load file or assembly. Vérifiez que vous avez copié tous les fichiers .dll de l'archive et installé les plugins dépendants et les bibliothèques shared indiqués dans le README.
  • La modification d'un réglage reste sans effet : vous avez modifié le fichier d'exemple ou une copie avec l'extension .json.txt, ou le plugin n'a pas été rechargé. Vérifiez le nom du fichier et exécutez css_plugins reload.
  • Après modification du fichier de configuration, le plugin ne se charge plus du tout : le JSON est peut-être corrompu (guillemet manquant, virgule en trop) ; CS# ne remplace pas un fichier de configuration corrompu par les valeurs par défaut. Consultez l'erreur JSON dans le journal et corrigez le fichier, ou restaurez votre sauvegarde.
  • css_plugins reload #1 renvoie Could not reload plugin : saisissez le numéro sans # ou utilisez le nom exact affiché dans la sortie de list.
  • Le plugin Metamod n'apparaît pas dans meta list ou ne semble pas fonctionner : le paquet téléchargé ne correspond pas au système d'exploitation, le fichier .vdf se trouve hors de addons/metamod, le chemin file est mal écrit ou la compilation du plugin n'est pas compatible avec la version actuelle de CS2.
  • Erreur d'accès sous Linux (Permission denied) : les fichiers appartiennent à root ; exécutez la commande chown de l'étape 2.

Questions fréquentes

Dois-je redémarrer le serveur pour installer un plugin ?

Ce n'est pas obligatoire. Vous pouvez mettre en service un nouveau plugin CS# avec css_plugins load, et un plugin mis à jour par rechargement à chaud ou avec css_plugins reload, sans arrêter le serveur. Le rechargement peut réinitialiser les données que le plugin garde en mémoire à ce moment-là ; si le README demande un redémarrage, suivez-le. Pour les plugins Metamod, le plus sûr est de redémarrer le serveur.

Comment supprimer complètement un plugin ?

Arrêtez-le d'abord avec css_plugins unload et son numéro d'ID, puis supprimez son dossier sous plugins ou déplacez-le sous plugins/disabled. Le fichier de configuration reste sous configs/plugins ; si vous ne comptez plus utiliser le plugin, vous pouvez le supprimer aussi. Pour un plugin Metamod, supprimez, dans addons/metamod, le fichier .vdf ainsi que le dossier du plugin sous addons, puis redémarrez le serveur.

De quoi ai-je besoin pour les plugins d'administration et VIP ?

Dans les plugins CS#, les commandes d'administration sont généralement contrôlées par le système de permissions de CS# (p. ex. @css/ban) ; les administrateurs sont définis dans le fichier configs/admins.json. Ce fichier est décrit à l'étape 7 du guide d'installation. Pour les slots réservés et les réglages VIP, consultez le guide du système VIP pour CS2.

Un grand nombre de plugins ralentit-il le serveur ?

Les plugins s'exécutent dans le même processus que le serveur de jeu ; ceux qui travaillent à chaque étape de mise à jour du serveur (tick) ou qui se connectent souvent à une base de données augmentent la charge processeur. Au fur et à mesure que vous ajoutez des plugins, surveillez l'utilisation du CPU dans les graphiques d'utilisation en temps réel de l'Espace client, et placez les plugins que vous n'utilisez pas sous plugins/disabled. La gamme que nous recommandons pour les serveurs de jeu est celle des VDS AMD Ryzen 9 9950X, aux performances monocœur élevées ; pour les réglages, consultez le guide Performances d'un serveur CS2 et optimisation Sub-Tick.

Guides associés

Commentaires0

Pas encore de commentaire

Soyez le premier à partager votre avis.

Rejoignez la discussion

Veuillez vous connecter ou vous inscrire pour laisser un commentaire.

Ne manquez aucun article

Recevez nos derniers tutoriels, guides et actualités produit dans votre boîte de réception.

Votre abonnement à notre newsletter est confirmé.