For AutoTroll to identify a player via e-mail, the player must do 3 simple things:
1) Send the message to your host address (specified as the host identity)
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. OR, the player can put $Player: <their player number> in the message.
3) The player must put their (case sensitive) password in the subject line OR put
$PlayerID: <their case sensitive password> in the message.
If a player does these 3 conditions above, then AutoTroll will know the player account when it replies to him.
Note: #2 above can sometimes be a problem for players. Sometimes a player will define their primary address as joeblow@freemail.com. But, actually their mail program or their ISP or something actually puts in the 'From' or 'Reply-To' field : joeblow@mail.freemail.com. E-mail will be delivered to the player if it's addressed to either "joeblow@freemail.com" or "joeblow@mail.freemail.com" so it may not be immediately apparent there is this problem.
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 or CGI script 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. This also can allow CGI scripts to ask their player number and their password.
Example 1
$Player: 1
$PlayerID: myPassword
AutoTroll would then interpret this message as from player 1 (if player 1's password is "myPassword") - regardless of what the From and Reply-To fields are.
Example 2
$Player: 3
AutoTroll would look at a message with this and ignore the From and Reply-To fields. AT would verify that the message is from player 3 by checking the subject of the message to see if it's the password of player 3. If the subject is NOT the password of player 3, then AT would ignore this $Player: 3 line in the message.
See also forwarding unknown mail as a way of detecting these and other types of errors from players.
