Second Life Wiki - User contributions [en]

Viewer URI Name Space

2015-02-21T11:36:40Z

Dark Mole: /* Syntax */

{{ProtocolNav}}

== Overview ==

The SL client supports links of the format secondlife://Region/123/45/67/, which have traditionally specified a region name and x/y/z location. This means "run Second Life viewer and show Region on the world map".

The new URL scheme has 3 slashes, and allows direct control of the user interface and login. For example, secondlife:///app/login

Most secondlife:///app URLs only work from browser instances running inside Second Life because of a denial-of-service attack using secondlife:///app/teleport links to force repeated teleports. SLURLs that work with external browsers include:
* <nowiki>secondlife://<region name></nowiki>
* secondlife:///app/login

In chat, dialogs and other user interface elements, these URLs will be highlighted as clickable links, often with custom formatting including icons. The full functionality is available in Viewer 2.0 and up. Clickable links without formatting were available only in older versions' chat and IM history.

These links also may be known as ''Viewer URL Namespace'', ''SLAPP URLs'' or ''Application SLURL''.

Enclose your links in squared brackets, or they will in some cases (e.g. for ObjectIm - links) treat all text after the link as part of the link itself (which in most cases means, the text after the link will never display). Example: [secondlife:///app/objectim/190f571d-fdf1-8f6c-4e9d-973e9b5e0566?name=ObjectName&owner=c93c3129-2250-4c79-a5f7-8c755ca2707e&groupowned=true&slurl=Location/128/128/27 ObjectName]. In this case you will also need to ensure the object name has been escaped.

== Syntax ==

'''<nowiki>secondlife:///</nowiki>'''
: '''<region_name>''' log in to this region or, if logged in, show information and offer teleport
:: '''/<local_x>''' optional X position, defaults to 128
::: '''/<local_y>''' optional Y position, defaults to 128
:::: '''/<local_z>''' optional Z position, defaults to 0

: '''/app'''
:: '''/agent'''
::: '''/<agent_id>'''
:::: '''/about''' open agent's profile, with 2nd Life tab selected
:::: '''/inspect''' display info dialog for agent (2.0)
:::: '''/im''' start an IM session with the agent (2.0)
:::: '''/offerteleport''' display teleport offer dialog (2.0)
:::: '''/pay''' display pay resident dialog (2.0)
:::: '''/requestfriend''' display friendship offer dialog (2.0)
:::: '''/mute''' add to block list (2.0)
:::: '''/unmute''' remove from block list (2.0)
:::: '''/completename''' replace the URL with the avatar's display and user names,
:::::e.g., "hmm <nowiki>secondlife:///app/agent/eea40b5a-553d-4a07-b1ca-9f6e2f867814/complete</nowiki> wow" in chat becomes "hmm Cerise (cerise.sorbet) wow" (2.4); see {{LSLGC|Avatar/Name}} for more details.
:::: '''/displayname''' replace the URL with the avatar's display name (2.4)
:::: '''/username''' replace the URL with the avatar's username e.g. "user.name" (2.4)
:: '''/appearance'''
::: '''/show''' display the sidebar appearance tab (2.0)
:: '''/balance'''
::: '''/request''' request a L$ balance update from the server (2.0)
:: '''/chat'''
::: '''/<channel>''' any channel number greater than 0 except [[DEBUG_CHANNEL]]
:::: '''/<text>'''
:: '''/classified'''
::: '''/<classified_id>'''
:::: '''/about''' open floater describing classified
:: '''/event'''
::: '''/<event_id>'''
:::: '''/about''' open floater describing event
:: '''/group'''
::: '''/<group_id>'''
:::: '''/about''' open floater describing group
:::: '''/inspect''' display info dialog for group (2.0)
::: '''/create''' open the create group dialog (1.20)
::: '''/list'''
:::: '''/show''' open the list of groups to which user belongs (1.20)
:: '''/help'''
::: '''/<help_query>''' optional help topic (2.0)
:: '''/inventory'''
::: '''/<inventory_id>'''
:::: '''/select''' inventory offer (2.0)
::: '''/show''' open the inventory sidebar tab (2.0)
:: '''/login''' log in on launch. External and internal browsers.
::: see below for query parameters, of course, values are URL escaped
:: '''/maptrackavatar'''
::: '''/<friend_id>''' find a friend on the world map, requires permission (2.4)
:: '''/objectim'''
::: '''/<object_id>''' display an info dialog for the object sending this message (2.0)
:::: '''?name=<object_name>'''
:::: '''&owner=<owner_id>'''
:::: '''&groupowned=true''' (add if the object is deeded to a group)
:::: '''&slurl=<region>/<x>/<y>/<z>'''
:: '''/parcel'''
::: '''/<parcel_id>'''
:::: '''/about''' open floater describing place
:: '''<strike>/region'''
::: '''/<region_id>'''
:::: '''/about''' information from database about that region? list of parcels? covenant?</strike>
:: '''/search'''
::: '''/<category>''' "all", "people", "places", "events", "groups", "wiki", "destinations", "classifieds"
:::: '''/<search_term>''' open a search floater with matching results (2.0)
:: '''/sharewithavatar'''
::: '''/<agent_id>''' open an inventory share/IM window for agent (2.4)
:: '''/teleport'''
::: '''/<region_name>''' teleport instantly to this region, no dialog
:::: '''/<local_x>''' optional X position, defaults to 128
::::: '''/<local_y>''' optional Y position, defaults to 128
:::::: '''/<local_z>''' optional Z position, defaults to 0
:: '''/voicecallavatar'''
::: '''/<agent_id>''' start a private voice session (2.4)
:: '''/wear_folder'''
::: '''/?folder_id=<inventory_folder_uuid>''' replace outfit with contents of specified folder (2.6)
:: '''/worldmap''' open the map with this destination selected (2.0)
::: '''/<region_name>'''
:::: '''/<local_x>''' optional X position, defaults to 128
::::: '''/<local_y>''' optional Y position, defaults to 128
:::::: '''/<local_z>''' optional Z position, defaults to 0

This could be extended to things like:
: '''/app/event/<event_id>/subscribe''' to register for notifications
: '''/app/parcel/<parcel_id>/teleport''' to teleport to a specific location

== Login Query Parameters ==
{| border="1"
|-
| first || the account first name
|-
| last || the account last name
|-
| session || the secure session id
|-
| location || login location, format TBD, optional
|}

== Examples ==

<lsl>
string Who(key id)
{
return "secondlife:///app/agent/" + (string)id + "/inspect";
}

default
{
touch_start(integer num)
{
llSay(0, "Touched by " + Who(llDetectedKey(0)) + "." );
}
}
</lsl>

[[Category:Name Spaces]]
[[Category:Search]]
[[Category:LSL Chat]]
[[Category:LSL_Dialog]]

CHARACTER TYPE

2012-10-16T18:52:26Z

Dark Mole: Added path_update to the relevant events

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=CHARACTER_TYPE
|type=integer
|value=6
|desc=Used in combination with one of the character type flags. The default is [[CHARACTER_TYPE_NONE]], other options are [[CHARACTER_TYPE_A]], [[CHARACTER_TYPE_B]], [[CHARACTER_TYPE_C]] and [[CHARACTER_TYPE_D]]. Note that the character type is not used to describe the behavior of the [[Pathfinding]] object but is used to describe the kind of surface and terrain that it prefers to travel. For example, a cow designed for a field should use character type B, but sheep designed to be herded along a road should use character type C.
{{LSL_Constants/llCreateCharacter|}}
|examples
|constants=
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_A}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_B}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_C}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_D}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_NONE}}|3={{#var:comment}}}}
|functions=[[llCreateCharacter]], [[llUpdateCharacter]]
|events=[[Path update|path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

TRAVERSAL TYPE

2012-10-16T10:01:57Z

Dark Mole: Initial draft of the page.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=TRAVERSAL_TYPE
|type=integer
|value=7
|desc=Used in combination with one of the traversal type flags. The default is [[TRAVERSAL_TYPE_SLOW]], other options are [[TRAVERSAL_TYPE_FAST]] and [[TRAVERSAL_TYPE_NONE]].
{{LSL_Constants/llCreateCharacter|}}
|examples
|constants=
{{LSL DefineRow|1=|2={{LSL Const|TRAVERSAL_TYPE}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|TRAVERSAL_TYPE_FAST}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|TRAVERSAL_TYPE_SLOW}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|TRAVERSAL_TYPE_NONE}}|3={{#var:comment}}}}
|functions=[[llCreateCharacter]], [[llUpdateCharacter]]
|events=[[path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

CHARACTER ORIENTATION

2012-10-16T09:56:24Z

Dark Mole: Defined the associated constants.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=CHARACTER_ORIENTATION
|type=integer
|value=4
|desc=Constant used to indicate that the following argument is the orientation of the capsule for a [[Pathfinding]] character. This is used to help denote how to interpret the size of a character.
|examples
|constants=
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_ORIENTATION}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|VERTICAL}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|HORIZONTAL}}|3={{#var:comment}}}}
|functions=[[llCreateCharacter]], [[llUpdateCharacter]]
|events=[[path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

HORIZONTAL

2012-10-16T09:55:42Z

Dark Mole: Added the character orientation constant to the list of constants.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=HORIZONTAL
|type=integer
|value=1
|desc=Constant to indicate that the orientation of the capsule for a [[Pathfinding]] character is horizontal.
|examples
|constants=
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_ORIENTATION}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|VERTICAL}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|HORIZONTAL}}|3={{#var:comment}}}}
|functions=[[llCreateCharacter]], [[llUpdateCharacter]]
|events=[[path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

VERTICAL

2012-10-16T09:55:09Z

Dark Mole: Added the character orientation constant to the list of constants.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=VERTICAL
|type=integer
|value=0
|desc=Constant to indicate that the orientation of the capsule for a [[Pathfinding]] character is vertical.
|examples
|constants=
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_ORIENTATION}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|VERTICAL}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|HORIZONTAL}}|3={{#var:comment}}}}
|functions=[[llCreateCharacter]], [[llUpdateCharacter]]
|events=[[path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

CHARACTER ORIENTATION

2012-10-16T09:53:47Z

Dark Mole: Initial draft of the page.

CHARACTER LENGTH

2012-10-16T09:52:25Z

Dark Mole: Added the path_update event to the relevant events.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=CHARACTER_LENGTH
|type=integer
|value=3
|desc=Constant used to indicate that the following argument is the length of the capsule for a [[Pathfinding]] character. This is used to help denote the size of the character.
|examples
|constants=
|functions=[[llCreateCharacter]], [[llUpdateCharacter]]
|events=[[path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

CHARACTER TYPE NONE

2012-10-16T09:51:32Z

Dark Mole: Added the path_update event to the relevant events.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=CHARACTER_TYPE_NONE
|type=integer
|value=4
|desc=Used to set no specific character type.
|examples
|constants=
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_A}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_B}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_C}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_D}}|3={{#var:comment}}}}
|functions
|events=[[path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

CHARACTER TYPE D

2012-10-16T09:51:16Z

Dark Mole:

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=CHARACTER_TYPE_D
|type=integer
|value=3
|desc=Used for character types that are not consistent with the A, B, or C type.
|examples
|constants=
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_A}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_B}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_C}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_NONE}}|3={{#var:comment}}}}
|functions
|events=[[path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

CHARACTER TYPE C

2012-10-16T09:51:02Z

Dark Mole: Added the path_update event to the relevant events.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=CHARACTER_TYPE_C
|type=integer
|value=2
|desc=Used for mechanical character types or road going vehicles.
|examples
|constants=
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_A}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_B}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_D}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_NONE}}|3={{#var:comment}}}}
|functions
|events=[[path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

CHARACTER TYPE B

2012-10-16T09:50:40Z

Dark Mole: Added the path_update event to the relevant events.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=CHARACTER_TYPE_B
|type=integer
|value=1
|desc=Used for character types that you prefer move in a way consistent with wild animals or off road vehicles.
|examples
|constants=
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_A}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_C}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_D}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_NONE}}|3={{#var:comment}}}}
|functions
|events=[[path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

CHARACTER TYPE A

2012-10-16T09:50:15Z

Dark Mole: Added the path_update event to the relevant events.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=CHARACTER_TYPE_A
|type=integer
|value=0
|desc=Used for character types that you prefer move in a way consistent with humanoids.
|examples
|constants=
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_B}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_C}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_D}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|CHARACTER_TYPE_NONE}}|3={{#var:comment}}}}
|functions
|events=[[path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

HORIZONTAL

2012-10-16T09:49:30Z

Dark Mole: Initial draft of the page.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=HORIZONTAL
|type=integer
|value=1
|desc=Constant to indicate that the orientation of the capsule for a [[Pathfinding]] character is horizontal.
|examples
|constants=
{{LSL DefineRow|1=|2={{LSL Const|VERTICAL}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|HORIZONTAL}}|3={{#var:comment}}}}
|functions=[[llCreateCharacter]], [[llUpdateCharacter]]
|events=[[path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

VERTICAL

2012-10-16T09:48:37Z

Dark Mole: Initial draft of the page.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=VERTICAL
|type=integer
|value=0
|desc=Constant to indicate that the orientation of the capsule for a [[Pathfinding]] character is vertical.
|examples
|constants=
{{LSL DefineRow|1=|2={{LSL Const|VERTICAL}}|3={{#var:comment}}}}
{{LSL DefineRow|1=|2={{LSL Const|HORIZONTAL}}|3={{#var:comment}}}}
|functions=[[llCreateCharacter]], [[llUpdateCharacter]]
|events=[[path_update]]
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

CHARACTER LENGTH

2012-10-16T09:44:21Z

Dark Mole: Initial draft of the page.

CHARACTER RADIUS

2012-10-16T09:43:29Z

Dark Mole: Initial draft of the page.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=CHARACTER_RADIUS
|type=integer
|value=2
|desc=Constant used to indicate that the following argument is the radius of the capsule for a [[Pathfinding]] character. This is used to help denote the size of the character.
|examples
|constants=
|functions=[[llCreateCharacter]], [[llUpdateCharacter]]
|events
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

CHARACTER DESIRED SPEED

2012-10-16T09:42:17Z

Dark Mole: Initial draft of the page.

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=CHARACTER_DESIRED_SPEED
|type=integer
|value=1
|desc=Constant used to indicate that the following argument is the desired speed for a [[Pathfinding]] character.
|examples
|constants=
|functions=[[llCreateCharacter]], [[llUpdateCharacter]]
|events
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

CHARACTER TYPE

2012-10-16T09:33:31Z

Dark Mole: changed the wording to be consistent with the description at http://community.secondlife.com/t5/Second-Life-Server/Pathfinding-FAQ/td-p/1672699

CHARACTER TYPE D

2012-10-16T09:25:44Z

Dark Mole: changed the wording to be consistent with the description at http://community.secondlife.com/t5/Second-Life-Server/Pathfinding-FAQ/td-p/1672699

CHARACTER TYPE C

2012-10-16T09:24:07Z

Dark Mole: changed the wording to be consistent with the description at http://community.secondlife.com/t5/Second-Life-Server/Pathfinding-FAQ/td-p/1672699

CHARACTER TYPE B

2012-10-16T09:23:21Z

Dark Mole: changed the wording to be consistent with the description at http://community.secondlife.com/t5/Second-Life-Server/Pathfinding-FAQ/td-p/1672699

Pathfinding Simple Roaming Example With Evade Pursue

2012-10-11T12:10:06Z

Dark Mole: moved the change to the default state in the changed event.

A simple example is provided to use [[Pathfinding]] to have an object randomly roam around a small area is given below and randomly evade or pursue a person who touches it. The script is designed to have the object move around in a small area centered at the start location. The object will move back to its start position if anything goes wrong or a group member touches it.

The script has five states. In the default state the object is not moving and can be placed in its start position. From the default state it can transition into the ''Roaming'' state by touching it as a member of the same group. In the ''Roaming'' state it will simply wander around in a small area centered at the start point. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will transition into the ''TravelHome'' state.

In the ''TravelHome'' state the script will attempt to move the object back to its start position using the [[Pathfinding]] functions. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will delete the [[Pathfinding]] character and manually move the object back to its start position using the [[LlSetRegionPos|llSetRegionPos]] function. It will then transition back into the ''default'' state.

If someone touches this object while it is roaming who is not in the same group there is a small chance that it will either evade or pursue the person. If the decision is to evade then the script transitions to the ''Evade_Agent'' state. If the decision is to chase the agent then the script transitions to the ''Chase_Agent'' state.

This code is licensed under the [http://www.gnu.org/licenses/gpl.html|GNU General Public License].

<lsl>

/* *****************************************************************

%%% Desc: Simple example script to demonstrate pathfinding
%%% Author: Dark Mole (contact via IM within Second Life)
%%% File: $HeadURL: simpleMoverWithChaseAndEvade.sl $
%%% Date: $Date: Thu Oct 11 04:44:14 2012 $
%%% Revision: $Rev: .04 $

Copyright 2012 Dark Mole (contact via IM in Second Life

This program is free software: you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see
<http://www.gnu.org/licenses/>.

A copy of this script can be found at
https://wiki.secondlife.com/wiki/Pathfinding_Simple_Roaming_Example_With_Evade_Pursue

***************************************************************** */

// Configuration variables.
// Things to change to impact the behavior of the system

float TIME_TO_WAIT_BEFORE_MOVING = 300.0; // number of seconds to wait
// while in the default
// state before it
// automatically starts to
// roam on its own. Note
// that the first time this
// thing rezzes this timer
// is ignored.

// Global Variables. (do not change unless you know what they do!)

// Location related variables

vector home_position = <-1.0,0.0,0.0>;
rotation home_rotation = ZERO_ROTATION;
string home_region = "";

vector wondering_radius = <5.0,5.0,20.0>; // how far I can roam around
list wondering_parameters =
[CHARACTER_MAX_SPEED, 1.0, // parameters describing
CHARACTER_DESIRED_SPEED, 0.2, // how I can roam.
CHARACTER_DESIRED_TURN_SPEED,0.02,
CHARACTER_MAX_ACCEL, 0.5,
CHARACTER_MAX_DECEL, 0.5,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 0.5];

list traveling_parameters =
[CHARACTER_MAX_SPEED, 5.0, // parameters describing
CHARACTER_DESIRED_SPEED, 3.0, // how I can roam when
CHARACTER_DESIRED_TURN_SPEED,2.0, // traveling..
CHARACTER_MAX_ACCEL, 3.0,
CHARACTER_MAX_DECEL, 3.0,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 1.5];

list chasing_parameters =
[CHARACTER_MAX_SPEED, 15.0, // parameters describing
CHARACTER_DESIRED_SPEED, 10.0, // how I can chase someone.
CHARACTER_DESIRED_TURN_SPEED,8.0,
CHARACTER_MAX_ACCEL, 7.5,
CHARACTER_MAX_DECEL, 7.5,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_FAST,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 0.8,
CHARACTER_AVOIDANCE_MODE, AVOID_DYNAMIC_OBSTACLES];

// Variables associated with the state of the script
integer active_character = FALSE;
key agentToChase = NULL_KEY;

// Helper functions

/* *********************************************************
forceMoveHome(integer resetScript)

Routine to force the object to go home. The option "resetScript" is
to determine if the script should be reset when it is in the same
region it started from.

********************************************************* */
forceMoveHome(integer resetScript)
{
// Stop and delete the character
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
llDeleteCharacter();
active_character = FALSE;
if(home_region == llGetRegionName())
{
// I am in the same home region. Just move close to the start
// point.
llSetRegionPos(home_position);
if(resetScript)
{
llSetPos(home_position);
llSetRot(home_rotation);
llResetScript();
}
}
else
{
llInstantMessage(llGetOwner(),"There is an error. " +
"I wondered away from my start region and cannot go back home.\n" +
"I am located in " + llGetRegionName() + " at " +
(string)llGetPos());
}
}

// Primary (default) state.
// This is the initial state when the program resets.
//
// In this state the object waits for a touch to get started. There is
// a random chance that it might start moving at any time step though.
default
{

state_entry()
{
if(home_position.x < 0.0)
{
// This is the first time to enter this state. Do a little
// house cleaning to start the season.

// Add any parts to the different parameters that require any
// calculations.
wondering_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];
traveling_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];

// Set the initial home position and orientation.
home_position = llGetPos();
home_rotation = llGetRot();
home_region = llGetRegionName();
llOwnerSay("Touch me to start moving. " +
"I will not move until you touch me the first time. " +
"After that it will become automatic.");

}

else if(home_region == llGetRegionName())
{
// I am in the same region I started out in. Make sure I
// start at the last place and orientation when I left
// this state. Make sure that I move close to
// home. (There is some fudge factor in the llSetRegionPos
// command according to the wiki).
llSetPos(home_position);
llSetRot(home_rotation);
llSetTimerEvent(TIME_TO_WAIT_BEFORE_MOVING);
}

llDeleteCharacter(); // Clear and reset the character
// settings. You should always do this so
// that when an active object is taken
// into inventory it will be properly
// reset when rezzed again. (If not here
// then in the on_rez event.)
active_character = FALSE;

llOwnerSay("Stopped\nTouch me to have me wonder around.");
} // state_entry

state_exit()
{
llCreateCharacter(wondering_parameters);
active_character = TRUE;
llSetTimerEvent(0.0);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// This person is in the same group. Assume the idiot can
// be trusted.
home_position = llGetPos(); // Define my start position
home_rotation = llGetRot(); // and start orientation.
state Roaming;
}
} // touch_start

timer()
{
// I have waited to long without any interaction. Time to roam
// because I am a ramblin' object.
state Roaming;
}

} // end default state

// Roaming state.
//
// This is the state when the program decides to start roaming. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply roams around for a while.
state Roaming
{

state_entry()
{
// Set the character to the roaming parameters
llUpdateCharacter(wondering_parameters);
llWanderWithin(home_position, wondering_radius, []);
llOwnerSay("Roaming\nTouch me to have me go back home.");
} // state_entry

state_exit()
{
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
state default;
}
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// Again, if the person is in the same group then let them
// violate me by touching me.
state TravelHome;
}
else if (llFrand(1.0) < 0.10)
{
// What the heck. Let's chase this person!
agentToChase = llDetectedKey(0);
state Chase_Agent;
}
else if (llFrand(1.0) < 0.10)
{
// What the heck. Run away! Run Away!
agentToChase = llDetectedKey(0);
state Evade_Agent;
}

} // touch_start

path_update(integer type, list reserved)
{
if ((type == PU_SLOWDOWN_DISTANCE_REACHED) ||
(type == PU_GOAL_REACHED))
{
// While roaming this should not occur. if it does just restart???
llWanderWithin(home_position, wondering_radius, []);
}

else {
// Something went wrong with the navmesh. Just go home and wait.
state TravelHome;
}

} // end path_update event

} // end state Roaming

// TravelHome state.
//
// This is the state when the program decides to go home. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply tries to go to the home
// position. If it does not make it in the alloted time the character
// is deleted, and it simply sets its position.
state TravelHome
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here.
llUpdateCharacter(traveling_parameters);
llNavigateTo(home_position,[FORCE_DIRECT_PATH,TRUE]);
llSetTimerEvent(120.0);
llOwnerSay("Going back home\nTouch me to force the issue.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
state default;
}
}

touch_start(integer total_number)
{
// force the issue
if(llDetectedGroup(0))
{
// trust in the authority invested in the people in my
// group because blind trust always works out well.
forceMoveHome(FALSE);
state default;
}
} // touch_start

timer()
{
// It took too long to get home.
forceMoveHome(FALSE);
state default;
} // timer

path_update(integer type, list reserved)
{
if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if (type == PU_GOAL_REACHED)
{
// I have made it home.
state default;
}

else
{
// Something went wrong. Just force the issue and go home.
forceMoveHome(FALSE);
state default;
}

} // end path_update event

} // end state TravelHome

// Chase_Agent state.
//
// This is the state when the program decides to chase the person who
// touched the object. Touch it again to go back to wandering.
//
state Chase_Agent
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here.

// Get information about the person
list agentInfo = llGetObjectDetails(agentToChase,[OBJECT_ROT]);
if(llGetListLength(agentInfo)==0)
{
// well that was a bust. Cannot find this person. Just go
// back to roaming.
state Roaming;
}

// I can locate the agent. Let's chase it down.

// Need to get the offset separately, because the z-component
// will not be zero due to round off errors. The purse offset
// has to have a zero z component.
vector offset = <-1.0,0.0,0.0>*llList2Rot(agentInfo,0);
llUpdateCharacter(chasing_parameters);
llPursue(agentToChase,
[PURSUIT_OFFSET, <offset.x,offset.y,0.0>,
REQUIRE_LINE_OF_SIGHT, FALSE,
PURSUIT_FUZZ_FACTOR, 0.8,
PURSUIT_INTERCEPT, TRUE,
PURSUIT_GOAL_TOLERANCE,1.0]);
llSetTimerEvent(120.0);
llOwnerSay("Chasing this person\nTouch me to stop chasing.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
state default;
}
}

touch_start(integer total_number)
{
// Stop chasing and go back to wandering mode
state Roaming;
} // touch_start

timer()
{
// This is enough of this nonsense. I am tired. Start
// wandering again.
state Roaming;
} // timer

path_update(integer type, list reserved)
{

if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if ((type == PU_GOAL_REACHED) || (type == PU_FAILURE_TARGET_GONE))
{
// I have found the agent or they are gone. Let's just put
// an end to this.
state Roaming;
}

else
{
// Something went wrong. Just end this now.
state Roaming;
}

} // end path_update event

} // end state Chase_Agent

// Evade_Agent state.
//
// This is the state when the program decides to run away from the
// person who touched the object. Touch it again to go back to
// wandering.
//
state Evade_Agent
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here. Here
// I just use the same settings as used to chase since they
// seem okay. /me shrugs.

llUpdateCharacter(chasing_parameters);
llEvade(agentToChase,[]);
llSetTimerEvent(120.0);
llOwnerSay("Evading this person\nTouch me to stop chasing.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
state default;
}
}

touch_start(integer total_number)
{
// Stop evading and go back to wandering mode
state Roaming;
} // touch_start

timer()
{
// This is enough of this nonsense. I am tired. Start
// wandering again.
state Roaming;
} // timer

path_update(integer type, list reserved)
{

if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if ((type == PU_GOAL_REACHED) || (type == PU_FAILURE_TARGET_GONE))
{
// I have found the agent or they are gone. Let's just put
// an end to this.
state Roaming;
}

else if ((type == PU_EVADE_HIDDEN) || (type == PU_EVADE_SPOTTED))
{
// I have been spotted. Oh noze.... panic seems like an
// appropriate plan at this point.
vector mySize = llGetScale();
if(mySize.z*0.25 > 2.0)
{
// Cannot jump this high. Tone it down a bit
mySize.z = 8.0;
}
llExecCharacterCmd(CHARACTER_CMD_JUMP,[mySize.z*0.25]);
}

else
{
// Something went wrong. Just end this now.
state Roaming;
}

} // end path_update event

} // end state Evade_Agent

</lsl>

Pathfinding Simple Roaming Example

2012-10-11T12:06:58Z

Dark Mole: moved the change to the default state in the changed event.

A simple example is provided to use [[Pathfinding]] to have an object randomly roam around a small area is given below. The script is designed to have the object move around in a small area centered at the start location. The object will move back to its start position if anything goes wrong or a group member touches it.

The script has three states. In the default state the object is not moving and can be placed in its start position. From the default state it can transition into the ''Roaming'' state by touching it as a member of the same group. In the ''Roaming'' state it will simply wander around in a small area centered at the start point. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will transition into the ''TravelHome'' state.

In the ''TravelHome'' state the script will attempt to move the object back to its start position using the [[Pathfinding]] functions. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will delete the [[Pathfinding]] character and manually move the object back to its start position using the [[LlSetRegionPos|llSetRegionPos]] function. It will then transition back into the ''default'' state.

This code is licensed under the [http://www.gnu.org/licenses/gpl.html GNU General Public License].

<lsl>

/* *****************************************************************

%%% Desc: Simple example script to demonstrate pathfinding
%%% Author: Dark Mole (contact via IM within Second Life)
%%% File: $HeadURL: simpleMover.sl $
%%% Date: $Date: Thu Oct 11 04:44:14 2012 $
%%% Revision: $Rev: .04 $

Copyright 2012 Dark Mole (contact via IM in Second Life

This program is free software: you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see
<http://www.gnu.org/licenses/>.

A copy of this script can be found at
https://wiki.secondlife.com/wiki/Pathfinding_Simple_Roaming_Example

***************************************************************** */

// Configuration variables.
// Things to change to impact the behavior of the system

float TIME_TO_WAIT_BEFORE_MOVING = 300.0; // number of seconds to wait
// while in the default
// state before it
// automatically starts to
// roam on its own. Note
// that the first time this
// thing rezzes this timer
// is ignored.

// Global Variables. (do not change unless you know what they do!)

// Location related variables

vector home_position = <-1.0,0.0,0.0>;
rotation home_rotation = ZERO_ROTATION;
string home_region = "";

vector wondering_radius = <5.0,5.0,20.0>; // how far I can roam around
list wondering_parameters =
[CHARACTER_MAX_SPEED, 1.0, // parameters describing
CHARACTER_DESIRED_SPEED, 0.2, // how I can roam.
CHARACTER_DESIRED_TURN_SPEED,0.02,
CHARACTER_MAX_ACCEL, 0.5,
CHARACTER_MAX_DECEL, 0.5,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 0.5];

list traveling_parameters =
[CHARACTER_MAX_SPEED, 5.0, // parameters describing
CHARACTER_DESIRED_SPEED, 3.0, // how I can roam when
CHARACTER_DESIRED_TURN_SPEED,2.0, // traveling..
CHARACTER_MAX_ACCEL, 3.0,
CHARACTER_MAX_DECEL, 3.0,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 1.5];

// Variables associated with the state of the script
integer active_character = FALSE;

// Helper functions

/* *********************************************************
forceMoveHome(integer resetScript)

Routine to force the object to go home. The option "resetScript" is
to determine if the script should be reset when it is in the same
region it started from.

********************************************************* */
forceMoveHome(integer resetScript)
{
// Stop and delete the character
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
llDeleteCharacter();
active_character = FALSE;
if(home_region == llGetRegionName())
{
// I am in the same home region. Just move close to the start
// point.
llSetRegionPos(home_position);
if(resetScript)
{
llSetPos(home_position);
llSetRot(home_rotation);
llResetScript();
}
}
else
{
llInstantMessage(llGetOwner(),"There is an error. " +
"I wondered away from my start region and cannot go back home.\n" +
"I am located in " + llGetRegionName() + " at " +
(string)llGetPos());
}
}

// Primary (default) state.
// This is the initial state when the program resets.
//
// In this state the object waits for a touch to get started. There is
// a random chance that it might start moving at any time step though.
default
{

state_entry()
{
if(home_position.x < 0.0)
{
// This is the first time to enter this state. Do a little
// house cleaning to start the season.

// Add any parts to the different parameters that require any
// calculations.
wondering_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];
traveling_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];

// Set the initial home position and orientation.
home_position = llGetPos();
home_rotation = llGetRot();
home_region = llGetRegionName();
llOwnerSay("Touch me to start moving. " +
"I will not move until you touch me the first time. " +
"After that it will become automatic.");

}

else if(home_region == llGetRegionName())
{
// I am in the same region I started out in. Make sure I
// start at the last place and orientation when I left
// this state. Make sure that I move close to
// home. (There is some fudge factor in the llSetRegionPos
// command according to the wiki).
llSetPos(home_position);
llSetRot(home_rotation);
llSetTimerEvent(TIME_TO_WAIT_BEFORE_MOVING);
}

llDeleteCharacter(); // Clear and reset the character
// settings. You should always do this so
// that when an active object is taken
// into inventory it will be properly
// reset when rezzed again. (If not here
// then in the on_rez event.)
active_character = FALSE;

llOwnerSay("Stopped\nTouch me to have me wonder around.");
} // state_entry

state_exit()
{
llCreateCharacter(wondering_parameters);
active_character = TRUE;
llSetTimerEvent(0.0);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// This person is in the same group. Assume the idiot can
// be trusted.
home_position = llGetPos(); // Define my start position
home_rotation = llGetRot(); // and start orientation.
state Roaming;
}
} // touch_start

timer()
{
// I have waited to long without any interaction. Time to roam
// because I am a ramblin' object.
state Roaming;
}

} // end default state

// Roaming state.
//
// This is the state when the program decides to start roaming. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply roams around for a while.
state Roaming
{

state_entry()
{
// Set the character to the roaming parameters
llUpdateCharacter(wondering_parameters);
llWanderWithin(home_position, wondering_radius, []);
llOwnerSay("Roaming\nTouch me to have me go back home.");
} // state_entry

state_exit()
{
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
state default;
}
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// Again, if the person is in the same group then let them
// violate me by touching me.
state TravelHome;
}
} // touch_start

path_update(integer type, list reserved)
{
if ((type == PU_SLOWDOWN_DISTANCE_REACHED) ||
(type == PU_GOAL_REACHED))
{
// While roaming this should not occur. if it does just restart???
llWanderWithin(home_position, wondering_radius, []);
}

else {
// Something went wrong with the navmesh. Just go home and wait.
state TravelHome;
}

} // end path_update event

} // end state Roaming

// TravelHome state.
//
// This is the state when the program decides to go home. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply tries to go to the home
// position. If it does not make it in the alloted time the character
// is deleted, and it simply sets its position.
state TravelHome
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here.
llUpdateCharacter(traveling_parameters);
llNavigateTo(home_position,[FORCE_DIRECT_PATH,TRUE]);
llSetTimerEvent(120.0);
llOwnerSay("Going back home\nTouch me to force the issue.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
state default;
}
}

touch_start(integer total_number)
{
// force the issue
if(llDetectedGroup(0))
{
// trust in the authority invested in the people in my
// group because blind trust always works out well.
forceMoveHome(FALSE);
state default;
}
} // touch_start

timer()
{
// It took too long to get home.
forceMoveHome(FALSE);
state default;
} // timer

path_update(integer type, list reserved)
{
if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if (type == PU_GOAL_REACHED)
{
// I have made it home.
state default;
}

else
{
// Something went wrong. Just force the issue and go home.
forceMoveHome(FALSE);
state default;
}

} // end path_update event

} // end state TravelHome

</lsl>

Pathfinding Simple Roaming Example With Evade Pursue

2012-10-11T09:31:12Z

Dark Mole: Removed an unecessary check in the move home state.

A simple example is provided to use [[Pathfinding]] to have an object randomly roam around a small area is given below and randomly evade or pursue a person who touches it. The script is designed to have the object move around in a small area centered at the start location. The object will move back to its start position if anything goes wrong or a group member touches it.

The script has five states. In the default state the object is not moving and can be placed in its start position. From the default state it can transition into the ''Roaming'' state by touching it as a member of the same group. In the ''Roaming'' state it will simply wander around in a small area centered at the start point. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will transition into the ''TravelHome'' state.

In the ''TravelHome'' state the script will attempt to move the object back to its start position using the [[Pathfinding]] functions. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will delete the [[Pathfinding]] character and manually move the object back to its start position using the [[LlSetRegionPos|llSetRegionPos]] function. It will then transition back into the ''default'' state.

If someone touches this object while it is roaming who is not in the same group there is a small chance that it will either evade or pursue the person. If the decision is to evade then the script transitions to the ''Evade_Agent'' state. If the decision is to chase the agent then the script transitions to the ''Chase_Agent'' state.

This code is licensed under the [http://www.gnu.org/licenses/gpl.html|GNU General Public License].

<lsl>

/* *****************************************************************

%%% Desc: Simple example script to demonstrate pathfinding
%%% Author: Dark Mole (contact via IM within Second Life)
%%% File: $HeadURL: simpleMoverWithChaseAndEvade.sl $
%%% Date: $Date: Thu Oct 11 04:44:14 2012 $
%%% Revision: $Rev: .04 $

Copyright 2012 Dark Mole (contact via IM in Second Life

This program is free software: you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see
<http://www.gnu.org/licenses/>.

A copy of this script can be found at
https://wiki.secondlife.com/wiki/Pathfinding_Simple_Roaming_Example_With_Evade_Pursue

***************************************************************** */

// Configuration variables.
// Things to change to impact the behavior of the system

float TIME_TO_WAIT_BEFORE_MOVING = 300.0; // number of seconds to wait
// while in the default
// state before it
// automatically starts to
// roam on its own. Note
// that the first time this
// thing rezzes this timer
// is ignored.

// Global Variables. (do not change unless you know what they do!)

// Location related variables

vector home_position = <-1.0,0.0,0.0>;
rotation home_rotation = ZERO_ROTATION;
string home_region = "";

vector wondering_radius = <5.0,5.0,20.0>; // how far I can roam around
list wondering_parameters =
[CHARACTER_MAX_SPEED, 1.0, // parameters describing
CHARACTER_DESIRED_SPEED, 0.2, // how I can roam.
CHARACTER_DESIRED_TURN_SPEED,0.02,
CHARACTER_MAX_ACCEL, 0.5,
CHARACTER_MAX_DECEL, 0.5,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 0.5];

list traveling_parameters =
[CHARACTER_MAX_SPEED, 5.0, // parameters describing
CHARACTER_DESIRED_SPEED, 3.0, // how I can roam when
CHARACTER_DESIRED_TURN_SPEED,2.0, // traveling..
CHARACTER_MAX_ACCEL, 3.0,
CHARACTER_MAX_DECEL, 3.0,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 1.5];

list chasing_parameters =
[CHARACTER_MAX_SPEED, 15.0, // parameters describing
CHARACTER_DESIRED_SPEED, 10.0, // how I can chase someone.
CHARACTER_DESIRED_TURN_SPEED,8.0,
CHARACTER_MAX_ACCEL, 7.5,
CHARACTER_MAX_DECEL, 7.5,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_FAST,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 0.8,
CHARACTER_AVOIDANCE_MODE, AVOID_DYNAMIC_OBSTACLES];

// Variables associated with the state of the script
integer active_character = FALSE;
key agentToChase = NULL_KEY;

// Helper functions

/* *********************************************************
forceMoveHome(integer resetScript)

Routine to force the object to go home. The option "resetScript" is
to determine if the script should be reset when it is in the same
region it started from.

********************************************************* */
forceMoveHome(integer resetScript)
{
// Stop and delete the character
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
llDeleteCharacter();
active_character = FALSE;
if(home_region == llGetRegionName())
{
// I am in the same home region. Just move close to the start
// point.
llSetRegionPos(home_position);
if(resetScript)
{
llSetPos(home_position);
llSetRot(home_rotation);
llResetScript();
}
}
else
{
llInstantMessage(llGetOwner(),"There is an error. " +
"I wondered away from my start region and cannot go back home.\n" +
"I am located in " + llGetRegionName() + " at " +
(string)llGetPos());
}
}

// Primary (default) state.
// This is the initial state when the program resets.
//
// In this state the object waits for a touch to get started. There is
// a random chance that it might start moving at any time step though.
default
{

state_entry()
{
if(home_position.x < 0.0)
{
// This is the first time to enter this state. Do a little
// house cleaning to start the season.

// Add any parts to the different parameters that require any
// calculations.
wondering_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];
traveling_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];

// Set the initial home position and orientation.
home_position = llGetPos();
home_rotation = llGetRot();
home_region = llGetRegionName();
llOwnerSay("Touch me to start moving. " +
"I will not move until you touch me the first time. " +
"After that it will become automatic.");

}

else if(home_region == llGetRegionName())
{
// I am in the same region I started out in. Make sure I
// start at the last place and orientation when I left
// this state. Make sure that I move close to
// home. (There is some fudge factor in the llSetRegionPos
// command according to the wiki).
llSetPos(home_position);
llSetRot(home_rotation);
llSetTimerEvent(TIME_TO_WAIT_BEFORE_MOVING);
}

llDeleteCharacter(); // Clear and reset the character
// settings. You should always do this so
// that when an active object is taken
// into inventory it will be properly
// reset when rezzed again. (If not here
// then in the on_rez event.)
active_character = FALSE;

llOwnerSay("Stopped\nTouch me to have me wonder around.");
} // state_entry

state_exit()
{
llCreateCharacter(wondering_parameters);
active_character = TRUE;
llSetTimerEvent(0.0);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// This person is in the same group. Assume the idiot can
// be trusted.
home_position = llGetPos(); // Define my start position
home_rotation = llGetRot(); // and start orientation.
state Roaming;
}
} // touch_start

