All FAQs
Please select your question category
![]()
Search FAQs
| ||||||||||||||||||||||||||||||
Please see this step-by-step guide on how to download and install GroupTools. | ||||||||||||||||||||||||||||||
To activate (change) a group, use the command Agroup followed by the group name or the UUID key of the group. To change the group title (tag) of your bot, you need to use the command Chtitle. The command needs to be followed by the role UUID key, aswell as the name or UUID key of the group. The full command to change the active title for the group "GroupTool debug2" would look like this: Chtitle 1b02b4f1-d749-8b46-9429-b6f67f5557d4 GroupTool debug2 To clear the cache, just send the command Ccache If you need to find the location of your bot and you don't have access to the bot window (ie. you are an operator of someone elses bot), just send the command Location to the bot, and it will respond with a SLURL of it's current location. Your bot can invite an avatar to a group, if the group allows it to do so.
In order to invite someone, you need to know the group key, and also the role key of the title you want to give.
(See how to get a role key).
The everyone role can be substrituted with either "0" (a single zero), or "Everyone".
So, for example to invite someone to the group "GroupTools", make sure you first got the key by running the command Group2Key GroupTools.
The output will look like the following:
[15:16:48] Midday Ibor: Group "GroupTools" has key: 21151382-82e7-9f43-db46-400f082d15fa
Next, if you want to invite to any other role/title than everyone, run the command RoleKeys GroupTools
The output will look like this:
[15:20:55] Midday Ibor: Available roles in group: "GroupTools" (key: 21151382-82e7-9f43-db46-400f082d15fa)
Role/Title name: "Owner" has key fa676ae8-7104-09bf-bfed-d1ff53738d5b Role/Title name: "Member" has key 00000000-0000-0000-0000-000000000000 If you want to invite people to the Owners role, the invite command should look like this:
Invite 21151382-82e7-9f43-db46-400f082d15fa fa676ae8-7104-09bf-bfed-d1ff53738d5b Tadao Nordenskiold
The avatar tadao Nordenskiold will shortly after get the invitation.
Or if you want the invited avatar to only have the Everyone role/title, you could shorten the command like this:
Invite 21151382-82e7-9f43-db46-400f082d15fa 0 Tadao Nordenskiold
There are two ways to get your bot to join a group.
1. Send an invitation (Anyone can invite your bot to a group, but only the master or an operator can make the bot accept the invitation!)
2. Do it from the User Interface (directly in the program).
|
All | Listens to all chat from both avatars and scripted objects |
Avatars Only | Listens only to chat from Avatars |
Scripted Objects only | Listens only to chat from scripted objects |
This setting can also be changed by IM commands, by using the command "Set ListenToChat".
For more info on how to use the command, see the command help by issuing the command "Set ListenToChat Help".
This setting will NOT affect chat sent as Instant Messages (IM) to the bot.
Your bot will ALWAYS see IM's, regardless of this setting!
(Use the nearby command to see which avatars the bot can see).
Secondly, you need to get the key of the role/title you want them to have (except if you just want them to have the "everyone" role).
The everyone role can be substrituted with either "0" (a single zero), or "Everyone".
So, for example to invite everyone on the sim, to the group "GroupTools", make sure you first got the key by running the command Group2Key GroupTools.
Role/Title name: "Owner" has key fa676ae8-7104-09bf-bfed-d1ff53738d5b
Role/Title name: "Member" has key 00000000-0000-0000-0000-000000000000
Performing a clean install can sometimes help with a few errors, as well as preventing errors when installing an update.
Start first by installing GroupTools from the Add/Remove programs in the Windows Control Panel.
When this is done, download the GroupTools Cleaner from the Download section.
If asked, choose to Run the program, rather than Save, as the program does not install itself.
When you start the program, you will see a small window with a button.
IMPORTANT:
This application will remove ALL files that is used by GroupTools.
This means your bot credentials and settings that you have saved will be removed, along with any other files that GroupTools is using.
Timed Messages will NOT be affected by this, they will be kept safe!
To find out who is nearby, simply send the command Nearby to your bot, and it will present you with a list of nearby avatars not further away than 64 meters.
Please send an email to support@grouptools.eu.
Make sure to give us your mastername.
We will remove your curent password.
Once this is done, you need to make a new backup of one of your bots to create a new password.
Yes, you can indeed share your settings.
There are currently two ways of doing that.
Export your settings for your bot(s) to a file, save it to your computer and send it to the by email, skype etc. and have your coworked import the file from the ControlCenter manually.
Export your settings for your bot(s) to a file, have it uploaded to our cloud server, and have your coworked import the file from the ControlCenter directly from the cloud server.
1.1 On your end, open the ControlCenter and find the File menu in the upper left corner.
1.1.1 Select "Export saved bots".
1.1.2 Select the bot you wish to export and click "OK".
(The top most alternative "EXPORT ALL THESE BOTS!" is visible if you have more than
one bot.
This alternative will export ALL bots into one single export file instead of one file/bot
which the other alternatives does).
1.1.3 Enter a password to protect the backup file with and click "OK".
(In case the file gets lost or stolen, it will be protected with this password).
1.1.4 Click the Save button to save the file on your computer.
1.1.5 Select a location on your computer where the file will be saved, and click "OK".
1.1.6 The file is now saved where you chose to save it. You are now ready to send the file
to your coworker.
1.2 On your coworkers end, ask your coworker to open the ControlCenter and find the File menu in the upper left corner.
1.2.1 Select "Import saved bots".
1.2.2 Select "Disk".
1.2.3 Locate the file named "GroupTool2_Settings_Bot.Name_EXPORT.zip" and click Open.
1.2.4 If your coworker already has bots registered in the ControlCenter,
the import will ask wether it should ADD the new bot to the current list of bots,
or if it should REPLACE the entire list.
If no previous bots exists, the import will simply just add the bot without any
questions.
1.2.5 Your coworker will be asked to enter the password used when creating the backup file.
Enter the password and click OK, and the bot will be added to the list in ControlCenter.
1.2.6 The bot is now added and ready to be used!
2.1 On your end, open the ControlCenter and find the File menu in the upper left corner.
2.1.1 Select "Export saved bots".
2.1.2 Select the bot you wish to export and click "OK".
(The top most alternative "EXPORT ALL THESE BOTS!" is visible if you have more than
one bot.
This alternative will export ALL bots into one single export file instead of one file/bot
which the other alternatives does).
2.1.3 Enter a password to protect the backup file with and click "OK".
(In case the file gets lost or stolen, it will be protected with this password).
2.1.4 Click the Upload button to save the file on our cloud server.
2.1.5 If this is the first time you use this service, you will be asked to create a password.
Enter a password for your account (should NOT be the same as your previous entered
backup password, second life password etc. Please make it unique.)
2.1.6 The file is now saved on our cloud server. Your coworker can now import it.
2.2 On your coworkers end, ask your coworker to open the ControlCenter and find the File menu in the upper left corner.
2.2.1 Select "Import saved bots".
2.2.2 Select "Uploaded".
2.2.3 Your coworker will be asked to enter a mastername and botname.
If they are supposed to get a backup which used the option "EXPORT ALL THESE
BOTS!", then do not enter anything in the botname field and instead check the box
labeled "Import all bots?".
2.2.4 Your coworker will be asked to enter your account password.
Enter it and click OK.
2.2.5 A new window will open, where all available backup files for this particular bot is
visible. They are stamped with date and time when they were created.
Select the file to be used and click the button "Import bot from this file".
2.2.6 If your coworker already has bots registered in the ControlCenter,
the import will ask wether it should ADD the new bot to the current list of bots,
or if it should REPLACE the entire list.
If no previous bots exists, the import will simply just add the bot without any
questions.
2.2.7 Your coworker will be asked to enter the password used when creating the backup file.
Enter the password and click OK, and the bot will be added to the list in ControlCenter.
2.2.8 The bot is now added and ready to be used!
This feature came with version 2.2.35.0
From this version, you can add/remove protection to your license, so that you can be sure that nobody is using your license without your consent.
1. Add protection
2. Change password
3. Remove protection
If you want to add protection to your license, follow these steps:
1.1. Log in with one bot.
1.2. Once your bot is ready, locate the File menu in the upper left corner.
1.3. Select License protection -> Add protection
1.4 A dialog will appear in the upper right corner, asking you to enter a password.
Enter the password you wish to use, confirm it in the field below and click OK.
1.5 Your license is now password protected no matter which bot you use.
Once a bot has logged in under your license, a password prompt will show up in the upper
right corner. If no password is given within 2 minutes, the bot will log out.
Please remember, that there is no way that the GroupTools can remember your password.
You will need to enter the password EVERY TIME the bot logs in to Second Life, even when
the bot is disconnected and automatically reconnects!
If you need to change the password, start with loging the bot in.
If you know the password but just want to change it, enter the current password when asked for
it and find the File menu in the upper left corner and select License protection ->
Change password.
If you have forgot the password, simply click the button "Forgot password" when prompted for
the password.
Your bot will log out no matter which of the above methods you are using.
An email will be sent to your registered email address, which contains a link to where you can
change the password.
Follow the link and enter a new password and you shall be ready to log in with your new
password again.
If somebody is trying to use your license and are requesting a new password, they will not be
able to change the password unless they also have access to your registered email address.
If you did not receive the email within an hour, please contact us at support@grouptools.eu
If you need to change your email address, either use the terminal at the GroupTools office,
or contact us on support@grouptools.eu
When contacting us by email, Please make sure to give us your master name.
We will contact you ASAP (either inworld or by email) to verify that you are the rightful owner
of the license and help you get the password/email changed.
If you want to remove the password protection, log the bot in and find the File menu in the
upper left corner.
Select License protection -> Remove protection.
You will be prompted for the current password, please enter it.
If the password is correct, the protection will be removed.
The GroupTools inviter is configured by editing the notecard named "config", which can be found inside the object.
The notecard consists of 7 lines, namely:
BotName = Bot Name
BotKey = Bot UUID key
ObjectKey = ObjectKey
GroupName = Group Name
GroupKey = Group UUID key
RoleKey = 0
InviteMSG = I will invite you to GroupName shortly! Please wait..
To properly configure the inviter, please enter each setting after the equal sign, making sure not to add or remove any additional lines.
It is important that each setting is on it's own line.
At the end of this article, you will see a working configuration for one of our bots (with the exception of the ObjectKey, that for security reasons has been changed).
To make a difference between the text of this guide, commands and settings, the text is bold for commands and italic for settings.
LINE 1.
First of all lines, is the identification of your bot, the BotName line.
In our case, the bot is named "Broke Trapdoor", so the first line should be:
BotName = Broke Trapdoor
LINE 2.
Next line, is the UUID key of your bot, the BotKey line.
If you don't know the UUID key of your bot, simply give the command "mykey" in an IM to your bot. Like this:
Tadao Nordenskiold: mykey
Broke Trapdoor: My key: 29d181f7-555c-4b03-95fb-94716755bf42
In our case, the BotKey should be:
BotKey = 29d181f7-555c-4b03-95fb-94716755bf42
LINE 3.
Next line is the ObjectKey. This is a special password which you set in the ControlCenter.
The ObjectKey is there to protect your bot from being used by other scripted inworld objects which you have no control of.
Without the correct ObjectKey, your bot will simply deny access to the given command.
You will find the ObjectKey setting in ControlCenter under Settings -> Misc -> Commands -> ObjectKey.
Tick the box to enable the setting, and enter a password in the text box, like this:
The ObjectKey is case sensitive.
In this case, the config line should be:
ObjectKey = MySecretObjectKey
LINE 4.
The next line, GroupName, should be quite obvious, the configuration needs to know the name of the group you wish to send invitations to.
Your bot needs to be member of this group, and be allowed to invite new members to the group and the specific (if any) role.
In our case, we want to send an invitation to the group named "GroupTool customers".
The config line should then be:
GroupName = GroupTool customers
LINE 5.
The next line is the UUID key of the group, the GroupKey line.
If you don't know the key of the group, and don't know how to find it in your viewer, you can ask the bot, using the command Group2Keylike this:
Tadao Nordenskiold: Group2Key GroupTool customers
Broke Trapdoor: ec9d8079-f51c-ec04-7d72-a225a018aac6
The bot will give you the UUID key of the group you asked for.
The config line for GroupKey should then be:
GroupKey = ec9d8079-f51c-ec04-7d72-a225a018aac6
LINE 6.
The next line is the RoleKey, which identifies which role your bot should give to your new members.
If you want your new members to have the "Everyone" role, you can simply make this setting either:
RoleKey = 0 or RoleKey = Everyone
In our case, we want to invite new members to our VIP role.
But we don't have the role key, only the name of the role.
We will then ask our bot to give us the key, by using the command RoleKeys like this:
Tadao Nordenskiold: rolekeys GroupTool customers
Broke Trapdoor: Available roles in group: "GroupTool customers" (key: ec9d8079-f51c-ec04-7d72-a225a018aac6)
Role/Title name: "GroupTool VIP" has key 902e9f64-7f2f-157d-2087-892830979bd0
Role/Title name: "GroupTool customer" has key 00000000-0000-0000-0000-000000000000
As we can see from the response of the bot, we can see that the role "GroupTool VIP" has the key "902e9f64-7f2f-157d-2087-892830979bd0".
Our config for the RoleKey should thereby be:
RoleKey = 902e9f64-7f2f-157d-2087-892830979bd0
Please note: A group member must ALWAYS be member of the Everyone role.
No matter if you invite a new member to a specific role or not, they will ALWAYS get the Everyone role as well!
LINE 7.
The very last line, is the InviteMSG line.
This line holds a message that the bot will send to the new member just before it attempts to send the invitation.
The line must be present, but can be empty.
If you don't want a message to be sent, just leave it as InviteMSG = without anything after the equal sign.
In our case, we want to notify the new member that an invitation is about to be sent.
Our config is:
InviteMSG = I will send you an invitation to the group GroupTool Customers shortly! Please wait...
So, as we are at the end of our configuration, let's show it as a full config notecard.
BotName = Broke Trapdoor
BotKey = 29d181f7-555c-4b03-95fb-94716755bf42
ObjectKey = MySecretObjectKey
GroupName = GroupTool Customers
GroupKey = ec9d8079-f51c-ec04-7d72-a225a018aac6
RoleKey = 902e9f64-7f2f-157d-2087-892830979bd0
InviteMSG = I will send you an invitation to the group GroupTool Customers shortly! Please wait...
The GroupTools inviter+ is configured by editing the notecard named "config", which can be found inside the object.
The notecard consists of minimum 2 lines, namely:
Bot=Bot Name;Bot UUID Key;ObjectKey
Group=Bot Name;Group Name;Group UUID Key;Role Key
To properly configure the inviter, please enter the settings after the equal sign, separated with semi-colons ( ; ).
It is important that the BOT and GROUP config lines are on completely separate lines.
At the end of this article, you will see a working configuration for one of our bots (with the exception of the ObjectKey, that for security reasons has been changed).
To make a difference between the text of this guide, commands and settings, the text is bold for commands and italic for settings.
LINE 1.
The BOT line.
This line is separated into 3 sections, separated by a semi-colon ( ; ).
The first section, "Bot Name", is the name of your bot.
The second section, "Bot UUID key", is the UUID key of your bot.
The third section, is the ObjectKey that you enter in the Control Center for your bot.
In our case, we want to use 2 bots.
The reason for this, is because our two different bots are inviting to two different groups, and no bot is member of both groups.
Our bots are Gaia Unplugged (sending invitations to the group Gaia Streams customers) and GroupTool Scientist (sending invitations to the group GroupTool customers).
Because of this, we need to use two different BOT lines, which would look like this:
BOT=Gaia Unplugged;b5eaa604-ef64-4784-b935-f821200441dc;MySecretObjectKey
BOT=GroupTool Scientist;fdc92d85-0bcd-4bb4-8292-8539892c251c;MySecretObjectKey
If you don't know what the UUID key of your bot(s) are, you can ask the bot(s) to give them to you.
You do that by sending the command "mykey" as an IM to the bot, like this:
Tadao Nordenskiold: mykey
Gaia Unplugged: My key: b5eaa604-ef64-4784-b935-f821200441dc
You will also need to set the ObjectKey of your bot.
You will find the ObjectKey setting in ControlCenter under Settings -> Misc -> Commands -> ObjectKey.
Tick the box to enable the setting, and enter a password in the text box, like this:
Please remember that the ObjectKey is case sensitive!
Do NOT use any spaces!
LINE 2.
The GROUP line.
This line is separated into 4 sections, separated by a semi-colon ( ; ).
The first section, "Bot Name", is the name of your bot which is member of the group in the second section.
The second section, "Group Name", is the name of the group you want your bot to send invitations for.
The third section, "Group Name", is the UUID key of the group you want the bot to send invitations for.
The fourth section, is the RoleKey, corresponding to the role, that you want the newly invited member to have.
As we in our case want to use two bots with two different groups, we need two GROUP lines.
They look like this:
Group=GroupTool Scientist;GroupTool Customers;ec9d8079-f51c-ec04-7d72-a225a018aac6;Everyone
Group=Gaia Unplugged;Gaia Streams Customers;9a878301-e910-76c8-0d4e-5733cdd1e066;2d281471-5727-5641-3321-a481a5de4311
The first line, shows that the bot GroupTool Scientist should send invitations to the group "GroupTool Customers", which has the UUID key "ec9d8079-f51c-ec04-7d72-a225a018aac6", and new members should get the role "Everyone".
If you don't know the UUID key of the group, you can ask your bot to give it to you by using the command "Group2Key" like this:
Tadao Nordenskiold: Group2Key GroupTool Customers
GroupTool Scientist: ec9d8079-f51c-ec04-7d72-a225a018aac6
We do not want our newly invited members to have any specific role other than the "everyone" role. We will therefore set the last section to "Everyone" or "0" (both works equally good).
The second line, which is a bit more special compared to the first one, shows that the bot Gaia Unplugged should send invitations to the group "Gaia Streams Customers," which has the UUID key "9a878301-e910-76c8-0d4e-5733cdd1e066", and new members should get the role "2d281471-5727-5641-3321-a481a5de4311".
In this case, we have created a special role, "Gaia Stream VIP's", which has the RoleKey "2d281471-5727-5641-3321-a481a5de4311".
The only way to get the rolekey, is by asking your bot.
As with the above example with the first group line, you get the UUID key of the group by asking your bot with the command "Group2Key".
To get the rolekeys, you use the command "RoleKeys" like this:
Tadao Nordenskiold: RoleKeys Gaia Streams Customers
Gaia Streams (Gaia Unplugged): Available roles in group: "Gaia Streams Customers" (key: 9a878301-e910-76c8-0d4e-5733cdd1e066)
Role/Title name: "Gaia Stream VIP's" has key 2d281471-5727-5641-3321-a481a5de4311
Role/Title name: "♫Gaia Streams♫" has key 00000000-0000-0000-0000-000000000000
So, as we are at the end of our configuration, let's show it as a full config notecard.
BOT=Gaia Unplugged;b5eaa604-ef64-4784-b935-f821200441dc;MySecretObjectKey
BOT=GroupTool Scientist;fdc92d85-0bcd-4bb4-8292-8539892c251c;MySecretObjectKey
Group=GroupTool Scientist;GroupTool Customers;ec9d8079-f51c-ec04-7d72-a225a018aac6;Everyone
Group=Gaia Unplugged;Gaia Streams Customers;9a878301-e910-76c8-0d4e-5733cdd1e066;2d281471-5727-5641-3321-a481a5de4311
The GroupTools Timer is configured by editing the notecard named "config", which can be found inside the object.
The notecard consists of minimum 5 lines, namely:
Admin = Firstname Resident
Botname = BotFirstName BotLastName
Botkey = Bot UUID key
ObjectKey = ObjectKey
LogOutAfter = X minutes
To properly configure the timer, please enter each setting after the equal sign, making sure not to add or remove any additional lines.
It is important that each setting is on it's own line.
Near the end of this article, you will see a working configuration for one of our bots (with the exception of the ObjectKey, that for security reasons has been changed).
To make a difference between the text of this guide, commands and settings, the text is bold for commands anditalic for settings.
LINE 1.
First of all lines, is the Admin line, which help you set who (besides you) can control (override) the timer.
(For more information about overriding the timer, please scroll down to the end of this article.)
The avatar name you enter at this line, will gain ability to handle the timer for your bot.
The admin line can hold one name only!
If you need more than one admin, simply add more admin lines.
The example config at the end of this article will show you what it looks like to have 3 admins.
In our case, we want the avatar Midday Ibor to be administrator of this timer.
admin = Midday Ibor
LINE 2.
Next line, is the BotName line. This line represents the name of your bot and will also label the timer to help you distinguish
one timer from another (especially if you need more than one).
In our case, the bot is named "Broke Trapdoor", so this line should be:
BotName = Broke Trapdoor
LINE 3.
Next line, is the UUID key of your bot, the BotKey line.
If you don't know the UUID key of your bot, simply give the command "mykey" in an IM to your bot. Like this:
Tadao Nordenskiold: mykey
Broke Trapdoor: My key: 29d181f7-555c-4b03-95fb-94716755bf42
In our case, the BotKey should be:
BotKey =29d181f7-555c-4b03-95fb-94716755bf42
LINE 4.
Next line is the ObjectKey. This is a special password which you set in the ControlCenter.
The ObjectKey is there to protect your bot from being used by other scripted inworld objects which you have no control of.
Without the correct ObjectKey, your bot will simply deny access to the given command.
You will find the ObjectKey setting in ControlCenter under Settings -> Misc -> Commands -> ObjectKey.
Tick the box to enable the setting, and enter a password in the text box, like this:
The ObjectKey is case sensitive.
In this case, the config line should be:
ObjectKey = MySecretObjectKey
LINE 5.
The next line, LogOutAfter, Is the last of all config lines.
This line tells the timer how many minutes you want your bot to stay online.
When the timer has 30 seconds left, a message will be sent to your bot and tell it to log out in 30 seconds.
The bot will send you a message and tell you that it have received the command.
Broke Trapdoor: I will log out in 30 seconds.
When the 30 second times has been reached, the bot will send you another message and then log out.
Broke Trapdoor: I was told to set a timer and log out earlier. The timer has now reached its limit, so I am logging out!
In our case, we want the bot to stay online for 10 minutes.
The config line should then be:
LogOutAfter = 10
So, as we are at the end of our configuration, let's show it as a full config notecard.
Admin = Midday Ibor
Admin = GroupTool Scientist
Admin = Gaia Unplugged
BotName = Broke Trapdoor
BotKey = 29d181f7-555c-4b03-95fb-94716755bf42
ObjectKey = MySecretObjectKey
LogOutAfter = 10
Overriding the timer
The owner of the timer, and any administrators that has been granted access in the config card, can override the timer.
When touching the timer, a menu will let you either enable, disable or change the timer settings (LogOutAfter) of the timer.
If you don't have an account, you need to create one.
The cost for account creation is 50 lindens.
The entire fee will be available for you to use towards your bots online time.
Please see the menu item "Licenses" to see what the current online time fee is, or see the FAQ article "Why do you charge for the time my bot(s) is online?" to read more about why we charge for the online time.
If you have an account however, you can find the login site in the menu under "Hosting services" -> "Control Center".
If you want to run your bot(s) on our server using the hosted services, then the answer is YES.
If you however want to continue to run your bot(s) on your own PC like you have always done, then the answer is NO!
Paying for the time your bot(s) is online is ONLY affecting those who are running their bot(s) on our server using the hosted services!
Your username will always be your Second Life username (ie. the master name).
If you have lost your password, go to our office and touch the terminal. Follow the dialogs and choose "HOSTED", then "CHANGE" and then "PASSWORD".
Your password will be reset to a new one, and will be sent to your email.
If you did not get the email withing 2 hours time, please send us a support ticket and we will help you ASAP.
At the moment of writing this article (2015-09-20), yes.
(This article will be updated as we are reducing the limitations).
The hosted services is still under development.
We have not had the time to add all features yet, and this will take time.
At the moment when the article is being written, you can:
- * Log the bot in and out.
- * Use all IM commands.
- * Send group notices and IM's by using notecards.
- * Use the Timed Messages commands by converting notecards into Timed Messages.
(Please see the FAQ article about converting notecards into Timed Messages).
The hosted service is not fully reliable yet either, in the sense of making sure your bot is online 24/7.
Right now, we are working on the following features:
- * Making sure your bot stays online until you tell it to log out.
* Making commands available through the web interface.
* Making Timed Messages available from the web interface.
Due to the limitations, we are also having a reduced online fee.
When the hosted services are having all it's intended features, the online fee will be 0.04 lindens/minute.
We will notify you at least 2 weeks (14 days) prior to any changes in the fees.
Please see the menu item "licenses" for the most current online time fee.
You will benefit from letting us host your bot if you answer yes to any or all of these questions:
- * I am using a Macintosh or Linux (GroupTools will only run on a PC using Windows).
- * I want to be able to log my bot in from my smartphone/tablet or anywhere else than at home.
- * I don't want or I can't to install GroupTools on my computer.
- * I want to be able to use my bot(s) without my computer being online/powered on.
The Hosted services simply let you have your bot(s) logged in to Second Life without the need of your PC being online/powered on.
The difference between the hosted services and the normal "stand alone" bots, are that when you are using the hosted services, you run your bot(s) on our servers and thereby don't have to download and install GroupTools on your own PC. (Please see the article "What's the benefit from letting you host my bot(s)?"
The server we make available for you to run your bots from, is not cheap.
Bandwidth (data transfered) and the hardware (the actual computer) has a substantial cost each month, which we need to cover for somehow.
We found that charging for the time that you actually use our server (when you bot has logged in properly and is fully available to be used, until you have logged it out), is the most fair to all users.
If you have any questions or an idea that would make the charge more fair, please let us know by sending a support ticket!
No, there are only two reasons why we would send any money back.
- The services is discontinued and will not be available anymore.
- You couldn't use the service at all (ie. You couldn't even log your bot(s) in.)
In any other case, your money will stay safe and secure on your account in case you decide to return to us!
Unknown error, please contact support!
Please also make sure to provide the following details:
- Your email address (we may need to contact you with questions)
- Master Name
- Bot name
- Detailed information of how what you did just before you got the error (eg. Started the program, chose bot, edited settings for X function and tried to log in).
- Screenshot (if possible)
Invalid license.
Our authentication servers could not validate your license.
Please check the following:
- You have actually registered for a license (trial or owned).
- The master name you have entered is spelled correct AND
- The master name is the same as the avatar you registered your license with.
The license is bound to it's master avatar.
Also, the master name should NEVER be the same as the bot!
Due to an unknown error, the program could not generate your authentication code.
Please restart the program and try again.
Please also make sure to provide the following details:
- Your email address (we may need to contact you with questions)
- Master Name
- Bot name
- Detailed information of how what you did just before you got the error (eg. Started the program, chose bot, edited settings for X function and tried to log in).
- Screenshot (if possible)
Not enough licenses.
This means our server has detected that you are running more concurrent bots logged in than your license allows.
This can also be a "false positive".
In case your bot logged out due to a crash, or for some other reason was not able to tell our servers that it logged out, our servers will still see your bot as online in second life.
Our automatic cleanup system takes between 2 - 5 minutes to remove your bot from the database, depending on how fast Second Life reports your bot as being offline.
Please wait a minute or two, and try loggin in again.
If you still get the same message, wait and try again.
Second Life can be slow on reporting back, this is nothing we can help.
We ask you not to contact support regarding this issue unless a minimum of 15 minutes has passed since you first encountered the problems and you tried to log back in atleast two times during these 15 minutes.
Your trial period has ended.
Please consider purchasing a license if you like the program.
Your version of GroupTools is too old.
You must update to a newer version!
Our authentication servers have detected a possible cheat to circumvent the license verification!
Your login attempt has been highlighted in our logging system.
If you believe this to be wrong, please contact support and provide us with your master and botname as well as the email address you used when you purchased your license.
Your bot has troubles to log in to a certain location and gives an error message similar to the message below.
Parcels teleport routing set to Landing Point which is at <78.9987, 157.427, 22.1517>
I will never be able to reach my target at: <75, 215, 401> unless my start location is set to my home, or the sim teleport route is changed to "Anywhere".
or
Parcels teleport routing set to Landing Point which is at <78.9987, 157.427, 22.1517>
Error code: 800
Please see the FAQ entry at http://grouptools.eu/faq/error-codes#800 for more info!
This message is displayed when you have set the bot to log in at a certain location, while the land parcel it is trying to log in to is enforcing a different teleport location.
There are three ways to solve the issue:
- Set the parcel teleport routing to Anywhere.
- Change the bot's login location to the same as the parcel landing point.
- If the land is group owned, invite the bot to the group owning the land, and make sure the bot has a role which allow the bot to override the teleport routing.
The officers role usually allows to override the teleport routing.
When a bot is logging in, it will, among other things, report to the authentication server that it is going online using a certain license.
When it logs off, it will tell the authentication server that it is logging off and thereby not using the license anymore.
If the bot is crashing, the authentication server will still see the bot as being online since it didn't report that it logged off.
In these circumstances, we rely on Second Life to report to us whether your bot is online or not.
Second Life servers can take anything from 30 seconds up to 5 minutes before it reports the bot as being offline.
However, when you logged in and got the error message from the authentication server, you also hurried up the process for Second Life servers, which is now logging the crashed avatar off from the grid, thus reporting back to us that it is offline.
Waiting a few seconds and then trying to log in again usually solves this problem.
If not, please wait another 2 or 3 minutes and then try again.
If you still can not log in, please contact support!
Yes!
We have added a feature for you to import and convert your notecards to Timed Messages.
Depending on how many notecards you want to import, there are two ways of doing it.
Please read the "Please beware of:" section at the end before importing.
Importing one-by-one by dropping the notecard to the bot
(Best when importing ~5 notecards)
Open an IM with your bot and send the command timed import
Your bot will now ask you to give it a notecard.
When giving the notecard, the bot will read it and convert it to a Timed Message
and let you know when it's done.
Repeat for each notecard you wish to import.
Importing directly from the inventory of the bot
Log the bot out from the GroupTools viewer and log it in from a normal viewer like Firestorm
or a linden viewer.
Transfer all the notecards you want to import to the bot avatars inventory.
Log out and log back in using the GroupTools viewer.
Open the inventory, rightclick the notecard you want to import
and select "Import to Times Messages"
The bot will read the notecard and convert it to a Timed Message and let you know when
it is finnished.
Repeat for each notecard you want to import.
You can also import by double-click the notecard to preview/edit it before importing.
If you are editing, please save first, then click "Import as Timed message" from the
Notecard menu in the upper left corner.
Please beware of:
1. When importing the notecard (no matter which method you are using), any attachments
to the notecard will be saved to the bots inventory.
DO NOT DELETE THE COPIED INVENTORY ITEM!
Doing so will cause your bot not to be able to attach the inventory item to any notices.
2. When the notecard has been imported, the notecard can safely be deleted. Just don't delete
any attachments that was copied from the notecard as described above.
3. If you get an error that says the notecard is not correctly formatted, it means the bot could
not recognize the notecard as a notecard used for notices and IM's.
Please look over your notecard and try again!
4. If you want the Group IM to be different from the notice, you can add the following at the
end of the notecard:
#INDIM
YOUR INVIVIDUAL GROUP IM MESSAGE HERE
#END_INDIM
If you want a SLURL attached to the message, you also need to manually add it to the
individual IM.
Yes, it is!
Just as with the notecards, you need to use an Operators group (read more about that in FAQ -> How to -> How can my friend or associate use my bot?).
Once your friend/associate is a member of this Operators group, they can start using your bot.
They manipulate your Timed Messages by using IM commands, and these are the commands they need to use:
Command | Full syntax | Description |
Activate | TBD | Not yet in use. This command will be available at a later time. The command is supposed to give the operator the ability to activate a timer for the saved message. |
Deactivate | TBD | Not yet in use. This command will be available at a later time. The command is supposed to give the operator the ability to deactivate a timer for the saved message. |
Delete | timed telete # |
This command can be used to delete a saved message. You may have to use Timed List first to see the |
Export | timed export # |
This command can be used to export a saved You may have to use Timed List first to see the |
Import | timed import # |
This command can be used to import a saved You may have to use Timed List first to see the |
List | timed list |
When the bot receives this command, it will |
Mod | TBD | Not yet in use. This command will be available at a later time. The command is supposed to give the operator the possibility to edit the saved message. |
Send | timed send # |
This command is used to send a saved message. If it is saved as a template to send both notices You may have to use Timed List first to see the |
View | timed view # |
Not yet in use. |
Please see this guide for a step-by-step description of how to set up Timed Messages.
The PRO version of GroupTools currently have 102 IM commands,
-and 41 Scripted Object Commands available.
The LITE version of GroupTools currently have 61 IM commands,
-and 7 Scripted Object Commands available.
The amount of commands will grow larger as GroupTools is being developed.
Please don't hesitate to contact us with any feature requests or commands you wish it had.
All the columns are sortable.
By default, the list is sorted by Command category.
You can sort the commands differently by clicking the column headers.
{aridatatables moduleId="106"}
{aridatatables moduleId="103"}
{aridatatables moduleId="104"}
If you want your bot to be able to answer other avatars with it's Artificial Intelligence capabilities,
there are some settings in the Control Center you need to make.
This video will show you a demonstration of how it works and which settings to make.
http://vimeo.com/83183931
You can find the settings in the Control Center under Settings -> RolePlay.
Enable RolePlay by checking it's box, then enable Replies under the Talk tab.
Select "Reply with 'AI' ".
A popup will notify you that you need to adjust some settings under Misc -> Chat.
Remember this, and proceed by selecting what kind of messages the bot should reply to.
Local Chat | The bot will only reply to chat coming from Local Chat. |
IM | The bot will only reply to chat coming from IM. |
Both |
The bot will reply to chat in both IM and Local Chat. |
Now go you the Misc tab, and then to Chat.
Enable Listen to chat and select either Avatars Only or All, depending on your needs for other features in GroupTools.
All | The bot will notice chat coming from both avatars and scripted objects. |
Avatars only | The bot will notice chat avatars and ignores chat from scripted objects. |
Scripted objects only |
The bot will notice chat coming from scripted objects and ignores chat from avatars. |
You are now done and ready to log in!
IMPORTANT:
Please keep in mind, that your bot will NOT answer chat in local chat unless spoken to by name!
The name or display name of your bot MUST be used somewhere in the sentence every time you want it to reply.
There are three ways of getting help.
1. There is a group inworld called "GroupTools customers".
This group should be seen as a forum where mainly customers can connect and help eachother.
Of course, if a support rep is online and is seeing the question, they will answer too.
2. On the website is a link in the left hand menu to contact support.
Using this will create a ticket and is one of two preferred ways of getting help from us.
A ticket will be created shortly after you have submitted the form and a confirmation that we got your message should be sent to your email.
When we answer, the reply will end up in you email inbox, so please make sure you entered correct email address and keep an eye on your inbox.
We normally answer within an hour.
3. Using the "Contact support" button in the GroupTools Control Center or the GroupTools bot window.
If you have a bug or error to report, please use the button in the bot window before closing it (if possible), as this will give us more info regarding your problem aswell as giving you the opportunity to attach a screenshot of the problem.
In all other cases, please feel free to use the button in the Control Center.
As with submitting your question at the website, this will create a support ticket.
Please make sure your email address is correct and look for our answer in your email inbox.