Installer un système VIP sur CS2 et configurer les slots réservés
Counter-Strike 2 (CS2) ne comporte pas de système VIP intégré ; ce sont des plugins CounterStrikeSharp (CS#) qui accordent les privilèges. Ces plugins consultent le flag de permission CS# du joueur ou bien, comme VIPCore, conservent les enregistrements VIP et leurs durées dans leur propre base de données. Le slot réservé (reserved slot) est quant à lui un mécanisme qui garde de la place pour que les joueurs autorisés puissent entrer même lorsque le serveur est plein.
Dans ce guide, vous allez d'abord créer un groupe VIP avec admin_groups.json, puis définir avec VIPCore des VIP à durée limitée et des avantages comme les points de vie, l'armure ou un tag, et enfin libérer de la place pour les VIP sur un serveur plein avec ReservedSlots. Pour les autres sujets, consultez la page des guides Counter-Strike 2.
Avant de commencer
- Un serveur CS2 fonctionnel : le serveur doit être installé avec SteamCMD et accepter des joueurs. Si vous ne l'avez pas encore installé, suivez le guide d'installation d'un serveur CS2. Les chemins reposent sur l'installation de ce guide :
C:\cs2-dssous Windows, et sous Linux, pour l'utilisateursteam, le 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. - Metamod:Source et CS# : les deux doivent être installés et CounterStrikeSharp doit apparaître dans la sortie de
meta list. L'installation et les bases deadmins.jsonsont expliquées dans le guide d'installation de Metamod et CS#. La version actuelle de VIPCore est compilée avec .NET 10 et l'API CS# 1.0.376 ; mettez CS# à jour vers cette version ou une plus récente avec le paquetwith-runtime, qui apporte l'environnement d'exécution .NET 10. - Les SteamID64 des joueurs : le numéro à 17 chiffres qui commence par
7656119. - MySQL ou MariaDB : VIPCore conserve les enregistrements VIP dans une base de données MySQL. Vous pouvez installer le serveur de base de données sur le même VDS que le serveur de jeu ; pour l'installation, consultez le guide des bases de données sur VDS.
- Sauvegarde : sauvegardez le dossier
game/csgo/addons/counterstrikesharp/configs. La sauvegarde automatique n'est pas incluse dans les services VDS ; les sauvegardes relèvent de votre responsabilité.
État de maintenance : le dépôt VIPCore est activement développé et publie souvent de nouvelles versions ; lisez les notes de version avant de mettre à jour. Le dépôt ReservedSlots, en revanche, a été archivé par son propriétaire : il est en lecture seule et aucune nouvelle version n'est attendue. La dernière version, v1.1.1, comporte deux bugs connus ; les réglages de l'étape 8 les évitent. Si vous utilisez ce plugin, vérifiez qu'il fonctionne après chaque mise à jour de CS2 et de CS#.
1. Planifiez les flags et les groupes
CS# définit les permissions par du texte plutôt que par des lettres, et chaque permission doit commencer par @. La liste standard de la documentation comporte deux flags liés aux VIP : @css/vip (statut VIP général) et @css/reservation (accès aux slots réservés). Ces flags ne font rien à eux seuls ; c'est le plugin qui les lit qui leur donne un sens.
Plutôt que d'écrire les flags joueur par joueur, utilisez des groupes. Selon la documentation CS# sur les groupes, les noms de groupes doivent commencer par #, sinon CS# ne reconnaît pas le groupe. Le groupe d'exemple s'appellera #serveur/vip.
2. Créez le groupe VIP avec admin_groups.json
Les groupes se définissent dans le fichier addons/counterstrikesharp/configs/admin_groups.json : C:\cs2-ds\game\csgo\addons\counterstrikesharp\configs\admin_groups.json sous Windows, /home/steam/cs2-ds/game/csgo/addons/counterstrikesharp/configs/admin_groups.json sous Linux. Si le fichier n'existe pas, CS# ignore le chargement des groupes ; un exemple admin_groups.example.json se trouve dans le même dossier. Sous Windows, créez le fichier avec le Bloc-notes (Notepad). Sous Linux, ouvrez-le avec l'utilisateur steam :
sudo -iu steam
nano ~/cs2-ds/game/csgo/addons/counterstrikesharp/configs/admin_groups.json
Écrivez le contenu suivant :
{
"#serveur/vip": {
"flags": ["@css/vip", "@css/reservation"]
}
}
Dans l'exemple, le champ immunity (immunité) a été volontairement omis ; sa valeur est alors 0. Les plugins d'administration qui contrôlent cette valeur refusent la commande d'un administrateur dont la valeur est inférieure à celle de la cible ; si vous donnez une valeur élevée au groupe VIP, vos modérateurs dont la valeur est plus basse ne pourront plus expulser ni bannir les VIP. Même si l'exemple de la documentation montre une virgule après le dernier flag, le lecteur JSON de CS# n'accepte pas les virgules finales ; ne laissez pas de virgule après le dernier élément.
Ajoutez ensuite le joueur au groupe dans le fichier admins.json du même dossier ; le champ identity est obligatoire, flags peut être omis. Si le fichier contient d'autres administrateurs, ne les supprimez pas ; ajoutez seulement le bloc "Exemple VIP" et placez une virgule après l'entrée précédente. Remplacez le numéro de l'exemple par le SteamID64 du joueur :
{
"Exemple VIP": {
"identity": "76561198000000000",
"groups": ["#serveur/vip"]
}
}
Enregistrez, puis tapez ces commandes dans la console du serveur ; pour les utiliser depuis le jeu, il faut @css/generic :
css_groups_reload
css_admins_reload
css_groups_list
css_admins_list
La sortie de css_admins_list doit afficher le SteamID du joueur et les flags hérités du groupe. À ce stade, la permission VIP est prête : tout plugin CS# qui lit le flag @css/vip considère ce joueur comme VIP. Si vous voulez des VIP à durée limitée, un menu VIP et des avantages en jeu, installez VIPCore en suivant les étapes suivantes.
3. Installez VIPCore
VIPCore est le plugin principal qui gère les groupes VIP et leurs durées ; chaque avantage (points de vie, armure, argent, tag…) est un module séparé. La page Releases propose deux archives : VIPCore.zip et VIP_Modules.zip. À la racine de VIPCore.zip se trouve un dossier addons ; une fois ce dossier copié dans game/csgo, les fichiers se placent sous plugins/VIPCore et shared/VipCoreApi. Dans l'archive des modules, chaque module est un dossier distinct qui, selon le README, se place dans addons/counterstrikesharp/plugins ; ne copiez que les modules que vous utiliserez. Arrêtez d'abord le serveur avec quit.
Windows
- Depuis l'adresse
github.com/partiusfabaa/cs2-VIPCore/releases, téléchargez les fichiersVIPCore.zipetVIP_Modules.zip, puis extrayez-les avec « Extract All ». - Depuis l'archive
VIPCore, copiez le dossieraddonsextrait dansC:\cs2-ds\game\csgo\; il fusionne avec le dossieraddonsexistant. - Depuis l'archive des modules, copiez les dossiers
VIP_Health,VIP_Armor,VIP_MoneyetVIP_TagdansC:\cs2-ds\game\csgo\addons\counterstrikesharp\plugins\.
Linux
sudo -iu steam
curl -sLO https://github.com/partiusfabaa/cs2-VIPCore/releases/latest/download/VIPCore.zip
curl -sLO https://github.com/partiusfabaa/cs2-VIPCore/releases/latest/download/VIP_Modules.zip
mkdir -p ~/vipcore ~/vipmod
unzip -o VIPCore.zip -d ~/vipcore
unzip -o VIP_Modules.zip -d ~/vipmod
cp -r ~/vipcore/addons ~/cs2-ds/game/csgo/
cd ~/vipmod
cp -r VIP_Health VIP_Armor VIP_Money VIP_Tag ~/cs2-ds/game/csgo/addons/counterstrikesharp/plugins/
Pour les règles générales d'installation des plugins et les problèmes de dépendances, consultez le guide d'installation de plugins CS2.
4. Préparez la base de données et remplissez vip_core.json
Les fichiers de réglages de VIPCore se trouvent dans le dossier addons/counterstrikesharp/configs/plugins/VIPCore. D'après le code source, si vip_core.json et vip.json n'existent pas, ils sont créés avec les valeurs par défaut au premier démarrage. Démarrez puis arrêtez le serveur une fois ; comme aucune information de base de données n'a été saisie, VIPCore ne peut pas se connecter lors de ce démarrage.
Créez pour VIPCore une base de données vide et un utilisateur qui ne dispose que des droits nécessaires sur cette base. Connectez-vous au client MySQL avec le compte administrateur et exécutez les commandes suivantes, en remplaçant MOT_DE_PASSE_FORT_ICI par un mot de passe long et aléatoire :
CREATE DATABASE cs2vip;
CREATE USER 'cs2vip'@'localhost' IDENTIFIED BY 'MOT_DE_PASSE_FORT_ICI';
GRANT SELECT, INSERT, UPDATE, DELETE, CREATE ON cs2vip.* TO 'cs2vip'@'localhost';
D'après le code source, le plugin crée lui-même les tables vip_users et vip_servers, puis se contente de lire, d'ajouter, de mettre à jour et de supprimer des enregistrements ; le droit ALL n'est pas nécessaire. Le compte 'localhost' ne peut se connecter que depuis le même serveur ; si la base de données se trouve sur le même VDS que le serveur de jeu, n'ouvrez pas le port 3306 vers l'extérieur. Modifiez ensuite le fichier vip_core.json :
{
"TimeMode": 3,
"ServerId": 0,
"UseCenterHtmlMenu": true,
"ServerIP": "0.0.0.0",
"ServerPort": 27015,
"ReOpenMenuAfterItemClick": false,
"VipLogging": true,
"Connection": {
"Host": "localhost",
"Database": "cs2vip",
"User": "cs2vip",
"Password": "MOT_DE_PASSE_FORT_ICI",
"Port": 3306
}
}
TimeMode est l'unité de la durée que vous saisissez dans les commandes : 0 secondes (par défaut), 1 minutes, 2 heures, 3 jours. ServerId détermine à quel serveur appartiennent les enregistrements VIP ; donnez un numéro différent à chaque serveur qui utilise la même base de données. ServerIP et ServerPort sont seulement inscrits, à titre d'information, dans la table vip_servers.
5. Définissez les groupes VIP dans vip.json
Dans le fichier vip.json, chaque clé sous Groups est un groupe VIP ; chaque ligne de Values est la valeur d'un module, dont le format est défini par le README de ce module. Delay indique combien de secondes après l'apparition (spawn) du joueur les avantages sont appliqués.
{
"Delay": 2.0,
"Groups": {
"VIP": {
"Values": {
"Health": 120,
"Armor": 100,
"Money": "++1000",
"Tag": { "ScoreboardTag": "VIP", "ChatTag": "[VIP]", "ColorTag": "lime" }
}
}
}
}
Selon les README des modules, Health et Armor s'écrivent sous forme de nombre simple. Si vous faites précéder la valeur Money de ++, le montant est ajouté à chaque manche ; si vous l'écrivez simplement, comme "16000", l'argent est fixé à ce montant. D'après le code source, l'argent ne change pas lors des manches au pistolet et le montant ne dépasse pas la limite mp_maxmoney. Tag affiche un tag dans le tableau des scores et un préfixe coloré dans le chat. Si le module correspondant n'est pas installé, la ligne n'a aucun effet. Après une modification, tapez css_vip_reload dans la console.
Le module VIP_Flags de VIPCore peut aussi ajouter au groupe un flag ou un groupe CS#, sous la forme "flags": ["@css/reservation"]. Mais d'après le code source du module, ces flags sont attribués environ une seconde après le chargement du joueur. Pour un plugin de slots réservés qui effectue sa vérification au moment de la connexion, il est plus fiable d'attribuer le flag via le groupe admin_groups.json de l'étape 2.
En choisissant vos modules, respectez les règles de Valve : selon la page de l'Assistance Steam sur les bannissements de GSLT CS2, permettre aux joueurs d'utiliser des skins d'armes ou des couteaux qui ne sont pas dans leur inventaire, ou afficher de faux rangs compétitifs, rangs de profil ou médailles, peut entraîner un bannissement du GSLT ; donner des armes standard et modifier les scores ou les noms du tableau des scores est autorisé. Les détails se trouvent dans le guide GSLT CS2.
6. Ajoutez, modifiez et supprimez des VIP
Les enregistrements VIP se gèrent avec des commandes de console. Dans l'exemple, la valeur TimeMode étant 3, les durées sont exprimées en jours :
css_vip_adduser 76561198000000000 VIP 30
css_vip_updateuser 76561198000000000 -s 60
css_vip_deleteuser 76561198000000000
La première ligne ajoute le joueur au groupe VIP pour 30 jours ; avec une durée de 0, le VIP est permanent. css_vip_updateuser modifie le groupe ou la durée ; pour un champ que vous ne voulez pas modifier, écrivez -s. La ligne de l'exemple conserve le groupe et fixe la date d'expiration à 60 jours à partir de maintenant ; elle n'ajoute rien à la durée restante.
Les commandes acceptent le SteamID64, le format STEAM_ écrit entre guillemets ou l'identifiant de compte (account ID), et exigent @css/root depuis le jeu ; css_vip_help les liste toutes. Les joueurs ouvrent le menu VIP en tapant !vip dans le chat. Pour exécuter ces commandes sans vous connecter au serveur, consultez le guide RCON CS2.
7. Installez le plugin ReservedSlots
Arrêtez le serveur avec quit. Selon le README, l'archive ReservedSlots.zip s'extrait dans le dossier csgo/addons/counterstrikesharp/plugins/ ; vous devez obtenir au final le fichier plugins/ReservedSlots/ReservedSlots.dll.
Windows
- Depuis
github.com/NockyCZ/CS2-ReservedSlots/releases, téléchargez le fichierReservedSlots.zip. - Extrayez l'archive dans le dossier
C:\cs2-ds\game\csgo\addons\counterstrikesharp\plugins\et vérifiez que le cheminReservedSlots\ReservedSlots.dlla bien été créé.
Linux
sudo -iu steam
curl -sLO https://github.com/NockyCZ/CS2-ReservedSlots/releases/download/v1.1.1/ReservedSlots.zip
unzip -o ReservedSlots.zip -d ~/cs2-ds/game/csgo/addons/counterstrikesharp/plugins/
ls ~/cs2-ds/game/csgo/addons/counterstrikesharp/plugins/ReservedSlots
Démarrez le serveur. Au premier chargement, CS# crée le fichier de réglages du plugin, addons/counterstrikesharp/configs/plugins/ReservedSlots/ReservedSlots.json, avec les valeurs par défaut. Le plugin doit apparaître dans la sortie de css_plugins list ; en raison de la ligne de version du code source, il est normal que la liste indique 1.1.0.
8. Configurez les slots réservés
Ouvrez le fichier ReservedSlots.json. Utilisez les noms de clés tels qu'ils figurent dans le fichier généré : dans le tableau du README, les flags d'administrateur apparaissent sous le nom Reserved Admin Flags, mais dans le code source et dans le fichier généré, la clé s'appelle Admin Reserved Flags. Exemple qui réserve les 2 derniers slots d'un serveur de 10 slots aux joueurs possédant un flag :
{
"Reserved Flags": ["@css/reservation"],
"Admin Reserved Flags": ["@css/ban"],
"Reserved Slots": 2,
"Reserved Slots Method": 1,
"Leave One Slot Open": true,
"Kick Immunity Type": 0,
"Kick Reason": 135,
"Kick Delay": 5,
"Kick Check Method": 0,
"Kick Type": 1,
"Kick Players In Spectate": false,
"Log Kicked Players": true,
"Display Kicked Players Message": 2
}
Le nombre de slots correspond à la valeur -maxplayers de la ligne de lancement. Dans l'exemple (10 slots, 2 slots réservés, méthode 1), lorsque 8 joueurs sont sur le serveur, un nouveau joueur ne reste que s'il possède un flag ; sinon, il est expulsé. Comme Leave One Slot Open est activé, le dernier slot reste libre : lorsqu'un joueur avec flag entre par ce slot, un joueur sans flag est expulsé selon la règle Kick Type (dans l'exemple, le ping le plus élevé). D'après le code source, lorsque ce réglage est désactivé, l'expulsion des méthodes 1 et 2 ne se déclenche que si le nombre de joueurs dépasse le nombre de slots ; laissez donc ce réglage activé. Le plugin ne tient pas compte des bots dans son décompte. Après une modification, redémarrez le serveur.
La v1.1.1 comporte deux bugs, corrigés plus tard dans le code source : si la liste Admin Reserved Flags est vide, le plugin ne fait rien ; si Kick Players In Spectate est activé et qu'un joueur est en spectateur ou sans équipe, personne n'est expulsé. C'est pourquoi l'exemple utilise une liste d'administrateurs remplie et désactive l'option spectateur.
9. Testez l'installation
- Tapez
css_plugins listdans la console ; VIPCore, les modules que vous avez copiés et Reserved Slots doivent apparaître. - Connectez-vous avec le compte VIP, tapez
!vipdans le chat et vérifiez que le menu s'ouvre et qu'après l'apparition, les points de vie et l'armure atteignent les valeurs devip.json. - Pour tester le slot réservé, le serveur doit être plein, et les bots ne comptent pas. Baissez temporairement la valeur
-maxplayers, remplissez d'abord le serveur avec des comptes sans flag, puis connectez-vous avec un compte qui en possède un. Après le test, remettez la valeur d'origine.
Réglages de ReservedSlots.json
Les valeurs par défaut proviennent du code source du plugin, les descriptions du README :
| Clé | Par défaut | Rôle |
|---|---|---|
Reserved Flags | ["@css/reservation", "@css/vip"] | Flags qui donnent droit à un slot réservé ; ne peut pas rester vide |
Admin Reserved Flags | ["@css/ban", "@css/admin"] | Réserve administrateur : personne n'est expulsé pour un joueur qui entre avec ce flag. Le README indique qu'elle peut rester vide, mais en v1.1.1 le plugin ne fonctionne pas si elle l'est |
Reserved Slots | 1 | Nombre de slots réservés avec les méthodes 1 et 2 |
Reserved Slots Method | 0 | 0 : un slot reste toujours libre (9 joueurs au maximum sur 10 slots) ; 1 : seuls les joueurs avec flag prennent les derniers slots ; 2 : comme 1, mais les joueurs avec flag ne comptent pas dans le taux de remplissage |
Leave One Slot Open | false | Avec les méthodes 1 et 2, garde toujours un slot libre |
Kick Immunity Type | 0 | Joueurs protégés contre l'expulsion ; 0 protège les détenteurs des deux types de flags. Pour 1 et 2, le README et le code source se contredisent : utilisez 0 |
Kick Reason | 135 | Motif de déconnexion envoyé au joueur expulsé ; dans la liste CS#, 135 correspond à « serveur plein » (NETWORK_DISCONNECT_REJECT_SERVERFULL) |
Kick Delay | 5 | Secondes d'attente avant l'expulsion ; d'après le code source, une valeur de 1 ou moins expulse immédiatement |
Kick Check Method | 0 | Détermine le joueur à expulser : 0 à la connexion du joueur avec flag, 1 au choix de son équipe |
Kick Type | 0 | 0 aléatoire, 1 ping le plus élevé, 2 score le plus élevé, 3 score le plus bas |
Kick Players In Spectate | true | Expulse en priorité les joueurs en spectateur ; bogué en v1.1.1, utilisez false |
Log Kicked Players | true | Inscrit les joueurs expulsés dans le journal |
Display Kicked Players Message | 2 | Qui voit le message d'expulsion : 0 personne, 1 tout le monde, 2 uniquement les administrateurs disposant de @css/generic |
Erreurs fréquentes
- Les flags du groupe ne sont pas attribués au joueur : si les flags n'apparaissent pas dans la sortie de
css_admins_list, le nom du groupe ne commence pas par#ou le flag ne commence pas par@, le nom du groupe est écrit différemment dansadmins.json, ou le JSON contient une erreur de syntaxe comme une virgule finale. Dans ce cas, CS# afficheFailed to load admin groupsdans la console, ouAdmin groups file not foundsi le fichier n'existe pas du tout ; sous Windows, le fichier a peut-être été enregistré sous le nomadmin_groups.json.txt. Corrigez le fichier et exécutezcss_groups_reload. - Le VIP n'est pas ajouté, le joueur n'est pas reconnu comme VIP : VIPCore n'arrive pas à se connecter à la base de données. Vérifiez les champs
Connection, que le service MySQL fonctionne et que l'utilisateur dispose des droits sur la base ; testez la connexion TCP utilisée par le plugin avec la commandemysql --protocol=TCP -h localhost -P 3306 -u cs2vip -p cs2vip. - Message
VIP group '...' was not found!: le nom de groupe de la commande n'existe pas dansvip.json. Écrivez le nom à l'identique, ou modifiez le fichier puis exécutezcss_vip_reload. - L'enregistrement VIP existe, mais les points de vie, l'argent ou le tag ne s'appliquent pas : le dossier du module n'est pas sous
plugins, ou la clé devip.jsondiffère de celle du README du module ; vérifiez aveccss_plugins list. - Un VIP qui entre sur un serveur plein est lui aussi expulsé : le flag du joueur ne correspond pas exactement au nom de la liste
Reserved Flags, ou le flag n'est attribué que par le moduleVIP_Flags, après la connexion. Attribuez le flag@css/reservationvia le groupe de l'étape 2. - Le VIP est entré mais personne n'a été expulsé : la console affiche
Selected player is NULL, no one is kicked!; réglezKick Players In Spectatesurfalse. - Dans la console,
[Reserved Slots] Reserved Flags and Roles cannot be empty!: la listeReserved Flagsest vide ; indiquez au moins un flag. - ReservedSlots ne se charge plus après une mise à jour : un plugin archivé ne reçoit plus de correctifs ; déplacez son dossier hors de
pluginset consultez l'alternative proposée dans les questions fréquentes.
Questions fréquentes
Une base de données est-elle indispensable pour un système VIP ?
Seulement pour VIPCore. Si vous n'avez besoin ni du suivi des durées ni du menu VIP, il suffit de passer par admin_groups.json pour attribuer les flags @css/vip et @css/reservation ; les plugins qui lisent ces flags, comme ReservedSlots, fonctionnent sans base de données. Pour retirer le statut VIP d'un joueur, vous supprimez alors manuellement l'entrée de admins.json.
Puis-je utiliser la même liste de VIP sur plusieurs serveurs ?
Oui, plusieurs serveurs peuvent utiliser la même base de données. Comme VIPCore sépare les enregistrements VIP selon la valeur ServerId, donnez un numéro différent à chaque serveur et ajoutez le joueur séparément sur chacun d'eux.
Pourquoi mon compte administrateur ne profite-t-il pas du slot réservé ?
D'après son code source, ReservedSlots compare les flags exactement avec les noms de la liste. Si votre compte ne possède que @css/root et que ce nom ne figure pas dans la liste, le plugin ne vous considère pas comme ayant droit à la réserve. Ajoutez à votre compte @css/reservation ou l'un des flags de la liste Admin Reserved Flags.
Que puis-je utiliser à la place d'un plugin archivé ?
La fonction de réservation existe aussi dans certains plugins d'administration généralistes ; par exemple, le README de CS2-AdminPlus mentionne un système de réservation et le flag @css/reservation. Ne faites pas tourner deux plugins de réservation en même temps ; le README d'AdminPlus avertit aussi d'un risque de conflit avec d'autres plugins d'administration.
Guides associés
- Comment installer un serveur CS2 ? Guide SteamCMD pour Windows et Linux
- Comment installer Metamod et CounterStrikeSharp sur CS2 ? Windows et Linux
- Comment installer un plugin sur un serveur CS2 ? CS# et Metamod
- Comment activer le RCON sur CS2 ? Mot de passe, commandes et administration à distance
- Comment créer un serveur CS2 Deathmatch, Retake et Surf ?
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.