timer()
{
// I have waited to long without any interaction. Time to roam
// because I am a ramblin' object.
state Roaming;
}

} // end default state

// Roaming state.
//
// This is the state when the program decides to start roaming. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply roams around for a while.
state Roaming
{

state_entry()
{
// Set the character to the roaming parameters
llUpdateCharacter(wondering_parameters);
llWanderWithin(home_position, wondering_radius, []);
llOwnerSay("Roaming\nTouch me to have me go back home.");
} // state_entry

state_exit()
{
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// Again, if the person is in the same group then let them
// violate me by touching me.
state TravelHome;
}
else if (llFrand(1.0) < 0.10)
{
// What the heck. Let's chase this person!
agentToChase = llDetectedKey(0);
state Chase_Agent;
}
else if (llFrand(1.0) < 0.10)
{
// What the heck. Run away! Run Away!
agentToChase = llDetectedKey(0);
state Evade_Agent;
}

} // touch_start

path_update(integer type, list reserved)
{
if ((type == PU_SLOWDOWN_DISTANCE_REACHED) ||
(type == PU_GOAL_REACHED))
{
// While roaming this should not occur. if it does just restart???
llWanderWithin(home_position, wondering_radius, []);
}

else {
// Something went wrong with the navmesh. Just go home and wait.
state TravelHome;
}

} // end path_update event

} // end state Roaming

