Rez2: Difference between revisions

From CasperTech Wiki
Jump to navigation Jump to search
 
(102 intermediate revisions by 3 users not shown)
Line 8: Line 8:
Rez2 allows you to easily package, rotate, move, align, and sell big or sparse structures that may be impossible to link. The speed is greatly improved over Rez-Free, allowing your builds to be rezzed even faster!  
Rez2 allows you to easily package, rotate, move, align, and sell big or sparse structures that may be impossible to link. The speed is greatly improved over Rez-Free, allowing your builds to be rezzed even faster!  


Here are some of the features of Rez-Free:
'''Rez2 features include:'''


:* '''NEW IN REZ2:''' Faster rezzing! See the demo video below!
:* '''NEW IN REZ2:''' Access control options! Owner / Group / Public
:* '''NEW IN REZ2:''' Access control options! Owner / Group / Public
:* '''NEW IN REZ2:''' "Pair" option! Tell each piece which anchor you want them linked to
:* '''NEW IN REZ2:''' "Pair" option! Tell each piece which anchor you want them linked to
:* '''NEW IN REZ2:''' Rez Option: Toggle hide anchor when rezzing
:* '''NEW IN REZ2:''' Rez Option: Toggle disable floating text when rezzing
:* It's FREE!  The Free version contains all the features you would expect from other commercial package rezzers.
:* It's FREE!  The Free version contains all the features you would expect from other commercial package rezzers.
:* Integrates with CasperVend Holovendors - ideal for house sellers or otherwise demoing your large build
:* Integrates with CasperVend Holovendors - ideal for house sellers or otherwise demoing your large build
:* The Premium version also integrates with non-caspertech systems such as HippoVend, and includes API support
:* The separate parts of your build can be ANYWHERE on the same region
:* The seperate parts of your build can be ANYWHERE on the same region.....
:* .... or up to 100 meters over a region boundary! No other build rezzer in second life supports both these modes
:* Extremely robust rezzing system means that rezzing always succeeds even on lagged sims
:* Extremely robust rezzing system means that rezzing always succeeds even on lagged sims
:* Extremely low lag scripting means that your sim is not bogged down by this system
:* Extremely low lag scripting means that your sim is not bogged down by this system
:* Unlimited pieces can be managed - no memory limits
:* Unlimited pieces can be managed - no memory limits
:* Add/remove new pieces at any time without having to start again   
:* Add/remove new pieces at any time without having to start again   
:* Automatic temp-rezzer support detects if pieces are temporary and automatically re-rezzes them
 
'''Features removed from the Rez2 versus the older Rez-Free:'''
 
:* Temp-rezzing support. With mesh content this no longer gives any advantage over regular rezzing.
:* Rezzing across region borders. This wasn't reliable due to sim communications.
 
== '''<span style="color:#00528c">Customising Your Anchor</span>''' ==
 
=== Re-texturing The Original Object ===
----
 
The Rez2 anchor object has only ONE face. You cannot re-texture just the box portion without also re-texturing the arrows at the same time.
 
There is '''no texture template''' for the Rez2 at this time. You might find it easier to just make your own anchor object.
 
(Using your own anchor object has the advantage of the customer knowing exactly who to contact regarding your build!)
 
=== Using Your Own Anchor Object ===
----
 
