Showing posts with label notecard. Show all posts
Showing posts with label notecard. Show all posts

Monday, October 31, 2011

Setup the Smart Tip Jar with the Pandorabot METAbolt Add-On

You can easily configure your Pandorabot METAbolt Add-On so that it will operate with the Restless Studio Smart Tip Jar. This can allow your Smart Tip Jar to accept tips, trigger outfit changes, and chat emotes when tipped. Normally the Smart Tip Jar is used in conjunction with the Smart Dance Pole to accept tips and trigger outfit changes of a pole dancer. However, it can also be used in conjunction with the latest Pandorabot METAbolt Add-On.

To configure your Pandorabot METAbolt Add-On to work with the Smart Tip Jar, edit the METAbolt_Config notecard in the add-on's Contents. Set the following variables at the top of the notecard:

DEFAULT_OUTFIT_UUID = some-clothing-folder-uuid
NAKED_OUTFIT_UUID = clothing-folder-uuid-used-when-tipped
TIP_LISTEN = TRUE

Also edit the Tip_Config notecard in the Smart Tip Jar's contents and set the following variables at the top of the notecard:

DANCER_NAME = Bot's Fullname
WILL_STRIP = TRUE

The NAKED_OUTFIT_UUID is the UUID of the clothing folder that will be worn when the tip threshold is reached. The DEFAULT_OUTFIT_UUID is the UUID of the clothing folder worn after the tipped outfit duration is over. Setting WILL_STRIP = TRUE simply means that your bot avatar will change outfits when the tip threshold is reached - that may or may not be a naked outfit, it's up to you.

In addition to the above notecard changes, follow the setup procedure detailed in the Restless Studio Smart Tip Jar Manual.

You can purchase the Restless Studio Smart Tip Jar on the Second Life Marketplace.

Friday, October 21, 2011

Moving the Pandorabot METAbolt Add-On Into Another Object

The Pandorabot METAbolt Add-On base prim is, by default, a box. The box disappears when the METAbolt logged in avatar bot sits on it and reappears when the avatar logs out. What if you want that base prim to remain visible and you want it to be something other than a boring box ? Maybe you want it to be a drum kit for your bot drummer or a bar for your bot bartender. Here's how to do that.

First, get the latest Pandorabot METAbolt Add-On from the Second Life Marketplace or by exchanging your current base prim for the latest. Follow the setup procedure described in the Pandorabot METAbolt Add-On Manual but add these two settings to the METAbolt_Config notecard:
INVISIBLE_BASE = FALSE
RESIZE = FALSE
Set TEXT_ENABLED = FALSE in the Configuration notecard.

That's it, you can move the scripts and notecards into any object that has Modify permission. I've even had success moving the scripts into already scripted objects although of course this can be problematic if the existing scripts have channel or other conflicts with the Pandorabot METAbolt Add-On scripts.

When moving the Pandorabot METAbolt Add-On to another object it may be necessary to adjust the sit target. This is a vector consisting of 3 offsets from the base prim - left/right, forward/back, and up/down. The sit target can be specified in the METAbolt_Config notecard with the TARGET setting. For instance, a sit target for a thin vertical object where you want the avatar at the bottom of the object might be:
TARGET = <0.0,0.0,-0.6>
A drum bot might need a sit target toward the rear of the object:
TARGET = <0.0,-0.5,0.2>

Thursday, September 22, 2011

Help If You Get Stuck In Setup

It's not unusual for a first time customer to get confused or stuck when setting up their Pandorabot. This is especially true of the Actorbot and METAbolt Add-Ons as they are a little more complicated. I'll try to distill down the most common problems in setup here and in a "Help" notecard.

1. Read the Manual
The first thing I do when contacted for assistance in setting up a Pandorabot is to point out the PDF manual and make sure the user is following the step-by-step setup procedures detailed there. The manuals are included in the product as a notecard but are far easier to read in PDF format. Each Pandorabot model has its own manual but all of them include the Pandorabots Owner Manual V5. In addition to the base Pandorabot setup, if you have purchased either the Actorbot or METAbolt Add-On then there is a manual for that as well:
If you have one of the Add-On's then start with that manual and use the Pandorabot Owner Manual V5 for later configuration of your Pandorabot. If you have the Pandorabot V5 then ignore the Add-On manuals and start by reading the Pandorabots Owner Manual V5.