// TravelHome state.
//
// This is the state when the program decides to go home. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply tries to go to the home
// position. If it does not make it in the alloted time the character
// is deleted, and it simply sets its position.
state TravelHome
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here.
llUpdateCharacter(traveling_parameters);
llNavigateTo(home_position,[FORCE_DIRECT_PATH,TRUE]);
llSetTimerEvent(120.0);
llOwnerSay("Going back home\nTouch me to force the issue.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
// force the issue
if(llDetectedGroup(0))
{
// trust in the authority invested in the people in my
// group because blind trust always works out well.
forceMoveHome(FALSE);
state default;
}
} // touch_start

timer()
{
// It took too long to get home.
forceMoveHome(FALSE);
state default;
} // timer

path_update(integer type, list reserved)
{
if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if (type == PU_GOAL_REACHED)
{
// I have made it home.
state default;
}

else
{
// Something went wrong. Just force the issue and go home.
forceMoveHome(FALSE);
state default;
}

} // end path_update event

} // end state TravelHome

// Chase_Agent state.
//
// This is the state when the program decides to chase the person who
// touched the object. Touch it again to go back to wandering.
//
state Chase_Agent
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here.

// Get information about the person
list agentInfo = llGetObjectDetails(agentToChase,[OBJECT_ROT]);
if(llGetListLength(agentInfo)==0)
{
// well that was a bust. Cannot find this person. Just go
// back to roaming.
state Roaming;
}