You can (but it's not required to) make a customised anchor!
 
Simply "Open" and "Copy to inventory" the scripts in the default anchor.
 
In your inventory you will then find a folder with the "Anchor" and "setup" scripts. 
 
Simply create (or rez out) your desired anchor object, and drag those two scripts from your inventory, into your object.
 
Now you are ready to proceed with the step-by-step, beginning with the next section below.


== '''<span style="color:#00528c">Step By Step</span>''' ==
== '''<span style="color:#00528c">Step By Step</span>''' ==
Line 30: Line 59:
# Rez your build somewhere it can stay while you're packing it.  
# Rez your build somewhere it can stay while you're packing it.  
# Link together as many parts as you can, or as is efficient for your construction method.  
# Link together as many parts as you can, or as is efficient for your construction method.  
# The fewer linksets/pieces, the less time it takes to pack.   
# The fewer linksets/pieces, the less time it takes to pack.  
# Set your permissions on '''each linkset/piece, while they are rezzed inworld.'''  
# Before you begin to pack it, right-click > '''"take a copy"''' of the entire build.  
# Before you begin to pack it, right-click > '''"take a copy"''' of the entire build.  
# This gives you a backup copy in your inventory in case of "Oops!"
# This gives you a backup copy of the base build in your inventory in case of "Oops!"


=== 2. Start Packing Your Build ===
=== 2. Start Packing Your Build ===
----
----


: 1. Rez out and unpack your "Rez-Free" shipping crate to get the Anchor and the Rez-Free Tracker script in your inventory.
: 1. If this is your first time using Rez2, rez out and unpack your Rez2 shipping crate to get the Anchor and the Rez2 Tracker script in your inventory.
: 2. Rez a Rez2 Anchor on the ground.
: 2. Drag a Rez2 Anchor from your inventory to the ground.
: 3. Rename it to something distinctive, and appropriate for the build.  
: 3. Rename it to something distinctive, and appropriate for the build.  
: 4. Position it in an accessible location for your build
: 4. Position it in an accessible location for your build
: 5. Drop a '''Rez2 Tracker''' script into the root prim of each linkset of your build.  
: 5. Drop a '''Rez2 Tracker''' script into the root prim of each linkset of your build (Just the regular '''"Rez2 Tracker"''' script for now. For info on the other available tracker script options, see [[#Tracker Script Options|Tracker Script Options]]).  
: 6. Red hovertext will appear over the object that says: '''Rez2 Unpaired'''
: 6. Red hovertext will appear over the object that says: '''Rez2 Unpaired'''
: 7. You will get the following message in local chat:  
: 7. You will get the following message in local chat:  
   (name of linkset): Touch an anchor to pair me
   (name of linkset): Touch an anchor to pair me
: 8. Repeat steps 5-7 for each additional linkset in your build.  
: 8. Repeat steps 5-7 for each additional linkset in your build.  
: 9. Now click the anchor. You will get the following message in local chat:  
: 9. Now click the anchor and click Pair. You will get the following message in local chat - '''one for each linkset/piece''' - that was still unpaired at that time. If you have a lot of pieces/linksets, you'll get a screenful of messages:  
   (name of linkset): I'm now associated with anchor '(name of anchor)' (uuid string).  
   (name of linkset): I'm now associated with anchor '(name of anchor)' (uuid string).  
   You can touch me for a menu to reassociate if you wish.  
   You can touch me for a menu to reassociate if you wish.  
:10. You will see green hovertext saying '''TRACKING!''' and chain particles.  
:10. You will see green hovertext on the linksets/pieces saying '''TRACKING!''' and chain particles.  
:11. If you don't see any particles, make sure you have particles turned ON in your viewer, and that your particle slider in your viewer's graphics preferences has a number greater than "128".  
:11. If you don't see any particles, make sure you have particles turned ON in your viewer, and that your particle slider in your viewer's graphics preferences has a number greater than "128".  


Repeat the above steps for each linkset you want tracked with that anchor.  
Repeat the above steps for each linkset you want tracked with that anchor.


=== 3. Check Your Packed Build ===
=== 3. Check Your Packed Build ===
----
----
: 1. Move the anchor a sufficient distance away in order to see if you missed tracking any linksets/pieces.  
: 1. Move the anchor a sufficient distance away in order to see if you missed tracking any linksets/pieces.  
: 2. If you missed one or more pieces, simply "undo" the move (CTL + Z) to send the anchor back to its original position
: 2. If you missed one or more pieces, simply "undo" the move (CTL + Z) to send the anchor back to its original position.
: 3. Then repeat '''[[pack your build]]''' for each linkset/piece that was missed.  
: 3. Then repeat the steps in section '''[[#2._Start_Packing_Your_Build | packing your build]]''' for each linkset/piece that was missed.  
: 4. Once all the linksets/pieces are properly tracking, right-click > '''"take a copy"''' of '''each linkset/piece''' into your inventory.
: 5. On the anchor, right-click > go to "Contents" tab/
: 6. Drag all the linksets/pieces (about a dozen at a time) into the anchor's contents/
: 7. Once you are done, the anchor should have ALL the pieces in its contents.
: 8. "Take a copy" of the anchor. This is another backup in case of "Oops!"


# If you missed one or more pieces, simply "undo" the move (CTL + Z) to send the anchor back to its original position, and repeat from step 7, above.  
=== 4. Do You Have Copies in Inventory? ===
# Once all the pieces are properly tracked, then right-click > "take a copy" '''of each linkset''' into inventory.
----
# Right-click the anchor, click the "Content" tab, and drag all the pieces (a few at a time) into the anchor's contents.
At this point you should have a copy of ALL of the linksets/pieces '''and''' the anchor you are working with in your inventory.  
# At this point the anchor should have ALL the pieces in its contents.
 
# Once that's done, "take a copy" of the anchor.
If you do not, go back and "take a copy" of them!  
# At this point you should have a copy of all of the pieces AND the anchor you are working with in your inventory. If you do not, go back and get copies! Do '''NOT''' go further with these instructions until you have a copy of everything in your inventory!
 
# Once you've taken copies in your inventory, click the anchor and select "Derez".  
=== 5. If You Have Copies, Now You Can Delete ===
# Wait for everything inworld to disappear, then click the anchor again and select "Rez".  
----
# Everything should appear in place, relative to the anchor's position.  
: 1. Once you've taken copies in your inventory, you can delete the objects inworld.
# If you're satisfied with the position of all the pieces, then click the anchor and select DEREZ from the popup menu.  
: 2. Once everything is gone, click the anchor again and select "Rez".  
# Once everything is derezed, click the anchor and select '''"FINALISE"''' in the popup menu. This will make the anchor transferable and will also make it stop accepting adjusted or new positions - each piece is locked in the last position it was set in.  
: 3. Everything should appear in place, relative to the anchor's position.  
       
: 4. If you're satisfied with the position of all the pieces, then click the anchor and select DEREZ from the popup menu.
 
=== 6. Make Your Anchor Transferrable ===
----
: 1. Click the anchor
: 2. On the popup menu, select "FINALISE".  
 
This will make the anchor transferrable and will also "lock" the positions of the linksets/pieces and prevent further adjustment.  
     
The anchor is now ready to be either sold or given away!
The anchor is now ready to be either sold or given away!


== '''<span style="color:#00528c">Rez2 Demo Video</span>''' ==
== '''<span style="color:#00528c">Tracker Script Options</span>''' ==
 
The crate contains a selection of four different tracker scripts:
 
: * Rez2 Tracker - '''Recommended''' for most users
: * Rez2 Tracker (No Text/Particles) - Use this if your build has existing floating text that you need to preserve. If you just want to hide the text and particles, use the regular Tracker script in "Cloak" mode.
: * Rez2 Tracker (No Touch) - Use this if you don't want the "Unpair" dialog to show when you touch a tracked piece. Note that the dialog only shows while the rezzer is active, it goes away once the build is Finished.
: * Rez2 Tracker (No Text/Particles/Touch) - Combines the two options above.
 
{{Warning|'''WARNING:''' If you use the "No Touch" scripts, you will be unable to unpair items from your anchor via the menu. Instead, you should reset the tracker script, which will unpair it.}}


{{#ev:youtube|FsfM22iFHCw|600|center|Rez-Free tutorial video}}


=== Rez-Free Instruction Video ===
== '''<span style="color:#00528c">Rez2 Demo Video</span>''' ==
----


{{#ev:youtube|Fcnrey0DT7k|600|center|Rez-Free tutorial video}}
{{#ev:youtube|FsfM22iFHCw|600|center|Rez2 demo video}}


== '''<span style="color:#00528c">About the Menu Options</span>''' ==
== '''<span style="color:#00528c">About the Menu Options</span>''' ==
Line 101: Line 151:
This option removes '''ALL''' scripts in '''all''' of the pieces. You CANNOT undo this action!  
This option removes '''ALL''' scripts in '''all''' of the pieces. You CANNOT undo this action!  


If you just want to remove the green "TRACKING...." hovertext, use the "STEALTH" option instead.
If you just want to remove the green "TRACKING...." hovertext, use the '''CLOACK''' option instead.


==== Access Control ====
==== Access Control ====
Line 116: Line 166:
----
----


This option gives you two choices:
See '''[[Rez2#About_the_Rez_Options_Submenu | this section]]''' for details.
:* '''OPT1:''' Toggle for hiding the anchor(s) on rez - Default is to show anchor on rez
:* '''OPT2:''' Toggle for hiding the floating text when rezzing - Default is to show hovertext


==== Cloak (Hiding the floaty text) ====
==== Cloak (Hiding the floaty text) ====
Line 132: Line 180:
==== Terraform ====
==== Terraform ====
----
----
{{Warning|'''The terraform option only lowers the terrain to a point where the objects can move to the correct position, that's all. Any further terrain intersections need to be done manually.'''}}
{{Warning|'''The terraform option only lowers the terrain to a point where the objects can move to the correct position, that's all. Any further terrain adjustments need to be done by the avatar rezzing the build.'''}}


'''YOU''' must have "Terraform" ability on the land in order for this to work.  
'''YOU''' must have "Terraform" ability on the land in order for this to work.  
Line 138: Line 186:
This is a toggle option - when it's on, moving the build into the ground will roughly terraform (the ground will sink) as you move the build into place. Click again to turn the Terraforming option off.
This is a toggle option - when it's on, moving the build into the ground will roughly terraform (the ground will sink) as you move the build into place. Click again to turn the Terraforming option off.


(Usage: Click the rez-free anchor and select "Terraform" from the popup menu. In local chat you will get the message: '''''Build will now lower land when appropriate.''''' This means the option is now ON. Lower the build. When the center point of the lowest root prim out of the linksets hits the ground level, the ground will begin to sink below the build. The area will expand as each additional root prim hits the ground level. Toggle it off and finish positioning the build when satisfied with the depth of the terraforming effect.  
(Usage: Click the Rez2 anchor and select "Terraform" from the popup menu. In local chat you will get the message: '''''Build will now lower land when appropriate.''''' This means the option is now ON. Lower the build. When the center point of the lowest root prim out of the linksets hits the ground level, the ground will begin to sink below the build. The area will expand as each additional root prim hits the ground level. Toggle it off and finish positioning the build when satisfied with the depth of the terraforming effect.  


Raising the build will '''not''' undo the terraforming - that will need to be done manually, along with any fine-tuning / cleanup of the existing terraforming.
Raising the build will '''not''' undo the terraforming - that will need to be done manually, along with any fine-tuning / cleanup of the existing terraforming.
Line 152: Line 200:
This option writes the current position and rotation of the linkset in the object description field, as well as killing the scripts. The position and rotation numbers written into the description field is a "backup" of sorts - occasionally Second Life moves things out of place; sometimes people refer to this as "prim drift" - having these numbers in the description field will allow you to input the appropriate numbers for position and rotation for the linkset via the edit window to move the linkset back to its proper place, rather than trying to slide it with the arrows in edit mode.
This option writes the current position and rotation of the linkset in the object description field, as well as killing the scripts. The position and rotation numbers written into the description field is a "backup" of sorts - occasionally Second Life moves things out of place; sometimes people refer to this as "prim drift" - having these numbers in the description field will allow you to input the appropriate numbers for position and rotation for the linkset via the edit window to move the linkset back to its proper place, rather than trying to slide it with the arrows in edit mode.


== '''<span style="color:#00528c">Upgrading from Free Rez-Free to Premium Rez-Free</span>''' ==
== '''<span style="color:#00528c">About the Rez Options Submenu</span>''' ==
This is a simple process, but must be followed exactly:


# "Finalise" the non-premium anchor
{|
# Drag the Premium Rez-Free Setup script from a Premium anchor into your inventory
|-
# Drag the Premium Rez-Free Setup script from your inventory into the non-premium anchor
|[[File:Rez2_Rez_Options.png|400px|thumb|left|Rez2 Rez Options Submenu]]
# "Finalise" your anchor again
|}


Doing this will toggle the anchor script so that it now reacts to API commands.
==== OPT1 - Don't hide anchor(s) on rez====
----
: This setting only matters when the anchor is rezzed from a vendor. When a customer rezzes the anchor, the anchor will always be visible.
 
==== OPT2 - Disable floating text when rezzing ====
----
: This applies '''ONLY''' to the anchor itself - the pieces/linksets will still rez FROM the anchor with the usual tracking-related hovertext.
: See the '''[[#Cloak_.28Hiding_the_floaty_text.29|Cloak]]''' option to hide text from the rezzed pieces/linksets.


== '''<span style="color:#00528c">Common Issues</span>''' ==
== '''<span style="color:#00528c">Common Issues</span>''' ==
Line 170: Line 224:
If you did '''Edit > Contents tab > Delete''' on contents of an item, no you can't get them back.  
If you did '''Edit > Contents tab > Delete''' on contents of an item, no you can't get them back.  


If you put the tracking script in all the parts, then did '''Derez''' BEFORE picking up copies and packing it in the anchor, no you can't get them back.
If you put the tracking script in all the parts, then did '''Derez''' BEFORE picking up copies and packing it in the anchor, no you can't get them back. This is why the instructions explicitly have a step where you "take a copy" of everything BEFORE you hit derez.


=== Build Rezzing Out of Place ===  
=== Large Object Fix / Cannot Create Prims That Intersect Other Players ===
----
----
If you clicked "finalise" on a build before putting it in the Rez-Free, and it doesn't always rez properly, you will need to put the Rez-Free setup back in the anchor, reposition the build pieces where you want them to be, then pick them up and put them back in the Rez-Free anchor.


Please remember, if you have '''multiple''' sets of Rez-Free and Anchor scripts out in the nearby area, this '''WILL''' confuse the
This happens when you attempt to rez a physical object larger than 64m (in any axis), and there is an avatar in the way.
Rez-Free rezzer into thinking that all the affected pieces should actually be rezzing somewhere else.
 
There are three ways to work around the issue:


You should only be working with '''one''' rez-free anchor (and the associated pair of Anchor/Setup scripts) at a time!
:* Divide your build into smaller pieces


'''Solution:''' "Take a copy" of all the parts, then de-rez the build you're working with. Find the other rezboxes with the Rez-Free anchor/setup scripts, and remove them from the area (pick them up, delete, remove the scripts.....whichever is easier for you.) Then you should be able to reposition the pieces from the working build without a problem.
::- or -


=== Everything Is Now No-Mod by Rez-Free! ===  
:* Make sure the rez-area is clear of avatars
 
::- or -
 
:* Add the following script to the object which will turn it phantom, until after the item has been rezzed and moved into place:
 
:::(Note that if your build used the llVolumeDetect hack, or if your build is ''supposed'' to be phantom, you should not use this script.)
 
:::<syntaxhighlight lang="lsl" line='line'>
//
//
//  WORKAROUND for "Cannot create large prims that intersect other players. Please re-try when other players have moved." issue
//
//  Sets object phantom until after rezzed and moved into place. Compatible with Rez-Free, Rez2, Holovend.
//
//  Author: Casper Warden
//  License: Public Domain
//
default
{
    state_entry()
    {
        llSetLinkPrimitiveParamsFast(LINK_SET, [PRIM_PHANTOM, TRUE]);
        llOwnerSay("This prim is now phantom. Phantom property will be removed after rezzed and positioned by a Rez2, Rez-Free or Holovend.");
    }
    link_message( integer sender_num, integer num, string str, key id)
    {
        integer trigger = FALSE;
        if (num==505 && str=="MOVED" && llGetStartParameter()>0) //RezFree & Rez2
        {
            trigger = TRUE;           
        }
        if (num==0 && str=="MOVED" && llGetStartParameter()>0) //Holovend Tracker
        {
            trigger = TRUE;           
        }
       
        if (trigger == TRUE)
        {
            llSetLinkPrimitiveParamsFast(LINK_SET, [PRIM_PHANTOM, FALSE]);   
            llRemoveInventory(llGetScriptName());
        }
    }
}
 
</syntaxhighlight>
 
=== Everything Is Now No-Mod by Rez2! ===  
----
----
Actually, no it didn't - LSL scripting does not even have that capability.  
Actually, no it didn't render everything no-mod - LSL scripting does not even have that capability.  


What's likely happened is you used the "permissions" button in the Edit floater > Contents tab.
You most likely used the what's been nicknamed the "Bad Day Button" on the Edit > contents tab, as shown below:


This has the unfortunate side effect of making ALL contents have the lowest available next-person permissions. Since the Rez-Free scripts are no-mod.....'''everything''' becomes no-mod.  
{|
|-
| [[File:Dontpushthefuckingbutton.png|300px|thumb|left|The Bad Day Button]]
| This has the unfortunate side effect of making ALL contents have the lowest available next-person permissions. Since the Rez2 scripts are no-mod.....'''everything''' becomes no-mod.  


The steps you need to take to fix this are:  
The steps you need to take to fix this are:  
Line 197: Line 301:
:3) Click the anchor again, select "kill scripts"  
:3) Click the anchor again, select "kill scripts"  
:4) When that's finished, delete the current anchor
:4) When that's finished, delete the current anchor
:5) Rez out a NEW AND EMPTY rez-free anchor
:5) Rez out a NEW AND EMPTY Rez2 anchor
:6) Set the permissions INWORLD on each piece/linkset of your build
:6) Set the permissions INWORLD on each piece/linkset of your build
:7) Drop in a fresh tracking script in the root prim of all pieces/linksets
:7) Begin '''[[#2._Start_Packing_Your_Build | re-packing your build.]]'''
:8) Pick up each piece and put it in the anchor
|}


=== Extra Props & Parts Not Deleting ===  
=== Extra Props & Parts Not Deleting ===  
Line 208: Line 312:


'''[[CasperVend_2/Rez_Clean-up_script | Rez Cleanup Script]]'''
'''[[CasperVend_2/Rez_Clean-up_script | Rez Cleanup Script]]'''
=== Hand pointer instead of arrow ===
----
This occurs when you link stuff together AFTER adding the script.
The root cause is simulator bug [https://jira.secondlife.com/browse/BUG-139237 BUG-139237].
There is now a "fix" included in the crate, the script is called "z_Fix for BUG-139237". Simply drop it in the root prim of the linkset and it'll ask for link permissions - grant these permissions and it should fix the build.
You can manually fix your builds by unlinking, removing the script, linking your build back together, then re-adding the script. This is effectively what the "fix" does anyway.
To avoid hitting this issue in the future, just add the script AFTER you've linked everything together.


=== Hovertext/floaty text still there ===  
=== Hovertext/floaty text still there ===  
----
----
The primary reason hovertext will not respond to a "stealth", "finish" or "store" command is that the script is simply '''not there''' in the prim with the hovertext. Hovertext will always be there ("persistent") until a script tells the prims/linkset to clear it - if there's no script that handles hovertext IN that linkset, then the hovertext will stay until it is scrubbed.  
The primary reason hovertext will not respond to a "Cloak", "Finish" or "Store" command is that the script is simply '''not there''' in the prim with the hovertext. Hovertext will always be there ("persistent") until a script tells the prims/linkset to clear it - if there's no script that handles hovertext IN that linkset, then the hovertext will stay until it is scrubbed by a different script.  


Remember that if you link a set of prims, then unlink, and relink in a different order, with a different root prim, any tracker scripts that are '''not''' in the root prim will self-delete. (and, if you did that while there was hovertext, will also leave hovertext behind.)  
Remember that if you link a set of prims, then unlink, and relink in a different order, with a different root prim, any tracker scripts that are '''not''' in the root prim will self-delete. (and, if you did that while there was hovertext, will also leave hovertext behind.)  
Line 234: Line 351:
</syntaxhighlight>
</syntaxhighlight>


=== Inventory Creation Failed ===  
=== Inventory Creation Failed ===  
----
----
If you are getting this message:  
If you are getting this message:  
   '''"inventory creation on in-world object failed"'''
   '''"inventory creation on in-world object failed"'''
This is a message from the SL grid, '''not''' the rez-free. That message means you tried to move too many things at once into the Rez-Free. You'll need to delete the pieces that you already put in there, and then drag over a few pieces at a time from your inventory. 15 or less at a time normally works, even when the grid is being terrible that day.
This is a message from the SL grid, '''not Rez2.'''  
 
That message simply means you tried to move too many things at once into the anchor contents.  
 
You'll need to delete the pieces that you already put in there, and then drag over a few pieces at a time from your inventory. 15 or less at a time normally works, even when the grid is being terrible that day.


=== Navmesh Error ===  
=== Navmesh Error ===  
Line 252: Line 372:
----
----


This is a pathfinding error message, and comes from SL itself, '''NOT''' the Rez-Free script. Currently the rez-free cannot track objects that are set to be part of the pathfinding navmesh.  
This is a pathfinding error message, and comes from SL itself, '''NOT''' the Rez2 script. Currently the Rez2 cannot track objects that are set to be part of the pathfinding navmesh.  
              
              
Most common linkset issues are likely to be ones that contain any full-perm build components that were purchased from someone else, such as mesh items. Such items may have had "pathfinding" accidentally enabled for the item before sale.
Most common linkset issues are likely to be ones that contain any full-perm build components that were purchased from someone else, such as mesh items. Such items may have had "pathfinding" accidentally enabled for the item before sale.
Line 266: Line 386:
:# Save.  
:# Save.  
:# Repeat with all other errant linksets, if any. When done, close out of the pathfinding popup.  
:# Repeat with all other errant linksets, if any. When done, close out of the pathfinding popup.  
:# Replace the rez-free tracker script, and the prims should track properly now.
:# Replace the Rez2 tracker script, and the prims should track properly now.


=== No-Transfer, Even Finalised ===  
=== No-Transfer, Even Finalised ===  
Line 274: Line 394:
# You missed clicking "Finalize" before you picked it up. Just rez the anchor out again and hit "finalize" and it'll be all set.  
# You missed clicking "Finalize" before you picked it up. Just rez the anchor out again and hit "finalize" and it'll be all set.  
# OR...you have something in your build that's no-transfer to YOU. This is most commonly one of the following reasons:  
# OR...you have something in your build that's no-transfer to YOU. This is most commonly one of the following reasons:  
:* An errant no-transfer script in a prim
::* An errant no-transfer script in a prim
:* An errant no-transfer texture in - or ON - a prim
::* An errant no-transfer texture in - or ON - a prim
:* An errant no-transfer sculpt in - or ON - a prim
::* An errant no-transfer sculpt in - or ON - a prim
:* One or more of the prims you linked may be no-transfer to you (such as if you accidentally linked a stray piece of no-trans furniture)
::* One or more of the prims you linked may be no-transfer to you (such as if you accidentally linked a stray piece of no-trans furniture)


The fastest way to sort out which linkset(s) is/are the problem is to go into edit mode on the anchor, go to the "contents" tab, move the bottom scrollbar to the right, and see which one shows up as "(no transfer)". That tells you which piece you need to start looking in when you rez it to find the thing that shouldn't be there.
The fastest way to sort out which linkset(s) is/are the problem is to go into edit mode on the anchor, go to the "contents" tab, move the bottom scrollbar to the right, and see which one shows up as "(no transfer)". That tells you which piece you need to start looking in when you rez it to find the thing that shouldn't be there.
Line 286: Line 406:
Second Life displays the MINIMUM available permissions when an item is in your inventory. This by design of Linden Lab, and not something Casper can change.  
Second Life displays the MINIMUM available permissions when an item is in your inventory. This by design of Linden Lab, and not something Casper can change.  


Because the Rez-Free scripts are no-mod, your finalised product will always appear at least no-mod '''while in your inventory.''' Permissions on the object(s) themselves should display as intended '''once they are rezzed inworld,''' provided you have not used the "permissions" button on the object inventory contents.
Because the Rez2 scripts are no-mod, your finalised product will always appear at least no-mod '''while in your inventory.''' Permissions on the object(s) themselves should display as intended '''once they are rezzed inworld,''' provided you have not used the "permissions" button on the object inventory contents.


(If you arrived at here after using the Edit > Contents > permissions button, you need '''[[Rez_Free#Everything_Is_Now_No-Mod_by_Rez-Free.21 | this other section instead.]]''')
(If you arrived at here after using the Edit > Contents > permissions button, you need '''[[#Everything_Is_Now_No-Mod_by_Rez2.21 | this other section instead.]]''')


== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==
== '''<span style="color:#00528c">FAQ / Troubleshooting</span>''' ==
: '''Q. I packed everything in the Rez-Free, but when I test rez, I see this kind of message over the Rez-Free Anchor - "3 parts remaining: rez queue 0" - and/or nothing is rezzing where it should be! '''   
: '''Q. Items rez, but then almost immediately DEREZ?'''
:: '''A1.''' You don't have the Rez-Free Tracker script in the objects you're trying to rez.  
:: '''A.''' Remove all thirdparty (non-CasperTech) scripts from the build(s) are affected, and try again. This often happens with things like prop scripts.
:: '''A2.''' You have the wrong script in the pieces you are rezzing (or no script at all). Commonly this is the Holovend Tracker script in there by mistake. Take out the wrong script and replace with the one named: "Rez-Free Tracker".  
 
: '''Q. I "pair"ed an item with an anchor, then accidentally un"pair"ed it, and I re"pair"ed it with the same anchor, but now it gives me "I wasn't rezzed by a script" message, and won't delete.'''
:: '''A1.''' This is expected behavior. Un"pair"ing the linkset basically resets the script, which will then no longer have the memory of having been rezzed. (It resets the script, because it's expected that you MIGHT unpair an item from one anchor, to instead link it to another, which means you'll need to pack it in the other anchor.)
:: '''A2.''' Remember to make sure there's a copy of the linkset in the anchor you want it in, before using derez. 
 
: '''Q. I'm setting up a build with the Rez2 but the prims are either saying "searching for anchor" or "TRACKING!" but I don't see any particles!'''
:: '''A.''' Wrong script: This happens when you use the Rez-Free tracker script with a Rez2 Anchor. The prim is '''not being tracked,''' which is why you don't see particles.
 
: '''Q. I packed everything in the Rez2, but when I test rez, I see this kind of message over the Anchor - "3 parts remaining: rez queue 0" - and/or nothing is rezzing where it should be! '''   
:: '''A1.''' You don't have the Rez2 Tracker script in the objects you're trying to rez.  
:: '''A2.''' You have the wrong script in the pieces you are rezzing (or no script at all). Commonly this is the Holovend Tracker script in there by mistake. Take out the wrong script and replace with the one named: "Rez2 Tracker".  
          
          
: '''Q. When I rez my building, it doesn't rez completely - there's parts missing - and it also tells me that it cannot rez properly due to nearby avatars...'''
: '''Q. When I rez my building, it doesn't rez completely - there's parts missing - and it also tells me that it cannot rez properly due to nearby avatars...'''
:: '''A.''' This is an issue with ANY rezzing on a sim where pathfinding is enabled - the prims are checking for avatars within their bounding boxes (so if part of the build is sculpted prims, the bounding box can be substantially larger than the visible sculpt.)  
:: '''A.''' This is an issue with ANY rezzing on a sim where pathfinding is enabled - the prims are checking for avatars within their bounding boxes (so if part of the build is sculpted prims, the bounding box can be substantially larger than the visible sculpt.)  


: '''Q. I packed a build in the rez-free but when I rezzed it, the doors came out crooked / floating at an angle. Help!'''
: '''Q. I packed a build in the Rez2 but when I rezzed it, the doors came out crooked / floating at an angle. Help!'''
:: '''A.''' There are a few things to check:  
:: '''A.''' There are a few things to check:  
::: * Did any parts rez off-world / off parcel boundaries?  
::: * Did any parts rez off-world / off parcel boundaries?  
::: * Do the doors actually have the Rez-Free Tracker script in them?  
::: * Do the doors actually have the Rez2 Tracker script in them?  
::: * Were the doors in a closed state when you packed them?
::: * Were the doors in a closed state when you packed them?
:: Some door scripts are finicky - try making sure the doors are closed, reset the door scripts, and try a fresh tracker script again.  
:: Some door scripts are finicky - try making sure the doors are closed, reset the door scripts, and try a fresh tracker script again.  


: '''Q. I've been packing many builds successfully, but for some unknown reason now my new builds are starting to put pieces in the wrong positions...'''
: '''Q. I've been packing many builds successfully, but for some unknown reason now my new builds are starting to put pieces in the wrong positions...'''
:: '''A.''' Are you adding a third party (non-CasperTech) script to the rez-free? If so, you may have a conflict between one or more commands in the extra script and the Rez-Free.
:: '''A.''' Are you adding a third party (non-CasperTech) script to the Rez2? If so, you may have a conflict between one or more commands in the extra script and the Rez2.
:: Example third party scripts would be door or "whole house system" scripts.
 
: '''Q.  i have a problem with the Rez2. it won't find the items because if i put the tracker script in an item it says: ''Rez2 Anchor: I've associated with a new holovendor with key ____________________'''''
:: '''A.''' You used a holovend tracker script by mistake. Take it out and use the actual Rez2 tracker script instead.
 
: '''Q.  My scripted object stops working when rezzed with the Rez2'''
:: '''A.''' Some poorly scripted items use floating text to store data. Try using the "Rez2 Tracker (No Text/Particles)" tracker script instead.
:: '''A2.''' Otherwise, it's down to the third party script creator to make their items compatible with the Rez2.
 
== '''<span style="color:#00528c">API</span>''' ==
 
The Rez2 Anchor responds to linked messages sent like follows:
 
<syntaxhighlight lang="lsl">llMessageLinked(LINK_THIS, controlCode, "REZ2-API", uuid);</syntaxhighlight>
 
"controlCode" is detailed below.
 
"uuid" may be NULL_KEY unless required below.


: '''Q. I'm setting up a build with the Rez-Free but the prims are saying "searching for anchor" for several minutes now. The anchor is out, but they don't seem to be finding it.'''
=== Control Codes ===
:: '''A1.''' If the land is group owned:
:::* Is the proper group tag on?
:::* Are the prims themselves rezzed under the proper land group?
:::* Are scripts ON for the parcel?
:: '''A2.''' Other things to check:
:::* Look inside the anchor - are both scripts in there? You are looking for both '''Rez-Free Anchor''' and '''Rez-Free Setup'''. If the setup script is NOT in there, then the prims with the tracking scripts will always show "Scanning for Anchor" because they can't see the setup script.
:::* Is the avatar rezzing the anchor the same avatar that owns the prims? If not, they need to be. You cannot pack prims owned by someone else into an anchor owned by you.


: '''Q. i have a problem with the rez free. it won't find the items because if i put the tracker script in an item it says: ''Rez-Free Anchor ___ Free: I've associated with a new holovendor with key ____________________'''''
: '''10001''': Rez. Will send response code 11001 when done.
:: '''A.''' You used a holovend tracker script by mistake. Take it out and use the actual Rez-Free tracker script instead.
: '''10002''': DeRez. Will send response code 11002 when done.
           
: '''10003''': Show menu dialog. Pass the avatar key as the uuid parameter.
: '''Q. Can I use the Rez-Free to pack up a build for sale, or do I need to purchase the Premium version for that? '''
: '''10004''': Allow rez and de-rez by EVERYONE
:: '''A.''' You can use either version of the Rez-Free to pack up a build for sale.  
: '''10005''': Allow rez and de-rez by GROUP ONLY
       
: '''10006''': Allow rez and de-rez by OWNER ONLY
: '''Q. I packed everything in the Rez-Free, but when I test rez, I see this kind of message over the Rez-Free Anchor - "3 parts remaining: rez queue 0" - and/or nothing is rezzing where the build should be! '''
: '''10007''': Terraforming OFF
:: '''A.''' You have the wrong script in the pieces you are rezzing. Commonly this is the Holovend Tracker script in there by mistake. Take out the wrong script and replace with the one named: "Rez-Free Tracker".
: '''10008''': Terraforming ON
: '''10009''': Uncloak
: '''10010''': Cloak
: '''10011''': Store
: '''10012''': Kill Scripts
: '''10013''': Test
: '''10014''': Is build currently rezzed? Responds with a RESPONSE CODE as defined below.
: '''10015''': Internal - DO NOT USE
: '''10016''': Internal - DO NOT USE
 
=== Response Codes ===
 
: '''11001''': Build is currently rezzed
: '''11002''': Build is currently not rezzed
 
=== Tracker messages ===
 
Once the Rez2 tracker has moved the object it'll issue a linked message as follows:
 
<syntaxhighlight lang="lsl">llMessageLinked( LINK_SET, 505, "MOVED", NULL_KEY );</syntaxhighlight>
 
This is to provide compatibility with third party scripts.

Latest revision as of 15:57, 15 December 2020

Introduction

Welcome to Rez2!

Rez2 allows you to easily package, rotate, move, align, and sell big or sparse structures that may be impossible to link. The speed is greatly improved over Rez-Free, allowing your builds to be rezzed even faster!

Rez2 features include:

  • NEW IN REZ2: Faster rezzing! See the demo video below!
  • NEW IN REZ2: Access control options! Owner / Group / Public
  • NEW IN REZ2: "Pair" option! Tell each piece which anchor you want them linked to
  • NEW IN REZ2: Rez Option: Toggle hide anchor when rezzing
  • NEW IN REZ2: Rez Option: Toggle disable floating text when rezzing
  • It's FREE! The Free version contains all the features you would expect from other commercial package rezzers.
  • Integrates with CasperVend Holovendors - ideal for house sellers or otherwise demoing your large build
  • The separate parts of your build can be ANYWHERE on the same region
  • Extremely robust rezzing system means that rezzing always succeeds even on lagged sims
  • Extremely low lag scripting means that your sim is not bogged down by this system
  • Unlimited pieces can be managed - no memory limits
  • Add/remove new pieces at any time without having to start again

Features removed from the Rez2 versus the older Rez-Free:

  • Temp-rezzing support. With mesh content this no longer gives any advantage over regular rezzing.
  • Rezzing across region borders. This wasn't reliable due to sim communications.

Customising Your Anchor

Re-texturing The Original Object


The Rez2 anchor object has only ONE face. You cannot re-texture just the box portion without also re-texturing the arrows at the same time.

There is no texture template for the Rez2 at this time. You might find it easier to just make your own anchor object.

(Using your own anchor object has the advantage of the customer knowing exactly who to contact regarding your build!)

Using Your Own Anchor Object


You can (but it's not required to) make a customised anchor!

Simply "Open" and "Copy to inventory" the scripts in the default anchor.

In your inventory you will then find a folder with the "Anchor" and "setup" scripts.

Simply create (or rez out) your desired anchor object, and drag those two scripts from your inventory, into your object.

Now you are ready to proceed with the step-by-step, beginning with the next section below.

Step By Step

1. Prepare your build


  1. Rez your build somewhere it can stay while you're packing it.
  2. Link together as many parts as you can, or as is efficient for your construction method.
  3. The fewer linksets/pieces, the less time it takes to pack.
  4. Set your permissions on each linkset/piece, while they are rezzed inworld.
  5. Before you begin to pack it, right-click > "take a copy" of the entire build.
  6. This gives you a backup copy of the base build in your inventory in case of "Oops!"

2. Start Packing Your Build


1. If this is your first time using Rez2, rez out and unpack your Rez2 shipping crate to get the Anchor and the Rez2 Tracker script in your inventory.
2. Drag a Rez2 Anchor from your inventory to the ground.
3. Rename it to something distinctive, and appropriate for the build.
4. Position it in an accessible location for your build
5. Drop a Rez2 Tracker script into the root prim of each linkset of your build (Just the regular "Rez2 Tracker" script for now. For info on the other available tracker script options, see Tracker Script Options).
6. Red hovertext will appear over the object that says: Rez2 Unpaired
7. You will get the following message in local chat:
  (name of linkset): Touch an anchor to pair me
8. Repeat steps 5-7 for each additional linkset in your build.
9. Now click the anchor and click Pair. You will get the following message in local chat - one for each linkset/piece - that was still unpaired at that time. If you have a lot of pieces/linksets, you'll get a screenful of messages:
  (name of linkset): I'm now associated with anchor '(name of anchor)' (uuid string). 
  You can touch me for a menu to reassociate if you wish. 
10. You will see green hovertext on the linksets/pieces saying TRACKING! and chain particles.
11. If you don't see any particles, make sure you have particles turned ON in your viewer, and that your particle slider in your viewer's graphics preferences has a number greater than "128".

Repeat the above steps for each linkset you want tracked with that anchor.

3. Check Your Packed Build


1. Move the anchor a sufficient distance away in order to see if you missed tracking any linksets/pieces.
2. If you missed one or more pieces, simply "undo" the move (CTL + Z) to send the anchor back to its original position.
3. Then repeat the steps in section packing your build for each linkset/piece that was missed.
4. Once all the linksets/pieces are properly tracking, right-click > "take a copy" of each linkset/piece into your inventory.
5. On the anchor, right-click > go to "Contents" tab/
6. Drag all the linksets/pieces (about a dozen at a time) into the anchor's contents/
7. Once you are done, the anchor should have ALL the pieces in its contents.
8. "Take a copy" of the anchor. This is another backup in case of "Oops!"

4. Do You Have Copies in Inventory?


At this point you should have a copy of ALL of the linksets/pieces and the anchor you are working with in your inventory.

If you do not, go back and "take a copy" of them!

5. If You Have Copies, Now You Can Delete


1. Once you've taken copies in your inventory, you can delete the objects inworld.
2. Once everything is gone, click the anchor again and select "Rez".
3. Everything should appear in place, relative to the anchor's position.
4. If you're satisfied with the position of all the pieces, then click the anchor and select DEREZ from the popup menu.

6. Make Your Anchor Transferrable


1. Click the anchor
2. On the popup menu, select "FINALISE".

This will make the anchor transferrable and will also "lock" the positions of the linksets/pieces and prevent further adjustment.

The anchor is now ready to be either sold or given away!

Tracker Script Options

The crate contains a selection of four different tracker scripts:

* Rez2 Tracker - Recommended for most users
* Rez2 Tracker (No Text/Particles) - Use this if your build has existing floating text that you need to preserve. If you just want to hide the text and particles, use the regular Tracker script in "Cloak" mode.
* Rez2 Tracker (No Touch) - Use this if you don't want the "Unpair" dialog to show when you touch a tracked piece. Note that the dialog only shows while the rezzer is active, it goes away once the build is Finished.
* Rez2 Tracker (No Text/Particles/Touch) - Combines the two options above.
WARNING: If you use the "No Touch" scripts, you will be unable to unpair items from your anchor via the menu. Instead, you should reset the tracker script, which will unpair it.


Rez2 Demo Video

Rez2 demo video

About the Menu Options

Rez2 Main Menu Options

Finalise


This option deletes the "setup" script, and makes the anchor transferrable so you can now sell or give away your build. This also prevents adding or adjusting pieces - the anchor will no longer accept new data without the setup script in it.

(If your build is still not transferrable, that's because there's something else still in the anchor - or in one of your linksets - that is No-Transfer.)

Kill Scripts


This option removes ALL scripts in all of the pieces. You CANNOT undo this action!

If you just want to remove the green "TRACKING...." hovertext, use the CLOACK option instead.

Access Control


This option controls who can use the rezzer. Your options are:

  • Everyone
  • Group
  • Owner only

Owner is the default setting.

Rez Options


See this section for details.

Cloak (Hiding the floaty text)


This removes the green hovertext and particles, but does NOT remove scripts. This allows you to move things around without seeing distracting particles or hovertext. If you are satisfied with the placement and no longer wish to move the build, you should always use "kill scripts" or "finish".

Test


This option moves all the tracked parts up about 10 meters for about 10 seconds, then moves everything back down. This allows you to see if there's any parts that you missed putting a tracking script in.

Terraform


The terraform option only lowers the terrain to a point where the objects can move to the correct position, that's all. Any further terrain adjustments need to be done by the avatar rezzing the build.

YOU must have "Terraform" ability on the land in order for this to work.

This is a toggle option - when it's on, moving the build into the ground will roughly terraform (the ground will sink) as you move the build into place. Click again to turn the Terraforming option off.

(Usage: Click the Rez2 anchor and select "Terraform" from the popup menu. In local chat you will get the message: Build will now lower land when appropriate. This means the option is now ON. Lower the build. When the center point of the lowest root prim out of the linksets hits the ground level, the ground will begin to sink below the build. The area will expand as each additional root prim hits the ground level. Toggle it off and finish positioning the build when satisfied with the depth of the terraforming effect.

Raising the build will not undo the terraforming - that will need to be done manually, along with any fine-tuning / cleanup of the existing terraforming.

Rez / Derez


To rez and derez the build.

Store


This option writes the current position and rotation of the linkset in the object description field, as well as killing the scripts. The position and rotation numbers written into the description field is a "backup" of sorts - occasionally Second Life moves things out of place; sometimes people refer to this as "prim drift" - having these numbers in the description field will allow you to input the appropriate numbers for position and rotation for the linkset via the edit window to move the linkset back to its proper place, rather than trying to slide it with the arrows in edit mode.

About the Rez Options Submenu

Rez2 Rez Options Submenu

OPT1 - Don't hide anchor(s) on rez


This setting only matters when the anchor is rezzed from a vendor. When a customer rezzes the anchor, the anchor will always be visible.

OPT2 - Disable floating text when rezzing


This applies ONLY to the anchor itself - the pieces/linksets will still rez FROM the anchor with the usual tracking-related hovertext.
See the Cloak option to hide text from the rezzed pieces/linksets.

Common Issues

Accidentally deleted?


If you did Edit > Delete on items rezzed inworld, they should still be in your trash.

If you did Edit > Contents tab > Delete on contents of an item, no you can't get them back.

If you put the tracking script in all the parts, then did Derez BEFORE picking up copies and packing it in the anchor, no you can't get them back. This is why the instructions explicitly have a step where you "take a copy" of everything BEFORE you hit derez.

Large Object Fix / Cannot Create Prims That Intersect Other Players


This happens when you attempt to rez a physical object larger than 64m (in any axis), and there is an avatar in the way.

There are three ways to work around the issue:

  • Divide your build into smaller pieces
- or -
  • Make sure the rez-area is clear of avatars
- or -
  • Add the following script to the object which will turn it phantom, until after the item has been rezzed and moved into place:
(Note that if your build used the llVolumeDetect hack, or if your build is supposed to be phantom, you should not use this script.)
//
//
//  WORKAROUND for "Cannot create large prims that intersect other players. Please re-try when other players have moved." issue
//
//  Sets object phantom until after rezzed and moved into place. Compatible with Rez-Free, Rez2, Holovend.
//
//  Author: Casper Warden
//  License: Public Domain
//
default
{
    state_entry()
    {
        llSetLinkPrimitiveParamsFast(LINK_SET, [PRIM_PHANTOM, TRUE]);
        llOwnerSay("This prim is now phantom. Phantom property will be removed after rezzed and positioned by a Rez2, Rez-Free or Holovend.");
    }
    link_message( integer sender_num, integer num, string str, key id)
    {
        integer trigger = FALSE;
        if (num==505 && str=="MOVED" && llGetStartParameter()>0) //RezFree & Rez2
        {
            trigger = TRUE;            
        }
        if (num==0 && str=="MOVED" && llGetStartParameter()>0) //Holovend Tracker
        {
            trigger = TRUE;            
        }
        
        if (trigger == TRUE)
        {
            llSetLinkPrimitiveParamsFast(LINK_SET, [PRIM_PHANTOM, FALSE]);    
            llRemoveInventory(llGetScriptName());
        }
    }
}

Everything Is Now No-Mod by Rez2!


Actually, no it didn't render everything no-mod - LSL scripting does not even have that capability.

You most likely used the what's been nicknamed the "Bad Day Button" on the Edit > contents tab, as shown below:

The Bad Day Button
This has the unfortunate side effect of making ALL contents have the lowest available next-person permissions. Since the Rez2 scripts are no-mod.....everything becomes no-mod.

The steps you need to take to fix this are:

1) Rez the build anchor
2) Click the anchor and rez the build
3) Click the anchor again, select "kill scripts"
4) When that's finished, delete the current anchor
5) Rez out a NEW AND EMPTY Rez2 anchor
6) Set the permissions INWORLD on each piece/linkset of your build
7) Begin re-packing your build.

