Difference between revisions of "Admin Commands (SourceMod)"

From AlliedModders Wiki
Jump to: navigation, search
(reorganized command list)
Line 28: Line 28:
 
These are basic commands found in plugins that have been deemed safe for [[War_Mode_(SourceMod)|War Mode]]; they provide simple functionality for administering your server.
 
These are basic commands found in plugins that have been deemed safe for [[War_Mode_(SourceMod)|War Mode]]; they provide simple functionality for administering your server.
  
:{|
+
:{| cellpadding="6"
 
|- class="t2th"
 
|- class="t2th"
 
| Command
 
| Command
 
| Plugin
 
| Plugin
 +
| Access
 
| Format
 
| Format
| Access
 
 
| Description
 
| Description
 
|- class="t2td"
 
|- class="t2td"
 
| sm_addban
 
| sm_addban
 
| basebans
 
| basebans
 +
| rcon
 
| <time> <steamid> [reason]
 
| <time> <steamid> [reason]
| rcon
 
 
| Adds a Steam ID to Source's ban list.
 
| Adds a Steam ID to Source's ban list.
 
|- class="t2td"
 
|- class="t2td"
 
| sm_admin
 
| sm_admin
 
| adminmenu
 
| adminmenu
 +
| admin
 
|
 
|
| admin
 
 
| Displays the [[Admin Menu (SourceMod)|admin menu]].
 
| Displays the [[Admin Menu (SourceMod)|admin menu]].
 
|- class="t2td"
 
|- class="t2td"
 
| sm_ban
 
| sm_ban
 
| basebans
 
| basebans
 +
| ban
 
| <nowiki><#userid|name> <minutes|0> </nowiki>[reason]
 
| <nowiki><#userid|name> <minutes|0> </nowiki>[reason]
| ban
 
 
| Bans a client.
 
| Bans a client.
 
|- class="t2td"
 
|- class="t2td"
 
| sm_banip
 
| sm_banip
 
| basebans
 
| basebans
 +
| ban
 
| <time> <ip|#userid|name> [reason]
 
| <time> <ip|#userid|name> [reason]
| rcon for ip, ban for player
+
| Adds an IP address to Source's ban list.  Only someone with <tt>rcon</tt> access can ban an arbitrary IP.
| Adds an IP address to Source's ban list.
 
 
|- class="t2td"
 
|- class="t2td"
 
| sm_cancelvote
 
| sm_cancelvote
 
| basecommands
 
| basecommands
 +
| vote
 
|
 
|
| vote
 
 
| Cancels any vote in progress.
 
| Cancels any vote in progress.
 
|- class="t2td"
 
|- class="t2td"
 
| sm_cvar
 
| sm_cvar
 
| basecommands
 
| basecommands
 +
| cvar
 
| <cvar> [value]
 
| <cvar> [value]
| cvar
 
 
| Retrieves or changes a cvar value.  Protected cvars can only be accessed with rcon access, and sv_cheats can only be accessed with cheat access.
 
| Retrieves or changes a cvar value.  Protected cvars can only be accessed with rcon access, and sv_cheats can only be accessed with cheat access.
 
|- class="t2td"
 
|- class="t2td"
 
| sm_execcfg
 
| sm_execcfg
 
| basecommands
 
| basecommands
 +
| config
 
| <filename>
 
| <filename>
| config
 
 
| Executes a config file (path not needed, but extension is).
 
| Executes a config file (path not needed, but extension is).
 
|- class="t2td"
 
|- class="t2td"
 
| sm_help
 
| sm_help
 
| adminhelp
 
| adminhelp
 +
| admin
 
| [page|search]
 
| [page|search]
| admin
 
 
| 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.
 
| 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.
 
|- class="t2td"
 
|- class="t2td"
 
| sm_kick
 
| sm_kick
 
| basecommands
 
| basecommands
 +
| kick
 
| <nowiki><#userid|name></nowiki> [reason]
 
| <nowiki><#userid|name></nowiki> [reason]
| kick
 
 
| Kicks a player.
 
| Kicks a player.
 
|- class="t2td"
 
|- class="t2td"
 
| sm_map
 
| sm_map
 
| basecommands
 
| basecommands
 +
| map
 
| <map>
 
| <map>
| map
 
 
| Changes the current map.
 
| Changes the current map.
 
|- class="t2td"
 
|- class="t2td"
 
| sm_rcon
 
| sm_rcon
 
| basecommands
 
| basecommands
 +
| rcon
 
| <argstring>
 
| <argstring>
| rcon
 
 
| Executes the argument string via rcon.  Due to Source limitations, you cannot see any RCON output.
 
| Executes the argument string via rcon.  Due to Source limitations, you cannot see any RCON output.
 
|- class="t2td"
 
|- class="t2td"
 
| sm_reloadadmins
 
| sm_reloadadmins
 
| basecommands
 
| basecommands
 +
| config
 
|
 
|
| config
 
 
| Refreshes the Admin cache from all sources.
 
| Refreshes the Admin cache from all sources.
 
|- class="t2td"
 
|- class="t2td"
 
| sm_unban
 
| sm_unban
 
| basebans
 
| basebans
 +
| unban
 
| <steamid>
 
| <steamid>
| unban
 
 
| Unbans a Steam ID.
 
| Unbans a Steam ID.
 
|- class="t2td"
 
|- class="t2td"
 
| sm_who
 
| sm_who
 
| basecommands
 
| basecommands
 +
| admin
 
| <nowiki>[#userid|name]</nowiki>
 
| <nowiki>[#userid|name]</nowiki>
| admin
 
 
| Lists all users and their access rights, or a specific user's access rights.
 
| 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 [http://bugs.alliedmods.net/index.php?project=5&do=index feature request].
 +
 +
:{| cellpadding="4"
 +
|- class="t2th"
 +
| Command
 +
| Plugin
 +
| Access
 +
| Format
 +
| Description
 +
|- class="t2td"
 +
| sm_gag
 +
| basecomm
 +
| chat
 +
| &lt;target>
 +
| Prevents the target(s) from using messagemode/say chat.
 +
|- class="t2td"
 +
| sm_mute
 +
| basecomm
 +
| chat
 +
| &lt;target>
 +
| Prevents the target(s) from using voice chat.
 +
|- class="t2td"
 +
| sm_silence
 +
| basecomm
 +
| chat
 +
| &lt;target>
 +
| Performs both a gag and mute on the target(s).
 +
|- class="t2td"
 +
| sm_ungag
 +
| basecomm
 +
| chat
 +
| &lt;target>
 +
| Allows the target(s) to use messagemode/say chat again.
 +
|- class="t2td"
 +
| sm_unmute
 +
| basecomm
 +
| chat
 +
| &lt;target>
 +
| Allows the target(s) to use voice chat again.
 +
|- class="t2td"
 +
| sm_unsilence
 +
| basecomm
 +
| chat
 +
| &lt;target>
 +
| Perfoms both an ungag and unmute on the target(s).
 +
|}
 +
 +
  
 
[[Category:SourceMod Documentation]]
 
[[Category:SourceMod Documentation]]

Revision as of 12:20, 16 December 2007

This page lists all of the major admin commands in SourceMod.

Chat Triggers: Remember that commands do not have to be entered through the console; they can be entered via chat triggers. For example, saying "!ban bail" in chat will execute the same command as "sm_ban" and forward the output to chat. You can also use "/" instead of "!" to suppress your command from being shown to users.

How to Target

General targets:

  • 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).
  • @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).
  • @humans - All non-bot players (available on most commands).
  • @aim - Current player the admin is directly aiming at.

Counter-Strike only:

  • @ct or @cts - All Counter-Terrorists
  • @t or @ts - All Terrorists


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.

Command Plugin Access Format Description
sm_addban basebans rcon 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 #userid|name> [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 rcon access, and sv_cheats can only be accessed with cheat access.
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. Due to Source limitations, you cannot see any RCON output.
sm_reloadadmins basecommands config Refreshes the Admin cache from all sources.
sm_unban basebans unban <steamid> Unbans a Steam ID.
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.

Command Plugin Access Format Description
sm_gag basecomm chat <target> Prevents the target(s) from using messagemode/say chat.
sm_mute basecomm chat <target> Prevents the target(s) from using voice chat.
sm_silence basecomm chat <target> Performs both a gag and mute on the target(s).
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).