To forward a message, the player or cgi script must set the '$Game' variable and '$MailRace' variable. Only one $Game and one $MailRace should be used per message. The player who sent the message must be recognized by AutoTroll and be a player in the game!
Players can set a race number 1..11, or 0 to send the text to all players.
$MailRace: 0
This means the message will be sent to all players in the game.
$MailRace: 3
This sets the message to be sent to just the birdmen.
The text to be forwarded begins the line after the $MailRace: command. The text block will continue to the end of the message, or until a $End: keyword is reached. See the example below. Notice the tokens $MailRace and $End: must be on their own line.
$MailRace:11
I see your ship, you will die!
$End :
The outbound message will look something like this:
----------------------------------------------------------------------------------------------
To: Red Troll <red.troll@sharenet,com>
From: AutoTroll <auto.troll@sharenet.com>
Subject: Message from Evil Empire (Game #23 : Seek and Destroy)
I see your ship, you will die!
----------------------------------------------------------------------------------------------
Template
Note: you can customize the way the outbound message looks by changing the GAME-MailRace.atf template.
When customizing the template, the Race.* and Player.* variables will refer to the player receiving the message. Only the [Forward.*] template variables give you access to the original message's info. The below GAME-MailRace.atf produced the above result:
----------------------------------------------------------------------------------------------
[Forward.Text]
----------------------------------------------------------------------------------------------
Or, you can modify this template to look like this:
[Player.Alias] -
The [Forward.RaceName] in [Game.Name] has sent you a
private transmission. The message is below:
----------------------------------------------------------------
[Forward.Text]
----------------------------------------------------------------
You can visit [Game.Name]'s webpage at:
[Host.url]/games/g[Game.Number].htm
