Error
  • The template for this display is not available. Please contact a Site administrator.

Article Index

Getting started with the Hosting Service

 


 

Screen shot Step 1 - Log in

login

In order to log in to the hosting service, you need a license.
Once you got it, enter your mastername and the password you were given and klick "Login" and you are halfway to getting yout bot ready for action!


Screen shot Step 2 - The Dashboard

dashboard no bots


dashboard bot running

Dashboard - First login (and no bots running)

 

Once you have logged in, you will see the Dashboard. 

From here, you will see information regarding your account as well as info about your bot when it's logged in to Second Life.

 

 


Dashboard - Bots running

 

As soon as you have started one bot, the dashboard will be filled with info regarding your bot.

You can:
* See when you started yout bot (when it logged in).
* See how long time your bot has been active (logged in).
* See how much of your account balance your bot has used since it last logged in.
* Open the local chat log (Where you can see further information from your bot).
* Log the bot out.


Screen shot Step 3 - The Bot Manager - Add a bot

 

botmanager add bot

Overview:

The Bot Manager is where you add/remove your bots from the system, change settings for your bot and log the bot in. 

Remove Bot

Clicking this button will remove the bot selected in the dropdown box above the button. 

Bot Settings

Change settings for your bot. 

Start Bot

Select a bot from the dropdown box above and click Start Bot to make the bot login to Second Life. 


To add a bot:

Scroll down to the bottom.
The master name is allready added for you, you only need to enter the full name of the avatar you wish to use as your bot, and the password for the avatar. 

Bot name:

The name of the avatar you wish to use as a bot.
Please make sure to denote the first and last name with a period.
For example "Steller.Sunshine" or "MyBot.Resident".

Password:

The password you selected for he avatar you want to use as a bot.
We can NEVER help you with this password.
Please go to the SecondLife website to reset the password.  


Step 3.1 - Settings -> Main Settings

Settings:

The setings in the hosted Control Center are the same as in the client installed version.
Click "Bot Settings" to get to the settings panel. 


Main Settings: 

Login Location:

The Login Location is used to determine where your bot will rezz when it logs in.

Enter the sim name and the X, Y, Z coordinates. For example, to rezz your bot in the exact middle of the sim "Pooley", enter the following coordinates:
Simname: Pooley
X: 128 , Y: 128 , Z: 20 You can also tell the bot to log in at it's last known location, or it's home point, by entering @home or @last in the field for simname.

If you are using @home och @last, do not enter any X, Y, Z coordinates. If you leave the Login Location empty, the bot will log in at it's home point.

When you have entered a location, click the button "Add location".
To use the location for your bot, select the location from the dropdown box and click the button "Use location". 

Operators group:

The operators group is used if you want others to be able to use your bot. 

Create a group, for example "My Bot Operators Group" and invite your bot to it.
Enter the name of your Operators Group in the field.

