Linden text version 2
{
LLEmbeddedItems version 1
{
count 0
}
Text length 9193
EazyDoor Instructions
EazyDoor 3.0 is a highly versatile system for creating linked doors in InWorldz.  With modification, it is usable in both OpenSim and (to a lesser degree) Second Life.  Follow the simple step-by-step instructions below to get your door up and running.

Contents

1 Basic EazyDoor Setup
2 Extra Options
3 Access Controls
4 Custom Sounds
5 Using in Other Grids
6 Change Logs

Basic EazyDoor Setup
Basic setup of the EazyDoor system is quick and painless:
Drop the script "EazyDoor Access 3.x" and the Notecard ACCESS into the root prim. (This can not be the doors)
Drop the script " EazyDoor 3.x" into a child prim you are using as a door.
If the door is meant to be a swinging door, you may wish to path cut the door so that it will swing on its center. (Located under Building Block Type is Path Cut Begin and End, the idea values for swinging doors are Begin=0.125, End=0.625)
Set the prim's size, rotation, and position to what it should be when closed.  Also set other prim parameters if you wish (path cut, hollow, twist, etc.) and alpha transparency.
Click the door and select "Closed"
Repeat step 3, except you set it for how the door should be when opened.
Click the door and select "Opened"
Click the door again and select "-+Finish+-"

Extra Options
These are some extra options you can apply during setup as well.  If you just want a basic door, feel free to ignore these.  If you need the door to do a little more, such as open in pairs or to lock, then check the settings below.

Paired Doors:
A) Click the door and select "Pairing"
B) Another menu will come up.  Select one of the number displayed, or click "Clear" to remove pairing.
C) Repeat this for each door.

Paired Doors - Alternate
A) In chat, say "/door setpair, X" without the quotes, where X is the desired pairing ID number.
B) All doors within 30 meters of you will be assigned the pairing number if their setup hasn't been completed.

Phantom Doors
If you wish for the door to turn phantom when opened, simply click it and select "Phantom", or select it again to make it stay solid when opened.  Note that being linked does not affect the door's ability to remain phantom: it will stay phantom even when the other prims it is linked with are not phantom.

Open on Collision
By default, the doors will open when an avatar collides with them. If you do not want the doors to open on collision, then click the door and select "Collision" to turn it off.  Click that button again to turn collision back on.

Open on Clicking
By default, the doors will open when clicked. If you do not want the doors to open when clicked, then click the door and select "Clickable" to turn it off.  Click that button again to turn it back on.

Automatic Door Closing
By default, the doors automatically shut 10 seconds after being closed.  If you wish to change the length of time or disable autoclose entirely, then say "/door autoclose X", where X is how many seconds the door will wait before closing.  If X is set to 0 or lower, then autoclose is disabled.

Delayed Open
By default, the doors open immediately.  If you wish for the door to wait before opening, then say "/door delay-open X" without the quotes, where X is how many seconds the door will wait before opening.  If X is set to 0 or lower, there will be no delay.

Delayed Close
By default, the doors close immediately when the command is triggered.  If you wish for the door to wait before closing, then say "/door delay-close X" without the quotes, where X is how many seconds the door will wait before closing.  If X is set to 0 or lower, there will be no delay.  Note that this is different from AutoClose, which makes the door wait before closing on it's own.

Locking Doors
If you wish for the doors to be lockable, select the +Locking option from the menu, or -Locking to disable it again.  Note that this requires the EazyDoor Access script to be in the root prim in order to work properly.  And, unlike previous versions of EazyDoor, doors which can be locked will be locked by default.  See the Access Controls section below for more information.

Slow Open
If you wish for the doors to slowly open, where they gradually transition between the opened and closed states, click the +SlowOpen option, or -SlowOpen to disable it.  The doors will slide, resize, or rotate gradually over 1 second, using 24 frames of transition.  Note that changes in prim shape will not work with this property if the prim type is changed.  If both the opened and closed states use hollow, then both will need to use the same hollow shape in order to properly transition.