// I can locate the agent. Let's chase it down.

// Need to get the offset separately, because the z-component
// will not be zero due to round off errors. The purse offset
// has to have a zero z component.
vector offset = <-1.0,0.0,0.0>*llList2Rot(agentInfo,0);
llUpdateCharacter(chasing_parameters);
llPursue(agentToChase,
[PURSUIT_OFFSET, <offset.x,offset.y,0.0>,
REQUIRE_LINE_OF_SIGHT, FALSE,
PURSUIT_FUZZ_FACTOR, 0.8,
PURSUIT_INTERCEPT, TRUE,
PURSUIT_GOAL_TOLERANCE,1.0]);
llSetTimerEvent(120.0);
llOwnerSay("Chasing this person\nTouch me to stop chasing.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
// Stop chasing and go back to wandering mode
state Roaming;
} // touch_start

timer()
{
// This is enough of this nonsense. I am tired. Start
// wandering again.
state Roaming;
} // timer

path_update(integer type, list reserved)
{

if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if ((type == PU_GOAL_REACHED) || (type == PU_FAILURE_TARGET_GONE))
{
// I have found the agent or they are gone. Let's just put
// an end to this.
state Roaming;
}

else
{
// Something went wrong. Just end this now.
state Roaming;
}

} // end path_update event

} // end state Chase_Agent

// Evade_Agent state.
//
// This is the state when the program decides to run away from the
// person who touched the object. Touch it again to go back to
// wandering.
//
state Evade_Agent
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here. Here
// I just use the same settings as used to chase since they
// seem okay. /me shrugs.

llUpdateCharacter(chasing_parameters);
llEvade(agentToChase,[]);
llSetTimerEvent(120.0);
llOwnerSay("Evading this person\nTouch me to stop chasing.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
// Stop evading and go back to wandering mode
state Roaming;
} // touch_start

timer()
{
// This is enough of this nonsense. I am tired. Start
// wandering again.
state Roaming;
} // timer

path_update(integer type, list reserved)
{

if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if ((type == PU_GOAL_REACHED) || (type == PU_FAILURE_TARGET_GONE))
{
// I have found the agent or they are gone. Let's just put
// an end to this.
state Roaming;
}

else if ((type == PU_EVADE_HIDDEN) || (type == PU_EVADE_SPOTTED))
{
// I have been spotted. Oh noze.... panic seems like an
// appropriate plan at this point.
vector mySize = llGetScale();
if(mySize.z*0.25 > 2.0)
{
// Cannot jump this high. Tone it down a bit
mySize.z = 8.0;
}
llExecCharacterCmd(CHARACTER_CMD_JUMP,[mySize.z*0.25]);
}

else
{
// Something went wrong. Just end this now.
state Roaming;
}

} // end path_update event

} // end state Evade_Agent

</lsl>

Pathfinding Simple Roaming Example

2012-10-11T09:28:51Z

Dark Mole: Removed an unecessary check in the move home state.

A simple example is provided to use [[Pathfinding]] to have an object randomly roam around a small area is given below. The script is designed to have the object move around in a small area centered at the start location. The object will move back to its start position if anything goes wrong or a group member touches it.

The script has three states. In the default state the object is not moving and can be placed in its start position. From the default state it can transition into the ''Roaming'' state by touching it as a member of the same group. In the ''Roaming'' state it will simply wander around in a small area centered at the start point. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will transition into the ''TravelHome'' state.

In the ''TravelHome'' state the script will attempt to move the object back to its start position using the [[Pathfinding]] functions. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will delete the [[Pathfinding]] character and manually move the object back to its start position using the [[LlSetRegionPos|llSetRegionPos]] function. It will then transition back into the ''default'' state.

This code is licensed under the [http://www.gnu.org/licenses/gpl.html GNU General Public License].

<lsl>

/* *****************************************************************

%%% Desc: Simple example script to demonstrate pathfinding
%%% Author: Dark Mole (contact via IM within Second Life)
%%% File: $HeadURL: simpleMover.sl $
%%% Date: $Date: Thu Oct 11 04:44:14 2012 $
%%% Revision: $Rev: .04 $

Copyright 2012 Dark Mole (contact via IM in Second Life

This program is free software: you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see
<http://www.gnu.org/licenses/>.

A copy of this script can be found at
https://wiki.secondlife.com/wiki/Pathfinding_Simple_Roaming_Example

***************************************************************** */

// Configuration variables.
// Things to change to impact the behavior of the system

float TIME_TO_WAIT_BEFORE_MOVING = 300.0; // number of seconds to wait
// while in the default
// state before it
// automatically starts to
// roam on its own. Note
// that the first time this
// thing rezzes this timer
// is ignored.

// Global Variables. (do not change unless you know what they do!)

// Location related variables

vector home_position = <-1.0,0.0,0.0>;
rotation home_rotation = ZERO_ROTATION;
string home_region = "";

vector wondering_radius = <5.0,5.0,20.0>; // how far I can roam around
list wondering_parameters =
[CHARACTER_MAX_SPEED, 1.0, // parameters describing
CHARACTER_DESIRED_SPEED, 0.2, // how I can roam.
CHARACTER_DESIRED_TURN_SPEED,0.02,
CHARACTER_MAX_ACCEL, 0.5,
CHARACTER_MAX_DECEL, 0.5,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 0.5];

list traveling_parameters =
[CHARACTER_MAX_SPEED, 5.0, // parameters describing
CHARACTER_DESIRED_SPEED, 3.0, // how I can roam when
CHARACTER_DESIRED_TURN_SPEED,2.0, // traveling..
CHARACTER_MAX_ACCEL, 3.0,
CHARACTER_MAX_DECEL, 3.0,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 1.5];

// Variables associated with the state of the script
integer active_character = FALSE;

// Helper functions

/* *********************************************************
forceMoveHome(integer resetScript)

Routine to force the object to go home. The option "resetScript" is
to determine if the script should be reset when it is in the same
region it started from.

********************************************************* */
forceMoveHome(integer resetScript)
{
// Stop and delete the character
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
llDeleteCharacter();
active_character = FALSE;
if(home_region == llGetRegionName())
{
// I am in the same home region. Just move close to the start
// point.
llSetRegionPos(home_position);
if(resetScript)
{
llSetPos(home_position);
llSetRot(home_rotation);
llResetScript();
}
}
else
{
llInstantMessage(llGetOwner(),"There is an error. " +
"I wondered away from my start region and cannot go back home.\n" +
"I am located in " + llGetRegionName() + " at " +
(string)llGetPos());
}
}

// Primary (default) state.
// This is the initial state when the program resets.
//
// In this state the object waits for a touch to get started. There is
// a random chance that it might start moving at any time step though.
default
{

state_entry()
{
if(home_position.x < 0.0)
{
// This is the first time to enter this state. Do a little
// house cleaning to start the season.

// Add any parts to the different parameters that require any
// calculations.
wondering_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];
traveling_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];

// Set the initial home position and orientation.
home_position = llGetPos();
home_rotation = llGetRot();
home_region = llGetRegionName();
llOwnerSay("Touch me to start moving. " +
"I will not move until you touch me the first time. " +
"After that it will become automatic.");

}

else if(home_region == llGetRegionName())
{
// I am in the same region I started out in. Make sure I
// start at the last place and orientation when I left
// this state. Make sure that I move close to
// home. (There is some fudge factor in the llSetRegionPos
// command according to the wiki).
llSetPos(home_position);
llSetRot(home_rotation);
llSetTimerEvent(TIME_TO_WAIT_BEFORE_MOVING);
}

llDeleteCharacter(); // Clear and reset the character
// settings. You should always do this so
// that when an active object is taken
// into inventory it will be properly
// reset when rezzed again. (If not here
// then in the on_rez event.)
active_character = FALSE;

llOwnerSay("Stopped\nTouch me to have me wonder around.");
} // state_entry

state_exit()
{
llCreateCharacter(wondering_parameters);
active_character = TRUE;
llSetTimerEvent(0.0);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// This person is in the same group. Assume the idiot can
// be trusted.
home_position = llGetPos(); // Define my start position
home_rotation = llGetRot(); // and start orientation.
state Roaming;
}
} // touch_start

timer()
{
// I have waited to long without any interaction. Time to roam
// because I am a ramblin' object.
state Roaming;
}

} // end default state

// Roaming state.
//
// This is the state when the program decides to start roaming. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply roams around for a while.
state Roaming
{

state_entry()
{
// Set the character to the roaming parameters
llUpdateCharacter(wondering_parameters);
llWanderWithin(home_position, wondering_radius, []);
llOwnerSay("Roaming\nTouch me to have me go back home.");
} // state_entry

state_exit()
{
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// Again, if the person is in the same group then let them
// violate me by touching me.
state TravelHome;
}
} // touch_start

path_update(integer type, list reserved)
{
if ((type == PU_SLOWDOWN_DISTANCE_REACHED) ||
(type == PU_GOAL_REACHED))
{
// While roaming this should not occur. if it does just restart???
llWanderWithin(home_position, wondering_radius, []);
}

else {
// Something went wrong with the navmesh. Just go home and wait.
state TravelHome;
}

} // end path_update event

} // end state Roaming

// TravelHome state.
//
// This is the state when the program decides to go home. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply tries to go to the home
// position. If it does not make it in the alloted time the character
// is deleted, and it simply sets its position.
state TravelHome
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here.
llUpdateCharacter(traveling_parameters);
llNavigateTo(home_position,[FORCE_DIRECT_PATH,TRUE]);
llSetTimerEvent(120.0);
llOwnerSay("Going back home\nTouch me to force the issue.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
// force the issue
if(llDetectedGroup(0))
{
// trust in the authority invested in the people in my
// group because blind trust always works out well.
forceMoveHome(FALSE);
state default;
}
} // touch_start

timer()
{
// It took too long to get home.
forceMoveHome(FALSE);
state default;
} // timer

path_update(integer type, list reserved)
{
if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if (type == PU_GOAL_REACHED)
{
// I have made it home.
state default;
}

else
{
// Something went wrong. Just force the issue and go home.
forceMoveHome(FALSE);
state default;
}

} // end path_update event

} // end state TravelHome

</lsl>

Pathfinding Simple Roaming Example With Evade Pursue

2012-10-11T09:18:57Z

Dark Mole: Initial draft of a page to make a simple pathfinding script publicly available.

A simple example is provided to use [[Pathfinding]] to have an object randomly roam around a small area is given below and randomly evade or pursue a person who touches it. The script is designed to have the object move around in a small area centered at the start location. The object will move back to its start position if anything goes wrong or a group member touches it.

The script has five states. In the default state the object is not moving and can be placed in its start position. From the default state it can transition into the ''Roaming'' state by touching it as a member of the same group. In the ''Roaming'' state it will simply wander around in a small area centered at the start point. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will transition into the ''TravelHome'' state.

In the ''TravelHome'' state the script will attempt to move the object back to its start position using the [[Pathfinding]] functions. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will delete the [[Pathfinding]] character and manually move the object back to its start position using the [[LlSetRegionPos|llSetRegionPos]] function. It will then transition back into the ''default'' state.

If someone touches this object while it is roaming who is not in the same group there is a small chance that it will either evade or pursue the person. If the decision is to evade then the script transitions to the ''Evade_Agent'' state. If the decision is to chase the agent then the script transitions to the ''Chase_Agent'' state.

