Template Files


Certain events in AutoTroll cause an e-mail message response. When AutoTroll sends this response, it "executes" a template file. The typical example is when a player sends a TRN in. AutoTroll runs chktrn and prepares a message (i.e., it loads a template file) to send back to the player. By modifying the template files AutoTroll uses for its responses, you can customize what your playres see and have a personal "look and feel" about your host system.

Below are the files AutoTroll uses at key events. All of these files are found in the "at templates\" directory under where you installed AutoTroll.

CHKTRN-BadFileType.atf Sent when AT can't decode a time stamp from the file.  
CHKTRN-Cheat.atf Sent when chktrn returns an errorlevel of 3  
CHKTRN-Corrupt.atf Sent when chktrn returns an errorlevel of 2  
CHKTRN-Good.atf Sent when chktrn returns an errorlevel of 0 - a good TRN  
CHKTRN-Stale.atf Sent when chktrn returns an errorlevel of 1 - a stale TRN  
CHKTRN-UnknownGame.atf Sent when the TRN file (and the timestamp inside) can't be matched to any current games.  
GAME-AllyHostWarning.atf Sent if player chose to be sent allied host warnings, and the game host warning time has been reached, and one of the player's allies is missing a turn.  
GAME-Completed.atf Sent when a game is ended automatically It is not sent when you end a game manually  
GAME-Drop.atf Sent when a player is dropped automatically. It is not sent when you remove a player from the game.  
GAME-DropDead.atf Sent when a player is dropped automatically AND their race is considered dead. It is not sent when you remove a player from the game.  
GAME-DropWarning.atf Sent the turn before the player is about to be dropped for missing turns.  
GAME-HostWarning.atf Sent to the player if he's chosen to receive host warnings and the game's warning time has come and the player hasn't submitted their TRN yet.  
GAME-HurryTurn.atfSent to the last player who has not submitted a TRN for games that have Early Hosting enabled and Send HurryTurn enabled.  
GAME-MinTRNPercent.atf If a game is configured to abort if a minimum turns aren't received, this template is sent to all players when the game is delayed. See game configuration.  
GAME-MailRace.atf Sent when a one player in a game wants to forward a message to another player in that game. See forwarding messages.  
GAME-PlayerConfig.atf Sent to the player if they change any game config variables  
GAME-PlayerWelcome.atf Sent when a player joins a game via game config variables and the game hasn't yet started.  
GAME-Quit.atf Sent to the player when they quit a game using the $QuitRace : X game config variable.  
GAME-QuitDead.atf Sent to the player when they quit a game using the $QuitRace : X game config variable. and their race is considered dead. If the game isn't using AutoScore, this template isn't sent, the GAME-Quit.atf is sent.  
GAME-ReplacementWelcome.atf Sent when a player joins a game via game config variables and the game has started.  
GAME-SendRST.atf Sent to the player when they receive their RSTs for a game  
PLAYER-Config.atf Sent when AutoTroll recognizes the player and they've requested their configuration or they've made a change to their configuration  
PLAYER-Help.atf Sent when AutoTroll recognizes the player and they've requested help  
PLAYER-NoValidMsg.atf Sent when a AutoTroll recognizes the e-mail address, but doesn't see any 1)e-mail commands in the message with their password in the subject, or 2) a TRN file attached  
PLAYER-Welcome.atf Sent when a player joins your system  
UNKNOWN-Help.atf Sent to a person whom AutoTroll didn't find in its database and the person requested help  
UNKNOWN-NoValidMsg.atf Sent to a person whom AutoTroll didn't find in its database and the person sent a message with no valid commands or TRN attachments. This template is only used when you have Exclusive mailbox checked in setup.  

See also
Creating a Website