Spot On Costume Assistant

These tutor notes are intended for attendees of this Harleyquin workshop.  The benefits of making them available via the web outweigh the likelihood that others may stumble across them.  If you have not attended this workshop, please consider attending or supporting Harleyquin Workshops.  More info HERE

NOTICE:  This information is intended for personal use only.  It is not to be duplicated for any other purpose or distributed.  Please respect the time and effort put into Harleyquin workshops within the dance community of Second Life.


Tutor:  Eva Harley (EvaHarley Resident)
Last updated: 12/3/2018

Workshop Summary:

Use this tool to add or remove objects to your dancers and/or yourself all with a simple command.  Objects include props, clothing pieces, worn particles, and more.  We cover everything from the basics to how to trigger costume/prop changes through the Performance Director and other tools!  A fun hands on exercise also included in the workshop.

Workshop Notes:

HQ Workshop Tutor Notes – Spot On Costume Assistant ver. 1.2
Instructor ~ Eva Harley
* FREE TO DISTRIBUTE *

What is the Costume Assistant?

The CA is a HUD which you wear that allows you or other choreographers to add or remove objects during a performance by shouting a chat command.

Huh?

During a performance, a choreographer may want all the men to take off their shirt at the same time.  By having all the dancers wear their own Costume Assistant HUD, the choreographer can shout a command during the dance, triggering the Costume Assistant for each dancer to remove the dancer’s shirt.

Because it’s a shout command, the choreographer can say it in local chat, add it to a dance HUD button, or even make it an automatic part of a Performance Director routine.

Why would you want to use it?  A few reasons…

For dancer props during a performance:  cane, hat, cloak, an apple
Particles that trigger when worn.  Add to “turn on”, remove to “turn off”
Remove or add costume pieces – shirts, pants…other things…
Add or remove costume/clothing/hair, including mesh body pieces

Who can you use it on?

YOURSELF…. so that you don’t have to manually add or remove items during your performance.

YOUR DANCERS …. they must own their own copy of the costume assistant and whatever they will be adding or removing, but with this tool you can control when and what so that your dancers don’t have to worry about timing, freezing, forgetting, or missing “their mark”

OTHER CHOREOGRAPHERS CAN USE IT ON YOU …. in the CA notecard, you can identify who has permission to trigger your Costume Assistant HUD.  This allows you to give access to another choreographer and allows them to add or remove items while you dance in their performance.

How does it work?

The Costume Assistant uses RLV functionality.  Objects work with RLV to allow you or others to control you with a HUD.

The Costume Assistant was designed for dance and the solely the addition/removal of costume pieces, props, and particles. It doesn’t include or enable any sexual or control functions other that what is mentioned in this workshop. You are safe.

—————————————————————————–
**  Have it?  Let’s Get Ready to Rock & Roll!

1. Unpack the Costume Assistant (CA) box

2. Right click and add the Costume Assistant object. You will see it in the bottom left corner of your screen as a star.

3. The star may appear in three different colors:
– grey: RLV is not enabled in your preferences
– red: RLV is enabled, but you need to re-log to activate it.
– gold: RLV is activated *this is what you want*

4. Enabling RLV in your viewer
– For Firestorm, open Preferences, and choose Firestorm from the left
hand menu. “Allow Remote Scripted Viewer Controls (RLVa) is the top
item. Mark this box, click ok, and relog.

– For any other viewer, search Google or go to your viewer support page

5. Is your star gold? Awesome – let’s keep rolling! RLV functionality, like the Costume Assistant uses, requires a #RLV folder. Open your inventory window and look near the top. Do you have a folder called #RLV, probably the 2nd item down?

YES – skip to the next step!

NO – Right click on inventory, select New Folder, and name it #RLV.
If you can’t see it after adding, follow these steps:
https://community.secondlife.com/t5/Inventory/Why-won-t-RLV-folder-appear-after-creating-it-in-my-inventory/qaq-p/1938621

—————- Gold Star? #RLV foldder? ready to roll! ——————–