Extra Props & Parts Not Deleting


If your rezzed object will be rezzing poseballs (like for synced beds), props or other parts, you will need to put this script in each additional item to make sure they clean up after the rezzed object is removed from display.

Rez Cleanup Script

Hand pointer instead of arrow


This occurs when you link stuff together AFTER adding the script.

The root cause is simulator bug BUG-139237.

There is now a "fix" included in the crate, the script is called "z_Fix for BUG-139237". Simply drop it in the root prim of the linkset and it'll ask for link permissions - grant these permissions and it should fix the build.

You can manually fix your builds by unlinking, removing the script, linking your build back together, then re-adding the script. This is effectively what the "fix" does anyway.

To avoid hitting this issue in the future, just add the script AFTER you've linked everything together.

Hovertext/floaty text still there


The primary reason hovertext will not respond to a "Cloak", "Finish" or "Store" command is that the script is simply not there in the prim with the hovertext. Hovertext will always be there ("persistent") until a script tells the prims/linkset to clear it - if there's no script that handles hovertext IN that linkset, then the hovertext will stay until it is scrubbed by a different script.

Remember that if you link a set of prims, then unlink, and relink in a different order, with a different root prim, any tracker scripts that are not in the root prim will self-delete. (and, if you did that while there was hovertext, will also leave hovertext behind.)

