OsNpcCreate - Revision history

Djphil: Change See Also

2020-12-06T02:50:29Z

Change See Also

Djphil: Additional informations

2020-12-04T17:13:20Z

Additional informations

Djphil: Adding exemple with OS_NPC_OBJECT_GROUP

2020-12-04T17:02:42Z

Adding exemple with OS_NPC_OBJECT_GROUP

Djphil: Adding exemple with OS_NPC_SENSE_AS_AGENT

2020-12-04T17:01:44Z

Adding exemple with OS_NPC_SENSE_AS_AGENT

Djphil: Add links to exemples using OS_NPC_CREATOR_OWNED and OS_NPC_NOT_OWNED

2020-12-04T16:58:21Z

Add links to exemples using OS_NPC_CREATOR_OWNED and OS_NPC_NOT_OWNED

Djphil: Add See Also

2020-12-03T18:06:56Z

Add See Also

Djphil: Typo

2020-12-03T18:06:36Z

Typo

Djphil: Update Script

2020-11-30T22:38:12Z

Update Script

Ubit at 03:55, 26 September 2019

2019-09-26T03:55:34Z

BillBlight at 06:24, 26 November 2018

2018-11-26T06:24:18Z

@@ Line 229: / Line 229: @@
 *This function was added in 0.7.3-post-fixes
 }}
-'''See Also:'''
+== See Also ==
 * [[osNpcCreate]]
 * [[osNpcRemove]]

@@ Line 55: / Line 55: @@
+}
 </source>
-'''With OS_NPC_SENSE_AS_AGENT'''
+'''With OS_NPC_SENSE_AS_AGENT:''' (It Needs the setting '''AllowSenseAsAvatar''' on '''true''' in section '''[NPC]''' of your OpenSim.ini)
 <source lang="lsl">
 //
@@ Line 162: / Line 162: @@
+}
 </source>
-'''With OS_NPC_OBJECT_GROUP'''
+'''With OS_NPC_OBJECT_GROUP:''' (It Needs the setting '''NoNPCGroup''' on '''false''' in section '''[NPC]''' of your OpenSim.ini)
 <source lang="lsl">
 //

@@ Line 159: / Line 159: @@
              llSay(PUBLIC_CHANNEL, "No NPC senss as npc is near me at present.");
+         }
+     }
+}

@@ Line 55: / Line 55: @@
+}
 </source>
 |additional_info= Some more useful info:
 * NPC stands for Non-Player Character.

@@ Line 55: / Line 55: @@
+}
 </source>
 |additional_info= Some more useful info:
 * NPC stands for Non-Player Character.
@@ Line 61: / Line 62: @@
 * '''In current OpenSimulator development code (from commit c4972e77 on Thu Jan 12 2012), an overloaded version of osNpcCreate() has been added.'''
 ** This has the signature key osNpcCreate(string firstname, string lastname, vector position, string cloneFrom, integer options).
-** The options field can be either OS_NPC_CREATOR_OWNED or OS_NPC_NOT_OWNED.
+** The options field can be either OS_NPC_CREATOR_OWNED or OS_NPC_NOT_OWNED. For exemples, see [[osNpcGetOwner]]
 ** OS_NPC_CREATOR_OWNED will create an 'owned' NPC that will only respond to osNpc* commands issued from scripts that have the same owner as the one that created the NPC.
 ** OS_NPC_NOT_OWNED will create an 'unowned' NPC that will respond to any script that has OSSL permissions to call osNpc* commands.
-** Example: "key npc = osNpcCreate("ImYour", "Clone", npcPos, "appearance", OS_NPC_CREATOR_OWNED);"
+** Example: "key npc = osNpcCreate("ImYour", "Clone", npcPos, "appearance", OS_NPC_CREATOR_OWNED);". For full exemples, see [[osNpcGetOwner]]
 ** The existing osNpcCreate() function without the options field will continue to exist.
 * From git master commit 3b59af22 on Friday Jan 13 2012 (after the OpenSimulator 0.7.2 release), the avatar created by the existing osNpc* function without the options parameter will create an 'owned' NPC rather than an 'unowned' one.  Please see the discussion above for information on these terms.  This is a hopefully rare case where the behaviour of an existing function changes slightly.  If you continue to need an 'unowned' NPC, please use the OS_NPC_NOT_OWNED option described above.