2. Read the Configuration Notecard
By far the most common error in Pandorabot setup is mistakenly thinking you have set a configuration in a notecard when all you really did was modify a comment. All of my configuration notecards are in the following format:

setting_1 = value_1
setting_2 = value_2
END_SETTINGS
#
# Configuration notecard for the <whatever> script.
# Settings are specified in the format "<name> = <value>"
# DO NOT use "=" in either the <name> or <value>
# Place any uncommented configuration settings above the
# END_SETTINGS line above. Lines below END_SETTINGS
# will not be read and are here for information and help
# configuring.
#
# Comment describing setting_1
# setting_1 = default_value_1
#
# Comment describing setting_1
# setting_2 = default_value_2

You have to make your configuration settings above the END_SETTINGS line and delete the "#" character from the beginning of the line.

3. Isolate and Describe Your Problem
Know which step in the step-by-step setup process you are on. Be able to describe what you have done and what results you are seeing. How does that differ from the expected behavior ? It's hard to help when all I know is "I'm stuck!" or "It's broke!". I can provide assistance only if I know where you are, what you have done, and what you are seeing. So, take notes and follow the step-by-step setup procedure until you hit a snag. Then tell me exactly what you have done and where you are. This really helps. It's also often helpful if Actorbot or METAbolt users test their 3rd party text client first by logging the alt in with either Actorbot or METAbolt then logging themselves in with a standard viewer. Is the alt there ? Did it get successfully logged in with the text client ?

4. Send me an Instant Message or E-mail
I can see my Second Life IM's in my email even when I am not logged in to Second Life. I can also reply to IM's via email when not logged in to Second Life. You can IM me (Missy Restless) anytime. You can also send email to missyrestless@gmail.com. Because of timezone differences and scheduling conflicts I may not get to your message right away or even that day. Don't waste your time with a message like "Can you help ?" then wait a day for me to say "Yes" then another day for you to say what the problem is. Describe your problem, the steps you have taken, and the outcome you have observed in your initial request for assistance. Just assume I will help - I will. Do not hesitate to contact me if you are stuck.

5. Send me a copy of your notecard(s)
It often helps me to understand what you have done if I can review your configuration notecard(s). The Pandorabot base prim contains the Pandorabot V5 configuration notecard named "Configuration". If you have the Actorbot Add-On then there is another configuration notecard called "Actorbot_Config". If you have the METAbolt Add-On then the add-on configuration notecard is called "METAbolt_Config". The Greeter configuration notecard is called "Greeter_Config". To send me one or more of these notecards:
  • Login to Second Life as yourself using a standard viewer
  • Edit the Pandorabot prim - right click the prim and select "Edit"
  • Click on the "Contents" tab of the edit window
  • Click on the notecard you want to copy
  • Drag the notecard to your inventory
  • Open my Second Life Profile (e.g. search for Missy Restless)
  • Drag the notecard from your inventory onto my profile window
  • Send me an IM telling me what notecard(s) you sent me
I hope this helps a little. Let me know what other help tips I should add to this post and the Help notecard.

Sunday, September 18, 2011

How to Setup a Quiet Model Pandorabot

Recently I assisted a shop owner with the setup of 6 Pandorabot METAbolt Add-Ons to be used as models in her store. Basically, the Pandorabots just needed to login, stand in a pose before a product board, wear the skin/shape/clothing/attachments the shop was selling, and shut the f**k up. If you want to deploy multiple "quiet" Pandorbots, here is how to do so.

First, set NAME_ENABLED = TRUE. This means that the Pandorabot will only respond to chat that includes either her first or last name. Set the first and last names to some strings not commonly used in chat. Also, set the CHANNEL to a non-zero value - the bot will be listening on a private channel and not on local chat. Set AI_ENABLED = FALSE.

Here is an example Pandorabot Configuration notecard for a "quiet" Pandorabot:

FIRST_NAME = Something_Not_Common
LAST_NAME = Also_Not_Common
NAME_ENABLED = TRUE
TEXT_ENABLED = FALSE
RESTRICTED_ACCESS = 1
CHANNEL = 9
GREET_ENABLED = FALSE
AI_ENABLED = FALSE

