From upstream 530f603: - css_unban updates the ban cache at once (and clears the engine banid with UnlockedCommands) instead of waiting up to a minute for the cache refresh. - css_prename is saved in sa_renames (migration 017) and re-applied on connect and name change, so it survives restarts. css_rename from a hidden admin renames again. - New css_history command and Players > History menu entry. Commands missing from an existing Commands.json are registered under their default name. - Migrations are copied with a glob, so 017 reaches the build output. Upstream's admin-loading changes, css_say change and css_penalties fix are left out.
11 KiB
| sidebar_position |
|---|
| 3 |
Base Commands
Core admin commands for server management and admin system.
Player Information
Show Penalties
View your own active penalties.
css_penalties
css_mypenalties
css_comms
Permission: None (all players)
Shows:
- Active bans
- Active communication restrictions (gag, mute, silence)
- Warning count
- Duration remaining
Hide Penalty Notifications
Hide penalty notifications when you connect to the server.
css_hidecomms
Permission: @css/kick
Notes:
- Toggle on/off
- Admins won't see penalty notifications on join
- Useful for admin privacy
Admin Menu
Open Admin Menu
Opens the main admin menu interface.
css_admin
Permission: @css/generic
Features:
- Player management
- Server management
- Ban/kick/mute players via menu
- Map changing
- Custom server commands
Admin Help
Print the admin help file.
css_adminhelp
Permission: @css/generic
Shows:
- Available commands for your permission level
- Command syntax
- Permission requirements
Admin Management
Add Admin
Add a new admin to the database.
css_addadmin <steamid> <name> <flags/groups> <immunity> <duration>
Permission: @css/root
Parameters:
steamid- Player's SteamID (any format)name- Admin name (for identification)flags/groups- Permission flags or group nameimmunity- Immunity level (0-100, higher = more protection)duration- Duration in minutes (0 = permanent)
Examples:
# Add permanent admin with root access
css_addadmin 76561198012345678 "AdminName" "@css/root" 99 0
# Add moderator for 30 days
css_addadmin STEAM_1:0:12345678 "ModName" "@css/kick,@css/ban" 50 43200
# Add admin using group
css_addadmin 76561198012345678 "AdminName" "#moderators" 60 0
# Add admin to all servers (-g flag)
css_addadmin 76561198012345678 "AdminName" "@css/root" 99 0 -g
Flags:
-g- Add to all servers (global admin)
Delete Admin
Remove an admin from the database.
css_deladmin <steamid>
Permission: @css/root
Examples:
# Remove admin from current server
css_deladmin 76561198012345678
# Remove admin from all servers (-g flag)
css_deladmin 76561198012345678 -g
Add Admin Group
Create a new admin group.
css_addgroup <group_name> <flags> <immunity>
Permission: @css/root
Parameters:
group_name- Name of the group (e.g., "#moderators")flags- Permission flags for the groupimmunity- Default immunity level for group members
Examples:
# Create moderator group
css_addgroup "#moderators" "@css/kick,@css/ban,@css/chat" 50
# Create VIP group
css_addgroup "#vip" "@css/vip" 10
# Create global group (-g flag)
css_addgroup "#owner" "@css/root" 99 -g
Flags:
-g- Create group on all servers
Delete Admin Group
Remove an admin group from the database.
css_delgroup <group_name>
Permission: @css/root
Examples:
# Delete group from current server
css_delgroup "#moderators"
# Delete group from all servers (-g flag)
css_delgroup "#moderators" -g
Reload Admins
Reload admin permissions from the database.
css_reloadadmins
Permission: @css/root
When to use:
- After adding/removing admins via database
- After modifying admin permissions
- After group changes
- Troubleshooting permission issues
Note: Admins are automatically reloaded periodically and on map change (if configured).
Player Information
Hide in Scoreboard
Toggle admin stealth mode (hide from scoreboard).
css_hide
css_stealth
Permission: @css/kick
Features:
- Hides you from the scoreboard
- Makes admin actions anonymous
- Useful for undercover moderation
Who is This Player
Show detailed information about a player.
css_who <#userid or name>
Permission: @css/generic
Shows:
- Player name and SteamID
- IP address (if you have
@css/showippermission) - Connection time
- Active penalties
- Warning count
- Ban history
Examples:
css_who #123
css_who PlayerName
css_who @me
Show Disconnected Players
Show recently disconnected players.
css_disconnected
css_last
css_last10 # Show last 10 (config value)
Permission: @css/kick
Shows:
- Player name
- SteamID
- Disconnect time
- Disconnect reason
Configuration:
"DisconnectedPlayersHistoryCount": 10
Show Warns for Player
Open warn list for a specific player.
css_warns <#userid or name>
Permission: @css/kick
Shows:
- All warnings for the player
- Warning reasons
- Admins who issued warnings
- Warning timestamps
- Total warning count
Examples:
css_warns #123
css_warns PlayerName
Show Penalty History
Print every past and current penalty for a player to your console.
css_history <#userid or name or steamid64> [bans|gags|mutes|silences|warns]
Permission: @css/kick
Shows:
- Bans, gags, mutes, silences and warns, newest first
- Status (active, expired, unbanned, unmuted), duration and reason
- Admin who issued it
- Who lifted it, when and why, for unbans and unmutes
Notes:
- Accepts a SteamID64, so it works for players who are not online
- The optional second argument narrows the list to one penalty type
- Also available in the admin menu under Players > History
Examples:
css_history #123
css_history PlayerName bans
css_history 76561198012345678
Show Online Players
Show information about all online players.
css_players
Permission: @css/generic
Shows:
- List of all connected players
- UserIDs
- Names
- Teams
- Connection status
Server Management
Kick Player
Kick a player from the server.
css_kick <#userid or name> [reason]
Permission: @css/kick
Examples:
css_kick #123 "AFK"
css_kick PlayerName "Rule violation"
css_kick @spec "Cleaning spectators"
Configuration:
"KickTime": 5
Delay in seconds before kicking (allows player to see the reason).
Change Map
Change to a different map.
css_map <mapname>
css_changemap <mapname>
Permission: @css/changemap
Examples:
css_map de_dust2
css_changemap de_mirage
Configuration:
"DefaultMaps": [
"de_dust2",
"de_mirage",
"de_inferno"
]
Maps in this list appear in the map change menu.
Change Workshop Map
Change to a workshop map by ID or name.
css_wsmap <name or id>
css_changewsmap <name or id>
css_workshop <name or id>
Permission: @css/changemap
Examples:
css_wsmap 123456789
css_wsmap aim_map
Configuration:
"WorkshopMaps": {
"aim_map": "123456789",
"surf_map": "987654321"
}
Maps configured here can be changed by name instead of ID.
Change CVar
Change a server console variable.
css_cvar <cvar> <value>
Permission: @css/cvar
Examples:
css_cvar sv_cheats 1
css_cvar mp_roundtime 5
css_cvar mp_maxmoney 16000
Warning: This is a powerful command. Only grant to trusted admins.
Execute RCON Command
Execute any command as the server.
css_rcon <command>
Permission: @css/rcon
Examples:
css_rcon status
css_rcon changelevel de_dust2
css_rcon sv_cheats 1
Warning: Extremely powerful command. Only grant to server owners.
Configuration:
"DisableDangerousCommands": true
When enabled, prevents execution of dangerous commands via css_rcon.
Restart Game
Restart the current game/round.
css_rr
css_rg
css_restart
css_restartgame
Permission: @css/generic
Notes:
- Restarts the current round
- Score is reset
- Players remain connected
Permission Flags
Common permission flags used in CS2-SimpleAdmin:
| Flag | Description | Common Use |
|---|---|---|
@css/generic |
Generic admin access | Basic admin menu, info commands |
@css/chat |
Chat management | Gag, mute, silence |
@css/kick |
Kick players | Kick, warnings, player info |
@css/ban |
Ban players | Ban, banip, addban |
@css/unban |
Unban players | Remove bans |
@css/permban |
Permanent bans | Issue permanent bans |
@css/changemap |
Change maps | Map changing |
@css/cvar |
Change cvars | Server variable modification |
@css/rcon |
Execute rcon | Full server control |
@css/root |
Root access | All permissions, admin management |
@css/slay |
Slay/respawn | Player manipulation |
@css/cheats |
Cheat commands | God mode, noclip, give weapons |
@css/showip |
View IPs | See player IP addresses |
Immunity System
Immunity prevents lower-level admins from targeting higher-level admins.
How it works:
- Each admin has an immunity value (0-100)
- Higher immunity = more protection
- Admins can only target players with lower immunity
Example:
- Admin A has immunity 50
- Admin B has immunity 30
- Admin A can ban Admin B
- Admin B cannot ban Admin A
Best Practice:
- Owner: 99
- Senior admins: 80-90
- Moderators: 50-70
- Trial mods: 20-40
- Regular players: 0
Configuration Options
Reload Admins on Map Change
"ReloadAdminsEveryMapChange": false
Options:
true- Reload admin permissions every map changefalse- Only reload when explicitly requested (better performance)
Show Activity Type
"ShowActivityType": 2
Options:
0- Hide all admin activity1- Show activity anonymously ("An admin banned PlayerName")2- Show admin name ("AdminName banned PlayerName")
Best Practices
Admin Management
- Use groups - Easier to manage than individual permissions
- Set appropriate immunity - Prevent abuse
- Time-limited admin - For trial moderators
- Document changes - Keep track of who has what permissions
Permission Assignment
Recommended hierarchy:
Root (@css/root, immunity 99):
- Server owners only
Senior Admin (@css/ban,@css/kick,@css/chat,@css/changemap, immunity 80):
- Trusted long-term admins
Moderator (@css/kick,@css/chat, immunity 50):
- Regular moderators
Trial Mod (@css/kick, immunity 20):
- New moderators on probation
Security
- Limit @css/rcon - Only to server owner
- Limit @css/cvar - Only to senior admins
- Monitor admin actions - Review logs regularly
- Use time-limited admin - For temporary staff
Troubleshooting
Admin permissions not working
Check:
- Is admin correctly added with
css_addadmin? - Run
css_reloadadmins - Check database connection
- Verify SteamID format
Can't target another admin
Check:
- Your immunity level vs target's immunity
- You need equal or higher immunity to target
Commands not available
Check:
- Your permission flags
- Commands.json for disabled commands
- Server console for errors
Related Commands
- Ban Commands - Player punishment
- Communication Commands - Chat/voice management
- Player Commands - Player manipulation