Hovertext Scrubber Script


If you have this situation come up, you can use this script in EVERY linkset that needs to have the hovertext cleared off. This script will only get rid of the hovertext and any particle beams - no other scripts in the linkset will be deleted.

  //By Casper Warden
  //Public Domain, use as you wish. No license terms.
   
  default
  {
      state_entry() 
      {  
          llSetLinkPrimitiveParamsFast(LINK_SET, [PRIM_TEXT,"",<1.0,1.0,1.0>,1.0,PRIM_OMEGA,<0.0,0.0,0.0>,0.0,0.0]);
          llLinkParticleSystem(LINK_SET,[]);  
          llRemoveInventory(llGetScriptName());
      }
  }

Inventory Creation Failed


If you are getting this message:

  "inventory creation on in-world object failed"

This is a message from the SL grid, not Rez2.

That message simply means you tried to move too many things at once into the anchor contents.

You'll need to delete the pieces that you already put in there, and then drag over a few pieces at a time from your inventory. 15 or less at a time normally works, even when the grid is being terrible that day.

Navmesh Error


Error Message


  "Unable to set prim position or scale: object contributes to the navmesh."

Problem


This is a pathfinding error message, and comes from SL itself, NOT the Rez2 script. Currently the Rez2 cannot track objects that are set to be part of the pathfinding navmesh.

