My Activeworld OH! ATBot beta help

Thank you for your interest in ATBot V0.9.xx! This is a Windows Console program and has been tested on Windows XP only.

Comments, suggestions, and bug reports are welcome, please post in the AWI Bots forum.

NOTICE! This is a beta copy of the software and may have bugs. Use at your own risk! I cannot and will not accept responsibility for any damage this FREE software may cause.

Download ATBot V0.9.75 171k zipped(AW SDK 77) w/documentation

Download ATBot V0.9.74 168k zipped(AW SDK 77)
Download ATBot V0.9.03 227k zipped(AW SDK 72)
Download ATBot V0.9.02 223k zipped(AW SDK 72)

WHAT DOES IT DO?
The purpose of ATBot is to give caretakers and world owners the ability to create attribute dump files, and the ability to upload them to the world server.

Currently, ATBot can create atdump.txt, at????.txt and a series of at????.txt files for editing. The value of ???? will always be in the range 0 to 1439. All other values are ignored by ATBot.

There are 1440 minutes in a given day, as each minute passes, the Bot will check in the \minutes folder to see if a matching at????.txt file can be found, and if so the Bot will upload the contents.

Currently Activeworlds atdump.txt files include 154 lines of information, but when creating and editing at????.txt files, it is not necessary to include every line. If all you want to do is change the message of the day(AKA the "Welcome Message") and the world web page, then you could have a 1 or 2 line at????.txt file containing only line number 129 and line number 57. The line numbers are what count.

Example:

at0.txt //midnight
******************
57 http://www.myawo.com/morning.htm
129 Good morning! Welcome, please enjoy yourself! :P

at721.txt //1 minute past noon
******************************
129 Good afternoon! Please come back often. :)

at1140.txt //7pm
****************
57 http://www.myawo.com/evening.htm
129 Good evening! Welcome to my world, :)

WHERE DO FILES GO?
There are 3 name variations for ATDUMP files, with 1 not being used by ATBot.

ATDUMP.TXT - When SHIFT T is pressed, this file will generate in the same folder where the ATBots EXE file is. This filename is not read by ATBot.

ATxxxx.TXT -(xxxx=0..1439) When SHIFT D is pressed, this file will generate in the same folder where the ATBots EXE file is. It will not work there, but once you have edited the file, it can be placed in the \minutes folder for use. If you press SHIFT S, 144 identical ATDUMP files will be generated in the \presets folder numbered for every 10 minutes. These are used as an aide in the editing process before being moved to the \minutes folder.

ATDUMPx.TXT -(x=0..9) These files are not generated by ATBot, but you can place renamed/edited ATDUMP.TXT files in the \instant folder to allow you to upload these files to the world server by pressing SHIFT 0 thru SHIFT 9.

IMPORTANT
Please be aware that many line numbers only take 0 and 1 for their data, these are flags and 0 means NO/FALSE and 1 means YES/TRUE. Placing anything other than 0 and 1 on those line numbers will more than likely be ignored or cause an error. Also, placing text where numbers are expected may have unpredictable results, but placing numbers where text is expected will be considered text and shown as such in the world or cause the world server an error. For example, line 76 is the object path, if there is an error on that line number, the world will be without objects, textures, etc.

READ ONLY
The following line numbers are read only and can not be changed by ATBot. If you include them in your ATDUMP files, they will generate a harmless error message.

16 Build Number: World Server Build number
38 Creation Date: Date the world was created or renewed
48 Expiration Date: Date the world Expires/Shuts down
71 Max Users: Maximum user count a world can support simultaneously
73 Object Count: Number of objects the world contained
82 World Size: Size of the world P-xxx
111 Terrain Timestamp: Date terrain was last changed

MISSING LINE
Line 75 is not used at this time by AW, but including it should be harmless.

WHAT'S NEW?

0.9.75: Added: ability to change "action" on the seed object; Added: ability to name the bot whatever you want; Added: ability to make bot visible or invisible; Added: ability to select bots avatar if visible; Added: ability to enable/disable bot version announcement when user first enters.; Added: SHIFT-L command to local console for a list of users in world
0.9.74: Added: Ability to use ATBot in other universes via atbot.ini; Added: Global chat; Added: atbot.ini to configure ATBot to your needs; Added: Global Notice of user entry and exits(i.e. "Talisan Entered"); Added: Ability for anyone to seed an object at the location of their avatar; Added: User list(/l command) of current people in the world; Fixed: Typos
0.9.03: Added: Hotkeys(SHIFT 0-9) to allow immediate ATDUMPx.TXT upload; Rewrote: ATLOAD routine is smaller and more universal; Fixed: If the last line did not contain a newline(#10) character, the last character would be omitted. This was obvious when changing the World Message, as the last character would be missing, but this only happened when line 129 was the last line in the atdump file.; Added: Windows 32x32, and 48x48 icon; Added: Windows version and application data
0.9.02: First beta released

HamBOT