Comment installer Metamod et CounterStrikeSharp sur CS2 ? Windows et Linux
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-dssous Windows ; sous Linux, l'utilisateursteamet 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 formemmsource-2.0.0-git<build>-windows.zipetmmsource-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 contientwith-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,
libicupeut être nécessaire au fonctionnement de .NET ; il faut aussiunzippour 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
- Téléchargez le fichier
mmsource-2.0.0-git<build>-windows.zipdepuis la page de téléchargement. - Faites un clic droit sur le fichier et extrayez-le dans un dossier avec « Extract All » (Extraire tout).
- Copiez le dossier
addonsobtenu dansC:\cs2-ds\game\csgo\. Vous devez obtenir au final le dossierC:\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 :
| Paquet | Quand l'utiliser |
|---|---|
counterstrikesharp-with-runtime-windows-<version>.zip | Première installation sous Windows |
counterstrikesharp-with-runtime-linux-<version>.zip | Première installation sous Linux |
counterstrikesharp-windows-<version>.zip | Mise à jour sous Windows ; uniquement si vous maintenez vous-même à jour l'environnement d'exécution .NET |
counterstrikesharp-linux-<version>.zip | Mise à jour sous Linux ; à la même condition |
Windows
- Assurez-vous que Visual C++ Redistributable (X64) est installé.
- Téléchargez le paquet
with-runtime-windowset extrayez-le avec « Extract All ». - Copiez le dossier
addonsobtenu dansC:\cs2-ds\game\csgo\. Il fusionne avec le dossieraddonsexistant : les fichiers de Metamod restent en place et le dossiercounterstrikesharpvient 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éfaut | Rô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 |
FollowCS2ServerGuidelines | true | Bloque 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é |
PluginHotReloadEnabled | true | Recharge automatiquement le plugin lorsque son fichier .dll change |
PluginAutoLoadEnabled | true | Charge 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 |
AutoUpdateEnabled | true | Vé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 :
- Démarrez le serveur et tapez
meta version. Si la commande n'est pas reconnue, ouvrezgameinfo.giet 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. - Vérifiez avec
meta listque 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 versionrenvoieUnknown command: la ligne a été ajoutée dans le mauvais fichier (csgo_core/gameinfo.gi) ou à la mauvaise position,GameBina été écrit, ou le dossieraddonsa é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 listn'affiche pas CS# : si le fichieraddons/metamod/counterstrikesharp.vdfest absent, l'archive de CS# n'a pas été copiée correctement. Si la console affiche le messageCounterStrikeSharp 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
libicude 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 variableDOTNET_SYSTEM_GLOBALIZATION_INVARIANT=truedans l'environnement du serveur ; cela désactive la prise en charge de la localisation par .NET. - Un paquet sans
with-runtimea été utilisé pour la première installation : si le dossiercounterstrikesharp/dotnetn'existe pas, l'environnement d'exécution .NET est absent lui aussi ; l'erreurFailed to initialize .NET runtimes'affiche dans la console et CS# ne démarre pas. Copiez le paquetwith-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 valeuridentity, les noms des permissions ainsi que les virgules et les guillemets du JSON ; après avoir enregistré le fichier, exécutezcss_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
- Comment installer un serveur CS2 ? Guide SteamCMD pour Windows et Linux
- Comment installer un plugin sur un serveur CS2 ? CS# et Metamod
- Installer un système VIP sur CS2 et configurer les slots réservés
- Comment activer le RCON sur CS2 ? Mot de passe, commandes et administration à distance
- Qu'est-ce qu'un GSLT CS2, comment l'obtenir et l'ajouter à votre serveur ?
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.