To add or remove items, they are put into folders under the #RLV directory. You can have many items or links to items in a folder.  Links seem to be the option preferred by the Spot On Team.

There are three commands the CA uses:

addfolder – adds all the items/item links in the folder
removefolder – removes all the items/item links in the folder
change – replaces your current outfit with whatever is in this folder
NOTE: I prefer to use addfolder and removefolder instead of change, especially in high lag areas.

To add or remove items, commands can be given in local chat or via a HUD. HUD examples are farther below. These are the commands if you use local chat:

/44 addfolder Cheese
* adds whatever items/links are in the folder Cheese in your #RLV folder

/44 removefolder Cheese
* removes whatever items/links are in the folder Cheese in your #RLV folder THAT ARE CURRENTLY BE WORN. If the dancer isn’t wearing *those* specific copies, the items won’t be removed.

CA will add or remove whatever is in the folder, which can be one or more items. Next, we’ll talk about options you have for the CA, then
how to automate the commands!

The Configuration Card – Who can activate your CA and Changing the Channel

Inside your Costume Assistant HUD is a configuration notecard.  This is where you can choose what channel your CA listens to and WHO it will listen to.

1. Right click on the CA (the gold star in your bottom left corner) , select edit, and go to the contents tab.

2. Double click on the notecard named ! Configuration

3. The second item down is custom channel. By default, CA listens to channel 44 for everyone. You may wish to change this to something more unique. To do this, remove the hashtag  and space, and change the number 44 to something different:
@channel 1900 <– sets it to listen to channel 1900

4. By default, your CA will only listen to you. You may be in a dance where the leader wants to automate adding or removing costume pieces/props during the dance.  In this case, you must modify your configuration notecard to give authorization to the choreographer.  They cannot command your HUD without it.

Options:

group – authorizes anyone in your activated group
anyone – all avatars in existence are authorized
user name – listed avatars are authorized

to enable group – remove the # and space before group: @group
to enable anyone – remove the # and space before all: @all
add names for individual users – below# One name per line, list avatar legacy names, one per line, such as:
EvaHarley Resident
ImaSexGod Radek

Now save and close your notecard. You can always come back and edit your configuration notecard or you can even have multiple copies of the Costume Assistant if you want one for just you, and one for certain people.  (To rename a Costume Assistant HUD, you must rez it on the ground.)

!STOP…WAIT…WHAT IF MY DANCERS DIDN’T SET UP THEIR COSTUME ASSISTANT OR FOLDERS RIGHT??? HELP!

* Pings, Pongs, and Searches to the rescue! *

With CA version 1.2, the ability to “ping” and “search” through someone’s CA was added.  These are great features for a choreographer to test their dancers.

A “ping” lets the choreographer know they can communicate with the CA HUD of their dancer.

If you don’t receive a “pong” response from one of your dancers, they are either: 1. set for a different channel or 2. don’t have the access setting set so that you can command their CA.  (Either by enabling all, group, or preferably listing you individually.)

Searches

This allows the choreographer to search and verify the folder for their dance is set up properly.  Case and spelling are important.  If there is an extra space, they won’t be able to trigger your CA during the performance.

/1700 search <what to search for – word, name, etc.>  example:

/1700 search bedlam

If you received a pong response (above, meaning you are able to communicate with your dancer’s HUD), you will receive a response in local chat listing any folders in the dancers RLV folder that include the term you searched for.

Using Your Costume Assistant – Review:

Add your CA HUD and make sure it is gold
Double check the channel and who has access to your CA by checking the config notecard in the CA’s contents.
To create a folder to be added and removed during a dance, create a new folder under the #RLV folder in your inventory
Copy the objects you want to add/remove and paste shortcuts into the folder you created
You can then shout a command to add or remove the folder, using local chat or your performance HUD.
/channel addfolder foldername
/channel removefolder foldername
Automating Costume Assistant Changes

Costume Assistant HUDs are triggered by a chat command.  Generally a “shout” or “region say” are the recommended methods of communicated.

