CS2 CS2

How to Add Admins on a CS2 Server (CounterStrikeSharp)

Add admins on your CS2 server with CounterStrikeSharp: admins.json, permission flags, groups and immunity, plus CS2-SimpleAdmin for kick, ban and an admin menu.

6 min read Last checked 59m ago 3 views
Series · part 4 of 4Your first CS2 server
  1. 1How to Make a CS2 Dedicated Server (Windows & Linux)
  2. 2How to Install Metamod:Source and CounterStrikeSharp on CS2
  3. 3How to Install CS2 Plugins (CounterStrikeSharp)
  4. 4How to Add Admins on a CS2 Server (CounterStrikeSharp)
In this guide 9 sections
  1. 1Quick steps
  2. 2What you need
  3. 3Make yourself admin
  4. 4Add more admins
  5. 5Use groups
  6. 6Install CS2-SimpleAdmin
  7. 7Troubleshooting
  8. 8FAQ
  9. 9Next steps

CS2 has no admin system of its own. CounterStrikeSharp provides the permissions: you list admins in admins.json and give them flags like @css/kick or @css/ban. The actual commands (!kick, !ban, the admin menu) come from an admin plugin; the most used one is CS2-SimpleAdmin. This guide sets up both.

Quick steps#

  1. Open game/csgo/addons/counterstrikesharp/configs/admins.json.
  2. Add yourself with your SteamID64 and the flag @css/root.
  3. Restart the server (or run css_admins_reload).
  4. Install CS2-SimpleAdmin and the three plugins it needs.
  5. In game, type !admin in chat to open the admin menu.

The full instructions for each step are below.

What you need#

A CS2 server with Metamod:Source and CounterStrikeSharp running (meta list shows CounterStrikeSharp):

How to Install Metamod:Source and CounterStrikeSharp on CS2Install Metamod:Source and CounterStrikeSharp on your CS2 server: edit gameinfo.gi, check with meta list, and fix plugins after CS2 updates.Read the guide