This code is licensed under the [http://www.gnu.org/licenses/gpl.html|GNU General Public License].

<lsl>

/* *****************************************************************

%%% Desc: Simple example script to demonstrate pathfinding
%%% Author: Dark Mole (contact via IM within Second Life)
%%% File: $HeadURL: simpleMoverWithChaseAndEvade.sl $
%%% Date: $Date: Thu Oct 11 04:44:14 2012 $
%%% Revision: $Rev: .04 $

Copyright 2012 Dark Mole (contact via IM in Second Life

This program is free software: you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see
<http://www.gnu.org/licenses/>.

A copy of this script can be found at
https://wiki.secondlife.com/wiki/Pathfinding_Simple_Roaming_Example_With_Evade_Pursue

***************************************************************** */

// Configuration variables.
// Things to change to impact the behavior of the system

float TIME_TO_WAIT_BEFORE_MOVING = 300.0; // number of seconds to wait
// while in the default
// state before it
// automatically starts to
// roam on its own. Note
// that the first time this
// thing rezzes this timer
// is ignored.

// Global Variables. (do not change unless you know what they do!)

// Location related variables

vector home_position = <-1.0,0.0,0.0>;
rotation home_rotation = ZERO_ROTATION;
string home_region = "";

vector wondering_radius = <5.0,5.0,20.0>; // how far I can roam around
list wondering_parameters =
[CHARACTER_MAX_SPEED, 1.0, // parameters describing
CHARACTER_DESIRED_SPEED, 0.2, // how I can roam.
CHARACTER_DESIRED_TURN_SPEED,0.02,
CHARACTER_MAX_ACCEL, 0.5,
CHARACTER_MAX_DECEL, 0.5,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 0.5];

list traveling_parameters =
[CHARACTER_MAX_SPEED, 5.0, // parameters describing
CHARACTER_DESIRED_SPEED, 3.0, // how I can roam when
CHARACTER_DESIRED_TURN_SPEED,2.0, // traveling..
CHARACTER_MAX_ACCEL, 3.0,
CHARACTER_MAX_DECEL, 3.0,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 1.5];

list chasing_parameters =
[CHARACTER_MAX_SPEED, 15.0, // parameters describing
CHARACTER_DESIRED_SPEED, 10.0, // how I can chase someone.
CHARACTER_DESIRED_TURN_SPEED,8.0,
CHARACTER_MAX_ACCEL, 7.5,
CHARACTER_MAX_DECEL, 7.5,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_FAST,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 0.8,
CHARACTER_AVOIDANCE_MODE, AVOID_DYNAMIC_OBSTACLES];

// Variables associated with the state of the script
integer active_character = FALSE;
key agentToChase = NULL_KEY;

// Helper functions

/* *********************************************************
forceMoveHome(integer resetScript)

Routine to force the object to go home. The option "resetScript" is
to determine if the script should be reset when it is in the same
region it started from.

********************************************************* */
forceMoveHome(integer resetScript)
{
// Stop and delete the character
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
llDeleteCharacter();
active_character = FALSE;
if(home_region == llGetRegionName())
{
// I am in the same home region. Just move close to the start
// point.
llSetRegionPos(home_position);
if(resetScript)
{
llSetPos(home_position);
llSetRot(home_rotation);
llResetScript();
}
}
else
{
llInstantMessage(llGetOwner(),"There is an error. " +
"I wondered away from my start region and cannot go back home.\n" +
"I am located in " + llGetRegionName() + " at " +
(string)llGetPos());
}
}

// Primary (default) state.
// This is the initial state when the program resets.
//
// In this state the object waits for a touch to get started. There is
// a random chance that it might start moving at any time step though.
default
{

state_entry()
{
if(home_position.x < 0.0)
{
// This is the first time to enter this state. Do a little
// house cleaning to start the season.

// Add any parts to the different parameters that require any
// calculations.
wondering_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];
traveling_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];

// Set the initial home position and orientation.
home_position = llGetPos();
home_rotation = llGetRot();
home_region = llGetRegionName();
llOwnerSay("Touch me to start moving. " +
"I will not move until you touch me the first time. " +
"After that it will become automatic.");

}

else if(home_region == llGetRegionName())
{
// I am in the same region I started out in. Make sure I
// start at the last place and orientation when I left
// this state. Make sure that I move close to
// home. (There is some fudge factor in the llSetRegionPos
// command according to the wiki).
llSetPos(home_position);
llSetRot(home_rotation);
llSetTimerEvent(TIME_TO_WAIT_BEFORE_MOVING);
}

llDeleteCharacter(); // Clear and reset the character
// settings. You should always do this so
// that when an active object is taken
// into inventory it will be properly
// reset when rezzed again. (If not here
// then in the on_rez event.)
active_character = FALSE;

llOwnerSay("Stopped\nTouch me to have me wonder around.");
} // state_entry

state_exit()
{
llCreateCharacter(wondering_parameters);
active_character = TRUE;
llSetTimerEvent(0.0);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// This person is in the same group. Assume the idiot can
// be trusted.
home_position = llGetPos(); // Define my start position
home_rotation = llGetRot(); // and start orientation.
state Roaming;
}
} // touch_start

timer()
{
// I have waited to long without any interaction. Time to roam
// because I am a ramblin' object.
state Roaming;
}

} // end default state

// Roaming state.
//
// This is the state when the program decides to start roaming. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply roams around for a while.
state Roaming
{

state_entry()
{
// Set the character to the roaming parameters
llUpdateCharacter(wondering_parameters);
llWanderWithin(home_position, wondering_radius, []);
llOwnerSay("Roaming\nTouch me to have me go back home.");
} // state_entry

state_exit()
{
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// Again, if the person is in the same group then let them
// violate me by touching me.
state TravelHome;
}
else if (llFrand(1.0) < 0.10)
{
// What the heck. Let's chase this person!
agentToChase = llDetectedKey(0);
state Chase_Agent;
}
else if (llFrand(1.0) < 0.10)
{
// What the heck. Run away! Run Away!
agentToChase = llDetectedKey(0);
state Evade_Agent;
}

} // touch_start

path_update(integer type, list reserved)
{
if ((type == PU_SLOWDOWN_DISTANCE_REACHED) ||
(type == PU_GOAL_REACHED))
{
// While roaming this should not occur. if it does just restart???
llWanderWithin(home_position, wondering_radius, []);
}

else {
// Something went wrong with the navmesh. Just go home and wait.
state TravelHome;
}

} // end path_update event

} // end state Roaming

// TravelHome state.
//
// This is the state when the program decides to go home. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply tries to go to the home
// position. If it does not make it in the alloted time the character
// is deleted, and it simply sets its position.
state TravelHome
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here.
llUpdateCharacter(traveling_parameters);
llNavigateTo(home_position,[FORCE_DIRECT_PATH,TRUE]);
llSetTimerEvent(120.0);
llOwnerSay("Going back home\nTouch me to force the issue.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
if(active_character)
{
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
}
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
// force the issue
if(llDetectedGroup(0))
{
// trust in the authority invested in the people in my
// group because blind trust always works out well.
forceMoveHome(FALSE);
state default;
}
} // touch_start

timer()
{
// It took too long to get home.
forceMoveHome(FALSE);
state default;
} // timer

path_update(integer type, list reserved)
{
if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if (type == PU_GOAL_REACHED)
{
// I have made it home.
state default;
}

else
{
// Something went wrong. Just force the issue and go home.
forceMoveHome(FALSE);
state default;
}

} // end path_update event

} // end state TravelHome

// Chase_Agent state.
//
// This is the state when the program decides to chase the person who
// touched the object. Touch it again to go back to wandering.
//
state Chase_Agent
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here.

// Get information about the person
list agentInfo = llGetObjectDetails(agentToChase,[OBJECT_ROT]);
if(llGetListLength(agentInfo)==0)
{
// well that was a bust. Cannot find this person. Just go
// back to roaming.
state Roaming;
}

// I can locate the agent. Let's chase it down.

// Need to get the offset separately, because the z-component
// will not be zero due to round off errors. The purse offset
// has to have a zero z component.
vector offset = <-1.0,0.0,0.0>*llList2Rot(agentInfo,0);
llUpdateCharacter(chasing_parameters);
llPursue(agentToChase,
[PURSUIT_OFFSET, <offset.x,offset.y,0.0>,
REQUIRE_LINE_OF_SIGHT, FALSE,
PURSUIT_FUZZ_FACTOR, 0.8,
PURSUIT_INTERCEPT, TRUE,
PURSUIT_GOAL_TOLERANCE,1.0]);
llSetTimerEvent(120.0);
llOwnerSay("Chasing this person\nTouch me to stop chasing.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
// Stop chasing and go back to wandering mode
state Roaming;
} // touch_start

timer()
{
// This is enough of this nonsense. I am tired. Start
// wandering again.
state Roaming;
} // timer

path_update(integer type, list reserved)
{

if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if ((type == PU_GOAL_REACHED) || (type == PU_FAILURE_TARGET_GONE))
{
// I have found the agent or they are gone. Let's just put
// an end to this.
state Roaming;
}

else
{
// Something went wrong. Just end this now.
state Roaming;
}

} // end path_update event

} // end state Chase_Agent

// Evade_Agent state.
//
// This is the state when the program decides to run away from the
// person who touched the object. Touch it again to go back to
// wandering.
//
state Evade_Agent
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here. Here
// I just use the same settings as used to chase since they
// seem okay. /me shrugs.

llUpdateCharacter(chasing_parameters);
llEvade(agentToChase,[]);
llSetTimerEvent(120.0);
llOwnerSay("Evading this person\nTouch me to stop chasing.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
// Stop evading and go back to wandering mode
state Roaming;
} // touch_start

timer()
{
// This is enough of this nonsense. I am tired. Start
// wandering again.
state Roaming;
} // timer

path_update(integer type, list reserved)
{

if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if ((type == PU_GOAL_REACHED) || (type == PU_FAILURE_TARGET_GONE))
{
// I have found the agent or they are gone. Let's just put
// an end to this.
state Roaming;
}

else if ((type == PU_EVADE_HIDDEN) || (type == PU_EVADE_SPOTTED))
{
// I have been spotted. Oh noze.... panic seems like an
// appropriate plan at this point.
vector mySize = llGetScale();
if(mySize.z*0.25 > 2.0)
{
// Cannot jump this high. Tone it down a bit
mySize.z = 8.0;
}
llExecCharacterCmd(CHARACTER_CMD_JUMP,[mySize.z*0.25]);
}

else
{
// Something went wrong. Just end this now.
state Roaming;
}

} // end path_update event

} // end state Evade_Agent

</lsl>

Pathfinding Simple Roaming Example

2012-10-11T09:12:58Z

Dark Mole: Fixed the url to the GPL license details.

A simple example is provided to use [[Pathfinding]] to have an object randomly roam around a small area is given below. The script is designed to have the object move around in a small area centered at the start location. The object will move back to its start position if anything goes wrong or a group member touches it.

The script has three states. In the default state the object is not moving and can be placed in its start position. From the default state it can transition into the ''Roaming'' state by touching it as a member of the same group. In the ''Roaming'' state it will simply wander around in a small area centered at the start point. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will transition into the ''TravelHome'' state.

In the ''TravelHome'' state the script will attempt to move the object back to its start position using the [[Pathfinding]] functions. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will delete the [[Pathfinding]] character and manually move the object back to its start position using the [[LlSetRegionPos|llSetRegionPos]] function. It will then transition back into the ''default'' state.

This code is licensed under the [http://www.gnu.org/licenses/gpl.html GNU General Public License].

<lsl>

/* *****************************************************************

%%% Desc: Simple example script to demonstrate pathfinding
%%% Author: Dark Mole (contact via IM within Second Life)
%%% File: $HeadURL: simpleMover.sl $
%%% Date: $Date: Thu Oct 11 04:44:14 2012 $
%%% Revision: $Rev: .04 $

Copyright 2012 Dark Mole (contact via IM in Second Life

This program is free software: you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see
<http://www.gnu.org/licenses/>.

A copy of this script can be found at
https://wiki.secondlife.com/wiki/Pathfinding_Simple_Roaming_Example

***************************************************************** */

// Configuration variables.
// Things to change to impact the behavior of the system

float TIME_TO_WAIT_BEFORE_MOVING = 300.0; // number of seconds to wait
// while in the default
// state before it
// automatically starts to
// roam on its own. Note
// that the first time this
// thing rezzes this timer
// is ignored.

// Global Variables. (do not change unless you know what they do!)

// Location related variables

vector home_position = <-1.0,0.0,0.0>;
rotation home_rotation = ZERO_ROTATION;
string home_region = "";

vector wondering_radius = <5.0,5.0,20.0>; // how far I can roam around
list wondering_parameters =
[CHARACTER_MAX_SPEED, 1.0, // parameters describing
CHARACTER_DESIRED_SPEED, 0.2, // how I can roam.
CHARACTER_DESIRED_TURN_SPEED,0.02,
CHARACTER_MAX_ACCEL, 0.5,
CHARACTER_MAX_DECEL, 0.5,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 0.5];

list traveling_parameters =
[CHARACTER_MAX_SPEED, 5.0, // parameters describing
CHARACTER_DESIRED_SPEED, 3.0, // how I can roam when
CHARACTER_DESIRED_TURN_SPEED,2.0, // traveling..
CHARACTER_MAX_ACCEL, 3.0,
CHARACTER_MAX_DECEL, 3.0,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 1.5];

// Variables associated with the state of the script
integer active_character = FALSE;

// Helper functions

/* *********************************************************
forceMoveHome(integer resetScript)

Routine to force the object to go home. The option "resetScript" is
to determine if the script should be reset when it is in the same
region it started from.

********************************************************* */
forceMoveHome(integer resetScript)
{
// Stop and delete the character
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
llDeleteCharacter();
active_character = FALSE;
if(home_region == llGetRegionName())
{
// I am in the same home region. Just move close to the start
// point.
llSetRegionPos(home_position);
if(resetScript)
{
llSetPos(home_position);
llSetRot(home_rotation);
llResetScript();
}
}
else
{
llInstantMessage(llGetOwner(),"There is an error. " +
"I wondered away from my start region and cannot go back home.\n" +
"I am located in " + llGetRegionName() + " at " +
(string)llGetPos());
}
}

// Primary (default) state.
// This is the initial state when the program resets.
//
// In this state the object waits for a touch to get started. There is
// a random chance that it might start moving at any time step though.
default
{

state_entry()
{
if(home_position.x < 0.0)
{
// This is the first time to enter this state. Do a little
// house cleaning to start the season.

// Add any parts to the different parameters that require any
// calculations.
wondering_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];
traveling_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];

// Set the initial home position and orientation.
home_position = llGetPos();
home_rotation = llGetRot();
home_region = llGetRegionName();
llOwnerSay("Touch me to start moving. " +
"I will not move until you touch me the first time. " +
"After that it will become automatic.");

}

else if(home_region == llGetRegionName())
{
// I am in the same region I started out in. Make sure I
// start at the last place and orientation when I left
// this state. Make sure that I move close to
// home. (There is some fudge factor in the llSetRegionPos
// command according to the wiki).
llSetPos(home_position);
llSetRot(home_rotation);
llSetTimerEvent(TIME_TO_WAIT_BEFORE_MOVING);
}

llDeleteCharacter(); // Clear and reset the character
// settings. You should always do this so
// that when an active object is taken
// into inventory it will be properly
// reset when rezzed again. (If not here
// then in the on_rez event.)
active_character = FALSE;

llOwnerSay("Stopped\nTouch me to have me wonder around.");
} // state_entry

state_exit()
{
llCreateCharacter(wondering_parameters);
active_character = TRUE;
llSetTimerEvent(0.0);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// This person is in the same group. Assume the idiot can
// be trusted.
home_position = llGetPos(); // Define my start position
home_rotation = llGetRot(); // and start orientation.
state Roaming;
}
} // touch_start