If you are deploying a Pandorabot as a model you may not want her to act as a greeter, issuing a welcome to new arrivals and delivering notecards and landmarks. To disable the greeter functionality of the Pandorabot, simply delete the Greeter script from the Pandorabot's base prim. You may want to make a copy of the Greeter script before deleting it. Delete the Greeter script in all Pandorabot model's base prims.

If you have multiple Pandorabot METAbolt Add-Ons deployed in the same general vicinity then you need to assign them unique channels. Edit the METAbolt_Config notecard and set the CHANNEL for each Pandorabot to a unique positive integer.

Tuesday, June 28, 2011

Fix for Actorbot/METAbolt Custom Greeting

There is a bug in the Pandorabot's greeter script which prevents the owner from configuring the default greeting for Actorbot and METAbolt Pandorabots. Here is the problem and a workaround.

The default Pandorabot greeting is specified by four strings labelled GREET_1, GREET_2, GREET_3, and GREET_4. The default greeting for a standalone Pandorabot uses GREET_1 and GREET_2 as follows:

"Hello <name of avatar>! Chat with me in local chat. Visit the Pandorabots Blog at http://pandorabot.blogspot.com/"

If the Pandorabot is running as an Actorbot then the following is added  to the default greeting (GREET_3):

"IM me with the message 'Help' for commands."

If the Pandorabot is running as an Actorbot or with METAbolt then the following is added to the default greeting (GREET_4):

"Say 'menu' in local chat for dialog menu of commands."

Should you wish to change the default greeting then each of these strings can be specified by editing the Greeter_Config notecard. Unfortunately, a bug in the Greeter script prevents the GREET_4 string from being specified in the Greeter_Config notecard. Fortunately, there is an easy workaround and a fixed Greeter script will be in the next update.

The workaround for specifying a custom GREET_4 string is to edit the Greeter script itself rather than the Greeter_Config notecard. Near the beginning of the Greeter script are the following lines:

// The greeting will be 'GREET_1 <name of avatar>! GREET_2'
// If running as an Actorbot, greeting will also include 'GREET_3'
// If running as an Actorbot or METAbolt, greeting will also include 'GREET_4'
string GREET_1 = "Hello";
string GREET_2 = "Chat with me in local chat. Visit the Pandorabots Blog at http://pandorabot.blogspot.com/";
string GREET_3 = "IM me with the message 'Help' for commands.";
string GREET_4 = "Say 'menu' in local chat for dialog menu of commands.";

Simple change the string "Say 'menu' in local chat for dialog menu of commands." to whatever you like. The same can be done for the other strings but only GREET_4 needs to be changed here and not in the configuration notecard.

Should you prefer, I can send you a pre-release copy of the fixed Greeter script which will allow you to make all greeter configuration changes to the Greeter_Config notecard rather than editing the script itself. IM Missy Restless with your request.

Monday, March 28, 2011

METAbolt Updates & Configuration Settings

The Good News: the METAbolt development team provides fairly frequent updates to the METAbolt text client. This indicates it is in active development, bugs are getting fixed, features added, all good.

The Bad News: occasionally it may be necessary to re-initialize your upgraded METAbolt client by removing any existing .ini files in the data directory and restarting. This means a new METAbolt password will be regenerated and you will need to re-do your preferences. It is only necessary to remove your METAbolt .ini file(s) when the format of the .ini files change (infrequent) or if they have somehow become unusable/corrupt.

What this means for Pandorabot METAbolt owners

Owners of a Pandorabot METAbolt Add-On who have re-initialized their METAbolt client may need to reconfigure the Pandorabot METAbolt base prim. This will be necessary if you have set the MD5SUM in the METAbolt_Config notecard. To set your newly upgraded MD5SUM follow these steps:
  1. Locate and copy your newly generated METAbolt password. In your METAbolt client go to Application -> Preferences -> Security/L$ and copy the METAbolt password string.
  2. Make sure your bot is logged out (Main -> Logout)
  3. Login to Second Life as the owner of the Pandorabot METAbolt Add-On
  4. Edit the Pandorabot METAbolt base prim and open the METAbolt_Config notecard. Find the CHANNEL setting. If you have not specified a CHANNEL setting then your channel is 777.
  5. Close the edit window and enter your METAbolt password from step 1 above into local chat in the following format --- "/777 password=string-from-step-1-above" (replace 777 with the CHANNEL setting from step 4 and do not use the quotes).
  6. Copy the MD5 checksum string that is returned in local chat
  7. Edit the Pandorabot METAbolt base prim and open the METAbolt_Config notecard. Replace the MD5SUM setting with the new MD5 checksum string from step 6. Close the notecard and edit session.