← Older revision		Revision as of 18:06, 3 December 2020
Line 71:		Line 71:
	*This function was added in 0.7.3-post-fixes		*This function was added in 0.7.3-post-fixes
	}}		}}
		+	'''See Also:'''
		+	* [[osNpcCreate]]
		+	* [[osNpcRemove]]

@@ Line 10: / Line 10: @@
 //
 // osNpcCreate Script Exemple
-// Authior: djphil
+// Author: djphil
 //
@@ Line 70: / Line 70: @@
 * OS_NPC_OBJECT_GROUP  with it the npc will be created with the group of the object with the script, if that object owner is member of that group. This should allow parcel access by group to work now, and not much else. The group Title will also be set, it the region option NoNPCGroup is not active.
 *This function was added in 0.7.3-post-fixes
 }}

@@ Line 6: / Line 6: @@
 key osNpcCreate(string firstname, string lastname, vector position, string cloneFrom, integer options)
 |ossl_example=<source lang="lsl">
-// touch to create a NPC clone of the toucher in front of this emitter
+//
-// NPC will move to the toucher, then will greet them.
+// osNpcCreate Script Exemple
-// Touch again to remove the NPC
+// Authior: djphil
 key npc;
 default
+{
      touch_start(integer number)
+     {
-         vector npcPos = llGetPos() + <1,0,0>;
+        key toucher = llDetectedKey(0);
-         osAgentSaveAppearance(llDetectedKey(0), "appearance");
+         vector npcPos = llGetPos() + <1.0, 0.0, 1.0>;
-        // coud use avatar UUID directly in osNpcCreate, but then NPC appearance is not persisted
+         osAgentSaveAppearance(toucher, "appearance");
          npc = osNpcCreate("ImYour", "Clone", npcPos, "appearance");
          state hasNPC;
+     }
@@ Line 31: / Line 36: @@
      state_entry()
+     {
-         osNpcMoveTo(npc, toucherPos + <3,0,0>);
+         llSetTimerEvent(5.0);
-         osNpcSay(npc, "Hi there! My name is " + llKey2Name(npc));
+     }
@@ Line 38: / Line 48: @@
+     {
          osNpcSay(npc, "Goodbye!");
          osNpcRemove(npc);
          npc = NULL_KEY;
@@ Line 44: / Line 55: @@
+}
 </source>
 |additional_info= Some more useful info:
 * NPC stands for Non-Player Character.

@@ Line 1: / Line 1: @@
 {{osslfunc
 |threat_level=High
-|permissions=${XEngine&#124;osslNPC}
+|permissions=${OSSL&#124;osslNPC}
 |delay=0
 |function_syntax=key osNpcCreate(string firstname, string lastname, vector position, string cloneFrom)

@@ Line 46: / Line 46: @@
 |description=*Creates an NPC named '''firstname''' '''lastname''' at '''position''' from avatar appearance resource '''cloneFrom'''
 |additional_info= Some more useful info:
 * NPC stands for Non-Player Character.
 * You can clone an appearance from a saved appearance notecard name or UUID, or from the UUID of an avatar logged into the same region or sim.
@@ Line 60: / Line 59: @@
 * Use OS_NPC_SENSE_AS_AGENT option if you would like for the created NPC to be able to be detected via a sensor and want to maintain llSensor() compatibility with type AGENT.
 * OS_NPC_OBJECT_GROUP  with it the npc will be created with the group of the object with the script, if that object owner is member of that group. This should allow parcel access by group to work now, and not much else. The group Title will also be set, it the region option NoNPCGroup is not active.
 }}