![]()
Example on how to Join a Game:
A player who sends these commands must be recognized by AutoTroll.
For AutoTroll
to identify a player via e-mail, the player must do 3 simple things:
1) Send
the message to vgap.host@dtn.ntl.com
2) Send
the address from the primary e-mail address they signed up to AutoTroll
with. This should not be their shadow e-mail or any other e-mail. AutoTroll
will look at the 'From' and 'Reply-To' field of the message they send.
This field must match the primary e-mail address for the player.
3) The
player must put their (case sensitive)
password in the subject line.
If a player does these 3 conditions above, then AutoTroll will know the player account when it replies to him.
Note: The player may also tell AutoTroll who they are by using the $Player variable. There should be only one $Player variable per message. The player must still put the player's password in the subject, but by setting $Player the message doesn't need to come from the primary e-mail.
The below
configuration variables are not case sensitive $PlaYErName and $Playername
are both recognized by AutoTroll. See the syntax rules for explanation
on how players must set these variables.
------------------------------------------------------------------------------------------------------------------------
$PlayerName : name Player name (must be >=2 characters) and corresponds to the "Name" field
$PlayerAlias
: alias
Player alias is optional.
Outgoing messages and posts to the player will use their alias if they
have one,
otherwise will use their name
$Password : newpass Player's password must be >=3 characters
$EMail: me@here.com Primary e-mail (must contain '@' sign)
$EMail2: me2@here.com Secondary e-mail (if $UseEMail2, must contain '@')
The following
are set to either 'Yes' or 'No' after ':' (not case sensitive)
------------------------------------------------------------------------------------------------------------------------
$UseMime
: yes
yes=mime encoding,
no=UUencoding
$BroadCastMsgs: no Receive broadcast/news type messages
$NewGameMsgs: yes Receive "new game" type messages
$ZipFiles: no Tells AT if it should zip RSTs to player
$UseEmail2: no No ignores e-mail2, yes puts e-mail2 to in CC field of all outgoing messages to the player
$LongFileSupport :yes Player supports long filenames
$HostWarning : yes If player wants to receive host warning messages
$PlayerAllyHostWarning:
yes If players wants
to receive a host warning message when their allies/team mates TRNs
aren't in. The player will also get chktrn results when this is set to
yes.
$FTPRSTs
: yes
Sets if player wants RST files sent to ftp site. Note: only games with
'FTP Zip files'
checked can have the player's RST files sent
$PrivateEMail
: no
If yes, [Player.EMail] & [Player.EMAil2] will return'PRIVATE'.
This sets the 'Hide EMail' flag for player
These
next 11 variables set the 11 race choices for each player.
The
value submitted may currently only be a number from 1 to 11.
------------------------------------------------------------------------------------------------------------------------
$Choice1
: 1
$Choice2
: 2
$Choice3
: 5
$Choice4
: 4
$Choice5
: 3
$Choice6
: 6
$Choice7
: 7
$Choice8
: 8
$Choice9
: 9
$Choice10
: 10
$Choice11
: 11
For the following commands the player must set the '$Game' variable. Only one $Game variable should be used per message. The player who sent the message must be recognized by AutoTroll.
The above
commands, ( $PlayerName through $Choice11 ), can be changed by using the
sign-up form but replace "sign up"
with your password in the subject line.
------------------------------------------------------------------------------------------------------------------------
$Game: 23 Sets the game. This must exist in messages where the player will be sending any game variables.
$QPlayer : yes Turns on/off The Q for the player. The player must be playing a race in the game.
$RemoveAlly : 3 Removes an ally.
$AddAlly
: 4
Adds an ally. This is a little tricky. The player adds an ally and that
means the other player (fascists
in this example) will start getting this player's RST files. That other
player (4) must send an $AddAlly
command also to have an "equal alliance".
$JoinRace
: 3
If Allow Joining is set in the game config screen, and race '3' in this
example is open, the player will
be added to the game and immediately sent his RST files. Multiple $JoinRace
commands can be in one
message and AT will process them in order from top to bottom.
$QuitRace: 4 Can only be sent if the player is playing race 4. When quitting, the Q is turned on for the player.
------------------------------------------------------------------------------------------------------------------------
Your Player #123 This can be gotten with the "Send Config" message to the host which will also give you your case sensitive password as well. Your password is Xtacy
The message you would send to join game 13 as the Privateer player would be this:
TO:
vgap.host@dtn.ntl.com
FROM:
your name <y_name@domain.com>
SUBJECT:
Xtacy
$player
: 123
$game
: 13
$joinrace
: 5