Admin Commands (SourceMod)

Overview

A guide for server Admin Commandsm, hope this could help with your server.

How to Target

• name

  – Exact name match, or partial name match (if the partial string is unique).

• #userid

  – If userid is numeric, the player will be targeted by their userid (found via the “users” command).

• #steamid

  – Matches by Steam ID. If you use colons (:), you must enclose in quotes. Otherwise, you can use an underscore (_) instead. Examples: “#STEAM_0:1:4433”, #STEAM_0_1_4433

• #<name>

  – Exact name match after the # sign.

• @all

  – All players (available on most commands).

• @bots

  – All bots (available on most commands).

• @alive

  – All alive players (available on most commands that accept alive players).

• @dead

  – All dead players (available on most commands that accept dead players).

• @aim

  – Current player the admin is directly aiming at.

• @me

  – Target self.

• @!me

  – Target everyone but yourself.

• Note that name matches occur last, “magic targets” (such as # and @) are processed first. This means that “@all” will target @all players, even if there is a player named “@all”. You should target “#@all” instead.

Basic Commands

These are basic commands found in plugins that have been deemed safe for War Mode; they provide simple functionality for administering your server.

• sm_addban

  basebans rcon <steamid> [reason] Adds a Steam ID to Source’s ban list.

• sm_admin

  adminmenu admin Displays the admin menu.

• sm_ban

  basebans ban <#userid|name> <minutes|0> [reason] Bans a client.

• sm_banip

  basebans ban <ip|#userid|name> <time> [reason] Adds an IP address to Source’s ban list. Only someone with rcon access can ban an arbitrary IP.

• sm_cancelvote

  basecommands vote Cancels any vote in progress.

• sm_cvar

  basecommands cvar <cvar> [value] Retrieves or changes a cvar value. Protected cvars can only be accessed with password access, and sv_cheats can only be accessed with cheat access. To add a cvar to the protected list (which by default contains all cvars flagged PROTECTED, rcon_password, sm_show_activity, and sm_immunity_mode), use sm_cvar protect <name>.

• sm_execcfg

  basecommands config <filename> Executes a config file (path not needed, but extension is).

• sm_help

  adminhelp admin search] Lists all admin commands. Output is paginated and a page number can be specified. Alternately, a search term can be specified to search for a specific command.

• sm_kick

  basecommands kick <#userid|name> [reason] Kicks a player.

• sm_map

  basecommands map <map> Changes the current map.

• sm_rcon

  basecommands rcon <argstring> Executes the argument string via rcon. You will only see RCON output on SourceMod 1.4 or above.

• sm_reloadadmins

  basecommands config Refreshes the Admin cache from all sources.

• sm_unban

  basebans unban <steamid|ip> Unbans a Steam ID or an IP.

• sm_who

  basecommands admin [#userid|name] Lists all users and their access rights, or a specific user’s access rights.

Extended Commands

These commands provide extended functionality that may not be present on all games, either due to game or engine differences. In general, they work on the most popular mods. If you have a mod which is new, or not supported yet due to lower popularity, file a feature request.

• sm_beacon

  funcommands slay <target> Adds a ring around each target, making them easily visible.

• sm_burn

  funcommands slay <target> [time] Sets the target(s) on fire for the specified amount of time. This may or may not work fully on certain games (for example, TF2 is missing the fire sprite, but clients will bleed/lose health). If specified, burning effect will stop after the [time] seconds.

• sm_chat

  basechat chat <message> Sends a say-chat message to all admins.

• sm_csay

  basechat chat <message> Sends a centered message to all players.

• sm_gag

  basecomm chat <target> Prevents the target(s) from using messagemode/say chat.

• sm_hsay

  basechat chat <message> Sends a message to all players via a center-bottom hint box.

• sm_msay

  basechat chat <message> Sends a message as a menu panel (only meaningful on games that support radio menus).

• sm_mute

  basecomm chat <target> Prevents the target(s) from using voice chat.

• sm_play

  sounds admin <target> <file> Plays a sound file on the server to each target.

• sm_psay

  basechat chat <target> <message> Sends a private chat message to a single target.

• sm_rename

  playercommands slay <#userid|name> Changes the name of a player.

• sm_resetcvar

  basecommands cvar <cvar> Resets CVAR value back to default.

• sm_say

  basechat chat <message> Sends a say-chat message to all players.

• sm_silence

  basecomm chat <target> Performs both a gag and mute on the target(s).

• sm_slap

  playercommands slay <target> [damage] “Slaps” a player, emitting a noise and throwing them in a random direction. If specified, the damage amount will be subtracted from each target’s health.

• sm_slay

  playercommands slay <target> Kills a player.

• sm_tsay

  basechat chat [color] <message> Sends a top-left message to all players. If no color is specified, the text will be white. Colors available are: white, red, green, blue, yellow, purple, cyan, orange, pink, olive, lime, violet, lightblue. The names are not case sensitive.

• sm_ungag

  basecomm chat <target> Allows the target(s) to use messagemode/say chat again.

• sm_unmute

  basecomm chat <target> Allows the target(s) to use voice chat again.

• sm_unsilence

  basecomm chat <target> Perfoms both an ungag and unmute on the target(s).

Vote Commands

These commands are listed separately as they are all related to voting. None of them are available in war mode by default.

• sm_vote

  basevotes vote <question> [answer1] [answer2] [answer3] … Starts an arbitrary vote with the given arguments as answers. If no answer parameters are supplied, the answer options will be Yes and No localized into each client’s language.

• sm_votealltalk

  funvotes vote Starts a vote to change the value of sv_alltalk.

• sm_voteban

  basevotes vote, ban <target> [reason] Starts a vote to ban a single player for thirty minutes.

• sm_voteburn

  funvotes vote, slay <target> Starts a vote to burn a single player.

• sm_voteff

  funvotes vote Starts a vote to change the value of mp_friendlyfire.

• sm_votegravity

  funvotes vote <amount> [amount2] [amount3] … Initiates a vote to change the value of sv_gravity.

• sm_votekick

  basevotes vote, kick <target> [reason] Starts a vote to kick a single player.

• sm_votemap

  basevotes vote, map <map> [map2] [map3] … Starts a vote to change the map.

• sm_voteslay

  funvotes vote, slay <target> Starts a vote to slay a single player.