How do bots log in?

*Smoothly sometimes, depending on the weather* :)

The ini file.

(recomended method for permanent logins, all xelagots)

All xelagots (x1.exe, av99bot.exe and SrvXlgBot.exe) keep their data in an ini file. Typically, the ini file is called the same as the application, but with a '.ini' extension. To edit the ini file, the application must not be running, and Service applications (SrvXlgBot) must be stopped (not paused) in the Services manager.

Open the ini file in an ascii-text processor (not Wordpad nor Word, use Notepad). You will see sections called [Bot1], [Bot2] etc. (x1.ini starts with [Bot0], all others with [Bot1]). Go to the section corresponding to the bot you wish to edit. In x1 the name is kept as Caption=name, in the other bots as BotName=name. Look in that section for the following entries:

ClientHost=
ClientPort=
ClientLogin=
ClientPassword=
ClientReconnectOn=1
ClientReconnectDelay=20
ClientReconnectPause=60
ClientReconnectAttempts=6
ClientReconnectCycles=-1

Add the missing data, or edit them if necessary. Supposing the server is at auth.myserver.com, on port 9800, and that your bot must login as Percy, and the password is cU2day. Your inifile entries will look like this:

ClientHost=auth.myserver.com
ClientPort=9800
ClientLogin=Percy
ClientPassword=?cU2day
ClientReconnectOn=1
ClientReconnectDelay=20
ClientReconnectPause=60
ClientReconnectAttempts=6
ClientReconnectCycles=-1

Notice the question mark heading the password: it indicates to the application that the password is not encrypted, as it usually is in the ini file. When you start the bot, because ClientReconnectOn=1, the bot will try to log into the server automatically.

The Action Script.

(recomended method for occasional logins, all xelagots)

The Action Script language has statements to connect the bot (Bot Client) to a Xelagot Server:
CLHost $host
CLPort %Port
CLLogin $Login
CLPassword $Password    (uncripted, no question mark)
CLReconnect On
CLReconnect Off
CLReconnectDelay %Seconds
CLReconnectAttempts %Number
CLReconnectPause %Seconds
CLReconnectCycles %Number
CLConnect
CLDisconnect

The matter is dealt with fully in the Xelagot help pages.

The DB2Bot command file interface.

(recommended for emergency cases. Av99Bot and SrvcXlgBot only)

If you have access to the bot's DB2Bot folder (on your machine, through a network or ftp), you can command the bot using WriteToBot commands packed into a file and dropped into this folder, as explained in the 'File interface to the WriteToBot commands' section of The Av99Bot and SrvcXlgBot commands page. The appropriate command depends on whether the bot knows the Host (IP), Port, Login name and Password (for example, they are in the ini file and have not been modified by a command or Action Script statement) or not. If the bot knows how to log in, this command will do the trick:
botname,CLConnect
Otherwise, you can specify the data:
botname,CLConnect,host,portnumber,login,password
To disconnect the bot:
botname,CLDisconnect
 

The User Interface

(x1 xelagot only)

How to connect a bot to a Xelagot server is explained in the Xelagot help pages. The method involves opening the Clients screen (menu Bot | Clients), selecting the bot, entering the data and connecting it.