Comment devenir admin sur votre serveur CounterStrikeSharp

Trouvez le dossier configs

Rendez-vous dans addons/counterstrikesharp/configs sur votre serveur. Trois fichiers comptent : admins.json liste les personnes et ce qu’elles ont le droit de faire, admin_groups.json définit des groupes de permissions réutilisables, et admin_overrides.json modifie la permission qu’exige une commande donnée.

Récupérez votre SteamID64

La liste d’admins vous identifie par votre compte Steam. Le format le plus simple est le SteamID64, un nombre à 17 chiffres qui commence par 7656119. Vous le trouvez en collant le lien de votre profil Steam dans n’importe quel site de recherche de SteamID. L’ancien format STEAM_0:X:Y est aussi accepté.

Ajoutez-vous avec tous les droits

Ouvrez admins.json et ajoutez une entrée avec votre nom, votre SteamID et les flags voulus. Le flag @css/root donne accès à tout : réservez-le à vous-même et aux personnes en qui vous avez une confiance totale.

{
  "MyName": {
    "identity": "76561198000000001",
    "flags": ["@css/root"]
  }
}

Les flags doivent commencer par @

Chaque flag s’écrit avec le @ devant, exactement comme @css/kick. Un flag sans @ n’est pas reconnu et le joueur n’obtient simplement aucun droit, sans erreur évidente. Les plus courants sont @css/generic pour les commandes d’admin de base, @css/kick, @css/ban, @css/changemap, @css/vip et @css/root.

Utilisez des groupes pour plusieurs admins

Si plusieurs admins ont les mêmes droits, définissez les permissions une seule fois dans admin_groups.json et renvoyez au groupe depuis admins.json. Les noms de groupe commencent par #. Modifier le groupe plus tard met à jour tous les admins qui l’utilisent.

{
  "#css/simple-admin": {
    "flags": ["@css/generic", "@css/kick", "@css/ban"]
  }
}

{
  "MyName": {
    "identity": "76561198000000001",
    "groups": ["#css/simple-admin"]
  }
}

Affinez avec les overrides

admin_overrides.json permet de changer le flag exigé par une commande sans toucher au plugin. Vous pouvez par exemple décider qu’une commande qui demande normalement @css/ban soit utilisable avec @css/kick. C’est facultatif, et beaucoup de serveurs n’en ont jamais besoin.

Si ça ne marche pas

Redémarrez le serveur après avoir modifié les fichiers et surveillez la console au démarrage pour repérer des erreurs JSON. Rejoignez ensuite le serveur et essayez une commande qui exige le flag. Les causes habituelles sont un mauvais SteamID, un flag écrit sans @, une erreur de syntaxe JSON ou la modification d’une copie du fichier dans le mauvais dossier.

Pour les développeurs : protéger vos propres commandes

Si vous écrivez des plugins, inutile de vérifier les flags à la main. Ajoutez l’attribut RequiresPermissions au-dessus de la méthode de la commande et CounterStrikeSharp la refuse à quiconque n’a pas le flag.

[RequiresPermissions("@css/kick")]
public void OnKickCommand(CCSPlayerController? player, CommandInfo commandInfo)
{
    // ...
}