Through local chat:      /44 addfolder ThisFolder   or /44 removefolder ThisFolder

Through the Performance Director Timeline:    85|RS:44:addfolder ThisFolder

Through a Smooth Dancer or Performance Director button:    @button1=RS:44:addfolder ThisFolder

Through a script in a simple prim HUD, touch the prim to trigger it:

default
{

touch_start(integer num_detected)

{
llRegionSay(44,”addfolder ThisFolder”);
}

}

Locking Your Costume Assistant HUD

Locking your Costume Assistant HUD is a handy feature.  If you are in multiple dances or will be changing outfits before or during the show, you can lock your HUD on.  This will prevent it from being removed during outfit changes.

To lock/unlock:  click on the gold star and press lock.  If it’s currently locked, press this again and select unlock.  You can then detach it.

While the HUD is locked, you won’t be able to open the configuration notecard.  Unlock it first.

Tips, Tricks, and Considerations:

For the Costume Assistant, only put items into the folders that you will be adding or removing.  If your hair isn’t changing, don’t put in a copy of your hair.
You can activate several different CA folders during a dance.  Example:  You can add a cane in the first part of the dance, and a chiquita banana hat in the second part – each in separate folders so they can be controlled separately.
I always recommend “caching” your CA changes, just like you would costumes or animations.

You can make copies of your CA, and have one set up for each choreographer you work with.  If you rez it to the ground, you can also rename the CA to include the troupe/choreographers name.  This way, you always know that your channel and access are always correct for whoever you’re performing with.
You can “change” costumes during a performance.  Because the “change” feature of the CA seems slower, I always use the addfolder and removefolder options.

If you use a mesh body like Maitreya where you may have to alpha out pieces or apply layers, this can be difficult to adjust during the dance. One option is to make a copy of your body, apply the layers and alpha settings, then delete the scripts via the HUD *for this copy*. This saves a version of the body where all these adjustments are done for you. Now you can treat your body just like you would a costume piece – removing your “normal” body and adding this special copy for that costume. *Note: this may not apply to all mesh bodies

A caveat:  because the Costume Assistant uses RLV to work, how fast the items are added or removed can depend a lot on your computer, your internet connection, any lag you’re experiencing, in addition to the complexity of the costume.
Example of “Changing” Costumes During a Performance:

For a dance, I may have my dancers wear two different costumes.  An old fashioned ball gown to start, then change into a scary, tattered, asylum gown.

I will have them create two folders:  Bedlam Costume 1 and Bedlam Costume 2

In Bedlam Costume 2, I have them paste links to all the items they will be adding – the asylum gown, panties, and hair.

In Bedlam Costume 1, I have them paste links to all the items they will be removing when they change to costume 2 – dress, shoes, hair, necklace.

Because there can be a little lag, in my PD I have their costume assistant start adding the new costume before removing the old one.

58|RS:1700:addfolder Bedlam Costume 2
62|RS:1700:removefolder Bedlam Costume 1

Special note:  the dancers must make sure they are wearing the same costume links for Bedlam Costume 1 before the dance starts.  (They just need to open that CA folder and make sure it says wearing.)

If they’re wearing different copies and not the links in the Bedlam Costume 1 folder, it won’t be able to remove those items.

Tips, Tricks, and Considerations for the Choreographer:

I’ve prepared a configuration notecard with the channel number I use and my access already designated.  I send this to my dancers so that they can easily replace the configuration notecard with my settings or update theirs.  For my troupe members or people who regularly dance with me, I also provide instructions on how they can create a copy of the CA HUD and rename it, so that they always have a HUD that’s already set up, easy to find and wear for my dances.

When I’m using the Costume Assistant for a dance, I also send my dancers a “tester hud”.  This is a very simple HUD, full perm, which I will send to you.  You can easily change the shout commands in the script in each button.  My dancers find this very easy to use when checking they’ve set up their CA folders correctly.  They press the GO Button and it adds the second costume, when they press the Reset button, it removes the pieces of the second costume and adds the first.  This is also what I use to cache the Costume Assistant before a performance, and as a backup in case someone doesn’t change.