Most common linkset issues are likely to be ones that contain any full-perm build components that were purchased from someone else, such as mesh items. Such items may have had "pathfinding" accidentally enabled for the item before sale.

Workaround


  1. Log in to a pathfinding capable viewer (SL Viewer 3, Cool VL Viewer, Firestorm, etc.)
  2. Right-click on the errant linkset
  3. Select "show in linksets" (or "show in characters", whichever comes up)
  4. You will get a HUGE popup, which -should- automatically have your selected linkset highlighted.
  5. Change the attributes (bottom left) to "Moveable obstacle"
  6. Save.
  7. Repeat with all other errant linksets, if any. When done, close out of the pathfinding popup.
  8. Replace the Rez2 tracker script, and the prims should track properly now.

No-Transfer, Even Finalised


There are two basic issues at work when you've finalized a build (and the setup script is gone) but the anchor is still no-transfer in your inventory. These are:

  1. You missed clicking "Finalize" before you picked it up. Just rez the anchor out again and hit "finalize" and it'll be all set.
  2. OR...you have something in your build that's no-transfer to YOU. This is most commonly one of the following reasons:
  • An errant no-transfer script in a prim
  • An errant no-transfer texture in - or ON - a prim
  • An errant no-transfer sculpt in - or ON - a prim
  • One or more of the prims you linked may be no-transfer to you (such as if you accidentally linked a stray piece of no-trans furniture)

