Astra
71d51d7b92
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.
656 lines
11 KiB
Markdown
656 lines
11 KiB
Markdown
---
|
|
sidebar_position: 3
|
|
---
|
|
|
|
# Base Commands
|
|
|
|
Core admin commands for server management and admin system.
|
|
|
|
## Player Information
|
|
|
|
### Show Penalties
|
|
|
|
View your own active penalties.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
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 name
|
|
- `immunity` - Immunity level (0-100, higher = more protection)
|
|
- `duration` - Duration in minutes (0 = permanent)
|
|
|
|
**Examples:**
|
|
```bash
|
|
# 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.
|
|
|
|
```bash
|
|
css_deladmin <steamid>
|
|
```
|
|
|
|
**Permission:** `@css/root`
|
|
|
|
**Examples:**
|
|
```bash
|
|
# 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.
|
|
|
|
```bash
|
|
css_addgroup <group_name> <flags> <immunity>
|
|
```
|
|
|
|
**Permission:** `@css/root`
|
|
|
|
**Parameters:**
|
|
- `group_name` - Name of the group (e.g., "#moderators")
|
|
- `flags` - Permission flags for the group
|
|
- `immunity` - Default immunity level for group members
|
|
|
|
**Examples:**
|
|
```bash
|
|
# 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.
|
|
|
|
```bash
|
|
css_delgroup <group_name>
|
|
```
|
|
|
|
**Permission:** `@css/root`
|
|
|
|
**Examples:**
|
|
```bash
|
|
# 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.
|
|
|
|
```bash
|
|
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).
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
css_who <#userid or name>
|
|
```
|
|
|
|
**Permission:** `@css/generic`
|
|
|
|
**Shows:**
|
|
- Player name and SteamID
|
|
- IP address (if you have `@css/showip` permission)
|
|
- Connection time
|
|
- Active penalties
|
|
- Warning count
|
|
- Ban history
|
|
|
|
**Examples:**
|
|
```bash
|
|
css_who #123
|
|
css_who PlayerName
|
|
css_who @me
|
|
```
|
|
|
|
---
|
|
|
|
### Show Disconnected Players
|
|
|
|
Show recently disconnected players.
|
|
|
|
```bash
|
|
css_disconnected
|
|
css_last
|
|
css_last10 # Show last 10 (config value)
|
|
```
|
|
|
|
**Permission:** `@css/kick`
|
|
|
|
**Shows:**
|
|
- Player name
|
|
- SteamID
|
|
- Disconnect time
|
|
- Disconnect reason
|
|
|
|
**Configuration:**
|
|
```json
|
|
"DisconnectedPlayersHistoryCount": 10
|
|
```
|
|
|
|
---
|
|
|
|
### Show Warns for Player
|
|
|
|
Open warn list for a specific player.
|
|
|
|
```bash
|
|
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:**
|
|
```bash
|
|
css_warns #123
|
|
css_warns PlayerName
|
|
```
|
|
|
|
---
|
|
|
|
### Show Penalty History
|
|
|
|
Print every past and current penalty for a player to your console.
|
|
|
|
```bash
|
|
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:**
|
|
```bash
|
|
css_history #123
|
|
css_history PlayerName bans
|
|
css_history 76561198012345678
|
|
```
|
|
|
|
---
|
|
|
|
### Show Online Players
|
|
|
|
Show information about all online players.
|
|
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
css_kick <#userid or name> [reason]
|
|
```
|
|
|
|
**Permission:** `@css/kick`
|
|
|
|
**Examples:**
|
|
```bash
|
|
css_kick #123 "AFK"
|
|
css_kick PlayerName "Rule violation"
|
|
css_kick @spec "Cleaning spectators"
|
|
```
|
|
|
|
**Configuration:**
|
|
```json
|
|
"KickTime": 5
|
|
```
|
|
Delay in seconds before kicking (allows player to see the reason).
|
|
|
|
---
|
|
|
|
### Change Map
|
|
|
|
Change to a different map.
|
|
|
|
```bash
|
|
css_map <mapname>
|
|
css_changemap <mapname>
|
|
```
|
|
|
|
**Permission:** `@css/changemap`
|
|
|
|
**Examples:**
|
|
```bash
|
|
css_map de_dust2
|
|
css_changemap de_mirage
|
|
```
|
|
|
|
**Configuration:**
|
|
```json
|
|
"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.
|
|
|
|
```bash
|
|
css_wsmap <name or id>
|
|
css_changewsmap <name or id>
|
|
css_workshop <name or id>
|
|
```
|
|
|
|
**Permission:** `@css/changemap`
|
|
|
|
**Examples:**
|
|
```bash
|
|
css_wsmap 123456789
|
|
css_wsmap aim_map
|
|
```
|
|
|
|
**Configuration:**
|
|
```json
|
|
"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.
|
|
|
|
```bash
|
|
css_cvar <cvar> <value>
|
|
```
|
|
|
|
**Permission:** `@css/cvar`
|
|
|
|
**Examples:**
|
|
```bash
|
|
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.
|
|
|
|
```bash
|
|
css_rcon <command>
|
|
```
|
|
|
|
**Permission:** `@css/rcon`
|
|
|
|
**Examples:**
|
|
```bash
|
|
css_rcon status
|
|
css_rcon changelevel de_dust2
|
|
css_rcon sv_cheats 1
|
|
```
|
|
|
|
**Warning:** Extremely powerful command. Only grant to server owners.
|
|
|
|
**Configuration:**
|
|
```json
|
|
"DisableDangerousCommands": true
|
|
```
|
|
|
|
When enabled, prevents execution of dangerous commands via css_rcon.
|
|
|
|
---
|
|
|
|
### Restart Game
|
|
|
|
Restart the current game/round.
|
|
|
|
```bash
|
|
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
|
|
|
|
```json
|
|
"ReloadAdminsEveryMapChange": false
|
|
```
|
|
|
|
**Options:**
|
|
- `true` - Reload admin permissions every map change
|
|
- `false` - Only reload when explicitly requested (better performance)
|
|
|
|
### Show Activity Type
|
|
|
|
```json
|
|
"ShowActivityType": 2
|
|
```
|
|
|
|
**Options:**
|
|
- `0` - Hide all admin activity
|
|
- `1` - Show activity anonymously ("An admin banned PlayerName")
|
|
- `2` - Show admin name ("AdminName banned PlayerName")
|
|
|
|
---
|
|
|
|
## Best Practices
|
|
|
|
### Admin Management
|
|
|
|
1. **Use groups** - Easier to manage than individual permissions
|
|
2. **Set appropriate immunity** - Prevent abuse
|
|
3. **Time-limited admin** - For trial moderators
|
|
4. **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
|
|
|
|
1. **Limit @css/rcon** - Only to server owner
|
|
2. **Limit @css/cvar** - Only to senior admins
|
|
3. **Monitor admin actions** - Review logs regularly
|
|
4. **Use time-limited admin** - For temporary staff
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### Admin permissions not working
|
|
|
|
**Check:**
|
|
1. Is admin correctly added with `css_addadmin`?
|
|
2. Run `css_reloadadmins`
|
|
3. Check database connection
|
|
4. 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](basebans)** - Player punishment
|
|
- **[Communication Commands](basecomms)** - Chat/voice management
|
|
- **[Player Commands](playercommands)** - Player manipulation
|