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 Metamod et CounterStrikeSharp sur CS2 ? Windows et Linux

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

Dans ce guide, vous allez installer les deux couches nécessaires pour faire fonctionner des plugins sur votre serveur Counter-Strike 2 (CS2) : Metamod:Source et CounterStrikeSharp (CS#), qui s'exécute par-dessus. Vous verrez pas à pas, pour Windows et Linux, la mise en place des fichiers, la modification de gameinfo.gi, la vérification de l'installation, la définition des administrateurs et ce qu'il faut faire après les mises à jour du jeu. Les étapes s'appuient sur la documentation d'installation officielle de CounterStrikeSharp et sur la page d'installation de Metamod:Source d'AlliedModders. Pour les autres sujets, consultez la page Guides Counter-Strike 2.

Avant de commencer

SourceMod, utilisé à l'époque de CS:GO, ne fonctionne pas sur CS2 : dans le tableau des versions d'AlliedModders, SourceMod est indiqué « Unsupported » (non pris en charge) pour CS2, et Metamod:Source « Current Development » (version de développement). CounterStrikeSharp est un framework de plugins chargé par Metamod ; les plugins écrits pour lui sont développés en C#. Avant de commencer l'installation, préparez les éléments suivants :

  • Un serveur CS2 qui fonctionne : le serveur doit avoir été installé avec SteamCMD et accepter des joueurs. Si ce n'est pas encore fait, suivez d'abord le guide d'installation d'un serveur CS2. Les chemins utilisés ici reprennent l'installation de ce guide : C:\cs2-ds sous Windows ; sous Linux, l'utilisateur steam et son dossier /home/steam/cs2-ds. Si vous n'avez pas de serveur, vous trouverez les offres sur la page Location de serveur Counter-Strike 2.
  • Un build de développement (dev build) de Metamod:Source 2.x : la documentation de CS# exige un build 1467 ou plus récent, avec prise en charge de KHook. Utilisez la section « Dev Builds » (branche master) de la page de téléchargement : metamodsource.net/downloads.php?branch=master. Les noms de fichiers sont de la forme mmsource-2.0.0-git<build>-windows.zip et mmsource-2.0.0-git<build>-linux.tar.gz.
  • Le paquet « with-runtime » de CounterStrikeSharp : il se télécharge depuis la page Releases (versions publiées), à l'adresse github.com/roflmuffin/CounterStrikeSharp/releases. Pour une première installation, il est obligatoire de choisir le paquet dont le nom contient with-runtime ; ce paquet embarque l'environnement d'exécution (runtime) .NET dont les plugins ont besoin.
  • Sous Windows, Visual C++ Redistributable : selon la documentation de CS#, CS# ne fonctionne pas si ce paquet n'est pas installé. Installez le paquet X64 proposé sur la page Visual C++ Redistributable de Microsoft.
  • Sous Linux, la bibliothèque ICU et unzip : selon la distribution, libicu peut être nécessaire au fonctionnement de .NET ; il faut aussi unzip pour extraire l'archive de CS#. Vous installerez les deux à l'étape 4.
  • Sauvegarde : sauvegardez votre dossier game/csgo/cfg. Les services VDS n'incluent pas de sauvegarde automatique ; la sauvegarde relève de votre responsabilité.

1. Mettez en place les fichiers de Metamod:Source

Avant de copier les fichiers, arrêtez le serveur en tapant quit dans sa console. L'archive de Metamod contient un dossier addons ; ce dossier se copie tel quel dans le dossier game/csgo du serveur.

Windows

  1. Téléchargez le fichier mmsource-2.0.0-git<build>-windows.zip depuis la page de téléchargement.
  2. Faites un clic droit sur le fichier et extrayez-le dans un dossier avec « Extract All » (Extraire tout).
  3. Copiez le dossier addons obtenu dans C:\cs2-ds\game\csgo\. Vous devez obtenir au final le dossier C:\cs2-ds\game\csgo\addons\metamod.

Linux

Exécutez les commandes avec l'utilisateur steam ; si les fichiers sont copiés en root, l'utilisateur qui exécute le serveur risque de ne pas pouvoir y écrire. Le serveur de téléchargement d'AlliedModders fournit le nom de fichier du build Linux le plus récent à l'adresse mmsource-latest-linux :

sudo -iu steam
MM=$(curl -s https://mms.alliedmods.net/mmsdrop/2.0/mmsource-latest-linux)
curl -sLO "https://mms.alliedmods.net/mmsdrop/2.0/$MM"
mkdir -p ~/mm && tar -xzf "$MM" -C ~/mm
cp -r ~/mm/addons ~/cs2-ds/game/csgo/

Une fois l'opération terminée, la sortie de la commande ls ~/cs2-ds/game/csgo/addons doit afficher le dossier metamod.

2. Ajoutez la ligne Metamod au fichier gameinfo.gi

Selon AlliedModders, Source 2 ne prenant pas en charge les plugins serveur (server plugins), Metamod se charge au moyen d'une ligne ajoutée au fichier gameinfo.gi. Le fichier se trouve à l'emplacement C:\cs2-ds\game\csgo\gameinfo.gi sous Windows et /home/steam/cs2-ds/game/csgo/gameinfo.gi sous Linux. Faites-en d'abord une copie, puis ouvrez-le avec un éditeur comme « Notepad » (Bloc-notes) ou nano.

Repérez la section SearchPaths ; après l'accolade { et avant toutes les lignes Game, insérez une nouvelle ligne et écrivez Game csgo/addons/metamod. Dans le fichier de CS2, cet emplacement se situe, comme le décrit aussi la documentation de CS#, juste sous la ligne Game_LowViolence csgo_lv. La section modifiée doit ressembler à ceci ; les autres lignes de votre fichier peuvent différer selon la version :

SearchPaths
{
    Game_LowViolence    csgo_lv
    Game    csgo/addons/metamod
    Game    csgo
    ...
}

Soyez attentif aux points suivants : selon AlliedModders, la ligne Metamod doit être la première entrée Game de la liste ; la liste est ordonnée, et une ligne écrite ailleurs ne charge pas Metamod. Remplacer Game par GameBin ne fonctionne pas. Bien que l'avertissement « DO NOT EDIT THIS FILE DIRECTLY » du fichier vous renvoie vers le fichier csgo_core/gameinfo.gi, modifier ce dernier ne charge pas Metamod ; le bon fichier est csgo/gameinfo.gi. Sous Windows, il n'est pas nécessaire d'écrire le chemin avec des barres obliques inverses.

3. Vérifiez que Metamod est chargé

Démarrez le serveur avec votre ligne de lancement habituelle : start.bat sous Windows, ./cs2.sh dans la session tmux sous Linux. Une fois la map chargée, tapez ceci dans la console du serveur :

meta version

Si la sortie contient une ligne de la forme Metamod:Source version 2.x.x, Metamod fonctionne. Si la commande n'est pas reconnue (Unknown command), ne passez pas à l'étape suivante ; effectuez d'abord les vérifications de la section « Erreurs courantes ».

4. Installez CounterStrikeSharp

Arrêtez de nouveau le serveur avec quit. La page Releases propose quatre paquets pour chaque version :

PaquetQuand l'utiliser
counterstrikesharp-with-runtime-windows-<version>.zipPremière installation sous Windows
counterstrikesharp-with-runtime-linux-<version>.zipPremière installation sous Linux
counterstrikesharp-windows-<version>.zipMise à jour sous Windows ; uniquement si vous maintenez vous-même à jour l'environnement d'exécution .NET
counterstrikesharp-linux-<version>.zipMise à jour sous Linux ; à la même condition

Windows

  1. Assurez-vous que Visual C++ Redistributable (X64) est installé.
  2. Téléchargez le paquet with-runtime-windows et extrayez-le avec « Extract All ».
  3. Copiez le dossier addons obtenu dans C:\cs2-ds\game\csgo\. Il fusionne avec le dossier addons existant : les fichiers de Metamod restent en place et le dossier counterstrikesharp vient s'y ajouter.

Linux

Installez d'abord les paquets nécessaires avec le compte administrateur (si vous êtes dans la session de l'utilisateur steam, quittez-la avec exit) :

# Ubuntu / Debian
sudo apt-get update
sudo apt-get install unzip libicu-dev

# AlmaLinux
sudo dnf install unzip libicu

Téléchargez ensuite le paquet avec l'utilisateur steam et extrayez-le. Remplacez la valeur 1.0.378 de l'exemple par la version actuelle indiquée sur la page Releases ; la lettre v placée au début de l'étiquette de version ne figure pas dans le nom du fichier :

sudo -iu steam
VERSION=1.0.378
curl -sLO "https://github.com/roflmuffin/CounterStrikeSharp/releases/download/v$VERSION/counterstrikesharp-with-runtime-linux-$VERSION.zip"
mkdir -p ~/css && unzip -o "counterstrikesharp-with-runtime-linux-$VERSION.zip" -d ~/css
cp -r ~/css/addons ~/cs2-ds/game/csgo/

Si vous avez fait la copie en root par erreur, corrigez le propriétaire : sudo chown -R steam:steam /home/steam/cs2-ds/game/csgo/addons

5. Vérifiez CounterStrikeSharp

Démarrez le serveur. Pendant le démarrage, la ligne CounterStrikeSharp.API Loaded Successfully. doit apparaître dans la console. Tapez ensuite meta list ; la sortie attendue ne liste qu'un seul plugin (la version entre parenthèses peut différer) :

meta list
Listing 1 plugin:
  [01] CounterStrikeSharp (...) by Roflmuffin

Les commandes propres à la couche CS# fonctionnent désormais elles aussi : css affiche la version de l'API, css_plugins list les plugins C# chargés. Pour utiliser ces commandes depuis le jeu, il faut la permission @css/generic ; dans la console du serveur, aucune permission n'est demandée. En résumé, l'arborescence doit être la suivante :

game/csgo/addons
├── counterstrikesharp
│   ├── api
│   ├── bin
│   ├── configs
│   ├── dotnet
│   ├── gamedata
│   └── plugins
├── metamod
│   ├── bin
│   ├── counterstrikesharp.vdf
│   └── metaplugins.ini
├── metamod.vdf
└── metamod_x64.vdf

6. Effectuez les réglages de base : core.json

Les réglages généraux de CS# se trouvent dans le fichier addons/counterstrikesharp/configs/core.json. Si le fichier n'existe pas, il est créé au premier démarrage à partir de l'exemple core.example.json situé à côté. Après une modification, redémarrez le serveur ou tapez css_core_reload dans la console. Voici les clés importantes du fichier d'exemple et leurs valeurs par défaut :

CléValeur par défautRôle
PublicChatTrigger["!"]Préfixe visible de tous, utilisé pour appeler les commandes des plugins depuis le chat
SilentChatTrigger["/"]Préfixe qui fait la même chose sans afficher le message dans le chat
FollowCS2ServerGuidelinestrueBloque les fonctions connues pour enfreindre les règles de Valve relatives aux serveurs et susceptibles d'entraîner un bannissement du GSLT ; laissez-le activé
PluginHotReloadEnabledtrueRecharge automatiquement le plugin lorsque son fichier .dll change
PluginAutoLoadEnabledtrueCharge au démarrage les plugins du dossier plugins
ServerLanguage"en"Langue par défaut des commandes et des messages du serveur (p. ex. "fr") ; une valeur non reconnue entraîne le retour à en
AutoUpdateEnabledtrueVérifie si une mise à jour du fichier de données de jeu gamedata.json est disponible et, le cas échéant, la télécharge

7. Définissez les administrateurs : admins.json

Le système de permissions de CS# lit les administrateurs au démarrage dans le fichier addons/counterstrikesharp/configs/admins.json. Si le fichier n'existe pas, aucun administrateur n'est chargé ; créez-le en copiant l'exemple admins.example.json du même dossier ou en partant de zéro. Chaque entrée comporte un nom, un SteamID et une liste de permissions :

{
  "Propriétaire du serveur": {
    "identity": "VOTRE_STEAMID64",
    "flags": ["@css/root"]
  },
  "Modérateur": {
    "identity": "STEAM_0:1:1",
    "flags": ["@css/generic", "@css/kick", "@css/ban", "@css/changemap"]
  }
}

Le champ identity accepte le numéro SteamID64 à 17 chiffres ou le format STEAM_0:1:1. Les permissions doivent impérativement commencer par @, faute de quoi elles ne sont pas reconnues. @css/generic donne les droits d'administrateur général, @css/reservation le slot réservé, @css/rcon les commandes RCON, et @css/root toutes les permissions. Après avoir enregistré le fichier, tapez css_admins_reload dans la console et vérifiez avec css_admins_list.

CS# n'apporte pas à lui seul de commandes d'administration comme !kick ou !ban ; ces commandes sont fournies par les plugins que vous installez. Pour les slots réservés et les réglages VIP, consultez le guide du système VIP pour CS2.

8. Ajoutez votre premier plugin

Chaque plugin se place sous addons/counterstrikesharp/plugins, dans un dossier qui porte le même nom que son fichier .dll : plugins/MonPlugin/MonPlugin.dll. Lorsque PluginAutoLoadEnabled est activé, le plugin se charge tout seul au démarrage suivant. Pour le charger sans arrêter le serveur et voir le résultat, tapez ceci dans la console :

css_plugins load MonPlugin
css_plugins list

Pour trouver des plugins, gérer les dépendances et les fichiers de configuration ou résoudre un problème, passez au guide d'installation des plugins CS2.

9. Vérifiez après les mises à jour

AlliedModders précise que vous devez ajouter de nouveau la ligne Metamod chaque fois que Valve modifie le fichier gameinfo.gi. Dans SteamCMD, validate écrase lui aussi les fichiers par défaut modifiés ; il ne touche pas, en revanche, au dossier addons, qui ne fait pas partie de l'installation par défaut. Par conséquent, après chaque mise à jour de CS2 :

  1. Démarrez le serveur et tapez meta version. Si la commande n'est pas reconnue, ouvrez gameinfo.gi et ajoutez de nouveau la ligne comme à l'étape 2. Ne restaurez pas telle quelle votre ancienne sauvegarde ; Valve a peut-être apporté d'autres modifications au fichier.
  2. Vérifiez avec meta list que CS# est chargé. Si des plugins renvoient des erreurs, regardez sur la page Releases si une nouvelle version de CS# est disponible.

Pour mettre à jour CS#, copiez la nouvelle version au même endroit, comme lors de la première installation ; selon la documentation de CS#, vos fichiers de configuration ne sont pas écrasés. Si vous ne maintenez pas vous-même à jour l'environnement d'exécution .NET, choisissez là aussi le paquet with-runtime pour la mise à jour.

Erreurs courantes

  • meta version renvoie Unknown command : la ligne a été ajoutée dans le mauvais fichier (csgo_core/gameinfo.gi) ou à la mauvaise position, GameBin a été écrit, ou le dossier addons a été copié au mauvais endroit (exemple fréquent : game/csgo/addons/addons). La dernière mise à jour du jeu a aussi pu supprimer la ligne. AlliedModders recommande par ailleurs de mettre à jour le jeu et Metamod vers leur dernière version.
  • Metamod fonctionne, mais meta list n'affiche pas CS# : si le fichier addons/metamod/counterstrikesharp.vdf est absent, l'archive de CS# n'a pas été copiée correctement. Si la console affiche le message CounterStrikeSharp requires Metamod with KHook, votre build de Metamod est trop ancien ; installez un dev build 1467 ou plus récent.
  • Sous Windows, CS# ne se charge pas : Visual C++ Redistributable (X64) n'est peut-être pas installé ; installez le paquet et redémarrez le serveur.
  • Sous Linux, .NET ne trouve pas la bibliothèque ICU : installez le paquet libicu de l'étape 4. La note d'installation du dépôt de CS# indique qu'il est aussi possible, à défaut, de définir la variable DOTNET_SYSTEM_GLOBALIZATION_INVARIANT=true dans l'environnement du serveur ; cela désactive la prise en charge de la localisation par .NET.
  • Un paquet sans with-runtime a été utilisé pour la première installation : si le dossier counterstrikesharp/dotnet n'existe pas, l'environnement d'exécution .NET est absent lui aussi ; l'erreur Failed to initialize .NET runtime s'affiche dans la console et CS# ne démarre pas. Copiez le paquet with-runtime.
  • Les permissions d'administrateur ne fonctionnent pas : CS# ignore sans avertissement les SteamID qu'il ne parvient pas à interpréter et les permissions qui ne commencent pas par @. Vérifiez la valeur identity, les noms des permissions ainsi que les virgules et les guillemets du JSON ; après avoir enregistré le fichier, exécutez css_admins_reload.

Questions fréquentes

Puis-je utiliser des plugins SourceMod (.smx) sur CS2 ?

Non. AlliedModders indique que SourceMod n'est pas pris en charge pour CS2 ; les plugins .smx hérités de CS:GO ne fonctionnent donc pas sur CS2. Vous devez trouver l'équivalent, écrit pour CounterStrikeSharp, de la fonction que vous souhaitez utiliser.

Pourquoi dois-je installer un build de développement de Metamod ?

La prise en charge de CS2 se trouve dans la branche 2.0 de Metamod, et AlliedModders présente cette branche comme « Current Development » pour CS2. La documentation de CS# exige elle aussi un build de développement 2.x, au minimum le build numéro 1467.

L'utilisation de plugins peut-elle faire bannir mon GSLT ?

Selon la documentation de CS#, certaines fonctions de plugins contraires aux règles de Valve pour les serveurs CS2 peuvent entraîner le bannissement des jetons GSLT du propriétaire du serveur. Le réglage FollowCS2ServerGuidelines bloque les fonctions connues, mais la documentation indique clairement que ce réglage n'empêche pas à coup sûr le bannissement. Les détails concernant les jetons se trouvent dans le guide du GSLT CS2.

Quel serveur choisir pour un grand nombre de plugins ?

Les plugins s'exécutent dans le même processus que le serveur de jeu ; plus ils effectuent de travail, plus la charge processeur du serveur augmente. 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 mesurer la charge et ajuster les réglages, consultez le guide des performances d'un serveur CS2.

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é.