If you’ve attended one of the Harleyquin Workshops on Trigger HUDs or have a copy of my costume assistant tester, you can easily modify it for your own use!

Instructions here: https://harleyquinadventure.com/2018/06/09/simple-trigger-huds-editing-the-scripts-for-your-own-use/

If you are using Performance Director, you can use Private Messages in your routine for more control over when your dancers change. A Private Message (PM) is a shout that only the dancers in that group can hear. This makes it handy if you want each dancer to change their costume 10 seconds apart for example; (look at the line for 20 seconds Male 1, 30 seconds Male 2.)

Male1=
0.00|Le Poppycock-Ain’t 2 proud
18.5|!bang – stand 475
20|PM:7777:addfolder Standing Hat
24.5|Glamour pose13
25|D0603-Jump.N
26|oOo shrimp_six
33|forgive me (c)
56|oOo shrimp_six
232.0966|HelaMiyo_Dystopian_3M

Male2=
0.00|Le Poppycock-Half the pleasure
18.5|!bang – stand 475M
24.5|Glamour pose13
25|D0603-Jump.N
26|oOo shrimp_six
30|PM:7777:addfolder Standing Hat
33|forgive me (c)
56|oOo shrimp_six
232.0966|HelaMiyo_Dystopian_3

Play and enjoy your Costume Assistant!

Yours in dancing,
~ Eva Harley

**** TROUBLESHOOTING ****

I’ve added a troubleshooting page on the Harleyquin blog:

https://harleyquinadventure.com/2018/06/09/troubleshooting-costume-assistant/
**** EXERCISE *****

Want to try a practice exercise?

PURCHASING:
it is available on MP or in the Spot On store: https://marketplace.secondlife.com/p/Spot-On-Costume-Assistant/5962411
?

HAVE IT? LET’S GET READY TO ROCK & ROLL!

1. Unpack the Costume Assistant (CA) box

2. Right click and add the Costume Assistant object. You will see it in the bottom left corner of your screen as a star.

3. The star may appear in three different colors:
– grey: RLV is not enabled in your preferences
– red: RLV is enabled, but you need to re-log to activate it.
– gold: RLV is activated *this is what you want*

4. Enabling RLV in your viewer
– For Firestorm, open Preferences, and choose Firestorm from the left
hand menu. “Allow Remote Scripted Viewer Controls (RLVa) is the top
item. Mark this box, click ok, and relog.
􀀀
– For any other viewer, search Google

5. Is your star gold? Awesome – let’s keep rolling! RLV functionality, like the Costume Assistant uses, requires a #RLV folder. Open your
inventory window and look near the top. Do you have a folder called #RLV, probably the 2nd item down?

YES – skip to the next step!

NO – Right click on inventory, select New Folder, and name it #RLV.
If you can’t see it after adding, follow these steps:
https://community.secondlife.com/t5/Inventory/Why-won-t-RLV-folder-appear-after-creating-it-in-my-inventory/qaq-p/1938621

6. To add or remove items, they are put into folders under the #RLV directory. You can have many items OR links to items in a folder. Click on this object to save to your inventory: 􀀁

7. Open your inventory, right click on the #RLV folder, and select New Folder and name it Cheese

8. Find “Eva’s Costume Assistant Test Hat” in your inventory. Right click on it and select copy. Now, go to your new Cheese folder, and select paste OR Paste as Link. Paste makes another copy of the item, Paste as link will create a link to the original object. You can use either.

9. It’s time for the commands! There are three commands the CA uses:

addfolder – adds all the items/item links in the folder
removefolder – removes all the items/item links in the folder
change – replaces your current outfit with whatever is in this folder
NOTE: I prefer to use addfolder and removefolder instead of
change, especially in high lag areas.

10. In local chat, type /44 addfolder Cheese
You should now be wearing your test hat!

11. In local chat, type /44 removefolder Cheese
With this command, the hat should have been removed.