Xelagot script by Who 230147


Dynamic Object/Texture Yard Bot - for Xelagot's

Version 1.0
Script
This script allows you to have a dynamic object and texture yard available via your bot with the ability to use a database of objects/textures.

The bot currently has the following abilities:
1. Will display an object and/or texture
2. Will word search the object or texture database for matches.
3. Will describe an object or texture
4. Will edit an object or texture to the database
5. Will add a new object or texture to the database

The script is minimal in design, the database is even more primitive. This script only holds it own when you have a really good database to work with.
A lot of work is required to create the databases, well a lot of typing :)

It is up to you if you want to put the work in to make these databases useful to yourself and others of your world(s). Merely using the supplied examples will
not give much satisfaction with this bot script. You can add entries either in world via the bot or by directly editing the database files.

Note: If people are interested and wish to supply lists of all AW objects and textures and even lists of other 'free for use' objects and textures I
will add any databse descriptions I may have for the listings to the example databases. If you wish to also send any descriptions you have added to me
I also will include these in the example databases for distribution with this script.

If a number of people participate in this we could end up with a good set of object/texture database files that are very usable.

You can download the scripts by selecting this link: dotyb.zip
Warranty:

Dammit! I'm not a programmer..

if BROKE, then
  user;='Owns Both Pieces'

if PROBLEMS/SUGGESTIONS then
  contact:='Who - The Second Opinion, ricta@ricta.net'

if COMPLAINTS then
 send to dev/null




 

Install Instructions:

(Also included within archive)
#########################################################
# Dynamic Object/Texture Yard Bot - A script designed for Xelagot's.     #
#                     (1 Xelagot required)                                                          #
#                         Version 1.0                                                                   #
#                   Scripting Author: Who 230147                                            #
#                 Xelagot Programmer: XelaG 289499                                     #
#  IMPORTANT: This script series does require some knowledge of the   #
# Xelagot or at least a desire to learn that knowledge via the online            #
# documentation provided on the Xelagot website                                     #
#                http://www.imatowns.com/xelagot                                           #
# I will not provide support for this script except in exceptional                  #
# circumstances.                                                                                       #
# XelaG is not responsible for this script and therefore will not                   #
# provide support in any form.                                                                  #
#                                                                                                              #
# You are encouraged to visit the web site to see more information,           #
# tips and hints for this script. The URl for this is                                        #
#           http://www.ricta.net/ethaw/dotyard.html                                       #
#                                                                                                              #
# Other bot scripts of mine can also be accessed from:                              #
#           http://www.ricta.net/ethaw/botscript.html                                      #
#########################################################

What you should have in this archive:

 1. Readme.txt - this instruction file
 2. mod.txt - Bot Script
 3. texture.txt - Texture database
 4. model.txt - Object database

Installation:

1. Copy all the files in this series into the Script folder of the
   Xelagot program.

Script preparation:

1. Open the mod.txt file with a text editor. Around line 23 you will see:
   $owner = "Who"
   Change Who to your AW nickname.
   Save the file

Database files:

model.txt and texture.txt are the files that contain your object and
texture database. The supplied ones are far from complete. Creating these
files is where you could spend months if you really wanted to. I don't
run all the default AW objects/textures in the worlds I work in, as a matter
of fact I don't even know if the files I have left listed in these "example"
databases are freely available or are all standard AW ones.

My own database files list over 2700 different objects/textures - not all yet
have descriptions, but many do. I have not included all of these as I don't know
which are free and which aren't.

If in the database there is an object/texture that your world does not
include then the bot will create an lbt or the texture just will not work :)

It is up to you if you want to put the work in to make these databases useful
to yourself and others of your world(s). Merely using the supplied examples will
not give much satisfaction with this bot script. You can add entries either in
world via the bot or by directly editing the database files.

Note: If people are interested and wish to supply lists of all AW objects
and textures and even lists of other 'free for use' objects and textures I
will add any databse descriptions I may have for the listings to the example
databases. If you wish to also send any descriptions you have added to me
I also will include these in the example databases for distribution with
this script.

If a number of people participate in this we could end up with a good set
of object/texture database files that are very usable.

Email address: ricta@ricta.net

============================================================================

Starting the Bot!
=================

Note: The command structure within the script relies on AW V3 or better
version commands. While it is possible to alter to support V2.2 only commands
I have not done this as I don't consider V2.2 to be viable any longer. If you
really want it to use V2.2 commands you can figure it out (its easy) or perhaps
email me and if in real need of help.

You should now have everything you need to start the bot. Do so using the
following procedure.

1. Make sure you have build rights (and thus the bot does) in the world
   you are using the bot.
2. Go to where you will run the bot in the world.
3. Create an object - something like a pp01 - where you have space
   and permission to do so.
4. In the Description Box of the object add the words(this is very important):
   Object Texture Board
 
5. If the world requires that you name the object specifically ie:
   pp01.rwx then you will have to modify the "model.txt" database
   file. See "Modifying to add extensions" below)
6. Start the Xelagot bot and bring it to where you are
7. Select the mod.txt script and have the bot load and run it.

You are now ready to use it.
-------------------------

Once started you will have noticed the bot should have located the object
panel you created and put the texture "stone4" on it. (stone4 is a common
texture). This tells you its all working.

You can now say "comlist+" and the bot will respond with the available commands
to use the database script.
Note: If you did not enter your nickname where required in the mod.txt file
then the bot will not allow you to modify or add anything to the database,
it will only allow you to display and search the database.

The bot currently has the following abilities:
1. Will display an object and/or texture
2. Will word search the object or texture database for matches.
3. Will describe an object or texture
4. Will edit an object or texture to the database
5. Will add a new object or texture to the database

When displaying objects, the bot will not automatically default the current
texture so you will get your displayed object with the currently used texture
added. To reset the texture to the standard of the object request the bot to
display the "null" texture.

========================================================================

Help!
--------

If you have serious problems getting it to work I will assist you. If
your problems include questions like "how do I start my bot?" I will
not assist you. You must learn these basic commands from the documentation
on the Xelagot website.

I hope you enjoy this script, and I hope it gets you interested
enough to expand on it. It would be surprising if a number of people
contributed and we actually got a really good database going :)

I would appreciate an email sent to ricta@ricta.net if you use this
script, just so I know if its popular and people are using it. You
may also send questions about "serious problems" to that email address.

========================================================================

Modifying to add Extensions.
---------------------------

If your world requires the complete object name you will have to modify
the "model.txt" object database.

The easiest way to do this:

1. Open file in editor
2. Select the "Replace" option
3. Text to replace:  =
   Replace with   :  .rwx=
4. Replace all instances in the file
5. Save file - its ready for use
 

Enjoy!

         Who 230147