OsNpcRemove

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(9 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{osslfunc|
+
{{osslfunc
threat_level = High
+
|threat_level=High
|
+
|permissions=${OSSL|osslNPC}
function_syntax = <source lang="lsl">
+
|delay=0
osNpcRemove(key npc);
+
|function_syntax=osNpcRemove(key npc)
</source>
+
|ossl_example =This might be helpful to erase all of the NPCs in your sim.
|
+
ossl_example =It might be helpful to erase all of the NPCs in your sim.
+
 
<source lang="lsl">
 
<source lang="lsl">
 
// sim-wide NPC killer
 
// sim-wide NPC killer
 
// kill all of NPCs in this SIM
 
// kill all of NPCs in this SIM
 
// Attempts to kill agents too, but it will silently fail
 
// Attempts to kill agents too, but it will silently fail
 
+
// http://opensimulator.org/wiki/OsNpcRemove
 +
 
default
 
default
 
{
 
{
Line 18: Line 17:
 
         list avatars = llList2ListStrided(osGetAvatarList(), 0, -1, 3);
 
         list avatars = llList2ListStrided(osGetAvatarList(), 0, -1, 3);
 
         integer i;
 
         integer i;
 +
        llSay(0,"NPC Removal: No avatars will be harmed or removed in this process!");
 
         for (i=0; i<llGetListLength(avatars); i++)
 
         for (i=0; i<llGetListLength(avatars); i++)
 
         {
 
         {
 
             string target = llList2String(avatars, i);
 
             string target = llList2String(avatars, i);
 
             osNpcRemove(target);
 
             osNpcRemove(target);
 +
            llSay(0,"NPC Removal: Target "+target);
 
         }
 
         }
 
     }
 
     }
 
}
 
}
</source>
+
    </source>
See [[osNpcCreate]] for another example.
+
|description=*Removes the NPC specified by key '''npc'''.
|  
+
additional_info = *Removes the avatar who has specified by '''npc'''.
+
*If the '''npc''' is the uuid of any agent(or users, not NPC), this function will silently fail, not erasing existing avatar.
+
 
|
 
|
 +
|additional_info=If the '''NPC''' is the UUID of any other type of agent (i.e. a user's regular avatar, not an NPC), this function will silently fail, not erasing existing avatar. <!-- Can't we just say "this function does not work on regular avatars, only on NPCs" ? -->
 +
*See [[osNpcCreate]] for another example script.
 
}}
 
}}

Revision as of 21:04, 25 September 2019

osNpcRemove(key npc)
  • Removes the NPC specified by key npc.
Threat Level High
Permissions ${OSSL|osslNPC}
Extra Delay 0 seconds
Example(s)
This might be helpful to erase all of the NPCs in your sim.
// sim-wide NPC killer
// kill all of NPCs in this SIM
// Attempts to kill agents too, but it will silently fail
// http://opensimulator.org/wiki/OsNpcRemove
 
default
{
    touch_start(integer number)
    {
        list avatars = llList2ListStrided(osGetAvatarList(), 0, -1, 3);
        integer i;
        llSay(0,"NPC Removal: No avatars will be harmed or removed in this process!");
        for (i=0; i<llGetListLength(avatars); i++)
        {
            string target = llList2String(avatars, i);
            osNpcRemove(target);
            llSay(0,"NPC Removal: Target "+target);
        }
    }
}
Notes
If the NPC is the UUID of any other type of agent (i.e. a user's regular avatar, not an NPC), this function will silently fail, not erasing existing avatar.
Personal tools
General
About This Wiki