Access Controls
The following requires that you have at least one door with the Locking option enabled.  When you have setup such a door, place the ACCESS notecard and EazyDoor Access script into the object's root prim.  Then open the ACCESS notecard to edit it.  If the ACCESS notecard is absent, the Access Script will assume some sane defaults.
ADMIN: This option is a comma-seperated list of people who can lock and unlock the door, or open and close it while locked.  Specifying GROUP will grant this to anyone using the same active group as the door.  If left empty, then the owner will be assumed to have admin access.
ACCESS: This option is a comma-seperated list of people who can open and close the door while it is locked.  Specifying GROUP will grant this to anyone using the same active group as the door.  Remove this setting or set it to blank if you do not wish to use it.
CONTROL: This is a chat channel the door listens for locking commands: "lock" and "unlock".  Setting the channel to a negative value will disable chat commands.  If left blank or set to 0, it will assume the default channel of 10.
DENIED: This sound is played when someone is denied access dueto the door being locked.  It can be either a sound file's name or a UUID, but if specified by name, the sound file must be included in the prim contents with the script.


Custom Sounds
If you wish to replace the default door sounds with your own, you can use the below commands to change the sound.  Replace XYZ with the name or the UUID key of the sound. 
/doorsound open XYZ
/doorsound close XYZ
/doorsound lock XYZ
/doorsound unlock XYZ
You can obtain the key by right clicking the sound file in your inventory, and selecting "Copy Asset UUID".  If you use the name of the sound, then the sound file must be placed in the same prim as the script(s) using it in order to work.  The sound file does not need to be included with the script if you are using its UUID.

Using in Other Grids
EazyDoor is able to work outside of InWorldz, but it requires a few modifications.  For opensim, you search for the function iwMakeNotecard, and change the function name to osMakeNotecard, and it will compile and function normally (barring opensim-specific bugs).  If you are using EazyDoor on Second Life, or on an opensim installation which disallows osMakeNotecard, you must remove or comment out the iwMakeNotecard line.

Unlike with previous versions of EazyDoor, setup will still work correctly if iwMakeNotecard or osMakeNotecard are not used, but the configuration will be lost if the script is reset.  This is not much of a problem with Second Life, since scripts rarely ever reset without a manual trigger.  With opensim, however, script states are not saved, so they will always reset when rezzed, shift-copied, or when the region restarts.

If script resets would be a problem for you, then perform the setup on InWorldz or an opensim grid that allows osMakeNotecard (such as a personal standalone) and then copy the notecard over to where you wish to use it.

Change Logs
Version 3.1, Released June 22nd, 2014:
EazyDoor now features a "Slow Open" function that causes the door to gradually open or close over the course of one second, rather than instantly snapping into place.
Version 3.0, Released May 29th, 2014:
Revamped the setup process to utilize an easy-to-use menu system instead of chat commands.  The older chat commands are still available, however.
The door will no longer assume you are finished with setup when both the closed and opened options have been set.
The Opened and Closed parameters can now handle more than just position, scale, and rotation.  They can also handle the full range of primitive params, such as hollow, taper, shear, path cut, profile cut, etc.  They can also detect the alpha level of the door.
You can now set the door to ignore collisions or clicking, so that they will not activate the door.
EazyDoor will now automatically reset if it detects that the configuration notecard has been edited or removed, allowing it to automatically reload or enter setup mode as appropriate.
EazyDoor Access will now automatically reset if it detects the access notecard has been edited, allowing it to automatically reload it.
EazyDoor Access will now also operate without an access notecard, instead assuming the owner is an admin and listening on channel 10 for commands.
If locking is enabled on a door, then it will be locked by default when it starts up.
Doors can now (optionally) turn phantom when opened
You can now set a delay for when a door will open or close.}
 