Thoys Bot - Manual
Page 1 Page 2 Page 3 Page 4 Page 5 Page 6 Page 7 Page 8 Page 9 Page 10 Page 11 Page 12 Page 13 Page 14 Page 15 Page 16
version 1.4
1
Table of Contents
Table of Contents........................................................................... 2
Introduction
..................................................................................
3
1. Getting started........................................................................... 4
2. Installation ................................................................................ 5
2.1 - Windows................................................................................5
2.1.1 - Compatibility ....................................................................5
2.1.2 - Installer...........................................................................5
2.1.3 - ZIP..................................................................................5
2.2 - Linux ....................................................................................5
2.2.1 - Compatibility ....................................................................5
2.2.2 - ZIP..................................................................................5
2.3 - Mac ......................................................................................5
3. Startup / Login .......................................................................... 6
4. Bot Ownership ........................................................................... 7
5. Commands ................................................................................. 8
5.1 What are commands and what can i do with them?
.......................8
5.2 Commands in the Main Tab ........................................................8
5.3 Instant Message Commands.......................................................8
5.4 Command Examples..................................................................8
5.5 The orange boxes .....................................................................8
6. Communication .......................................................................... 9
6.1 How to communicate with your surrounding?................................9
6.2 How to communicate Privately?
..................................................9
6.3 Sending and Receiving Group Messages .......................................9
7. Movement ................................................................................ 10
8. Jobs .........................................................................................
11
8.1 ChatBot ................................................................................. 11
8.2 Greeter.................................................................................. 11
8.3 GroupInviter .......................................................................... 11
9. Alerts / Events......................................................................... 12
10. Teleportation ......................................................................... 13
11. Inventory............................................................................... 14
11.1 Viewing items ....................................................................... 14
11.2 Wearing clothes .................................................................... 14
11.3 Inventory transfers................................................................ 14
Frequently Asked Questions......................................................... 15
Copyright ..................................................................................... 16
2
Introduction
Hello and thank you for choosing Thoys Bot. This manual will take you through the
installation of the Thoys Bot software for several operating system. It will also explain
the things that you need to know to get an efficient use of the Bot.
All the main topics on the bot are discussed in their own Chapters.
3
1. Getting started
In order to use the Thoys Bot software you will need to buy a licence for the avatar
account that you will use the bot with. You do that by going to one of the Thoys Bot
shops. Sellers of Thoys Bot software are listed on the website
http://www.thoysbot.com/.
You could also choose to install the Thoys Bot software first, to see if your system is
compatible with it.
4
2. Installation
Thoys bot is available for several operating systems, including Windows and Linux. There
are also workarounds on how to get it working for Mac.
2.1 - Windows
2.1.1 - Compatibility
You will need the .Net Framework version 3.5 or higher installed to be able to run Thoys
Bot. This software is downloadable from the Microsoft download site, operating systems
like Windows Vista and 7 have it installed by default.
2.1.2 - Installer
In order to install using the .MSI file you will need to have Windows Installer version 3.1
or higher installed. You can download the latest version on the Thoys Bot product
website.
2.1.3 - ZIP
You will need to extract Extract the files in a folder. I recommend you to make a shortcut
to your desktop.
2.2 - Linux
2.2.1 - Compatibility
In order to run the Thoys Bot software on Linux, you will need to have Mono installed.
You can download it on http://mono-project.com/ , be sure you have the latest version.
2.2.2 - ZIP
The Thoys Bot for Linux is only downloadable as a ZIP file. You will need a zip tool to
extract it. To make it run, open up a terminal window, browse to the folder where you
have Thoys Bot extracted and type: 'mono Thoys\ Bot.exe' .
2.3 - Mac
To run on a Mac you will need to use a computer emulation program like VirtualBox or
Parallels and install Windows or Linux on that. See 2.1 and 2.2 for the installation once
you have Windows or Linux running virtually.
Try http://www.virtualbox.org/ it has host support for Mac.
5
3. Startup / Login
Once you start the program the program, it can be minimized and will then appear in the
task bar at the bottom of the screen. To open the main window, just double click on the
icon.
Once you open the screen, you can click the "Add Client" button to launch the startup
wizard. In the wizard you will be asked for you Avatars name and Password.
After completing the wizard the bot will be displayed on the left side of the main window.
Click on the bot and if you have not already done so, type in your password.
Next, click
the Login button.
Every bot has a GUI, with some tabs. You can select the bot on the left to display this
interface.
6
4. Bot Ownership
Before you can control the bot by Instant Message or the the bot can accept requests for
teleports or item offers, you will need to give your avatar or the other avatar ownership
to the bot.
Each bot can have multiple owners.
One or more "owners" can be assigned
to a folder which contains one or more bots.
There are the two ways to add a bot owner.
The first method is to use the Configuration
option.
The second is to use the MainTab.
picture 4.1
Configuration
To access the Bot Configuration, right-click the task bar icon and left-click on configure
(see picture 4.1 above).
In Configuration you will see multiple folders.
The "root" folder is called "all bots."
To
give an avatar ownership of all bots, add the avatar to the All Bots folder.
Optionally,
you can give ownership to a group of bots, by adding the bots into a sub-folder and
adding the avatar(s) you want to "own" the bots to that folder.
You can give one or more avatars ownership of a single bot, by selecting this bot and
editing its configuration.
Close the configuration when you are done, it will automatically
save after adding an owner.
MainTab
You can also add a bot owner using the Owner's control on the "Main" tab. By default it
sets the owner for the selected bot.
To make an avatar the owner of all the bots, enable
the "make owner of all my bots" check box.
7
5. Commands
5.1 What are commands and what can i do with them?
Commands are for giving the bot interaction. Some commands require parameters to get
the job done. These parameters are entered on the right of the entered command. To
get help on commands enter the help command. If you're not certain what a command
does or what the required parameters are you could use the command as parameter for
the help command. You could for example do this "help follow" or "help say". There are
serveral ways of entering commands, two of them are using the "Main" tab and using
"Instant Messages".
5.2 Commands in the Main Tab
In the "Main" tab theres a console window. In the bottom of this console window is a
text-box where you can enter a command.
5.3 Instant Message Commands
The bot owners as described in Chapter 4. are allowed to command the bots Through
Instant-message. You can simply start an Instant Message session with your avatar to
send commands towards the bot.
5.4 Command Examples
Here are some examples of commands:
- Say [message]
Allows you to make the bot say things ex. "say Hello, there!"
- Who
Tells you who is around the bot
- Shoot [name]
Allows you to make the bot say things ex. "shoot John Doe"
- Follow [name]
Allows you to make the bot follow someone ex. "follow John Doe"
- Help
Gives you a full list of commands
5.5 The orange boxes
Most of the next chapters contain orange boxes. These boxes include some commands
that are related to the topic discussed in the chapter.
MiniFAQ:
Q. Why dont InstantMessage commands work?
A. You might have to setup your avatar as botowner, see chapter 4.
8
6. Communication
6.1 How to communicate with your surrounding?
Messaging in Second Life is an essential. To meet friends you will have to communicate.
The best way to get started is by using the local chat fuction. You can read messages
that are send by avatars and objects nearby. Thoys Bot also offers you this function. In
the "Communication" tab theres a local chat button. This will open a panel. You can say,
shout and even whisper. If you want to speak normally, then be sure your channel is set
to 0. If an object needs you to interact you on a channel, then you could enter it there.
6.2 How to communicate Privately?
You don't want others to listen to all your messages. You could privately talk in Instant
Message. To start an Instant Message session, go to the friendlist or local chat and
double click on the person you would like to start a session with.
6.3 Sending and Receiving Group Messages
Thoys Bot is also able to receive group messages and start group sessions. To start a
session, double-click on a group in your Contacts->Groups and then type a message.
IM Commands:
- Say [message]
- Shout [message]
- Whisper [message]
9
7. Movement
There are many ways of movement in Thoys Bot. You could let the bot follow an avatar
or object, but you could also move the bot manually.
To make the bot follow someone through the Client program, you could right-click them
in the local chat window and then
click on the follow option. Or you Could also do a
command in instant message, written as "follow [avatar name]". Just "follow" to let it
follow yourself.
Manual movement could also be one of your needs. In the Movement Tab theres a
manual Tab. In this tab there are some controls to move the bot in each direction. You
can also right-click on a control like Forward, and it will stay pressed, now it will
continuously walk forwards.
IM Commands:
- Follow [avatar name]
- Fwd
- Bwd
- StopMove
- Rot [degrees]
10
8. Jobs
Thoys bot also gives the ability to make the bot do certain jobs through the "Jobs" tab.
Using this function you could make it easier to grow your group larger or give your bot
artificial intelligence to make it possible to have conversations with your own bot.
8.1 ChatBot
The chat bot is for enabling AIML in the bot. This AI Markup-Language makes it possible
for the bot to respond on other avatars. Through IM and Local Chat. The bot is even able
to remember some details about the person that the bot is speaking with.
8.2 Greeter
You can use the bot as greeter in your store or even at a party. You can personalize a
message by entering a macro for the name. The message can come out like this:
"Welcome to Bot Parts, Thoys. Please have a look arround".
The greeter can also be set to a certain distance. If the visitor is in distance but its too
far enough to hear a say message, then the bot will simply shout the welcome message.
8.3 GroupInviter
Your bot can become a group inviter. This job is only to generate the inviter script. This
script can be placed in an object owner by one of the bots owners. The bot will only
listen to scripts owned by one of the bots owners. The script will send the bot a message
to invite this detected person to the given group. It is also possible to setup if the script
is triggered by touch and/or sensor.
11
9. Alerts / Events
In world you can receive many types of alerts. Like that you received or send money. Or
you can receive a dialog message. This is all handled in the "Alert" tab of the bot.
In this "Alert" tab, you are able to respond on events. You can answer menu dialogs. Or
questions about if scripts can have your permissions.
It is possible to automatically answer these events. You do that by making filters. These
filters have conditions. These conditions can be used to filter certain events and answer
them with actions that you desire.
12
10. Teleportation
Teleportation is an important in-world functionality. It is the main way of moving
between regions or areas.
When you open someones profile in Thoys Bot, you can offer a teleport to someone. This
person will receive your given invitation message.
To teleport yourself you could go to the Main tab en click on the "World Map" button. You
can find a place and teleport to it.
To see the region you are currently in look on the bottom of the program's form. You will
see a status bar here which includes the region the bot is currently connected to and the
bot's coordinates.
IM Commands:
- Teleport x/y/z
- TeleportMe
- TeleportAv [FullName]
13
11. Inventory
Every avatar has their own inventory. Thoys Bot is able to simply let you navigate
through your inventory using some kind of explorer style.
You can find the inventory explorer in the "Inventory" tab.
11.1 Viewing items
The program allows you to view and edit notecards and scripts. You can also view
pictures. To do these things, simply double click on the desired inventory item.
11.2 Wearing clothes
You can double click clothes to wear them and right-click and click on attach for objects.
You can also detach and take off clothes through this right-click menu.
11.3 Inventory transfers
To move an item or folder you can simply drag them around through the inventory. You
can also drag an item to someones IM chat or profile to send the item to this avatar.
If you have multiple bots you can open the inventories next through eachother to drag
the item to the bots inventory folder. The bot will copy this item into the selected folder
of the other bot (the item has to be copyable).
IM Commands:
- ls
- cd
- wear [item/folder]
14
Frequently Asked Questions
Can I still login with the official Linden Labs Second Life viewers?
Yes you can! The Thoys Bot is just seen as an alternative client to Second Life.
15
Copyright
Thoys Bot is Copyright ©2010 Thoys. All rights reserved.
16