GroupBots: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
Line 82: Line 82:
1. Start your Thoys bot software
1. Start your Thoys bot software


2. If you don't already have a bot added, please add and configure your bot according to Thoys' instructions
2. If you don't already have a bot added, please add and configure your bot according to [http://slbot.thoys.nl/?page=manual Thoys' instructions]


3. Please make sure your bot is added to the group, with rights to invite (and eject if necessary).
3. Please make sure your bot is added to the group, with rights to invite (and eject if necessary).

Revision as of 11:06, 19 December 2016

Schaue hier in Deutsch!

What will bots do?

A properly set up bot is capable of handling both invites and ejects for groups - either on rentals (for CasperLet) or product purchase (for CasperVend; both inworld and Marketplace) and if you choose to use a "personal bot" from SmartBots, the bot is also capable of handling bot-based delivery, ideal for products that are no-copy. (Inventory drops from scripted gadgets simply vanish, never to be seen again, if accidentally declined. If an item is sent from an avatar, it at least goes to the trashcan first when it's accidentally declined.)

Bots are also able to send IM notifications from CasperLet - this means less chance of your renters missing the scripted message in local chat.

Terminology


Bot: A unattended avatar account, used for automatic programmed activities or responses
Hosted Service: You pay a third party to host the bot for you. Generally, you pay every week, and they are responsible for making sure everything is running.
Self-Hosted: You need to host the bot yourself, on your own computer. If you don't keep a computer on 24/7 already, then self-hosting is probably not for you.

Hosted Service

SmartBots

SmartBots is a third party bot hosting service that also allows you the option to have your own bot account hosted by them (so you don't have to run your computer 24/7 for your bot).

SmartBots Information


  • SmartBots has a weekly fee. This may be paid at the terminal at Casper's store.
  • For information on pricing, see the SmartBots price list.
  • The two types of SmartBot bots used with CasperTech products are the group inviter bot and the personal bot.
  • Both Inviter bot and Personal bot will also handle sending IM notifications for CasperLet as well as group invites.

SmartBots Instructions


  • For details on setting up your SmartBots bot, see the SmartBots page.

Sit, Rover, Sit!


To get your bot to sit on an object (pose stand, chair, etc.) follow the instructions on the SmartBots site. These instructions are originally set up for SmartBots, but might work for other bots as well.

You will need the UUID of the object you want your bot to sit on. In Firestorm, you will see the object's UUID if you right-click then select "Edit". If you're using any other viewer, you can simply copy this script into a script file in your object, and once the script saves, it will tell you the UUID of the object in local chat (just open up your chat buffer and look for yellow text):

 default{
 state_entry(){
   llOwnerSay("This object's UUID is: " + (string)llGetKey());
   }
 }

If you re-rez your object, it will get a new UUID, so you will need to use this script again to make sure your bot is up to date.

Self-Hosted

In order for self-hosted bots to be used, they must be running 24/7 on a machine that YOU control.

Corrade Bot - Advanced Users Only

June 2016: It is recommended to use the "Progressive" version 9.9.1 or later to work with CasperTech products; it has an automated configuration tool (the "configurator") to help you get your bot configured faster.
  • Corrade is for advanced users - the setup will be confusing for inexperienced operators.
  • Corrade is free to download and use
  • Full documentation is at Grimore.org

Minimum System Requirements


  • Unix: Linux or BSD + Mono 3.2.8
  • Windows: .NET framework 4.5
  • x86 or ARM dual-core CPU
  • 250MB RAM
  • Always-on internet connection
  • An editor that loads and saves files encoded in UTF8

Corrade Instructions


See the Corrade Bot page for details. Windows instructions courtesy of Aphrodite Atlas.

ThoysBot

Minimum System Requirements


  • Windows XP SP2, Win2000, Vista or Windows 7
  • .NET framework 3.5 or higher
  • Always-on internet connection

Instructions

1. Start your Thoys bot software

2. If you don't already have a bot added, please add and configure your bot according to Thoys' instructions

3. Please make sure your bot is added to the group, with rights to invite (and eject if necessary).

4. Go to Tools -> Configuration, "Bots" tab, and click the name of your bot

5. Under "Remote security code (KEEP THIS SECRET)", set a unique password. Don't use the same password that you use for anything else.

6. Make sure your own avatar (usually the avatar who purchased CasperLet) is added as an "Owner".

7. Click "Apply".

8. Log your bot in.

9. You need to get the UUID for your bot, and for your owner avatar. In the Thoys Bot console, type:

/name2key firstname lastname
For example, for a bot called "Group Resident", type:
/name2key group resident
Do the same for the owner avatar, and take a note of the UUIDs you get.

10. On the CasperLet website, click "Add Bot", and choose Thoys Bot. Click Next.

11. Fill in the form as so:

Label: Anything you like
Bot UUID: The bot key you obtained in step 8
Group Name: The EXACT name of the group to invite to
Security code: The password you set in step 4
Bot Owner Avatar UUID: The owner key you obtained in step 8
Role UUID: Leave blank, unless you need to specify a role - see the instructions below.
Default: Tick this unless you only want this bot active on a few of your units.

Role UUID

In the Thoys bot software, type:

/roles Your Group Name

For example, with the CasperTech group, we'd type:

/roles CasperTech User Support Group

The roles will be listed as:

<Number>. <Name> <UUID>

For example:

5 Everyone 00000000-0000-0000-0000-000000000000

The long string at the end is the Role UUID. This is what you need to copy and paste into the bot configuration under Role UUID.

Deprecated

These bots are no longer developed and/or maintained. As of June 2016, they currently still work, but any existing - or new - bugs will not be fixed.

METAbolt

METAbolt is a free text-based viewer for Second Life. METAbolt is popular for self-hosted bots because it needs minimal setup, and takes minimal system resources on the computer it is running on (so multiple instances can be running simultaneously).

Minimum System Requirements


  • Microsoft .Net 3.5 SP1 - Download
  • Windows: XP/SP2, Vista, Windows Server 2003, Windows 7, Windows Server 2008
  • Always-on internet connection

METAbolt Installation


  • Download and install .Net if it's not already
  • Get METAbolt - Download
  • Open the .zip file and double-click on "setup.exe"
  • Let the install complete

METAbolt Instructions


  • See the METAbolt page for details on setting up your bots.

PikkuBot

PikkuBots is a bot system that allows you to download and self-host one or more bots, or they can host the bot for you. Pikku has 49 commands available for the "lite" version, and over 500 commands available for the "premium" version, whether or not you self-host or have them host a bot for you. Be aware that while PikkuBot is very powerful in features, it is potentially very complicated to get fully set up. If you get "lost" easily, consider METAbolt (if you want to self-host) or SmartBots (if you want to have someone else host the bot) instead.

Minimum System Requirements


  • Microsoft .Net 3.5 SP1 - Download
  • Windows: XP 32bit / 64bit, Vista 32bit, Home Server 32bit, 2003 Server 32bit / 64bit (others may work but are NOT tested)
  • Apple: Mac OS X 10.5 or later
  • Linux: Linux with Mono-Beta
  • Always-on Internet connection, for self-hosting

PikkuBot Installation


  • Download and install .Net if it's not already
  • Get PikkuBot Installer - Download
  • Double-click on the installer.exe
  • Let the install complete

PikkuBot Info


Adding PikkuBot to CasperLet


  • See the config section on the Metabolt page for details on adding Pikkubot (they use the same configuration screen.)

PikkuBot bug


  • Your PikkuBot can NOT be on the same sim as ANY of your vendors, OR any neighbouring regions right next door to a region with your vendors, or group invites will not work. If you move your bot to another region, you may need to wait up to 2 minutes before invites will start working.

This is due to Pikkubot not understanding messages delivered with llRegionSayTo.