{{:elitehudatt.jpg?200 |}}
====== Elite HUD attacher ====== 
V1.6 [[https://marketplace.secondlife.com/p/Elite-HUD-Attacher/25360707|Marketplace]]

** A device to attach (not included) HUDs or objects to your visitors. **
Demo version is full functional but will attach only to 3 avatars. 


====This product needs====
  * Your own HUD copiable, modifiable and transferable by you. It needs no permissions for next owner. It can also not be a HUD but any object you want to attach.
    * it will be attached as temporary. Wearer can't keep it and it's detached at relog.
  * Your land to be [[Blaise experience]] enabled
  * It will offer avatars to allow this experience if they never did it before

You get:
  * **Elite HUD Attacher** 
  * **BT Elite attach HUD 2** script to add into your HUD
  
Attacher can work in two different modes. 
  * Either by detecting arrivals on your land or region in a specified altitude range
  * Or by collision with avatars (like a mat at landing point)

====Installing====
  * Add script **BT Elite attach HUD** to your HUD
    * Your HUD can not request TELEPORT as this is not allowed to temporary attachments. But see tech notes below
    * If your HUD is not a teleport HUD, No problem.
  * Rez **Elite HUD attacher** and click on it for menu to review and change settings
  * Place modified HUD in Elite HUD attacher and delete "demo hud" and "demo object" that are here for example
  * Use menu again to turn it ON

====Settings====  
{{ :hud_attach_menu.jpg?300|}}
  * **turn ON** or **turn OFF** will appear on menu. 
    * Device is turned OFF when rezzed and when object inside is removed. 
    * Turn it on only when all your settings are correct. 
    * Face 0 is green when ON, red when OFF.
  * **Misc** Manage list of avatars we won't attach to and counter submenu
    * **+ Except** to add an exception enter it's UUID
    * **- Except** to remove from exceptions enter it's UUID
    * **+ Manager** to add a manager that can use menu enter it's UUID
    * **- Manager** to remove a manager enter it's UUID
    * **List** lists all exceptions
    * **Clr except** remove all exceptions and managers
    * **Clr given** clear number of HUDs attached
  * **Exit** closes the dialog and **resets**. 
  * -----------
  * **One setting** is shown on menu with its value and short info. Use **<<** and **>>** to browse all settings and **Change** to modify one.
    * **channel** - change the channel if you need several attachers that work on same region to deliver different HUDs
    * **mode** - to select working mode. If you choose "collision" modify it so avatars will collide on it (shape and transparency)
    * **optional** - Yes to ask avatar before attaching. Adapt 'message' accordingly. Avatar answering 'no' will be ignored for 24h. unless you reset
    * **random** - If more than one object inside, yes to attach a random one - no to attach all
    * for detection mode: (not used in collision mode)
      * **altmin** - minimum altitude for detection
      * **altmax** - maximum altitude for detection
      * **range** - your parcel, all parcels with same owner or whole region. Don't select region if you don't own all the parcels.
    * **attach** - to force attachment point number [[https://wiki.secondlife.com/wiki/Category:LSL_Integer/attach_point|see this page]] normally 0 will use last object's attachement point
    * **detach** - should the HUD be detached when avatar leaves the region
    * **retry** - after how many seconds we attach again to an avatar that has detached it
    * **message** - a message that is sent as blue menu to the avatar when attaching.
      * your message can contain characters § that will be replaced by line feed
    * **mess to** - Select if message is sent as blue dialog or as local chat or none. Always blue dialog if you set 'optional' to yes     
    * **timer** - frequency to check arrivals in detection mode and to make sure they don't already wear a hud.  Less than 2 second, they might get more than one HUD. Long time, HUD might take twice that time to arrive. 2 sec is usually good.

====Tech notes====
  * **Timer** set to T
    * Avatar arriving on sim will be detected 0 to T sec later
    * T sec later attacher will send request to know if avatar already wears a hud
    * again T sec later, if no answer, it will rez and attach hud
    * So avatars should get attachments from 2T to 3T after arriving. In collision mode it will be T to 2T
   * **Detach**
    * if detach = Yes hud will detach when leaving sim
    * if detach = No it will detach
      * when reaching a place that not have the experience enabled
      * when logging out
   * **Retry**
    * Attacher will forget someone
      * when that avatar leaves the sim
      * or retry seconds after attaching. If they still have the HUD nothing happens. if not, they get a new attachment. 
   * **Teleporter HUDs**
    * Your HUD can not request TELEPORT as this is not allowed to temporary attachments. But you can use experience to teleport with this instruction 

      for intra-sim teleport
      llMessageLinked(LINK_SET,38946,(string)PositionVector,(string)AngleInteger); 
      Angle defines avatar orientation when arriving, 0 is east 90 is north etc. 
      Example: llMessageLinked(LINK_SET,38946,"<124,28,1000>","90"); 
      
      for inter-sim teleport
      llMessageLinked(LINK_SET,38947,sim,x,y,z,angle""); 
      Example: llMessageLinked(LINK_SET,38947,"mysim,124,28,1000,90",""); 

    * If you bought my [[Distributable teleport HUD]] You can use it in attacher. It switches to Elite mode when the attacher script is added to it.