Yes, it's a hassle. No, you do not need to do this every upgrade - only for those infrequent METAbolt upgrades that require the removal of the .ini file(s) from the data directory and only if you have configured an MD5SUM in your METAbolt_Config notecard.

NOTE: the above process of configuring your MD5SUM setting will also be necessary if you reset your METAbolt password.

Wednesday, January 12, 2011

Create a 3D Sculpted Pandorabot

If you own one of the 2D Pandorabots you can easily transform it into a 3D Pandorabot using a sculpted prim. Sculpted prims can give the appearance of a 3D avatar. All that is required is to move the scripts, notecards, and landmarks from your 2D Pandorabot into the contents of a 3D sculpted prim. Here are a few tips and tricks to help you.

First, find or create a 3D sculpted prim you want to use as a Pandorabot. It doesn't have to be a single prim, it can be as elaborate as you like or just a single prim. You must have modify permission on the sculpted prim. XD Fusion has a few free full perm 3D sculpted prims and some animated sculpted prims for sale. Any modifiable prim will do and it doesn't have to be a male/female human form. I run one Pandorabot as a spinning texture changing bunch of prims in a club setting.

Create a folder in your inventory where you will temporarily store the scripts, notecards, and landmark(s). Rez the 2D Pandorabot and edit it by right clicking and selecting "Edit". In the edit window click on "Contents". Select all the items in the contents by left clicking on the first one and shift left clicking on the last one. Left click and hold the mouse button down as you drag the items from the Pandorabot contents to the new folder you created. Release the mouse button. Your Pandorabot contents should be in the new folder. You can close the edit window and take the Pandorabot back into your inventory.

To make sure the Pandorabot does not attempt to apply a texture to itself, edit the Configuration notecard. Right click on the Configuration notecard in your new folder and select "Open". Add the following line to the top of the Configuration notecard:

TEXT_ENABLED = FALSE

Close the notecard editing window.

Rez the sculpted prim you want to use as a Pandorabot. Edit the prim and click on the Contents tab. Select the items from your new folder you wish to copy. You do not need to copy the textures. Drag and drop the items from your inventory into the Contents tab of the edit window. While still in edit mode, select "Tools -> Reset Scripts in Selection" from your viewer's menu bar. Close the reset window and close the edit window.

You should be running a 3D sculpted Pandorabot now!

Wednesday, December 15, 2010

Setup a "Sit on prim" Action

Actorbots can be programmed to perform specific actions when a given trigger condition is met. For instance, if an Actorbot is paid 250L that could trigger an action. Actions can be any one of instant message, chat, send group invitation, give object, wear outfit, play animation, stop animation, or sit on prim. This post describes how to setup that last action, sit on prim, and details the following steps:
  • Receive 250L or more -> Sit on prim
  • Configure prim
  • Receive 250L or more -> IM avatar with thanks
  • Receive 250L or more -> Wear a specified outfit folder
  • Receive 250L or more -> Chat to Actorbot to setup timer
  • Receive IM contains _Wear Default Outfit -> Wear an outfit
Go to the Sine Wave website, login, click on "My Actorbots", click on the Actorbot you want to program, then click on "Advanced settings". Here is where you will program your Actorbot.

First, decide what your Actorbot's trigger for the action will be. Triggers can be either an instant message or payment. Let's choose payment for this example and we'll set the condition to "Receive money" with "Amount greater equals 250". This specifies a trigger condition of payment to the Actorbot's avatar of 250L or more.

Next, specify the action and execution level for this trigger. Select "Sit on prim" from the pull down menu of actions and "Concurrent" from the pull down menu of execution levels. We want a concurrent action in this example because we are going to want this condition (payment of 250L) to trigger more than one action, all of which should be performed.

