MetaHarper Show Tools – Automatically Rezzing and De-Rezzing Items on Demand

TABLE of CONTENTS

  1. Overview
    1. Why make another rezzer?
    2. Major Features.
  2. Preparing Your Props for Rezzing
    1. Go to your work area with an MST centerpoint.
    2. Set out props and make sure they have good. permissions,linkage,and names.
    3. Add the tracker script.
    4. Customizing the rezzer: appearance, size, linking.
  3. Saving and Rezzing Props – Simple Cases
    1. Save prop positions.
    2. Update the ~PACKLIST notecard.
    3. Pick up props.
    4. Copy props to the rezzer inventory.
    5. Use the rez/redez commands.
    6. Final Touches for a Particular Venue or Stage
    7. Testing
  4. Updating Props
    1. Updating a Prop where the Position Stays the Same.
    2. Updating a Prop that Moves its Rez Position
    3. Adding new Prop.
    4. Removing Props.
  5. “Boxed” Stages and Collaboration
    1. Shrink the MST Performance Engine to a Box.
    2. Rezzing and Derezzing directly from a boxed stage
    3. Allowing other Users to operate your Performance Engine  collaboratively.
    4. Working with Particular Venues
  6. Other Rez Commands
    1. Rezzing and Derezzing Specific Objects.
    2. Force MST Performance Engine to Re-Center.
    3. Update Locations of All Props.
    4. Adding No-Mod Props.
    5. Permanently Removing ~MST rezTracker Scripts.

 


1. Overview

 

1.a  Why Make Another Rezzer?

I believe that tools should be collaborative, and you should be able to have your friends (or alts) help you configure them. As much as possible, this tool is designed so that others on your team can share and help with. it is not locked to the owner, unless you want it to be.

I made this rezzer specifically for use with performing venues where timing between acts is tight and performance needs to be fast and lag-free. One major feature you get with this rezzer is automatic perfect positioning autocentered to the venue stage, every time. Another major difference is that your rezzer can put itself away, out of sight automatically, and allow specific people your specify to be able to make it rez and derez props. This feature is very useful for creating collaborative shows where you wish to work closely with others or rehearse shows even if you are not online.

1.b  Major Features

  • Minimizes rotations and movement after rezzing. Objects won’t swing around distractingly if it can be avoided.
  • Allows individual objects to be rezzed/derezzed on demand, as well as all at once.
  • Can be easily controlled via 3rd party HUDs and choreography systems, as well as MetaHarper Show Tools. Allows both click dialogs and chat commands for control behavior.
  • Doubles as a stage template.
  • Some limited support for rezzing no-mod objects
  • Can be shared with other users
  • Fast and responsive.
  • Works well in areas with multiple stages or with many acts in the same place.

 


2. Preparing Props for Rezzing

 

2.a  Go to your work area with an MST centerpoint.

Go to a place where you’ve previously rezzed and set up an MST centerpoint. if you haven’t done this yet, see documentation here.

Next, rez your MST performance engine.  This is the object named “MST Performance Engine (basic)”. Normally, it will look like a medium size gold triangle.  CAUTION: In some case your MST performance engine may automatically move over to your MST centerpoint. This is to be expected.

2.b  Set Out Props – Ensure Props Have Good Permissions, Linkage, and Names.

Envision that the MST performance engine you placed in step 2.a is in your live performance area. Place your props on and around the rezzer in the right positions. You may also wish to put down a floor to cover the MST performance engine prim so your audience can’t see it. Alternatively, you can make the MST performance engine prim transparent. When selecting your props It is very important that the following conditions are met:

  • All props must include COPY and MODIFY permissions or you will not be able to use them with a rezzer system.
  • All props must have unqiue names. Do not have four props named “Object”, for example.
  • Prop names should not have trailing spaces, or have names that include commmas, or “|” characters.
  • The more you can link your props together into larger objects, the faster they will rez and the easier the set will be to maintain. However in general do not link props with moving parts to props that do not move. Sometimes linking can change movement.
  • Any “mover” gadgets you may be using with your act should be considered separate props. Do not link movers to stationary objects.

2.c  Add the Tracker Script

For each of the prop objects you have set out on and around the rezzer in the previous step, copy the “~MST reztracker” script included with MetaHarper Show Tools into each one. This script will help the props find their correct positions and rez and derez properly. WARNING: Do not copy the “~MST reztracker” script into the rezzer itself.

2.d  Customizing the MST Performance Engine – Appearance, Size, Linking, and Name

You should rename your rezzer to be easier to find in your inventory and make it easy to distinguish from other people’s MST peformance engines.

You can also change the textures of the MST Performance Engine and make it invisible and/or phantom if you want. However, avoid resizing the rezzer or linking it with other objects. If you do this it will not understand how to box and unbox itself later.

