View source for ServerCmd()

'''<code>ServerCmd()</code>''' is a quick and easy method for passing user input to the server available through <code>[[cbase.h]]</code>. It uploads an [[Wikipedia:ASCII|ASCII]] string, including with it information about which connected client sent it. The received strings are processed in <code>ClientCommand()</code> as a <code>[[CCommand]]</code> (i.e. a string array where 0 is the command itself and 1+ are parameters).

{{tip|You can also trigger a <code>[[Developer_Console_Control#Using_the_ConCommand_class|ConCommand]]</code> if the client's argument matches its name.}}

{{warning|Since <code>ServerCmd()</code> passes a full string value, it is NOT suitable for commands that will be sent frequently. You might get away with it in single-player, but in a multi-player mod you should transmit frequent commands by modifying the [[Usercmd]].}}

==Example==
 ''client:''
 	[[engine]]->ServerCmd( [[VarArgs()|VarArgs]]<span style="color:gray;">("MyCommand %i", m_iMyNumber)</span> ); ''// No variables? Pass the command as a simple string.''
 ''server:''
 	bool [[CBasePlayer]]::ClientCommand( const CCommand &args )
 	{
 		if ( ![[V_stricmp()|V_stricmp]]( args[0], "MyCommand" ) )
 		{
 			[[Msg()|Msg]]( "MyCommand received! Value: %i\n", [[atoi()|atoi]](args[1]) );
 			return true;
 		}
 	}

==See also==
*[[cl_restrict_server_commands]]
*[[Usercmd]]

[[Category:Functions]]
[[Category:Networking]]