So wirst du Admin auf deinem CounterStrikeSharp-Server

Finde den Ordner configs

Gehe auf deinem Server nach addons/counterstrikesharp/configs. Drei Dateien sind wichtig: admins.json enthält die Personen und was sie dürfen, admin_groups.json definiert wiederverwendbare Berechtigungsgruppen, und admin_overrides.json ändert, welche Berechtigung ein bestimmter Befehl verlangt.

Ermittle deine SteamID64

Die Adminliste erkennt dich an deinem Steam-Konto. Am einfachsten ist die SteamID64, eine 17-stellige Zahl, die mit 7656119 beginnt. Du findest sie, indem du den Link zu deinem Steam-Profil in eine beliebige SteamID-Suche einfügst. Das ältere Format STEAM_0:X:Y wird ebenfalls akzeptiert.

Trage dich mit vollen Rechten ein

Öffne admins.json und füge einen Eintrag mit deinem Namen, deiner SteamID und den gewünschten Flags hinzu. Das Flag @css/root gibt Zugriff auf alles, nutze es also nur für dich selbst und Menschen, denen du voll vertraust.

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

Flags müssen mit @ beginnen

Jedes Flag wird mit vorangestelltem @ geschrieben, genau wie @css/kick. Ein Flag ohne @ wird nicht erkannt, und der Spieler bekommt einfach keine Rechte, ohne dass ein offensichtlicher Fehler erscheint. Die häufigsten sind @css/generic für einfache Admin-Befehle, @css/kick, @css/ban, @css/changemap, @css/vip und @css/root.

Nutze Gruppen für mehrere Admins

Hast du mehrere Admins mit denselben Rechten, definiere die Berechtigungen einmal in admin_groups.json und verweise in admins.json auf die Gruppe. Gruppennamen beginnen mit #. Änderst du die Gruppe später, gilt das für alle Admins, die sie nutzen.

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

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

Feinabstimmung mit Overrides

Mit admin_overrides.json änderst du das Flag, das ein Befehl verlangt, ohne das Plugin anzufassen. Du kannst zum Beispiel festlegen, dass ein Befehl, der normalerweise @css/ban braucht, mit @css/kick nutzbar ist. Das ist optional, und viele Server brauchen es nie.

Wenn es nicht funktioniert

Starte den Server nach dem Bearbeiten der Dateien neu und achte beim Start in der Konsole auf JSON-Fehler. Betritt dann den Server und probiere einen Befehl, der das Flag verlangt. Die häufigsten Ursachen sind eine falsche SteamID, ein Flag ohne @, ein JSON-Syntaxfehler oder das Bearbeiten einer Kopie der Datei im falschen Ordner.

Für Plugin-Entwickler: eigene Befehle schützen

Wenn du Plugins schreibst, musst du Flags nicht von Hand prüfen. Setze das Attribut RequiresPermissions über die Befehlsmethode, und CounterStrikeSharp lehnt den Befehl bei jedem ab, der das Flag nicht hat.

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