Make yourself admin#

  1. 1Find your SteamID64

    Your SteamID64 is the 17-digit number in your Steam profile link (it starts with 7656119). If your profile has a custom link, get it here:

    SteamID FinderEvery SteamID format from a profile link.Open
  2. 2Edit admins.json

    Open this file (create it if it doesn't exist):

    game/csgo/addons/counterstrikesharp/configs/admins.json

    Put this in it, with your name and SteamID64:

    configs/admins.jsonjson
    {
      "Owner": {
        "identity": "76561198000000001",
        "flags": ["@css/root"]
      }
    }

    @css/root gives every permission and ignores immunity. Keep it for the owner.

  3. 3Reload the admins

    Restart the server, or type in the server console:

    bash
    css_admins_reload
JSON is strict

Every entry is in curly brackets, every text is in double quotes, and entries are separated by commas, with no comma after the last one. One missing or extra comma and no admin works. If something breaks, paste the file into an online JSON validator.

Add more admins#

Each admin is one entry. Separate them with commas:

configs/admins.jsonjson
{
  "Owner": {
    "identity": "76561198000000001",
    "flags": ["@css/root"]
  },
  "Andrei": {
    "identity": "76561198000000002",
    "flags": ["@css/generic", "@css/kick", "@css/slay", "@css/chat"],
    "immunity": 50
  },
  "Maria": {
    "identity": "STEAM_0:1:12345678",
    "flags": ["@css/generic", "@css/kick", "@css/ban", "@css/unban", "@css/changemap"],
    "immunity": 70
  }
}

identity takes a SteamID64 (7656119…) or the classic form (STEAM_0:1:…); CounterStrikeSharp converts it.

The permission flags#

FlagWhat it allows
@css/genericBasic admin. Most admin commands need it, so give it to every admin
@css/kickKick players
@css/banBan players
@css/unbanRemove bans
@css/slaySlay, slap and similar
@css/changemapChange the map
@css/chatMute and gag players
@css/voteStart votes
@css/cvarChange server settings
@css/configRun config files
@css/passwordSet the server password
@css/rconRun any server command
@css/cheatsTurn on sv_cheats and use cheat commands
@css/reservationReserved slot
@css/vipMarks VIPs for VIP plugins
@css/rootEverything, and ignores immunity

Plugins can add their own flags, written like @pluginname/something. They're listed on the plugin's page.

Immunity#

immunity is a number. An admin can't use commands like kick or ban on another admin with higher immunity. Give the owner and head admins higher numbers than moderators (for example 100, 70, 50).

Use groups#

With more than a few admins, put the flags in groups and give people a group instead. Groups go in:

game/csgo/addons/counterstrikesharp/configs/admin_groups.json
configs/admin_groups.jsonjson
{
  "#moderator": {
    "flags": ["@css/generic", "@css/kick", "@css/slay", "@css/chat", "@css/vote"],
    "immunity": 50
  },
  "#admin": {
    "flags": ["@css/generic", "@css/kick", "@css/ban", "@css/unban", "@css/slay", "@css/chat", "@css/vote", "@css/changemap"],
    "immunity": 70
  }
}

Group names must start with #, or CounterStrikeSharp ignores them. Then in admins.json, give admins a group with groups:

configs/admins.jsonjson
{
  "Andrei": {
    "identity": "76561198000000002",
    "groups": ["#moderator"]
  }
}

An admin can be in several groups and gets the flags of all of them, plus any flags you add to them directly.

Install CS2-SimpleAdmin#

CounterStrikeSharp only defines who is admin. To get !kick, !ban, !map and an admin menu, install an admin plugin. CS2-SimpleAdmin is the most used.

  1. 1Install what it needs

    CS2-SimpleAdmin needs three other plugins. Install them first, each in its own folder under addons/counterstrikesharp/plugins/:

    PluginWhy
    AnyBaseLibCS2Needed by PlayerSettings
    PlayerSettingsNeeded by MenuManagerCS2
    MenuManagerCS2Draws the admin menu
  2. 2Install CS2-SimpleAdmin

    Download it from the CS2-SimpleAdmin releases and copy it into plugins like any CS# plugin. Not sure how? See installing CS2 plugins.

  3. 3Choose where bans are stored

    On its first start it creates its settings file:

    addons/counterstrikesharp/configs/plugins/CS2-SimpleAdmin/CS2-SimpleAdmin.json

    By default it uses SQLite: bans and admins are saved in a file on the server, with nothing to set up. For several servers that share bans, switch to MySQL in the DatabaseConfig part:

    CS2-SimpleAdmin.jsonjson
    "DatabaseConfig": {
      "DatabaseType": "MySQL",
      "DatabaseHost": "db.example.com",
      "DatabasePort": 3306,
      "DatabaseUser": "cs2admin",
      "DatabasePassword": "your-db-password",
      "DatabaseName": "cs2admin"
    }
  4. 4Restart and check

    Restart the server and type css_plugins list. CS2-SimpleAdmin and the three plugins it needs should all be loaded. Watch the console for database errors on start.

CS2-SimpleAdmin commands#

In chat, start commands with ! (for example !kick). In the console, use the full css_ name. A #userid is the number shown by status or css_players.

CommandWhat it doesNeeds
css_adminOpens the admin menu@css/generic
css_adminhelpLists the commands you can use@css/generic
css_playersLists players with their #userid@css/generic
css_kick <#userid or name> [reason]Kicks a player@css/kick
css_ban <#userid or name> [minutes] [reason]Bans a player; 0 minutes is permanent@css/ban
css_addban <steamid> [minutes] [reason]Bans a player who isn't on the server@css/ban
css_unban <steamid, name or ip>Removes a ban@css/unban
css_mute / css_gag / css_silenceBlocks voice, chat, or both@css/chat
css_slay <#userid or name>Kills a player@css/slay
css_map <map>Changes the map@css/changemap
css_wsmap <name or id>Changes to a Workshop map@css/changemap
css_rcon <command>Runs a server command@css/rcon

Admins in SimpleAdmin's database#

CS2-SimpleAdmin can also keep admins in its own database, so you can add them from the console without editing files:

bash
css_addadmin 76561198000000002 "Andrei" "#moderator" 50 0

The parts are: SteamID, name, flags or group, immunity, and duration in minutes (0 = permanent). Remove one with css_deladmin <steamid> and reload with css_reloadadmins. You can use this, admins.json, or both.

Troubleshooting#

Commands say I have no access#

  • The identity is wrong: check it with the SteamID tool above. Use your SteamID64, not your profile name.
  • The admin has no @css/generic, which most commands need.
  • The file wasn't reloaded: restart the server or run css_admins_reload.

Nobody is admin anymore#

The JSON is broken, usually a missing or extra comma. Check admins.json and admin_groups.json with a JSON validator.

A group doesn't work#

Its name doesn't start with #, or the admin's groups has a different spelling.

CS2-SimpleAdmin doesn't load#

Usually one of the three plugins it needs is missing or outdated. Check that AnyBaseLibCS2, PlayerSettings and MenuManagerCS2 are in css_plugins list, and that CounterStrikeSharp is up to date.

Database errors on start (MySQL)#

Check the host, user, password and database name in CS2-SimpleAdmin.json. On game hosting, the database is usually on another machine, so localhost won't work; use the host your provider gives you.

FAQ#

How do I make myself admin on a CS2 server?#

Add your SteamID64 with the @css/root flag to addons/counterstrikesharp/configs/admins.json, then restart the server.

Does CS2 have admin commands without plugins?#

Only server commands through the console or RCON. In-game commands like !kick and !ban, and the admin menu, come from plugins such as CS2-SimpleAdmin.

What's the difference between flags and groups?#

Flags are single permissions. Groups are named sets of flags (names start with #), so you can give the same rights to many admins at once.

What does immunity do?#

It stops admins from acting on admins with higher immunity. @css/root ignores it.

Next steps#

  • Find more CS2 plugins in the plugin library
  • Put your server on XCSTRIKE so players can find it:
Add your serverList your server on XCSTRIKE and get players.Open
Was this guide helpful?
Thanks for the feedback!
Stuck on a step?Ask other server admins on the forum. Say which guide and which step.
Ask on the forum

More CS2 guides

CS2 Practice Server: Config and Commands (2026)