Come diventare admin sul tuo server CounterStrikeSharp

Trova la cartella configs

Vai in addons/counterstrikesharp/configs sul tuo server. Contano tre file: admins.json elenca le persone e cosa possono fare, admin_groups.json definisce gruppi di permessi riutilizzabili, e admin_overrides.json cambia quale permesso richiede un certo comando.

Ricava il tuo SteamID64

L’elenco degli admin ti identifica tramite il tuo account Steam. Il formato più semplice è lo SteamID64, un numero di 17 cifre che inizia con 7656119. Lo trovi incollando il link del tuo profilo Steam in un qualsiasi sito di ricerca SteamID. Viene accettato anche il vecchio formato STEAM_0:X:Y.

Aggiungiti con tutti i diritti

Apri admins.json e aggiungi una voce con il tuo nome, il tuo SteamID e i flag che vuoi. Il flag @css/root dà accesso a tutto, quindi usalo solo per te e per persone di cui ti fidi ciecamente.

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

I flag devono iniziare con @

Ogni flag si scrive con la @ davanti, proprio come @css/kick. Un flag senza @ non viene riconosciuto e il giocatore semplicemente non riceve alcun diritto, senza un errore evidente. I più comuni sono @css/generic per i comandi base, @css/kick, @css/ban, @css/changemap, @css/vip e @css/root.

Usa i gruppi se hai più admin

Se più admin hanno gli stessi diritti, definisci i permessi una volta sola in admin_groups.json e rimanda al gruppo da admins.json. I nomi dei gruppi iniziano con #. Se in seguito modifichi il gruppo, si aggiornano tutti gli admin che lo usano.

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

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

Affina con gli override

admin_overrides.json permette di cambiare il flag richiesto da un comando senza toccare il plugin. Per esempio, puoi decidere che un comando che normalmente richiede @css/ban sia usabile da chi ha @css/kick. È facoltativo e molti server non ne hanno mai bisogno.

Se non funziona

Riavvia il server dopo aver modificato i file e controlla la console all’avvio per eventuali errori JSON. Poi entra nel server e prova un comando che richiede il flag. Le cause tipiche sono uno SteamID sbagliato, un flag scritto senza @, un errore di sintassi JSON o la modifica di una copia del file in una cartella sbagliata.

Per gli sviluppatori: proteggi i tuoi comandi

Se scrivi plugin, non devi controllare i flag a mano. Aggiungi l’attributo RequiresPermissions sopra il metodo del comando e CounterStrikeSharp lo rifiuta a chiunque non abbia il flag.

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