Client-Sided Scripter v3.1
------------------------------------------------
CREATOR: Gen. Raven [M.I.B.]

ASSISTED BY: Com. Sentinal [M.I.B.]
------------------------------------------------

------------------------------------------------
1. ENABLING CLIENTSCRIPT.CS:
------------------------------------------------
Move the included file:

- ClientScript.cs

to your starsiege main directory (Usually C:\Dynamix\Starsiege)

Next, start Starsiege and enable the console. (Click on the white mark below 
the version number on the main menu.)

Create a server, then press the tilde ~ key to bring up the console. Then type:

exec("ClientScript.cs");

This will enable clients to script on your server as if they were the host 
using the information provided in the "Game Info" ? tab in the wait room.

The client DOES NOT NEED ClientScript to use it. They only need to enable 
their console and follow the directions in the "Game Info" ? tab.


For more information check the "Game Info" ? tab after enabling ClientScript.cs

------------------------------------------------
2. SETTING A PASSWORD
------------------------------------------------
If you wish to set a password to restrict client-sided console use to 
only certain players, type the following in the console after enableing 
ClientScript.cs:

$password = "PASSWORD GOES HERE";

Give the password to anyone you would like to be able to use ClientScript.cs

Remember the password is case-sensitive!

To remove the password, giving access to anyone in your server, type:

$password = "";

For more information check the "Game Info" ? tab after enabling ClientScript.cs


------------------------------------------------
3. TURNING ON SHOWSCRIPT MODE
------------------------------------------------

To show players scripts in the chat box as they send them, type th following
after enabling clientscript:

$showScript = true;

To disbale this feature, simply type:

$showScript = false;

------------------------------------------------
4. USING CLIENTSCRIPT
------------------------------------------------

Clients can send scripts to the server just as if they were the host. To 
use ClientScript, type the following in the console:

remoteEval(2048, sendScript, "INSERT SCRIPT CODE HERE");

If a password is required, use the following format:

remoteEval(2048, sendScript, "INSERT SCRIPT CODE HERE","PASSWORD");

Example:   remoteEval(2048, sendScript, "function vehicle::onadd(%v){setTeam(%v,*IDSTR_TEAM_BLUE);}","banana");

NOTE: YOU MUST PUT A BACKSLASH \ BEFORE ANY QUOTATION MARKS INCLUDED IN YOUR 
SCRIPT CODE!

Example:   remoteEval(2048, sendScript, "say(0,0,\"Hello\");");

If your text string is greater than 255 characters, you must use the 
following format:

remoteEval(2048, longScript, "SCRIPT CODE PART 1", "PART 2");

Example:   remoteEval(2048, longScript, "function vehicle::onadd(%v){healObj", "ect(%v,-2500);}");

Add a password after both text strings if necessary:

remoteEval(2048, longScript, "SCRIPT CODE PART 1", "PART 2", "PASSWORD");

All of this information can be found in the "Game Info" ? tab after enabling 
ClientScript.

------------------------------------------------
4. CLIENTSCRIPT LOGGING
------------------------------------------------

All scripts that clients send to the server using ClientScript can be seen in
the host's console during gameplay. All of this information is also logged to
a text file named ClientScriptLog.txt in your Starsiege main directory.
It records player's names, squads, IP addresses, the date, the time, and the 
script code that was sent to the server. This can be used to find out which 
players may be abusing ClientScript.


------------------------------------------------
5. NOTES
------------------------------------------------

The password and showScript features can be permanently set by following 
these steps:

Open ClientScript.cs with wordpad
Look near the top of the script
Find these lines:

$password = "";       //password restrict use of clientscript
$showScript = true;  //show the script sent in the chat

Then change them as needed.