Difference between revisions of "User:Toy Wylie/RLV Documentation/addattach"

From Second Life Wiki
Jump to navigation Jump to search
(first draft)
 
(better example, explanation about multiple attachment points)
Line 2: Line 2:
|command=@addattach|type=Restriction
|command=@addattach|type=Restriction
|usage=@addattach[:<attachmentpoint>]=<y/n>
|usage=@addattach[:<attachmentpoint>]=<y/n>
|purpose=This is a counterpart function to @addoutfit. Blocks the user from attaching anything to the specified attachment point. If you don't provide an attachment point, the user will be prevented from attaching anything at all. Using this general attachment block does not remove any single attachment blocks already present. So if you remove the general block later, the single blocks will still be in effect. Attaching attempts by llAttachToAvatar() will be stopped by detaching the object right away. No items will be detached by this command itself.
|purpose=This is a counterpart function to @addoutfit. Blocks the user from attaching anything to the specified attachment point. The names of the attachment points can be found by right clicking on an attachment in your inventory and navigate to the "Attach To" and "Attach to HUD" menu items. If you don't provide an attachment point, the user will be prevented from attaching anything at all. Using this general attachment block does not remove any single attachment blocks already present. So if you remove the general block later, the single blocks will still be in effect. Attaching attempts by llAttachToAvatar() will be stopped by detaching the object right away. No items will be detached by this command itself. '''Note:''' You can't specify more than one attachment point at the same time. You need to do one call for each point you want to block.
 
|version=1.22
|version=1.22
|seealso=addoutfit
|seealso=addoutfit
|seealsoalso=
|seealsoalso=
|example=<lsl>integer mode;
|example=<lsl>integer mode;
 
default
default
{
{
Line 30: Line 31:
                 mode=0;
                 mode=0;
             }
             }
 
             if(mode==0)
             if(mode==0)
             {
             {
Line 38: Line 39:
             else if(mode==1)
             else if(mode==1)
             {
             {
                 llOwnerSay("@addattach:right hand=n");
                 llOwnerSay("@addattach:right hand=n,addattach:left foot=n");
                 llOwnerSay("You are now prevented from attaching objects to your right hand.");
                 llOwnerSay("You are now prevented from attaching objects to your right hand and left foot.");
             }
             }
             else if(mode==2)
             else if(mode==2)
             {
             {
                 llOwnerSay("@addattach:right hand=y,addattach=n");
                 llOwnerSay("@addattach:right hand=y,addattach:left foot=y,addattach=n");
                 llOwnerSay("You are now prevented from attaching objects overall.");
                 llOwnerSay("You are now prevented from attaching objects overall.");
             }
             }

Revision as of 04:30, 8 July 2010


@addattach

Type

Restriction

Implemented

Implemented since RLV version 1.22

Usage

@addattach[:<attachmentpoint>]=<y/n>

Purpose

This is a counterpart function to @addoutfit. Blocks the user from attaching anything to the specified attachment point. The names of the attachment points can be found by right clicking on an attachment in your inventory and navigate to the "Attach To" and "Attach to HUD" menu items. If you don't provide an attachment point, the user will be prevented from attaching anything at all. Using this general attachment block does not remove any single attachment blocks already present. So if you remove the general block later, the single blocks will still be in effect. Attaching attempts by llAttachToAvatar() will be stopped by detaching the object right away. No items will be detached by this command itself. Note: You can't specify more than one attachment point at the same time. You need to do one call for each point you want to block.


See Also

Example

<lsl>integer mode;

default {

   on_rez(integer num)
   {
       llResetScript();
   }

   state_entry()
   {
       mode=0;
       llOwnerSay("Touch me to change the restrictions applied to you.");
   }

   touch_start(integer num)
   {
       if(llDetectedKey(0)==llGetOwner())
       {
           mode++;
           if(mode==3)
           {
               mode=0;
           }

           if(mode==0)
           {
               llOwnerSay("@clear");
               llOwnerSay("You can now attach objects freely once again.");
           }
           else if(mode==1)
           {
               llOwnerSay("@addattach:right hand=n,addattach:left foot=n");
               llOwnerSay("You are now prevented from attaching objects to your right hand and left foot.");
           }
           else if(mode==2)
           {
               llOwnerSay("@addattach:right hand=y,addattach:left foot=y,addattach=n");
               llOwnerSay("You are now prevented from attaching objects overall.");
           }
       }
   }

}

</lsl>