METAbolt: Difference between revisions
Line 30: | Line 30: | ||
You will need to invite your bot to your group, and give them the appropriate roles. | You will need to invite your bot to your group, and give them the appropriate roles. | ||
== '''<span style="color:#00528c">Enabling the LSL Plugin</span>''' == | |||
To do more than just invite users to the group(s) on a specific event, you will need to enable the LSL plugin. Use the following steps: | |||
: 1) Run METAbolt | |||
: 2) On the top menu, go to "Plugins", then "Plugin Manager" | |||
: 3) Select "MB_LSLAPI" from the list | |||
: 4) Click the right arrow to bring it to the right-hand window. | |||
: 5) Click "apply" | |||
: 6) Restart METAbolt | |||
Now you need to choose whether you want to enable LSL commands for everyone, or just the master avatar (a/k/a, your bot). | |||
Also see the [http://www.metabolt.net/METAwiki/Default.aspx?Page=Using-Preferences METAbolt preferences page] for more details. | |||
== '''<span style="color:#00528c">Configure METAbolt for Group Invites</span>''' == | == '''<span style="color:#00528c">Configure METAbolt for Group Invites</span>''' == |
Revision as of 02:25, 10 July 2013
Introduction
METAbolt is a lightweight text client for Second Life. It's also free, which makes it a great choice for people who want to run a bot, in order to send automatic group invites, group ejects, and such.
This page provides detailed information on the exact settings you need to get METAbolt working with CasperVend and CasperLet for group invites (and ejects).
Self Hosted
Before we begin, it should be noted that METAbolt will be a "self hosted" bot. That means, you have to run software on your computer 24/7 in order to keep the bot online.
It can cost quite a bit of money to keep a PC online 24 hours a day. If your computer is NOT normally on 24/7, then financially, it might make more sense to buy a SmartBots subscription - this costs L$79 per week, or roughly 31 cents, per group. You can sign up at the SmartBots website - and there are terminals in the CasperTech store for payments, at http://maps.secondlife.com/secondlife/Izanagi/194/58/132.
However, if you already have a PC online most of the time, or you have an additional server you'll be using for this, then read on!
Install METAbolt
First, you need to install the METAbolt client. You can get the latest version from here: http://www.metabolt.net/download.aspx
Once you have it downloaded, open the archive (the zip file you downloaded), move the files out to somewhere on your computer, and run the "Setup.exe" file. This will install METAbolt.
Run METAbolt
Run the METAbolt viewer. You will need to login with your bot avatar (if you haven't made one yet, you can create a new avatar here).
GroupMan Pro
This plugin is NOT REQUIRED in order to send group invites using METAbolt and your CasperTech system. However, we highly recommend you consider purchasing it in order to support the development of METAbolt.
Set Up Your Group
You will need to invite your bot to your group, and give them the appropriate roles.
Enabling the LSL Plugin
To do more than just invite users to the group(s) on a specific event, you will need to enable the LSL plugin. Use the following steps:
- 1) Run METAbolt
- 2) On the top menu, go to "Plugins", then "Plugin Manager"
- 3) Select "MB_LSLAPI" from the list
- 4) Click the right arrow to bring it to the right-hand window.
- 5) Click "apply"
- 6) Restart METAbolt
Now you need to choose whether you want to enable LSL commands for everyone, or just the master avatar (a/k/a, your bot).
Also see the METAbolt preferences page for more details.
Configure METAbolt for Group Invites
Once METAbolt is running, you need to give it a password.
- Press CTRL + P to bring up the "Preferences" window.
- Select the "General" tab on the left
- Select the "Security/L$" tab up top (you may need to scroll)
- Under "METAbolt password", a password is displayed. EITHER make a note of this password, or change it to something else, and remember it.
- Hit "OK".
Group Invites in CasperVend
- Log-in to your CasperVend account.
- Switch to the "Products" tab.
- Edit one of the products for which you want to send group invites when purchased.
- Under "Metabolt", set the following information:
- Bot UUID: This is the avatar key of your bot. It's displayed in the "Chat" tab after you login to METAbolt.
- Group UUID: This is the group key of the group you want to invite users to. To find the UUID, click the "Groups" tab in metabolt and then select the group you want to invite to. The UUID will be displayed up to.
- Role UUID: If you want to just invite to the "Everyone" role, leave this blank. Otherwise, to get the role UUID, go to "Groups" from the top menu in METAbolt. Select the group you want to invite to, and click "Info". Then select the "Roles" tab, and you will see the role UUID's listed.
- Password: This is the "password" you set in the last section.
- Save the product (save button at the bottom).
- Do the same to the next product, and continue until you've set invites on all the products you want.
You are now set up to use METAbolt for group invites for CasperVend!
Group Invites in CasperLet
- First, please rez the "METABolt Proxy" included with your rental system. This needs to stay rezzed, but you can put it anywhere in Second Life. If you can't find this, please redeliver the latest version from the CasperTech store.
- Log-in to your CasperLet account.
- Click the "Group Bots" icon at the top.
- Under "Metabolt", set the following information:
- Bot Key: This is the avatar key of your bot. It's displayed in the "Chat" tab after you login to METAbolt.
- Group Key: This is the group key of the group you want to invite users to. To find the UUID, click the "Groups" tab in metabolt and then select the group you want to invite to. The UUID will be displayed up to.
- Role Key: If you want to just invite to the "Everyone" role, leave this blank. Otherwise, to get the role UUID, go to "Groups" from the top menu in METAbolt. Select the group you want to invite to, and click "Info". Then select the "Roles" tab, and you will see the role UUID's listed.
- Password: This is the "password" you set in the last section.
- Hit "Save".
You are now set up to use METAbolt for group invites with CasperLET! If you also want to eject users when their tenancy expires, read on.
METAbolt Proxy (CasperLet)
Rez the METAbolt Proxy out. This needs to STAY rezzed out, so pick a place you won't have to move it from later.
- Pick a place to rez it out
- Rez the metabolt proxy out
- That's it! Done!
The proxy is needed IF you plan to have metabolt eject users, as well as invite. If you are only inviting (such as most CasperVend merchants would be), then the proxy is NOT needed.
The proxy is no-transfer since it should never be deeded.
Configure METAbolt for Group Ejects
Configuring METAbolt to eject expired CasperLET tenants is a little more tricky. Please follow the following instructions closely.
- Please ensure you still have the "METABolt Proxy" object rezzed, as described above.
- Please download the MB LSL API plugin, available here: http://www.metabolt.net/metawiki/lslcommands.ashx
- In METAbolt, hit "Help" in the top right, and then "About". Take a note of the "Data Dir".
- In Windows, hit Windows Key + R, to open up the "Run" prompt. Paste in the Data Dir mentiond above.
- Double click on the Extensions folder.
- Extract the MB_LSLAPI.exe file from the archive you just downloaded, to the Extensions folder you opened.
- Restart METAbolt (close it, re-open it, and login)
- Go to "Application", then "Preferences".
- On the left, scroll down to "Plugins".
- Click the "MB_LSLAPI" plugin, and then click the ">" button to activate it.
- Now scroll to the "General" tab on the left.
- Up top, select the "Security/L$" tab.
- Please ensure that "Enforce LSL command security" is NOT TICKED, and that both "Avatar UUID" and "Object UUID" are set to "00000000-0000-0000-0000-000000000000". Don't worry, this won't let anyone use your bot, because they still need the password you set.
- Now, please close the METAbolt preferences by clicking OK.
You will now need to do the following, and do it again every time you run METAbolt:
- Click on the "Plugins" button up top.
- Click "MB_LSLAPI".
- A black window will pop up. Click "Hide" - DO NOT CLICK CLOSE (the LSL api will NOT work if you use the "close" button).
Congratulations! Your MetaBOLT bot is now set up to eject users from the group.