timer()
{
// I have waited to long without any interaction. Time to roam
// because I am a ramblin' object.
state Roaming;
}

} // end default state

// Roaming state.
//
// This is the state when the program decides to start roaming. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply roams around for a while.
state Roaming
{

state_entry()
{
// Set the character to the roaming parameters
llUpdateCharacter(wondering_parameters);
llWanderWithin(home_position, wondering_radius, []);
llOwnerSay("Roaming\nTouch me to have me go back home.");
} // state_entry

state_exit()
{
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// Again, if the person is in the same group then let them
// violate me by touching me.
state TravelHome;
}
} // touch_start

path_update(integer type, list reserved)
{
if ((type == PU_SLOWDOWN_DISTANCE_REACHED) ||
(type == PU_GOAL_REACHED))
{
// While roaming this should not occur. if it does just restart???
llWanderWithin(home_position, wondering_radius, []);
}

else {
// Something went wrong with the navmesh. Just go home and wait.
state TravelHome;
}

} // end path_update event

} // end state Roaming

// TravelHome state.
//
// This is the state when the program decides to go home. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply tries to go to the home
// position. If it does not make it in the alloted time the character
// is deleted, and it simply sets its position.
state TravelHome
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here.
llUpdateCharacter(traveling_parameters);
llNavigateTo(home_position,[FORCE_DIRECT_PATH,TRUE]);
llSetTimerEvent(120.0);
llOwnerSay("Going back home\nTouch me to force the issue.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
if(active_character)
{
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
}
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
// force the issue
if(llDetectedGroup(0))
{
// trust in the authority invested in the people in my
// group because blind trust always works out well.
forceMoveHome(FALSE);
state default;
}
} // touch_start

timer()
{
// It took too long to get home.
forceMoveHome(FALSE);
state default;
} // timer

path_update(integer type, list reserved)
{
if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if (type == PU_GOAL_REACHED)
{
// I have made it home.
state default;
}

else
{
// Something went wrong. Just force the issue and go home.
forceMoveHome(FALSE);
state default;
}

} // end path_update event

} // end state TravelHome

</lsl>

Pathfinding Simple Roaming Example

2012-10-11T09:11:16Z

Dark Mole: Initial draft of a page to make a simple pathfinding script publicly available.

A simple example is provided to use [[Pathfinding]] to have an object randomly roam around a small area is given below. The script is designed to have the object move around in a small area centered at the start location. The object will move back to its start position if anything goes wrong or a group member touches it.

The script has three states. In the default state the object is not moving and can be placed in its start position. From the default state it can transition into the ''Roaming'' state by touching it as a member of the same group. In the ''Roaming'' state it will simply wander around in a small area centered at the start point. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will transition into the ''TravelHome'' state.

In the ''TravelHome'' state the script will attempt to move the object back to its start position using the [[Pathfinding]] functions. If anything goes wrong with the [[Pathfinding]] functions or a group member touches it, the script will delete the [[Pathfinding]] character and manually move the object back to its start position using the [[LlSetRegionPos|llSetRegionPos]] function. It will then transition back into the ''default'' state.

This code is licensed under the [[http://www.gnu.org/licenses/gpl.html|GNU General Public License]].

<lsl>

/* *****************************************************************

%%% Desc: Simple example script to demonstrate pathfinding
%%% Author: Dark Mole (contact via IM within Second Life)
%%% File: $HeadURL: simpleMover.sl $
%%% Date: $Date: Thu Oct 11 04:44:14 2012 $
%%% Revision: $Rev: .04 $

Copyright 2012 Dark Mole (contact via IM in Second Life

This program is free software: you can redistribute it and/or
modify it under the terms of the GNU General Public License as
published by the Free Software Foundation, either version 3 of the
License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program. If not, see
<http://www.gnu.org/licenses/>.

A copy of this script can be found at
https://wiki.secondlife.com/wiki/Pathfinding_Simple_Roaming_Example

***************************************************************** */

// Configuration variables.
// Things to change to impact the behavior of the system

float TIME_TO_WAIT_BEFORE_MOVING = 300.0; // number of seconds to wait
// while in the default
// state before it
// automatically starts to
// roam on its own. Note
// that the first time this
// thing rezzes this timer
// is ignored.

// Global Variables. (do not change unless you know what they do!)

// Location related variables

vector home_position = <-1.0,0.0,0.0>;
rotation home_rotation = ZERO_ROTATION;
string home_region = "";

vector wondering_radius = <5.0,5.0,20.0>; // how far I can roam around
list wondering_parameters =
[CHARACTER_MAX_SPEED, 1.0, // parameters describing
CHARACTER_DESIRED_SPEED, 0.2, // how I can roam.
CHARACTER_DESIRED_TURN_SPEED,0.02,
CHARACTER_MAX_ACCEL, 0.5,
CHARACTER_MAX_DECEL, 0.5,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 0.5];

list traveling_parameters =
[CHARACTER_MAX_SPEED, 5.0, // parameters describing
CHARACTER_DESIRED_SPEED, 3.0, // how I can roam when
CHARACTER_DESIRED_TURN_SPEED,2.0, // traveling..
CHARACTER_MAX_ACCEL, 3.0,
CHARACTER_MAX_DECEL, 3.0,
CHARACTER_ORIENTATION, VERTICAL,
TRAVERSAL_TYPE, TRAVERSAL_TYPE_SLOW,
CHARACTER_TYPE, CHARACTER_TYPE_A,
CHARACTER_MAX_TURN_RADIUS, 1.5];

// Variables associated with the state of the script
integer active_character = FALSE;

// Helper functions

/* *********************************************************
forceMoveHome(integer resetScript)

Routine to force the object to go home. The option "resetScript" is
to determine if the script should be reset when it is in the same
region it started from.

********************************************************* */
forceMoveHome(integer resetScript)
{
// Stop and delete the character
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
llDeleteCharacter();
active_character = FALSE;
if(home_region == llGetRegionName())
{
// I am in the same home region. Just move close to the start
// point.
llSetRegionPos(home_position);
if(resetScript)
{
llSetPos(home_position);
llSetRot(home_rotation);
llResetScript();
}
}
else
{
llInstantMessage(llGetOwner(),"There is an error. " +
"I wondered away from my start region and cannot go back home.\n" +
"I am located in " + llGetRegionName() + " at " +
(string)llGetPos());
}
}

// Primary (default) state.
// This is the initial state when the program resets.
//
// In this state the object waits for a touch to get started. There is
// a random chance that it might start moving at any time step though.
default
{

state_entry()
{
if(home_position.x < 0.0)
{
// This is the first time to enter this state. Do a little
// house cleaning to start the season.

// Add any parts to the different parameters that require any
// calculations.
wondering_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];
traveling_parameters +=
[CHARACTER_AVOIDANCE_MODE, AVOID_CHARACTERS | AVOID_DYNAMIC_OBSTACLES];

// Set the initial home position and orientation.
home_position = llGetPos();
home_rotation = llGetRot();
home_region = llGetRegionName();
llOwnerSay("Touch me to start moving. " +
"I will not move until you touch me the first time. " +
"After that it will become automatic.");

}

else if(home_region == llGetRegionName())
{
// I am in the same region I started out in. Make sure I
// start at the last place and orientation when I left
// this state. Make sure that I move close to
// home. (There is some fudge factor in the llSetRegionPos
// command according to the wiki).
llSetPos(home_position);
llSetRot(home_rotation);
llSetTimerEvent(TIME_TO_WAIT_BEFORE_MOVING);
}

llDeleteCharacter(); // Clear and reset the character
// settings. You should always do this so
// that when an active object is taken
// into inventory it will be properly
// reset when rezzed again. (If not here
// then in the on_rez event.)
active_character = FALSE;

llOwnerSay("Stopped\nTouch me to have me wonder around.");
} // state_entry

state_exit()
{
llCreateCharacter(wondering_parameters);
active_character = TRUE;
llSetTimerEvent(0.0);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// This person is in the same group. Assume the idiot can
// be trusted.
home_position = llGetPos(); // Define my start position
home_rotation = llGetRot(); // and start orientation.
state Roaming;
}
} // touch_start

timer()
{
// I have waited to long without any interaction. Time to roam
// because I am a ramblin' object.
state Roaming;
}

} // end default state

// Roaming state.
//
// This is the state when the program decides to start roaming. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply roams around for a while.
state Roaming
{

state_entry()
{
// Set the character to the roaming parameters
llUpdateCharacter(wondering_parameters);
llWanderWithin(home_position, wondering_radius, []);
llOwnerSay("Roaming\nTouch me to have me go back home.");
} // state_entry

state_exit()
{
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
if(llDetectedGroup(0))
{
// Again, if the person is in the same group then let them
// violate me by touching me.
state TravelHome;
}
} // touch_start

path_update(integer type, list reserved)
{
if ((type == PU_SLOWDOWN_DISTANCE_REACHED) ||
(type == PU_GOAL_REACHED))
{
// While roaming this should not occur. if it does just restart???
llWanderWithin(home_position, wondering_radius, []);
}

else {
// Something went wrong with the navmesh. Just go home and wait.
state TravelHome;
}

} // end path_update event

} // end state Roaming

// TravelHome state.
//
// This is the state when the program decides to go home. I
// strongly prefer not to use all these states, but it makes for a
// much cleaner code in this case and a better demo.
//
// In this state the object simply tries to go to the home
// position. If it does not make it in the alloted time the character
// is deleted, and it simply sets its position.
state TravelHome
{

state_entry()
{
// Set the character to the traveling parameters and set a
// timer to make sure something eventually happens here.
llUpdateCharacter(traveling_parameters);
llNavigateTo(home_position,[FORCE_DIRECT_PATH,TRUE]);
llSetTimerEvent(120.0);
llOwnerSay("Going back home\nTouch me to force the issue.");
} // state_entry

state_exit()
{
llSetTimerEvent(0.0);
if(active_character)
{
llExecCharacterCmd(CHARACTER_CMD_SMOOTH_STOP,[]);
}
} // state_exit

on_rez(integer param)
{
llResetScript();
} // on_rez

changed( integer change)
{
if(change & CHANGED_REGION_START)
{
// The simulator this thing is on has reset
forceMoveHome(TRUE);
}
state default;
}

touch_start(integer total_number)
{
// force the issue
if(llDetectedGroup(0))
{
// trust in the authority invested in the people in my
// group because blind trust always works out well.
forceMoveHome(FALSE);
state default;
}
} // touch_start

timer()
{
// It took too long to get home.
forceMoveHome(FALSE);
state default;
} // timer

path_update(integer type, list reserved)
{
if (type == PU_SLOWDOWN_DISTANCE_REACHED)
{
// I am close to home.
llSetTimerEvent(10.0);
}

else if (type == PU_GOAL_REACHED)
{
// I have made it home.
state default;
}

else
{
// Something went wrong. Just force the issue and go home.
forceMoveHome(FALSE);
state default;
}

} // end path_update event

} // end state TravelHome

</lsl>

CHARACTER TYPE A

2012-10-09T10:07:47Z

Dark Mole: Added to the description.

CHARACTER TYPE A

2012-10-09T10:03:27Z

Dark Mole: Changed category