If you are an comfortable with copy and pasting technical text and being careful with formatting, there is an advanced process for changing the outside shape of an MST performance engine. Typically this is done to make a version that is shaped to fit a particular stage to help show important borders and spaces when building sets later. If you want to find more information about this advanced procedure look for documentation here.

 


3. Saving and Rezzing Props – Simple Cases

3.a  Save Prop Positions

When you have finished placing “~MST reztracker” scripts in each prop as described in step 2c, you can now save the positions of your props. To do this click the performance engine and select “saverez”. If you cannot click the performance engine you can also use the chat command  “/8 saverez”. After doing this a number of “REZME..” lines will be printed out. Copy these into your clipboard and continue.

3.b Update the ~PACKLIST Notecard

Open the “~PACKLIST” notecard inside the performance engine and paste the lines you copied in the previous step to the end of the notecard, replacing any existing “REZME” lines. Visually check that you have one “REZME..” line for every prop object you placed a “~MST reztracker” script in step 1.3. If you are missing one of your props, check that the prop has a “~MST reztracker” script inside it and repeat step 3.a. Save the ~PACKLIST notecard when you are satisfied.

3.c Pick Up Props

One at a time, never as a collection, right click your props and select “take” to pick them off the stage and place them into your inventory. Make note of where in your inventory window the picked up props appear. If it is hard to keep track of them, it may be useful to open a second inventory window, create a new folder, and then move the objects into this folder each time you pick one up.

You must pick up the props from the ground and not re-use props in inventory from some previous time. Older versions will likely not have the “MST ~reztracker” script inside and may also differ in other ways that can lead to surprising results later. When you have picked up all your props and have a largely empty stage, continue to the next step.

3.d Copy Props to The Performance Engine Inventory

Now, select the new props you just picked up in step 3c in your viewer inventory window, and drag them into the contents tab of the MST performance engine. You may see some script messages when you do this, and these can be safely ignored. When you have dragged your picked up inventory into the performance engine, continue to the next step.

3.e Rez and Derez your Props

You are now ready to test rezzing and de-rezzing! Click the MST Performance Engine and select  <more REZ> then click the “rez” button. Your props should appear in the correct locations. If you cannot click the performance engine, you may also use the chat command “/8 rez” to accomplish the same thing.

Similarly, you can click the MST performance engine, select <more REZ>, then “derez” to clear away the props. You can use the chat command “/8 derez”.

You are now ready to use your MST Performance Engine to handle rezzing and derezzing!

3.f Final Touches for A Particular Venue or Stage

The owner or director of a particular performance venue will sometimes have special instructions for MST users. For example they may ask you to use a particular VENUE_NAME value in your MST Performance Engine’s “~PACKLIST” notecard, or they may ask you to add “ALLOW=…” lines to your “~PACKLIST” notecard. Ask your director or stage manager to confirm.

3.g Testing!

Right before your act starts, rez your MST Performance Engine on the ground near a venue supported by MetaHarper Show Tools. Your rezzer will automatically snap into position. Then rez the props as described above, and perform your act. When you are done, derez your props as described above and pick up your MST performance engine.

The rest of the steps below are for more sophisticated uses. or to  explain how to make updates to the props more efficiently.


4. Updating Props

 

4.a Updating a Prop Where the Position Stays the Same

If you want to replace one of the props loaded in the MST performance engine, without changing where it will appear when it rezzes, first derez your current props to clear the stage. Next, delete the older version from the contents of the performance engine, then drag the new version of your prop into the performance engine’s inventory. The new version must have the same name as the old one and must contain the ~MST reztracker script. After doing this you can rez and derez your new version of the prop using the method described in step 3e.

4.b Updating a Prop that Moves its Rez Position

If you want to change the location where an existing prop will rez, first rez the prop as usual and then move the prop into the new correct position. Now, use the “saverez” button or command as described in step 3a. Find the “REZME” line that has the name of the prop you are moving. Copy this line into your clipboard. Finally, open up the ~PACKLIST notecard and past this new line overwriting the previous “REZME” line for this one specific prop and save the notecard. Now you can use the rez and derez commands as described in step 3e and they should appear in the new location.

4.c Adding New Props

If you wish to add a new prop object to a MST performance engine, place your new prop in the right location on your stage and add a “~MST reztracker” script inside it as usual. Click the MST performance engine and select “saverez” or use the “/8 saverez” chat command, as described in step 3a. You can save time by just copy-pasting the single new “REZME=” line that includes the name of your new prop, and pasting that single line to the end of the ~PACKLIST notecard. You will then need to pick up your new prop and drag it into the contents of the performance engine.

4.d Removing Props

It is easy to remove an object from your MST performance engine. First open the “~PACKLIST” notecard and delete the “REZME=” line that contains the name of the prop you wish to remove. Then, actually delete that prop from the contents of the MST performance engine.


5. “Boxed” Stages and Collaboration

 

5.a  Shrink the MST Performance Engine to a Box