Now that we have a trigger with condition and associated action and execution level we can configure the prim on which we want the Actorbot to sit. Click the "Save" button just below the "Sit on prim" field and copy the resulting red string (usually your Actorbot's avatar name followed by a number). You may have to scroll down to see the red string  which will be part of the action description in your list of triggers.

Log in to Second Life and edit the prim you are going to pay the Actorbot to sit on. Right click the object the prim is in, select "Edit", select "Edit linked parts", and click on the prim you wish to edit. Now paste the red string you copied into the Description field of the General tab. Now we need to populate the prim with a couple of scripts and a notecard.

Click the "Content" tab of the edit window and drag the following from your inventory to the edit window Content tab:
  • Actorbot Location script
  • TimedSitAndNotify
  • Configure_Key
You can obtain the Actorbot Location script from Sine Wave Island. The TimedSitAndNotify script and Configure_Key notecard are included with the Pandorabot Actorbot Add-On. After dragging these three items into the prim contents you need to edit the Configure_Key notecard to add your Actorbot's avatar key. Right click Configure_Key in the Content tab, select Open. Insert a line at the top of the notecard that specifies your bot's key. You can find the key by viewing the avatar's profile - it's at the top of the 2nd Life tab. The line should look something like:
    BOTKEY = your-actorbot's-key-goes-here

While you're here you can set a number of other parameters like what strings get used in instant messages, duration of the Actorbot's time on this prim, and the channel number used to communicate with the script. For the purposes of this example we will just need to set the BOTKEY parameter. BOTKEY always needs to be set. Click "Save" and close the notecard editing window.

While still in the prim editing window click Tools -> Recompile Scripts in Selection -> Mono from the viewer toolbar. Finally, click Tools -> Reset Scripts in Selection from the viewer toolbar and close the edit window. Your prim is now setup for the Actorbot to sit on it when paid 250L or more.

However, we're not done yet! Go back to the Sine Wave website where we are programming the Actorbot. We need to add more actions. First, add another "Receive money", "Amount greater equals 250" condition and this time select "Instant message" and "Concurrent" for the action. Enter a message in the Content field to be sent to the avatar that paid you. Something like "Thanks {avatar name}! Give me a minute to get undressed :)". Click "Save".

Next, add another action for "Receive money", "Amount greater equals 250". Again, use "Concurrent" and this time select "Wear outfit". In the "Outfit name" field, enter the name of a subfolder in the Actorbot avatar's Clothing folder that you want it to wear when paid 250L or more. For this example, enter "Nude". Click "Save".

Add another "Receive money", "Amount greater equals 250" condition and this time select "Chat". In the Content field enter "{avatar key} paid me to get naked". In the Channel field enter the Actorabot script's channel (default 25 or whatever you set it to be in the Actorbot base prim Actorabot_Config). Select the Concurrent execution level and click "Save".

Add one final action for "Receive instant message", "Message contains _Wear Default Outfit". Select "Wear outfit" and enter the name of a subfolder of the Clothing folder you want your Actorbot to wear when done with the paid action. Let's use the Outfit name "Blue Dress". Select the "Exclusive" execution level and click "Save".

Log into Second Life as the Actorbot's avatar and create a subfolder of the Clothing folder called "Nude" (for this example). Populate the Nude subfolder with all the items you want your Actorbot to wear for this action. Include hair, shoes, attachments, etc. Create another subfolder of the Clothing folder called "Blue Dress" and populate it with all the items you want your Actorbot to wear when the paid 250L or more action completes.

Log out of Second Life and start the Actorbot. Log in to Second Life as another resident (not the Actorbot's avatar) and pay the Actorbot's avatar 250L. It should now sit on the prim, perform whatever animations are in that prim, and wear the outfit folder "Nude". After the duration set in the Configure_Key notecard (15 minutes default) the Actorbot will leave the prim, return to its base prim and wear the outfit folder "Blue Dress".

Wednesday, November 24, 2010

Custom Notecard and Landmark

Pandorabots V2 and later come preconfigured to give a notecard, landmark, and the Pandorabot User Guide when touched by a non-owner. By default, the notecard and landmark describe Pandorabots and provide a landmark to the Restless Studio demonstration pandorabot.

You may prefer to configure your Pandorabot to give a notecard and landmark more suitable for your needs. To do so, edit the Pandorabot and add your custom notecard and landmark to the Pandorabot's contents. You can delete the Restless Studio notecard and landmark if you wish but it is not necessary. Only the first notecard and landmark in the Pandorabot's contents are delivered.

Therefore, make sure your notecard and landmark are named so they appear first in alphabetical order within the Pandorabot contents.