Difference between revisions of "SendServerCommand"

Latest revision as of 23:06, 16 June 2007

et.trap_SendServerCommand() is used to send a command from the server to one or more clients. The first argument is the slot number of the client the command will be sent to. If it's equal to -1, the command will be broadcast to all clients.

The following commands can be issued with this function:

Printing

Print

• "print \"Message\n\""

print prints Message to the client's console.

Center Print MoO

• "cpm \"Message\n\""
  

cpm prints Message to the client's annoucement area and console.

Center Print

• "cp \"Message\n\""
  

cp prints Message to the center of the client's screen.

Banner Print

• "b locations \"Message\n\""
  

b prints Message to the client's banner locations

the locations can be a number from 0 to 248

For compatibility, the old-style locations (from 0-4) are also supported.

8 - player chat area

16 - left popup area (not recommended)

32 - centered above the chat area

64 - console only

128 - banner area (recommended)(top of screen)

Scores Print

• "sc \"Message\n\""
  

sc prints Message to the client's console and writes it to the statsdump file.

Chatting

Chat

• "c ClientNum \"Message\""
  

c prints Message as a global chat message on behalf of the client specified by ClientNum.

Team Chat

• "tc ClientNum \"Message\" X-Location Y-Location Z-Location"
  

tc prints Message as a team chat message on behalf of the client specified by ClientNum,

the X,Y,Z-Location's are optional parematers that represent the client's location,

if the X,Y,Z-Location's are left out then the message will be printed without a location.

Fireteam Chat

• "bc ClientNum \"Message\" X-Location Y-Location Z-Location".
  

bc prints Message as a fireteam chat message on behalf of the client specified by ClientNum,

the X,Y,Z-Location's are parematers that represent the client's location.

Global Message

• "chat \"Message\""
  

chat prints Message like global message via rcon (qsay command).

Voice Chat

Global Voice Chat

• "vchat VoiceOnly ClientNum 50 Vsay-String Vsay-Number \"Custom-Message\"".
  

vchat sends a global voice chat Vsay-String on behalf of the client specified by ClientNum.

Vsay-Number is by default random, however, it can be set by the player by passing parameters to the vsay command (/vsay <Vsay-Number> <Vsay-String>),
Vsay-Number represents the vsay number of Vsay as listed in the .voice files.

Custom-Message is by default \"\" (empty), otherwise it's the message that gets printed in the chat area.

if VoiceOnly is 0 it will print a chat message on behalf of ClientNum contaning the message

if VoiceOnly is 1 it will only do the sound but not the message

Team Voice Chat

• "vtchat VoiceOnly ClientNum 50 Vsay-String X-Location Y-Location Z-Location Vsay-Number \"Custom-Message\""
  

vchat sends a team voice chat Vsay-String a on behalf of client ClienNtum.

Vsay-Number is by default random, however, it can be set by the player by passing parameters to the vsay command (/vsay <Vsay-Number> <Vsay-String>),
Vsay-Number represents the vsay number of Vsay as listed in the .voice files.

the X,Y,Z-Location's parematers the represent the clients location.

Custom-Message is by default \"\" (empty), otherwise it's the message that gets printed in the chat area.

if VoiceOnly is 0 it will print a chat message on behalf of ClientNum contaning the message

if VoiceOnly is 1 it will only do the sound but not the message

Fireteam Voice Chat

• "vtchat VoiceOnly ClientNum 50 Fireteam-String X-Location Y-Location Z-Location Vsay-Number \"Custom-Message\""
  

vchat will team voice chat Vsay-String on behalf of client ClienNum.

Vsay-Number is by default random, however, it can be set by the player by passing parameters to the vsay command (/vsay <Vsay-Number> <Vsay-String>),
Vsay-Number represents the vsay number of Vsay as listed in the .voice files.

the X,Y,Z-Location's parematers the represent the clients location.

Custom-Message is by default \"\" (empty), otherwise it's the message that gets printed in the chat area.

if VoiceOnly is 0 it will print a chat message on behalf of ClientNum contaning the message

if VoiceOnly is 1 it will only do the sound but not the message

Fireteam

Application

• "application Number"

application shows a fireteam invation message to the client.

if Number > -1 - the "accept ... application to join your fireteam" message shows up. In this case Number is the ClientNum of the applying client.

if Number == -1 - the "your aplication has been submitted" message shows up.

if Number == -2 - the "your aplication failed" message shows up.

if Number == -3 - the "your aplication has been approved" message shows up.

if Number == -4 - the "your aplication reply has been sent" message shows up.

Proposition

• "proposition Number Number2"

proposition shows a fireteam proposition message to the client.

if Number > -1 - the "accept ... proposition to invite ... to your fireteam" message shows up. In this case Number is the ClientNum of the proposed client, and Number2 is the ClientNum of the proposing player.

if Number == -1 - the "your proposition has been submitted" message shows up.

if Number == -2 - the "your proposition was rejected" message shows up.

if Number == -3 - the "your proposition was accepted" message shows up.

if Number == -4 - the "your proposition reply has been sent" message shows up.

Number2 is an optional paramater only used when Number > -1.

Invitation

• "invitation Number"

invitation shows the fireteam invation message to the client.

if Number > -1 - the "accept .. invitation to join your fireteam" message shows up. In this case Number is the ClientNum of the applying client.

if Number == -1 - the "your invitation has been submitted" message shows up.

if Number == -2 - the "your invitation rejected" message shows up.

if Number == -3 - the "your invitation was accepted" message shows up.

if Number == -4 - the "your invitation reply has been sent" message shows up.

Others

Complaining

• "complaint Number"
  

complaint shows the complaint vote message to the client.

if Number > 1 - the vote shows up. In this case Number is the ClientNum of the teamkilling player.

if Number == -1 - the "complaint filed" message shows up.

if Number == -2 - the "complaint dismissed" message shows up.

Spawning

• "setspawnpt Number"
  

setspawnpt sets the client game selected spawnpoint to number number.

Kicking

• "disconnect \"reason\""
  

disconnect will disconnect the client it has been send with a "Server disconnected" message

reason is an optional parameter to show a reason after "Server disconnected"

note: use trap_DropClient instead.

Configstrings

• "cs Number \"String\""
  

cs will set the clients configstringnumber Number to the String

Note: Setting individual players configstrings this way is probably a Bad Idea.

Shaders

• "remapShader \"OldShader\" \"NewShader\" #"
  

remapShader replaces any texture OldShader with NewShader

# is the Timeoffset, which currently should be left as 0.