It is often useful to leave your MST Performance Engine in a small, “box” form near your performance stage. That way it’s ready to go when you need it, you don’t have to worry about getting it out of your inventory at show time, and you can optionally allow other people to rez it for rehearsals, testing, or collaboration.

To box up your performance engine, first derez your props, then click the MST performance engine, go to “<more REZ>, and select “box”. You can also chat “/8 box” if this is easier. Your stage template will shrink to a smaller version with floating text above it that matches the name you set in the previous step.  Now that your stage is boxed you can drag it to a storage area away from the stage, but within 100m. It will automatically expand when needed and shrink when you’re finished, as we will see in the next step. If you ever wish to manually return your set to full size, you may click it, go to <more REZ>, and then click “unbox”. You can also use the chat command “/8 unbox”.

5.b  Rezzing and Derezzing directly from a boxed stage

When your MST Performance Engine is in boxed form within 100m of an MST centerpoint, you can expand it, move it to the center of the stage, and rez all of its props in a single action. To accomplish this either click the performance engine and choose “stagerez”, OR use the chat command “/8 stagerez <name>” where <name> matches the floating text above your small boxed stage. For example:

/8 stagerez ArrehnTest

You can also use a single command to box the stage, remove all props, and return the MST performance engine to its former storage location. You can do this by either clicking the performance engine and selecting “stagederez”, or using the chat command “/8 stagederez <name>”. For example:

/8 stagederez ArrehnTest.

The two methods above can be used to quickly clear and set stages alongside a large number of collaborators sharing the same stage space.

5.c  Allowing other users to operate your show tools, collaboratively

You can optionally allow other users to use the stagerez, stagederez and other MST performance engine commands, especially if you have left your boxed template in a storage location near a venue centerpoint. To allow another user to be able to click your stage or send chat commands, edit the “~PACKLIST” notecard and add a line with your friend’s login name or avatar key. For example:

ALLOW=Arrehn Oberlander

There should be an example of this line already in the notecard. After you’ve added your own line to the ~PACKLIST notecard, save the notecard and they will be able to share control of your show tools.

5.d  Working with Particular Venues

You can edit the “VENUE” line in the ~PACKLIST notecard to a name that matches a particular venue. Ask your venue owner what name to use! This will allow different venues to exist close to each other without interfering with each other’s rezzing, cameras, or event timelines.


6 Other Commands

 

6.a Rezzing and Derezzing Specific Objects

If you wish to rez a single prop or derez a single prop, you can use the chat commands “/8 rez <propname>” and “/8 derez <propname>”. For example:

/8 rez largePlant
/8 derez sofa1

You can also rez or derez more than one specific object at a time, like:

/8 rez largePlant:smallPlant:table
/8 derez sheets:pillows

These targetted prop rez and derez commands can sometimes be an alternative to using “hide” transparency scripts.

NOTE #1: If you do not want one of your objects to be rezzed by default when you use “rez” or “stagerez” commands, edit the PACKLIST notecard and find the line for the object you do not want to rez by default. Change the command “REZME” at the start of
the line to “NOREZ”. This will allow you to load the object individual as described above, but it will not rez by default.

NOTE #2: Any one “rez” or “derez” line can be a maximum of 256 characters. If you have more objects than can fit on one line, just use more then one line.

6.b Force MST Performance Engine to Re-Center

If your MST performance engine needs to be manually centered for any reason, you can click the performance engine, choose “<more REZ>”, and click “center”. You can also use the chat command, “/8 center”.

6.c Update Locations of all Props

If you have moved one or more of your props out of its normal position, and you want the prop to return to its normal spot, you can click the performance engine, choose “<more REZ>” and then choose “updaterez”.  You may also use the chat command, “/8 updaterez”.

6.d Adding No-Mod Objects

If you simply must use a no-mod object as a prop, sometimes you can get it to work in the MST Performance Engine. Your results may vary. Instead of using saverez (which requires a ~MST reztracker script), use the chat command “/8 nomodsaverez <name>”. For example:

/8 nomodsaverez  pinkcadillac

The above command will print out a “REZME=…” line you can add to the ~PACKLIST notecard, similar to the saverez method from section [2.1]. From here pack the no-modify prop like you would any other prop. There are some limitations with this method:
– It only works if the prop will be location < 10m from the stage center.
– Sometimes the position or rotation of the saved prim will not be accurate. It may depend on the specific object and the rotation of the stage how accurate the positioning will be. This inaccuracy in some circumstances when rezzing no-mod objects is a known SL bug.
– You will have to manually pick up or delete any no-mod rezzed objects from your set when you are finished. They will not be able to listen to “derez” or “stagederez” commands.

6.e Permanently Removing ~MST rezTracker Scripts

If you ever wish to stop managing your props with the MST Performance Engine and wish for them to stay out permanently, you may use the following command to automatically delete the “~MST reztracker” scripts:

/8 permrez