If the group name starts with a non-alphanumeric character (such as #¤%& or space etc), you can use the UUID key of the group instead. Any avatar that is member of this group will be able to use your bot.

Best practise is to have the group set to non open enrollment so that no unwanted people can gain access to your bot.
If you want to use your bot to advertise in groups, and you don't want the bot to spam your operators group, you can check the box for "Exclude this group from messages".
The bot will then exclude the operators group from advertisements. 

AutoSit on prim:

If you want the bot to sit on something immediately after it has logged in, please use this feature.

Get the UUID key of the object you want the bot to sit on and add it to this field.
If the bot for some reason are unseated, the bot can sit again as soon as it is in the same region as the object.
To use this feature, check the box for "Sit again if unseated".


Step 3.2 - Settings -> Command Settings

Accept Friendships From:

The bot can automatically accept or reject friendship requests.
If this is set to "Masters & Operators", your bot will ONLY accept friendships from it's master and members of the Operators Group.
If set to "Everyone", the bot will accept the friendship from anyone who sends a friendship request.

Object key:

The Object Key is used as a password when you want your bot to communicate with inworld objects, such as the GroupTools HUD, the HCLV addon script, or any other scripted object you have created for yout bot.

Enable the feature and enter an Object Key.
You can find an example in the FAQ section, under How to -> "How do I make scripted objects communicate with my bot?"

Invite Request Group:

Do you want your bot to invite avatars to a group by request?
If you enable this feature, any avatar can send the message "invite" as an IM to your bot, and the bot will automatically send an invitation to the group you have set here, with the group title you want them to have.

To use this feature, enable it, enter the name of the group you wish the bot to send an invitation for, and the name of the title you wish to use.
When finnished, click the "Set" button.

Please note the following:
* The bot MUST be a member of this group.
* The bot MUST be allowed to invite to the group and the role that has this title.
* The title must be a valid title.

Please also note the difference between role name and title.
You may have the role "Everyone" with the tag "My groupie" and the role "Officers" with the tag "My managers".

Do NOT enter the role name, enter the title or tag of the group (same text as will appear over the avatars head when activating the group).


Step 3.3 - Settings -> Inventory Settings

Notecards:

The bot can accept inventory items for different reasons.
Notecards are a bit special, since they are used to send group advertisements.

The default setting is to only accept notecards from the master and operators (if operators group is used).
If you change this setting to "AutoAccept", the feature to send group advertisemens using notecards will be disabled.
This is to make sure that your bot won't spam it's groups just because someone sends it a notecard.

The default setting is to only accept from master and operators. 

Other Inventory Items:

Other inventory items, such as objects, folders, landmarks etc. is automatically accepted bases on these settings.
Set to "AutoAccept" to automatically accept any incoming inventory offer (except notecards), or set to "Accept from master and operators only" to avoid accepting inventory offers from random avatars.


Step 3.4 - Settings -> Greet Settings

Your bot can be used to automatically greet avatars coming in to your store, venue etc.
Enable this setting to make your bot greet any new avatars when they come in range of the bot.


Greet anyone within (meters):

This value determines when the bot greet an avatar.
The value can be set from 0 to 20 meters.

The bot is using regular chat, which can only be seen in local chat if the bot is maximum 20 meters away from the avatar.

Message:

Enter the message you want the bot to greet the avatar with.
There are a few code variables reserved to personalise your message to the greeted avatar.

The message "Hello {disp_name}, welcome to {parcel}!" will greet the avatar with it's display name and the name of the parcel where the bot is standing. (ex. "Hello Mark, welcome to Pooley!").

The reserved codes that you can use is:

{first_name} - First name in legacy username, eg. "Mark"
{name} - Full legacy username, eg "Mark Resident"
{disp_name} - The display name of the avatar, eg. "Mark Johnson"
{sim} - The name of the sim
{parcel_name} - The name of the parcel

If you are missing a reserved code, please let us know.
We will add more upon request if we think they are useful to others as well. 

Invite to Invite Request Group:

If you enable this feature, the bot will send a group invitation to the Invite Request Group to the greeted avatar. 

Forget greeted avatars after minutes:

Change the value of this setting to make your bot forget it greeted the avatar after X minutes.
This is particularly useful if you want to make sure the avatar is greeted periodically or when the avatar comes back to for examle your store or venue.
If set to 0, the bot will never forget it has greeted the avatar, thus making sure the avatar will only be greeted once, ever!

The IM Command "Cleargreet" can be used to clear the bots memory of greeted avatars.


Step 3.5 - Settings -> ChatSettings

Listen to chat:

Enabling this feature will allow you to choose what chat messages your bot will see.
All - The bot will see and process messages from both avatars and scripted objects.
Avatars only - Your bot will only process chat messages from avatars.
Scripted objects only - Your bot will only process chat messages from scripted objects.


Step 3.6 - Settings -> IM Settings

AutoResponse:

If this feature is enabled, your bot will reply to anyone sending the bot an IM.
Enter a message in the textbox. This message will be used when the bot responds to an IM.

Command reply to channel:

If you want your bot to send messages to scripted objects inworld, this is the feature for you.
Enable the feature, select a channel and chat type, and your bot will be able to send any command results directly to the scripted object.

You can only use one channel at this moment.
We might extend this feature in the future depending on interest from our customers!


Step 3.7 - Settings -> Groups Settings

This feature is only used in the Client installed version of GroupTools.
The hosted version is at this moment unable to use these settings, they are therefore disabled and defaulted to not receive notices and group IM's. (Notices and Group IM's are still received, they are just not shown).


Step 3.8 - Settings -> RolePlay Settings

Overview:
Your bot can be used in different roleplay scenarios.
This feature is still under development, and thus is can more or less onlybe used as a stationary "NPC".
We are working on extending this feature to make your bot roam aswell.

Please note, if you have enabled the IM reply under IM Settings, it will be disabled when enabling the RolePlay feature!


RolePlay enabled:

Enabled or disables the RolePlay feature.

Enable reply method:

Enables replies for the Roleplay feature.

Reply with same phrase every time:

This works very much like the IM Reply feature.
Enable this, and create your message by entering a message name and message body. 

Reply with random phrase:

When this setting is enabled, your bot will randomly choose one of the reply phrases you have saved. 

Reply with 'AI':

Enabling this feature will make your bot more human like.
Your bot will use an Artificial Intelligence engine called "Alice".
It will have the brain capacity of a child and will learn to build new sentances every time it sees a new message.

Answer chat from:

Local chat - The bot will only interact with messages seen in local chat.
IM - The bot will only interact with messages seen in it's IMs.
Both - The bot will interact with messages from both IMs and Local Chat.


Step 3.9 - Settings -> Timed Messages Settings

Only master can use the Timed Commands (IM commands):

Yes - If set to Yes, only the master can use the Timed IM commands.
No - If set to No, both Master and operators can use the Timed commands.

Minimum time and Period:

If you want to ensure that your operators don't advertise in the groups too often, set this to the minimum allowed time.
Setting this value will ensure that an operator can't set Timed Messages timers below thi value.

A value of 30 minutes will ensure that a Timed Message can't have a timer with anything less than 30 minutes.


Screen shot Step 4 - Start your bot

botmanager bots populated

botmanager bot started

When you start yout bot, a popup with some info regarding your bot session is shown.
This info has no relevance to the user, except for telling you that the bot has been successfully started.

Click Close and go to the Dashboard to see more info about your bot.


Screen shot Step 5 - The Dashboard again

dashboard bot running

dashboard bot running show log

When a bot has been started, the Dashboard will show you relevant info for the bot session(s).
You can see that the bot is running by the revolving sprocket before the botname.
The number shown afterwards is the sessions process ID.

Further down you will see when the bot was started and how much this session has been costing you since you started the bot.

The button "Open Chat Log" will show all that is going on in the bots Local Chat Window. Here you will find status messages, messages from Local Chat a well as incoming IM's to your bot.