The Av99Bot and SrvcXlgBot commands

There are three command sets the Xelagots understand:

  1. Verbal commands
  2. Action Script statements
  3. WriteToBot commands

Verbal commands

When you chat or whisper to the bot through an AW browser, the bot follows a set of verbal commands. These commands are language dependent, and the language files are in the bot's Chat folder. There are at present (november 2000) 3 standard sets: English (default), Dutch and Spanish. These commands can also be used by the owner of the bot if both the bot and the owner are logged into a xelagot server: the bot as BOT or MASTER, the owner as USER. The English Verbal Commands are explained on the Xelagot help pages, and a link to the Server package can be found on the Xelag Quality Bots page.

Action Script statements

Xelagots have a scripting language: the Xelagot Action Script. Scripts can be written to customise the bots and their actions, and turn them into poets, guides, shop attendants, play-mates, RPG bots... The Action Scripts, which require programming skills to write, are explained on the Xelagot help pages.

WriteToBot commands

This set of commands is used in various contexts:

  1. the Action Script implements them to communicate with other bots in the same application
  2. they can be issued by bots connected to a Xelagot Server (if they have a MASTER protocol) to command other bots
  3. they can be used for commanding the bot by dropping a file with these commands in the bot's DB2Bot folder

The first two cases are explained in the Action Script section of the Xelagot help pages. The third method, which is particular to the Av99Bot and the SrvcXlgBot, is explained here below.

File interface to the WriteToBot commands

Please open the WriteToBot commands page of the Xelagot help pages: you will need it as a reference.

The Av99Bot and SrvcXlgBot applications search the DB2Bot folder twice a second for command files. They 'swallow' up any file in this folder and, if they find WriteToBot statements, they will execute them. To implement this, open Notepad (not Wordpad or Word, the file must be a pure ascii file), type in your command or commands, and save the file with any name you like in the DB2Bot folder.

WriteToBot commands are one-liners: they usually start with the name of the bot followed by a comma, followed by the actual command. On the WriteToBot page, the commands are shown inside a table. The general formula for these one liners is:
botname,command
I will give some examples here, for a bot called Moishele. Please refer to the above mentioned page for a longer list of commands.

To void Moishele (that is, to log him out of a universe), use:
Moishele,void

To warp the bot to a world called Mystery, use:
Moishele,warp,Mystery

To warp him to specific coordinates in the world Mystery:
Moishele,warp,10.3n 5e 0a 180 Mystery
or
Moishele,warp,Mystery 10.3n 5e 0a 180

A few others:
Moishele,avatar,21
Moishele,say,Hello everybody, I'm back :)

To connect a bot to a Xelagot Server, if the bot has all the data from the ini file:
Moishele,CLConnect

If the data to log in must be specified:
Moishele,CLConnect,host,portnumber,login,password

You can put more than one WriteToBot command in a file: each command must be on its own line.

There are a few commands which will affect all bots. They cannot be issued through a server connection (using CLWriteToBot), only by a bot in the same application (using WriteToBot script statement) or through the DB2Bot file. These commands have this general form:
/command

To void all bots:
/void

To log them all back in:
/enter

To terminate the Av99Bot (not the SrvcXlgBot) and shut down the application:
/terminate

WriteToBot responses: the Bot2DB folder

Some WriteToBot commands issued through the DB2Bot file interface may trigger written responses from the bot. These are written to files in the Bot2DB folder. This folder must be checked periodically, and emptied.

Have fun :)