METAbolt: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
Line 51: Line 51:
Now you need to choose whether you want to enable LSL commands for everyone, or just the master avatar (a/k/a, your bot).  
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.
Also see the '''[http://www.metabolt.net/METAwiki/index.php?title=Preferences METAbolt preferences page]''' for more details.


==== Enabling LSL commands for all ====
==== Enabling LSL commands for all ====

Revision as of 19:25, 7 October 2014

Schaue hier in Deutsch!

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).

If you wish to read more about METAbolt, you can do so at the METAbolt website.

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: https://github.com/CasperTech/METAbolt/releases/latest

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.

Caution on METAbolt RE-installs

Double-check your METAbolt security settings as well as the METAbolt password - if you've had to UNinstall, and then REinstall, your METAbolt client these WILL have changed, and unless you update your settings in CasperVend and/or CasperLet, your invites/ejects will no longer happen.

If you have simply installed the new version over the old version, you should be fine.

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.

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.

Enabling LSL commands for all

1) On the top menu, go to "Applications", then "Preferences", then "General"
2) Click the "Security / L$" tab
a) Leave avatar UUID as all 0's
b) Leave object UUID as all 0's
c) UNcheck both the options for:
  • "Enforce LSL Security"
  • "Limit LSL commands to above avatar and object"
3) Click "OK" - window will close

Limiting LSL commands

1) Run METAbolt
2) On the top menu, go to "Applications", then "Preferences", then "General"
a) Click the "Security / L$" tab
b) Put in the master avatar (your bot) UUID
c) AND / OR put in the master object UUID
d) Tick the box for "Enforce LSL Command Security"
e) Click "OK"
3) On the top menu, go to "Plugins" then "Plugin Manager"
a) Put in the master avatar (your bot) UUID
b) AND / OR the master object UUID
c) Check the box for "limit LSL commands to above avatar and object
d) If you like, also check the box for "Display LSL Commands on MB_LSLAPI window"
4) Click "apply" - window will close

Finding Avatar / Group / Role keys

For all three of these activities, you will need to be logged in to METAbolt with your bot avatar.

1) Finding the group key - this is the UUID of the group:
a) Open up an IM window with the group
b) Click "Group info" on the menu bar - this will pop up the group floater
c) Copy the group's UUID from the top of the "general" tab
2) Finding the role key - this is the UUID of the role within the group:
a) On the group floater, click "Members & Roles" tab
b) Click the role you want to invite renters to
c) Copy the role's UUID from the "selected role" line above the role list
3) Finding the avatar UUID
a) On the top menu, go to "Applications", then "Preferences", then "General"
b) Click the "Security / L$" tab
c) By default, the key of the avatar logged in will show under "master avatar"

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".

Do NOT use your Second Life or CasperTech passwords here!

Group Invites in CasperVend

Click for larger image
  • 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:
  1. Bot UUID: This is the avatar key of your bot. It's displayed in the "Chat" tab after you login to METAbolt.
  2. 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.
  3. 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.
  4. 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 (Bulk)

Click for larger image
  • 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:
  1. Bot Key: This is the avatar key of your bot. It's displayed in the "Chat" tab after you login to METAbolt.
  2. 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.
  3. 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.
  4. Password: This is the "password" you set in the last section.
  • Click "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.

Group Invites in CasperLet (Per-Unit)

File:CL Unit Bots Numbered.png
SmartBots / CasperLet Per-Unit
Click for larger image
  • Click the (C)asperLet logo on the unit inworld
  • Select "config" from the popup menu
  • Log in to CasperLet
  • You will be on the unit's configuration page
  • Scroll down to "Group Invite Bots"
  • Click "Add New Bot" - you'll get a popup box
  • Use the pulldown to select the type - choose "MetaBolt"
  • Click "Add"
  • A series of blank lines will appear
  • Enter your bot key, role key, group key, and master password in the appropriate boxes
  • Click "Add"
  • Done!

METAbolt Proxy (CasperLet) - MB versions 0.970 and earlier

NOTE: This applies ONLY to MetaBolt versions PRIOR TO v0.971 - as of 0.971, the proxy is no longer required.

Rez the METAbolt Proxy out. This needs to STAY rezzed out, so pick a place you won't have to move it from later.

  1. Pick a place to rez it out
  2. Rez the metabolt proxy out
  3. 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 because 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.

Limitations

  • The bot's group role MUST have eject capability, if you want them to eject group members
  • The bot CANNOT eject officers or owners in the group
  • Only the Lindens can actually eject group owners