{{LSL Constant/Pathfinding Character}}{{LSL Constant
|name=CHARACTER_TYPE_A
|type=integer
|value=0
|desc
|examples
|functions
|events
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

CHARACTER TYPE A

2012-10-09T10:02:41Z

Dark Mole: Initial draft of the page.

{{LSL Constant/Attachment}}{{LSL Constant
|name=CHARACTER_TYPE_A
|type=integer
|value=0
|desc
|examples
|functions
|events
|cat1=Pathfinding
|cat2
|cat3
|cat4
|self
}}

Pathfinding in Second Life

2012-10-08T10:03:17Z

Dark Mole: /* LSL functions */

{{Pathfinding Nav}}
__TOC__
{{Multi-lang}}
== Overview ==
At a high level, pathfinding provides tools and functions to enable smoother and smarter movement behavior for non-avatar entities in Second Life (for example, monsters in a game, rats in a haunted house, wisps in a fantasy forest). We refer to these entities as ''characters''; in gaming terminology, they are sometimes called ''NPCs'' (non-player characters) or ''mobs'' (mobile objects).

Up till now, content creators had to use resource-intensive scripting workarounds to emulate intelligent character movement. With the addition of pathfinding, content creators will have a much easier and better performing way of creating characters that can move around in the world. Characters can use LSL functions to avoid obstacles, move around corners, climb inclines, and move across region boundaries: things that were very difficult or even impossible before. Pathfinding will also enable new gameplay mechanics, such as creating food that attracts monsters.

{{KBnote|Pathfinding is not an animation system. It does not provide a way to animate a biped or quadruped in conjunction with the new movement functionality. You must use existing methods to animate characters. Nevertheless, pathfinding enables more dynamic movement and provides a better system for controlling character movement than was previously possible. For more information on creating animations, see [[Animation]].}}

=== User group ===
The Pathfinding user group meets Thursdays at 4pm in the center of [http://slurl.com/secondlife/PathTest1/128/128/23/?&title=PathTest1 Pathtest1] on the Aditi test grid.

Transcripts:
* [[Pathfinding_in_Second_Life/2012-06-07|2012-06-07]]
* [[Pathfinding_in_Second_Life/2012-05-31|2012-05-31]]
* [[Pathfinding_in_Second_Life/2012-05-17|2012-05-17]]
* [[Pathfinding_in_Second_Life/2012-05-10|2012-05-10]]
* [[Pathfinding_in_Second_Life/2012-05-03|2012-05-03]]
* [[Pathfinding_in_Second_Life/2012-04-19|2012-04-19]]

=== LSL functions ===
The pathfinding LSL functions enable you to create characters that dynamically avoid obstacles while performing typical behaviors you might want in a game or other virtual experience, including:
* '''Create''' - Initialize an object to prepare it for using pathfinding functions. [[LlCreateCharacter]]
* '''Delete''' - Stop the object from responding to pathfinding functions. [[LlDeleteCharacter]]
* '''Evade''' - Run away from a specified object or avatar. See [[llEvade]].
* '''Flee''' - Attempt to get a specified distance from a specified location. See [[llFleeFrom]].
* '''Navigate''' - Move to a specific location. See [[llNavigateTo]].
* '''Patrol''' - Move through a path defined by a set of "patrol points." See [[llPatrolPoints]].
* '''Pursue''' - Chase a specified object or avatar. See [[llPursue]].
* '''Update''' - Update or change the parameters associated with a character. See [[LlUpdateCharacter]].
* '''Wander''' - Randomly move around a specified distance from a specified central point. See [[llWanderWithin]].
* '''ExecCharacterCmd''' - Miscellaneous character-related functions such as stopping and jumping. See [[llExecCharacterCmd]].
* '''GetStaticPath''' - The only function which can be used on '''non'''-characters and on regions with dynamic pathfinding disabled. Returns a path to the goal. See [[llGetStaticPath]]

For more details, see [[Pathfinding LSL Functions]].

=== LSL events ===

The following event is designed to react when the various pathfinding event are triggered for an active pathfinding character:

* [[path_update]] - Triggered when a pathfinding event occurs.

== Alpha release information ==
* [[Pathfinding/Alpha release notes]] - Restrictions, known issues, and tips on how to test the alpha version of Pathfinding on the Aditi test grid.
* [[Preview_Grid#How_do_I_log_in_to_Aditi.3F|How do I log into the Aditi test grid?]] - This test is being run on the Aditi test grid; for more information, read this article about Aditi and how you can log in.
* [[Pathfinding_Tools_in_the_Second_Life_Viewer]] - New tools in the Second Life Viewer to help you manage your Pathfinding characters and their environment. Not yet publicly available.
* [[Pathfinding_Quick_Start_Guide]] - How to get your region up and running smoothly with Pathfinding.

Pathfinding in Second Life

2012-10-08T09:21:40Z

Dark Mole:

{{Pathfinding Nav}}
__TOC__
{{Multi-lang}}
== Overview ==
At a high level, pathfinding provides tools and functions to enable smoother and smarter movement behavior for non-avatar entities in Second Life (for example, monsters in a game, rats in a haunted house, wisps in a fantasy forest). We refer to these entities as ''characters''; in gaming terminology, they are sometimes called ''NPCs'' (non-player characters) or ''mobs'' (mobile objects).

Up till now, content creators had to use resource-intensive scripting workarounds to emulate intelligent character movement. With the addition of pathfinding, content creators will have a much easier and better performing way of creating characters that can move around in the world. Characters can use LSL functions to avoid obstacles, move around corners, climb inclines, and move across region boundaries: things that were very difficult or even impossible before. Pathfinding will also enable new gameplay mechanics, such as creating food that attracts monsters.

{{KBnote|Pathfinding is not an animation system. It does not provide a way to animate a biped or quadruped in conjunction with the new movement functionality. You must use existing methods to animate characters. Nevertheless, pathfinding enables more dynamic movement and provides a better system for controlling character movement than was previously possible. For more information on creating animations, see [[Animation]].}}

=== User group ===
The Pathfinding user group meets Thursdays at 4pm in the center of [http://slurl.com/secondlife/PathTest1/128/128/23/?&title=PathTest1 Pathtest1] on the Aditi test grid.

Transcripts:
* [[Pathfinding_in_Second_Life/2012-06-07|2012-06-07]]
* [[Pathfinding_in_Second_Life/2012-05-31|2012-05-31]]
* [[Pathfinding_in_Second_Life/2012-05-17|2012-05-17]]
* [[Pathfinding_in_Second_Life/2012-05-10|2012-05-10]]
* [[Pathfinding_in_Second_Life/2012-05-03|2012-05-03]]
* [[Pathfinding_in_Second_Life/2012-04-19|2012-04-19]]

=== LSL functions ===
The pathfinding LSL functions enable you to create characters that dynamically avoid obstacles while performing typical behaviors you might want in a game or other virtual experience, including:
* '''Create''' - Initialize an object to prepare it for using pathfinding functions. [[LlCreateCharacter]]
* '''Delete''' - Stop the object from responding to pathfinding functions. [[LlDeleteCharacter]]
* '''Evade''' - Run away from a specified object or avatar. See [[llEvade]].
* '''Flee''' - Attempt to get a specified distance from a specified location. See [[llFleeFrom]].
* '''Navigate''' - Move to a specific location. See [[llNavigateTo]].
* '''Patrol''' - Move through a path defined by a set of "patrol points." See [[llPatrolPoints]].
* '''Pursue''' - Chase a specified object or avatar. See [[llPursue]].
* '''Wander''' - Randomly move around a specified distance from a specified central point. See [[llWanderWithin]].
* '''ExecCharacterCmd''' - Miscellaneous character-related functions such as stopping and jumping. See [[llExecCharacterCmd]].
* '''GetStaticPath''' - The only function which can be used on '''non'''-characters and on regions with dynamic pathfinding disabled. Returns a path to the goal. See [[llGetStaticPath]]

For more details, see [[Pathfinding LSL Functions]].

=== LSL events ===

The following event is designed to react when the various pathfinding event are triggered for an active pathfinding character:

* [[path_update]] - Triggered when a pathfinding event occurs.

== Alpha release information ==
* [[Pathfinding/Alpha release notes]] - Restrictions, known issues, and tips on how to test the alpha version of Pathfinding on the Aditi test grid.
* [[Preview_Grid#How_do_I_log_in_to_Aditi.3F|How do I log into the Aditi test grid?]] - This test is being run on the Aditi test grid; for more information, read this article about Aditi and how you can log in.
* [[Pathfinding_Tools_in_the_Second_Life_Viewer]] - New tools in the Second Life Viewer to help you manage your Pathfinding characters and their environment. Not yet publicly available.
* [[Pathfinding_Quick_Start_Guide]] - How to get your region up and running smoothly with Pathfinding.

User talk:Dark Mole

2012-10-02T17:49:03Z

Dark Mole: Initial edit for this page

Nobody is talking about Dark Mole.

User:Dark Mole

2012-10-02T17:48:24Z

Dark Mole: Initial edit for this page

This is the page for Dark Mole.

Please add your favorite stories about Dark Mole below or he will have to start making stuff up.

Pathfinding in Second Life

2012-10-02T17:03:10Z

Dark Mole: /* LSL functions */ moved a misplaced space.

{{Pathfinding Nav}}
__TOC__
{{Multi-lang}}
== Overview ==
At a high level, pathfinding provides tools and functions to enable smoother and smarter movement behavior for non-avatar entities in Second Life (for example, monsters in a game, rats in a haunted house, wisps in a fantasy forest). We refer to these entities as ''characters''; in gaming terminology, they are sometimes called ''NPCs'' (non-player characters) or ''mobs'' (mobile objects).

Up till now, content creators had to use resource-intensive scripting workarounds to emulate intelligent character movement. With the addition of pathfinding, content creators will have a much easier and better performing way of creating characters that can move around in the world. Characters can use LSL functions to avoid obstacles, move around corners, climb inclines, and move across region boundaries: things that were very difficult or even impossible before. Pathfinding will also enable new gameplay mechanics, such as creating food that attracts monsters.

{{KBnote|Pathfinding is not an animation system. It does not provide a way to animate a biped or quadruped in conjunction with the new movement functionality. You must use existing methods to animate characters. Nevertheless, pathfinding enables more dynamic movement and provides a better system for controlling character movement than was previously possible. For more information on creating animations, see [[Animation]].}}

=== User group ===
The Pathfinding user group meets Thursdays at 4pm in the center of [http://slurl.com/secondlife/PathTest1/128/128/23/?&title=PathTest1 Pathtest1] on the Aditi test grid.

Transcripts:
* [[Pathfinding_in_Second_Life/2012-06-07|2012-06-07]]
* [[Pathfinding_in_Second_Life/2012-05-31|2012-05-31]]
* [[Pathfinding_in_Second_Life/2012-05-17|2012-05-17]]
* [[Pathfinding_in_Second_Life/2012-05-10|2012-05-10]]
* [[Pathfinding_in_Second_Life/2012-05-03|2012-05-03]]
* [[Pathfinding_in_Second_Life/2012-04-19|2012-04-19]]

=== LSL functions ===
The pathfinding LSL functions enable you to create characters that dynamically avoid obstacles while performing typical behaviors you might want in a game or other virtual experience, including:
* '''Create''' - Initialize an object to prepare it for using pathfinding functions. [[LlCreateCharacter]]
* '''Delete''' - Stop the object from responding to pathfinding functions. [[LlDeleteCharacter]]
* '''Evade''' - Run away from a specified object or avatar. See [[llEvade]].
* '''Flee''' - Attempt to get a specified distance from a specified location. See [[llFleeFrom]].
* '''Navigate''' - Move to a specific location. See [[llNavigateTo]].
* '''Patrol''' - Move through a path defined by a set of "patrol points." See [[llPatrolPoints]].
* '''Pursue''' - Chase a specified object or avatar. See [[llPursue]].
* '''Wander''' - Randomly move around a specified distance from a specified central point. See [[llWanderWithin]].
* '''ExecCharacterCmd''' - Miscellaneous character-related functions such as stopping and jumping. See [[llExecCharacterCmd]].
* '''GetStaticPath''' - The only function which can be used on '''non'''-characters and on regions with dynamic pathfinding disabled. Returns a path to the goal. See [[llGetStaticPath]]

For more details, see [[Pathfinding LSL Functions]].

== Alpha release information ==
* [[Pathfinding/Alpha release notes]] - Restrictions, known issues, and tips on how to test the alpha version of Pathfinding on the Aditi test grid.
* [[Preview_Grid#How_do_I_log_in_to_Aditi.3F|How do I log into the Aditi test grid?]] - This test is being run on the Aditi test grid; for more information, read this article about Aditi and how you can log in.
* [[Pathfinding_Tools_in_the_Second_Life_Viewer]] - New tools in the Second Life Viewer to help you manage your Pathfinding characters and their environment. Not yet publicly available.
* [[Pathfinding_Quick_Start_Guide]] - How to get your region up and running smoothly with Pathfinding.

Pathfinding Tools in the Second Life Viewer

2012-10-02T17:01:39Z

Dark Mole:

{{Pathfinding Nav}}
__TOC__
== Introduction ==
For pathfinding, each region has a navigation mesh, commonly referred to as a "'''navmesh'''". The '''navmesh''' is a representation of the region's geometry generated and used by the physics simulator to determine paths for the pathfinding characters. The navmesh may be in one of the following three states:

* Up-to-date
* Has pending changes
* Building ''(a.k.a. rebaking)''

The navmesh will transition through these states according to the following diagram:

[[File:Navmesh_transitions.png|alt=Second Life Pathfinding NavMesh Transitions|Second Life Pathfinding NavMesh Transitions]]

Six new elements have been added to the SL Viewer interface to communicate the navmesh state for the current region. These new elements are:

* icon representations of the pathfinding region state for the SLURL bar
* a "Rebake region" button that appears above the lower toolbar
* a right-click context menu option addition
* an additional field on the Build floater
* an additional field on the Object Profile floater
* additional simulator metrics on the Statistics floater

In addition to these new elements, three new floaters allow users to more efficiently create, visualize, test, and debug pathfinding-enabled characters. These tools are not required to create pathfinding behaviors but are particularly useful to builders and experienced creators in Second Life. These new floaters are:

* Pathfinding linksets
* Pathfinding characters
* Pathfinding view / test

== Pathfinding UI Elements ==

'''Note that other residents editing pathfinding objects on the same region may create pending changes to the navmesh.''' When this occurs, all residents on the same region and with build rights will see the appropriate SLURL bar icons and rebake region button.

=== Pathfinding Icons in SLURL Bar ===

The SLURL bar indicates the three pathfinding states of the current region.
# '''Navmesh is up-to-date''' The current region's navmesh is up-to-date. No icon is shown as this is the expected default state. [[File:Pathfinding-clean-region-1.png|alt=Second Life URL Bar with Up-to-Date NavMesh Icon|Second Life URL Bar with Up-to-Date NavMesh Icon]]
# '''Navmesh has pending changes''' The region has pending changes that have not yet been baked into the navmesh. A pathfinding icon with a construction symbol is shown. [[File:Pathfinding-dirty-region-1.png|alt=Second Life URL Bar with Pending Changes Icon|Second Life URL Bar with Pending Changes Icon]]
# '''Dynamic pathfinding is disabled''' The region has dynamic pathfinding disabled. Pathfinding characters will not work as expected. A pathfinding icon with a disabled symbol is shown. [[File:Pathfinding-disabled-region-1.png|alt=Second Life URL Bar with Pathfinding Disabled Icon|Second Life URL Bar with Pathfinding Disabled Icon]]

=== Rebake Region Button ===

When a region has pending changes, the appropriate icon will be shown in the SLURL bar, as described above. In addition, if the user has build rights for any parcel on the current region, the user will also be able to see a "Rebake region" button that displays above the lower toolbar.

[[File:Rebake-button-1.png|alt=Second Life Rebake Region button that allows permitted users to rebake pathfinding changes into the navmesh]]

When the user clicks this button, a request is sent to the region to rebake the navmesh for the current region. As rebaking a region may be a time intensive process, the button will change to indicate "Region is rebaking" during this server process. After the rebaking is complete, this button on the viewer will vanish.

[[File:Rebaking-button-1.png|alt=Second Life Region is Rebaking button that indicates that the current region is rebaking its navmesh]]

=== Right-click context menu behavior ===

When right-clicking on an object in-world, pathfinding-specific menu options may be included in the pop-up context menu.

If the user right-clicks on a '''linkset''' object in-world, a menu option "Show in linksets" will allow the user to open the Pathfinding Linksets floater with the current object selected.

[[File:Right-click-show-in-linksets-1.png|alt=Second Life Context Menu with Show in Linksets floater menu option]]

If the user right-clicks on a pathfinding '''character''' object in-world, a menu option "Show in characters" will allow the user to open the Pathfinding Characters floater with the current object selected.

[[File:Right-click-show-in-characters-1.png|alt=Second Life Context Menu with Show in Characters floater menu option]]

=== Additional field on the Build floater ===

The Build floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Build floater with a ''character'' object selected.

[[File:Build-floater-character-1.png|alt=Build floater with pathfinding attribute character|Build floater with pathfinding attribute character]]

The following image is a screenshot of the Build floater with an object that ''affects navmesh'' selected. This object could be a ''walkable'', ''static obstacle'', ''material volume'', or ''exclusion volume''.

[[File:Build-floater-affects-navmesh-1.png|alt=Build floater with pathfinding attribute affects navmesh|Build floater with pathfinding attribute affects navmesh]]

{{KBwarning|For linksets that do affect the navmesh, it will be impossible to modify the object across the region boundary. The user and the object affecting a navmesh must be in the same region to enable modification of the object. This will be indicated on the General tab of the Build floater as illustrated in the following screenshot.}}
[[File:Build-floater-region-boundary-1.png|alt=Build floater indicating that the user cannot modify object across a region boundary|Build floater indicating that the user cannot modify object across a region boundary]]

=== Additional field on the Object Profile floater ===

Similar to the afore-described Build floater, the Object Profile floater has also been updated with an additional field indicating the pathfinding attributes of the current object.

The following image is a screenshot of the Object Profile floater with an ''affects navmesh'' object selected.

[[File:Object-profile-1.png|alt=Object Profile floater with pathfinding attribute affects navmesh|Object Profile floater with pathfinding attribute affects navmesh]]

=== Additional simulator metrics on the Statistics floater ===

For advanced users, additional simulator metrics have been added to the Statistics floater. The Statistics floater, available from the main menu Advanced > Performance Tools > Statistics Bar, has the following 3 additional fields reporting statistics from the simulator regarding pathfinding activity:

* '''AI Step Time''' - The average time spent during each frame computing character AI events.
* '''Skipped Silhouette Steps''' - The number of steps that are skipped per second in computing the influence of objects of type ''Movable Obstacles'' on the navmesh. A high value here means that objects on the region are marked as ''Movable Obstacles'' and could be contributing to improper pathfinding behavior on the region. To lower this value, set all objects that do not move to either type ''Walkable'' or ''Static Obstacle'', and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]].
* '''Characters Updated''' - The average percentage of characters updated during each frame. A low value here means that character AI computations are taking too long during each frame, and thus some character updates are skipped during subsequent frames. This could be contributing to improper pathfinding behavior on the region. To increase this value, decrease the number of characters on the region, and optimize any ''Movable Obstacle'' shapes to meet the [[Good_Building_Practices|Good Building Practices Guide]]. Note that the Pathfinding Characters floater (described below) may also be used to determine which characters on the region are contributing the most to the region's CPU time.

[[File:Pathfinding-stats-2.png|alt=Simulator Statistics floater with additional pathfinding statistics|Simulator Statistics floater with additional pathfinding statistics]]

== Pathfinding Floaters ==

These three pathfinding floaters may all be accessed through the Build->Pathfinding menu in the Project Viewer - Pathfinding.

[[File:Build-menu-pf-selected-1.png|alt=Second Life Build Menu with new Pathfinding menu items|SL Build -> Pathfinding Menu]]

 

=== Pathfinding Linksets Floater ===

==== Overview ====

The intent of the Pathfinding Linksets floater is to give advanced users and builders the ability to customize an area to achieve interesting effects with pathfinding-enabled characters. It can be initiated using the Build->Pathfinding->LinkSets options in the viewer menu.

The floater displays information for all linksets within the current region for which the user has the ability to alter. The table reports useful information including
* Linkset Name
* Description
* Owner
* Whether the object is Scripted
* Land Impact
* Distance from the resident's avatar
* Linkset Use
** Potential values
*** Walkable
*** Static Obstacle
*** Movable Obstacle
*** Material Volume
*** Exclusion Volume
*** Movable Phantom
* Walkability Coefficients
** Character Type A ''(example use: humanoid)''
** Character Type B ''(example use: creature)''
** Character Type C ''(example use: mechanical)''
** Character Type D ''(example use: other)''

Additionally, selecting any linksets within the floater will also select the object(s) within the Viewer.

[[File:Linksets-floater-3.png|alt=Pathfinding Linksets floater|Pathfinding Linksets]]

 

==== Controls ====

{{:Viewerhelp:Pathfinding linksets}}

==== Example use ====

The advanced users and builders will use the Pathfinding Linksets floater to customize areas to create interesting effects for pathfinding-enabled characters.

For instance, imagine the scenario of a builder constructing a single room in a pathfinding-enabled house. For the single room, the builder would use the following types as follows:

{|border="1"
! Linkset Use !! Description
|-
|width="200" align="center" | Walkable || align="left" | The floor linkset would be set to be Walkable to allow characters to move across the floor.
|-
|width="200" align="center" | Static Obstacle || align="left" | A desk linkset in the room would be set to be Static Obstacle to block characters from walking through or across the object.

NOTE Any object that should block character movement and that does not move should be marked as Static Obstacle to improve performance of pathfinding characters.
|-
|width="200" align="center" | Movable Obstacle || align="left" | A door linkset in the room would be set to be Movable Obstacle. This will still block characters but, in contrast to Static Obstacles, Movable Obstacles will allow the linkset itself to move. In the case of the door, this will allow the door to open and close, but will still prevent characters from walking through the door.
|-
|width="200" align="center" | Material Volume || align="left" | Material Volumes are phantom objects that can be used to affect the walkability coefficients of intersecting objects. Imagine that the builder applied a texture to the floor. Also, imagine that the floor texture includes small throw rug in the middle of the room. (The builder did not want to create a separate object for the rug, so is using a texture on the floor to give the appearance of a rug). The builder can then create a Material Volume object intersecting the floor at the location of the rug. Then, by setting a lower walkability coefficient for the Material Volume, the builder will create the affect of slowing down characters as the characters traverse across the painted rug area.
|-
|width="200" align="center" | Exclusion Volume || align="left" | Exclusion Volumes are phantom objects that can be used to create areas where characters are prevented from moving. For instance, the builder can use an Exclusion Volume to create a section of the room where avatars would be able to move, but characters would be blocked from following.
|-
|width="200" align="center" | Movable Phantom || align="left" | Movable Phantoms are phantom objects that have no affect on pathfinding-enabled characters.
|}
 
In addition to linkset use attributes, builders can achieve additional effects by modifying the walkability coefficients for linksets. The walkability coefficients are values, ranging from 0% to 100%, that affect a characters speed. A walkability coefficient of 50% will reduce a character's speed by half while the character is traversing across the linkset.
 

=== Pathfinding Characters Floater ===

==== Overview ====
The intent of Pathfinding Characters floater is primarily for users to locate characters moving throughout a region and to identify the CPU cost of characters affecting the performance of a region. It can be initiated using the Build->Pathfinding->Characters options in the viewer menu.

The floater displays information for all characters within the current region for which the user has the ability to manipulate. The table reports useful information including
* Character Name
* Description
* Owner
* CPU Time
* Altitude

[[File:Characters-floater-1.png|alt=Pathfinding Characters floater|Pathfinding Characters]]
 
==== Controls ====

{{:Viewerhelp:Pathfinding characters}}

==== Example use ====
# If a region owner has created a pathfinding-enabled character but is unable to find the character within the region, the Characters floater can be used to locate and select the character.
# Additionally, the Pathfinding Characters floater reports the CPU time cost for each character within the region. This functionality can be used by advanced users to identify which characters are impacting performance the most.

=== Pathfinding View/Test Floater ===

==== Overview ====

The intent of the Pathfinding View/Test floater is for advanced users who are building pathfinding-enabled objects and characters. It can be initiated using the Build->Pathfinding->View/Test options in the viewer menu.

This floater consists of 3 basic areas.

# Status area (illustrating both the Viewer and Simulator status of the region's navmesh)
# View tab Controls
# Test Path tab Controls

The following image is a screenshot of the Pathfinding View/Test floater with the navmesh displayed.

[[File:View-nav-mesh-1.png|alt=Pathfinding View/Test floater with the navmesh displayed|Pathfinding View/Test with navmesh displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with the pathfinding object types displayed.

[[File:View-pf-types-1.png|alt=Pathfinding View/Test floater with the pathfinding object types displayed|Pathfinding View/Test with the pathfinding object types displayed]]

The following image is a screenshot of the Pathfinding View/Test floater with a test path displayed.

[[File:View-test-path-1.png|alt=Pathfinding View/Test floater with a test path displayed|Pathfinding View/Test with a test path displayed]]

 
==== Controls ====

{{:Viewerhelp:Pathfinding edit and test}}

==== Example Use ====

# The advanced user will use the Visualization controls to visualize how the navmesh and related permanent objects have been generated. By seeing this visualization of how the physics engine interprets the navigation information, the advanced user can understand how to better customize the pathfinding-enabled objects to obtain the desired behaviors of characters.
# The advanced user will use the Test Tab to visualize how a test character would choose the path between selected start and end points.

 

== Known Issues ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/MAINT-1291 MAINT-1291]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Enable Debug GL crashes the viewer to the desktop
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac Pro running 10.7.4 with AMD Radeon HD5770 iMac running Mac OS X Lion 10.7.4 (11E53) with AMD Radeon HD 6770M (512 MB) PC Clone running XP Pro with GeForce2 Ultra
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-572 PATH-572]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Underwater 'Walkables' shapes are reflected about the water plane
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-659 PATH-659]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | navmesh being drawn over worn flexi prims and under avatar
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-790 PATH-790]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Physics capsule rendering of character shapes is broken after zooming
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-812 PATH-812]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Show capsules option creates black capsule instead of blue
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | ATI Radeon X300 Video card ATI Radeon X600 Video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-821 PATH-821]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop displays black environment
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Toshiba Satellite L645 laptop with AMD Radeon HD 4200 Mobile graphics
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-822 PATH-822]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Configuration with ATI Radeon 7500 can launch Viewer, serious GFx issues
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | AMD Athlon64 3000+ with ATI Radeon 7500 video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-851 PATH-851]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Crash in the beta viewer relating to LLLoginInstance
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | [https://jira.secondlife.com/browse/PATH-857 PATH-857] [https://jira.secondlife.com/browse/VWR-29500 VWR-29500]
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Shadows not operational under Second Life Beta 3.4.0.262596
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | Mac OS X 10.7.4 with ATI Radeon X1600 OpenGL Engine video card
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
|}

 

== Issues Fixed during Beta ==

{| style="border-style:solid;border-width:2px 0 2px 0px;"
! style="border-style:solid;border-width:0 0 1px 0" width="130" | JIRA
! style="border-style:solid;border-width:0 0 1px 0" width="300" | Summary
! style="border-style:solid;border-width:0 0 1px 0" width="550" | Hardware
! style="border-style:solid;border-width:0 0 1px 0" width="100" | Fixed in Version
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-814 PATH-814]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 laptop displays black environment</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Sony VAIO PCG-71211 with AMD Radeon HD5650M Mobile graphics</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-826 PATH-826]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Random crash while wearing a mesh avatar and dropping objects in-world</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (262596)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1413 MAINT-1413] [https://jira.secondlife.com/browse/VWR-29491 VWR-29491]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>"Weights Of Selected" never gives any results after pathfinding tools were merged in.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1414 MAINT-1414] [https://jira.secondlife.com/browse/VWR-29497 VWR-29497]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>User is not able to specify color of object with unchecked 'Apply now' chechbox</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1425 MAINT-1425]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>viewer spams the log with "LLViewerParcelMgr::requestParcelMediaURLFilter: can't get ParcelMediaURLFilterList cap" while editing an object</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1426 MAINT-1426]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Texture repeats/meter reset before you can click Apply button</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-643 PATH-643] [https://jira.secondlife.com/browse/PATHBUG-174 PATHBUG-174]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Changes in Preferences dialog stops work of Pathfinding View/Test functionality</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-842 PATH-842] [https://jira.secondlife.com/browse/VWR-29431 VWR-29431] [https://jira.secondlife.com/browse/MAINT-1362 MAINT-1362]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>TargetOmega object's rotation resets if it changes color in 3.4.0 (262596) Beta</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-849 PATH-849]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Crash in the beta viewer relating to pathfinding</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-852 PATH-852]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Custom cursors fail on mac and linux</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-854 PATH-854]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Add support in the viewer to display the Scripted column on the linksets floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-856 PATH-856]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>As a user, I want to see a notification when I am toggling the phantom flag on a linkset through the Pathfinding Linkset floater</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (263727)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1480 MAINT-1480]</del> <del>[https://jira.secondlife.com/browse/VWR-29562 VWR-29562]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>llSetRot does not clear TargetOmega rotation</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1506 MAINT-1506]</del> <del>[https://jira.secondlife.com/browse/VWR-29644 VWR-29644]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Keyframe Motion leads the Second Life Beta Viewer - version 3.4.0 (264194) to unexpected results.</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-864 PATH-864]</del> <del>[https://jira.secondlife.com/browse/PATHBUG-184 PATHBUG-184]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Allow the Linkset floater to shrink smaller than actually</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264601)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/MAINT-1561 MAINT-1561]</del> <del>[https://jira.secondlife.com/browse/BUG-86 BUG-86]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Pendulum motion is incorrect after world view is out of focus</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264785)
|-
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>[https://jira.secondlife.com/browse/PATH-880 PATH-880]</del> <del>[https://jira.secondlife.com/browse/PATHBUG-189 PATHBUG-189]</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | <del>Characters Waking Sideways and Backwards</del>
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" |
| style="border-style:solid;border-width:0 0 1px 0;border-color:rgb(200,200,200)" | 3.4.0 (264785)
|}

Talk:Smart Scripting

2012-07-17T19:56:07Z

Dark Mole:

What are we expected to put here? It is so vague that I have no idea where to start. Smart scripting means writing out a plan, thinking carefully about it, and editing the plan. Eventually you implement your plan.

Another question: if we write something up can we have it checked by Lindens familiar with the LSO and mono VM's. When it comes to scripting there is more superstition then real data out there.

Talk:Smart Scripting

2012-06-12T17:52:10Z

Dark Mole: Created page with "What are we expected to put here? It is so vague that I have no idea where to start. Smart scripting means writing out a plan, thinking carefully about it, and editing the plan. …"