The fastest way to sort out which linkset(s) is/are the problem is to go into edit mode on the anchor, go to the "contents" tab, move the bottom scrollbar to the right, and see which one shows up as "(no transfer)". That tells you which piece you need to start looking in when you rez it to find the thing that shouldn't be there.

Not Full Perm As Promised


Second Life displays the MINIMUM available permissions when an item is in your inventory. This by design of Linden Lab, and not something Casper can change.

Because the Rez2 scripts are no-mod, your finalised product will always appear at least no-mod while in your inventory. Permissions on the object(s) themselves should display as intended once they are rezzed inworld, provided you have not used the "permissions" button on the object inventory contents.

(If you arrived at here after using the Edit > Contents > permissions button, you need this other section instead.)

FAQ / Troubleshooting

Q. Items rez, but then almost immediately DEREZ?
A. Remove all thirdparty (non-CasperTech) scripts from the build(s) are affected, and try again. This often happens with things like prop scripts.
Q. I "pair"ed an item with an anchor, then accidentally un"pair"ed it, and I re"pair"ed it with the same anchor, but now it gives me "I wasn't rezzed by a script" message, and won't delete.
A1. This is expected behavior. Un"pair"ing the linkset basically resets the script, which will then no longer have the memory of having been rezzed. (It resets the script, because it's expected that you MIGHT unpair an item from one anchor, to instead link it to another, which means you'll need to pack it in the other anchor.)
A2. Remember to make sure there's a copy of the linkset in the anchor you want it in, before using derez.
Q. I'm setting up a build with the Rez2 but the prims are either saying "searching for anchor" or "TRACKING!" but I don't see any particles!
A. Wrong script: This happens when you use the Rez-Free tracker script with a Rez2 Anchor. The prim is not being tracked, which is why you don't see particles.
Q. I packed everything in the Rez2, but when I test rez, I see this kind of message over the Anchor - "3 parts remaining: rez queue 0" - and/or nothing is rezzing where it should be!
A1. You don't have the Rez2 Tracker script in the objects you're trying to rez.
A2. You have the wrong script in the pieces you are rezzing (or no script at all). Commonly this is the Holovend Tracker script in there by mistake. Take out the wrong script and replace with the one named: "Rez2 Tracker".
Q. When I rez my building, it doesn't rez completely - there's parts missing - and it also tells me that it cannot rez properly due to nearby avatars...
A. This is an issue with ANY rezzing on a sim where pathfinding is enabled - the prims are checking for avatars within their bounding boxes (so if part of the build is sculpted prims, the bounding box can be substantially larger than the visible sculpt.)
Q. I packed a build in the Rez2 but when I rezzed it, the doors came out crooked / floating at an angle. Help!
A. There are a few things to check:
* Did any parts rez off-world / off parcel boundaries?
* Do the doors actually have the Rez2 Tracker script in them?
* Were the doors in a closed state when you packed them?
Some door scripts are finicky - try making sure the doors are closed, reset the door scripts, and try a fresh tracker script again.
Q. I've been packing many builds successfully, but for some unknown reason now my new builds are starting to put pieces in the wrong positions...
A. Are you adding a third party (non-CasperTech) script to the Rez2? If so, you may have a conflict between one or more commands in the extra script and the Rez2.
Example third party scripts would be door or "whole house system" scripts.
Q. i have a problem with the Rez2. it won't find the items because if i put the tracker script in an item it says: Rez2 Anchor: I've associated with a new holovendor with key ____________________
A. You used a holovend tracker script by mistake. Take it out and use the actual Rez2 tracker script instead.
Q. My scripted object stops working when rezzed with the Rez2
A. Some poorly scripted items use floating text to store data. Try using the "Rez2 Tracker (No Text/Particles)" tracker script instead.
A2. Otherwise, it's down to the third party script creator to make their items compatible with the Rez2.

API

The Rez2 Anchor responds to linked messages sent like follows:

llMessageLinked(LINK_THIS, controlCode, "REZ2-API", uuid);

"controlCode" is detailed below.

"uuid" may be NULL_KEY unless required below.

Control Codes

10001: Rez. Will send response code 11001 when done.
10002: DeRez. Will send response code 11002 when done.
10003: Show menu dialog. Pass the avatar key as the uuid parameter.
10004: Allow rez and de-rez by EVERYONE
10005: Allow rez and de-rez by GROUP ONLY
10006: Allow rez and de-rez by OWNER ONLY
10007: Terraforming OFF
10008: Terraforming ON
10009: Uncloak
10010: Cloak
10011: Store
10012: Kill Scripts
10013: Test
10014: Is build currently rezzed? Responds with a RESPONSE CODE as defined below.
10015: Internal - DO NOT USE
10016: Internal - DO NOT USE

Response Codes

11001: Build is currently rezzed
11002: Build is currently not rezzed

Tracker messages

Once the Rez2 tracker has moved the object it'll issue a linked message as follows:

llMessageLinked( LINK_SET, 505, "MOVED", NULL_KEY );

This is to provide compatibility with third party scripts.