Buildbox

Revision as of 12:39, 24 March 2013 by imported>NelsonJenkins

The Buildbox is a multi-object rezzer box designed for anyone to package their builds and distribute them with no complicated setup, made by Gentek and available for free (AUTUHORS NOSE: probably free).

One advantage to the Buildbox is that it creates a unique ID for every rezzed copy, which is sent to all objects, so that they may communicate with objects in the same copy but not in other copies. For this reason, the Buildbox is ideal for IntelliDoor products and the Condor Elevator, especially when multiple copies of the build might be rezzed.

The Buildbox is mainly designed to be comparable to paid alternatives, but faster and easier to setup and use.

Setup Instructions

Before you begin, some preliminary tips...

  • Make sure your building is 100% complete and all objects are set to the correct permissions. Once you save the build, the objects themselves can't be edited, and you will have to start over.
  • Make sure every single object (and inventory item inside those objects) in your build is set with "Copy" permissions - without Copy, there is a variety of problems that can occur (see "Troubleshooting" below).
  • It is highly recommended that you take a copy of your build now, just in case, as a coalesced.
  • You should name all objects descriptively, so you can modify which objects make up the build later if needed.
  • If possible, link together as many unscripted prims as you can to make setup easier and rezzing quicker. Remember, you can link all IntelliDoor products (except the Bollard)!

Once you've heeded the above advice, it's time to start packaging:

  1. Rez a Buildbox and position/rotate it so that it is facing the front of your building, the box is placed directly on the sidewalk/ground/foundation, and it is directly up against the front of your building. This is not required, but makes rezzing easier.
  2. Click the box and select "Load Mode".
  3. For every object in your build, do the following:
    1. Drag the _BUILDBOX-SLAVE script into the object's root prim.
    2. Wait for the confirmation that the object has been saved.
    3. Take the object into your inventory. You should take the object directly instead of take copy, so you can see which objects are left, although you can take a copy if you really want - it won't break anything.
  4. When all the objects are taken, click the box and select "Finalize".
  5. Drag all of the objects into the box's inventory. The box should turn green and you will get a message when it's ready.
  6. Test the box by clicking it and selecting "Rez". Once all pieces have been rezzed, make sure it's working correctly, then click the box and select "Delete". It will return to the Ready To Rez state. Rename the box appropriately and take it.

Your build is now saved in the box and can be distributed and rezzed.
NOTE: Do not put the contents of the Buildbox into your own box, or the script may be reset and you will lose the stored build information.

Rezzing Instructions

  1. Rez the box and position/rotate it to your preference.
  2. Click the box and select "Rez". It will take a few seconds to rez everything for higher-prim builds.
  3. When finished rezzing, all objects will move into place and the box will turn blue. You can move/rotate the box and the whole build will move along with it instantly.
  4. Once the build is in place, click the box and select "Finish".

You're done!

Troubleshooting

  • "BUILD REZZING FAILED - Build could not be rezzed."
    • Make sure there are enough free prims on the parcel.
    • Make sure rezzing is enabled, or that the object is set to the land group.
    • If you receive a warning from your IntelliDoor products, please contact the creator and ask them to fix the permissions. If any part of the building cannot be rezzed, the whole building will self-delete to prevent leaving prims behind.
  • "SCRIPT ERROR - Duplicate script in object or script is not named correctly (must be "_BUILDBOX-SLAVE"). Script has been deleted automatically."
    • Make sure you have not renamed the script.
    • Make sure there is not a Buildbox slave script already in the object.
  • "OBJECT SAVE FAILED - Box did not respond."
    • Make sure the Buildbox is in Load Mode.
    • Make sure the Buildbox is in the same region (Buildboxes do not support cross-region saving).
    • Make sure the land the Buildbox is on allows scripts to run.
  • "OBJECT SAVE FAILED - Another object with the same name has already been saved."
    • Because of the way the Buildbox keeps track of rezzed objects to ensure none are lost, each object in the build must be named differently. Rename the object.
  • ">>> WARNING! <<< THIS OBJECT'S NEXT OWNER PERMISSIONS SHOULD BE SET TO COPY, OR YOUR BUILDBOX MAY BREAK! PLEASE SET PERMISSIONS NOW!"
  • ">>> WARNING! <<< INVENTORY ITEM "<name>"'S NEXT OWNER PERMISSIONS SHOULD BE SET TO COPY, OR YOUR BUILDBOX MAY BREAK! PLEASE SET PERMISSIONS NOW!"
    • You are attempting to add a no copy item to your build. Because this can cause serious problems with rezzing your building, we STRONGLY recommend setting all your objects (and any inventory/scripts inside them) to COPY permissions for the next owner.
  • ">>> WARNING! <<< THIS OBJECT MUST BE SET COPY / MODIFY / NO TRANSFER BEFORE THIS BUILD IS SENT TO ANYONE, OR IT WILL MALFUNCION AND/OR DELETE ITSELF! PLEASE SET PERMISSIONS NOW!"
  • ">>> WARNING! <<< SCRIPT "<name>" MUST BE SET COPY / MODIFY / NO TRANSFER BEFORE THIS BUILD IS SENT TO ANYONE, OR IT WILL MALFUNCION AND/OR DELETE ITSELF! PLEASE SET PERMISSIONS NOW!"
  • ">>> WARNING! <<< CONFIG NOTECARD MUST BE SET COPY / MODIFY / TRANSFER (FULL PERMS) BEFORE THIS BUILD IS SENT TO ANYONE, OR IT WILL MALFUNCION AND/OR DELETE ITSELF! PLEASE SET PERMISSIONS NOW!"
    • These are messages generated by the IntelliDoor products because you did not follow the instructions in the Builder Kit's user manual immediately after unboxing to set permissions. If you do not fix this, the object will be deleted when it is sent to anyone, and the build will automatically delete when rezzed!
  • "This door (or the script inside it) has been set to TRANSFER permissions - however, you don't appear to have purchased this door with full permissions." (...)
    • This is an error message generated by the IntelliDoor products, because the creator didn't follow the instructions as stated above and didn't heed the warnings they got, as also stated above. Please do not contact us to fix this. You must contact the person who sold you the building.

Updates & Release Notes

You can update your IntelliDoor by rezzing the Update Box.

  • v1.0
    • Primary public release.