Ambient ai.xls - Revision history

Sunjammer: Converting to new format

2012-03-22T14:23:01Z

Converting to new format

BloodsongVengeance: posted link to the xls file i uploaded to google docs.

2011-03-13T14:15:39Z

posted link to the xls file i uploaded to google docs.

BryanDerksen: Category:XLS files

2010-01-28T17:28:46Z

Category:XLS files

BryanDerksen at 21:43, 31 July 2009

2009-07-31T21:43:41Z

BryanDerksen: merging into ambient behavior

2009-07-31T21:43:05Z

merging into ambient behavior

BryanDerksen at 21:23, 31 July 2009

2009-07-31T21:23:54Z

BryanDerksen at 21:22, 31 July 2009

2009-07-31T21:22:33Z

BryanDerksen: Created page with 'Ambient Behaviour System Ambient behaviour begins when the player moves within 50m of a creature and ceases when the player remains more than 50m away for at least 40s. Ambient...'

2009-07-31T21:22:06Z

Created page with 'Ambient Behaviour System Ambient behaviour begins when the player moves within 50m of a creature and ceases when the player remains more than 50m away for at least 40s. Ambient...'

New page

Ambient Behaviour System

Ambient behaviour begins when the player moves within 50m of a creature and ceases when the player remains more than 50m away for at least 40s. Ambient behaviour alternates between a movement phase and an animation phase, simulating a bubble of activity around the player. In a movement phase, the creature (optionally) moves to a new waypoint or location. In an animation phase, the creature (optionally) performs one or more animations either in sequence or at random. Exact behaviour is controlled by local variables set on either the creature instance or template (see table below). All other local variables with the prefix AMBIENT_* are used internally by the ambient behaviour system (see script sys_ambient_h.nss) and should not be manually modified. Never directly modify AMBIENT_* local variables at run time using SetLocalInteger() - always use the functions Ambient_Start(), Ambient_Stop(), Ambient_OverrideBehaviour(), and Ambient_RestoreBehaviour() instead.

The actions used in an animation phase are listed in the ambient_anim_patterns worksheet of ambient_ai.xls. Each row defines a series actions, each composed of an animation (left of the decimal) and a loop count (right of decimal). For example, 619.02 will play a sleeping animation for 2 loops and 619.99 will play an infinitely looping sleeping animation. Non-looping animations require no looping (i.e. decimal) component. The list of all available animations is located in ANIM_base.xls.

{| cellpadding="2" cellspacing="0" border="1"
|-
! Local Variable Name !! Type !! Default !! Description
|-
| AMBIENT_SYSTEM_STATE
| align=center | int
| align=center | 0
| Bitmask controlling ambient system operation (ergo, values below are in hexadecimal).
* 0x01 (AMBIENT_SYSTEM_ENABLED) = Ambient behaviour enabled.
* 0x02 (AMBIENT_SYSTEM_SPAWNSTART) = Begin ambient behaviour immediately after spawning.
* 0x04 (AMBIENT_SYSTEM_NOPLAYNEXT) = Sets PlayNext parameter to CommandPlayAnimation() to false.
* 0x08 (AMBIENT_SYSTEM_NOBLEND) = Sets BlendIn parameter to CommandPlayAnimation to false.
* 0x10 (AMBIENT_SYSTEM_ALWAYSON) = Ambient behaviour never stops, regardless of distance to player.
|-
| AMBIENT_MOVE_PATTERN
| align=center | int
| align=center | 0
| Dictates how the creature moves. Add 100 to values below make creature run instead of walk.
* 0 (AMBIENT_MOVE_NONE) = No movement
* 1 (AMBIENT_MOVE_PATROL) = Patrol waypoints (1, 2, 3, 2, 1, …)
* 2 (AMBIENT_MOVE_LOOP) = Loop through waypoints (1, 2, 3, 1, 2, 3, ...)
* 3 (AMBIENT_MOVE_WARP) = Jump creature from the last waypoint to the first (1, 2, 3, jump to 1, 2, 3, …)
* 4 (AMBIENT_MOVE_RANDOM) = Walk to random waypoints
* 5 (AMBIENT_MOVE_WANDER) = Walk to random location within 5m of home location
* 6 (AMBIENT_MOVE_WANDER_FAR) = Walk to random location within 20m of home location
* 7 (AMBIENT_MOVE_PATH_PATROL) = Patrol waypoints using CommandMoveToMultiLocations() (1-2-3, 1-2-3, ...)
* 8 (AMBIENT_MOVE_PATH_LOOP) = Loop through waypoints using CommandMoveToMultiLocations() (1-2-3, 1-2-3, ...)
* 9 (AMBIENT_MOVE_ONCE) = Walk through the waypoint set once (1-2-3)
|-
| AMBIENT_MOVE_PREFIX
| align=center | string
| align=center | ap_<tag>
| The prefix used to determine the waypoints the creature travels to. Note that '<tag>' is a placeholder filled in at run-time with the tag of the creature. Hence, if a creature has the tag 'dog' and AMBIENT_MOVE_PREFIX is set to 'ap_<tag>', the system will first look for waypoints with tags corresponding to; ap_dog_01, ap_dog_02, etc. If no such waypoints are found, it will attempt to look for waypoints with the tag 'ap_dog'.
|-
| AMBIENT_ANIM_PATTERN
| align=center | int
| align=center | 0
| Index into ambient_ai.xls specifiying list of possible actions to perform during an animation phase.
|-
| AMBIENT_ANIM_FREQ
| align=center | float
| align=center | -1.0
| Animation frequency. The portion left of decimal specifies the minimum and the portion right of the decimal specifies the maximum number of animations to play during an animation phase (e.g. 2.4 will play between 2 and 4 animations randomly selected from the appropriate animation pattern). A value of -1.0 causes all animations for an animation pattern to play in the order listed in ambient_ai.xls. Animation pattens that are highlighted in green on the worksheeet should always be played in order (i.e. AMBIENT_ANIM_FREQ = -1.0).
|-
| AMBIENT_COMMAND
| align=center | int
| align=center | 0
| If non-zero, this value forces the creature to perform a specific command (instead of moving and animating).
*1 = Attack target, waiting 1-4s between attacks. Target's tag must be: <attacker tag>_target
*2 = Attack a target. Target's tag must be: <attacker tag>_target
|}

{{2da start|ambient_anim_patterns}}
{{2da column|Label|string|Anything in green MUST be played in order.}}
{{2da column|NoPlayNext|int|Sets bPlayNext parameter used with CommandPlayAnimation() function to FALSE.}}
{{2da column|ActionTotal|int|}}
{{2da column|Action0|float|Format: Animation.Loops}}
{{2da column|Action1|float|}}
{{2da column|Action2|float|}}
{{2da column|Action3|float|}}
{{2da column|Action4|float|}}
{{2da column|Action5|float|}}
{{2da column|Action6|float|}}
{{2da column|Action7|float|}}
{{2da column|Action8|float|}}
{{2da column|Action9|float|}}
{{2da column|Action10|float|}}
{{2da column|Action11|float|}}
{{2da column|Action12|float|}}
{{2da end}}

@@ Line 19: / Line 19: @@
 {{2da column|Action12|float|}}
 {{2da end}}
 [[Category:Ambient behavior]]
 [[Category:XLS files]]

← Older revision		Revision as of 17:28, 28 January 2010
Line 21:		Line 21:

	[[Category:Ambient behavior]]		[[Category:Ambient behavior]]
−	[[Category:~~2DAs~~]]	+	[[Category:XLS files]]

← Older revision		Revision as of 21:43, 31 July 2009
Line 21:		Line 21:

	[[Category:Ambient behavior]]		[[Category:Ambient behavior]]
		+	[[Category:2DAs]]

@@ Line 1: / Line 1: @@
 Ambient Behaviour System
-Ambient behaviour begins when the player moves within 50m of a creature and ceases when the player remains more than 50m away for at least 40s. Ambient behaviour alternates between a movement phase and an animation phase, simulating a bubble of activity around the player. In a movement phase, the creature (optionally) moves to a new waypoint or location. In an animation phase, the creature (optionally) performs one or more animations either in sequence or at random. Exact behaviour is controlled by local variables set on either the creature instance or template (see table below). All other local variables with the prefix AMBIENT_* are used internally by the ambient behaviour system (see script sys_ambient_h.nss) and should not be manually modified. Never directly modify AMBIENT_* local variables at run time using SetLocalInteger() - always use the functions Ambient_Start(), Ambient_Stop(), Ambient_OverrideBehaviour(), and Ambient_RestoreBehaviour() instead.
+Ambient behaviour begins when the player moves within 50m of a creature and ceases when the player remains more than 50m away for at least 40s. Ambient behaviour alternates between a movement phase and an animation phase, simulating a bubble of activity around the player. In a movement phase, the creature (optionally) moves to a new waypoint or location. In an animation phase, the creature (optionally) performs one or more animations either in sequence or at random. Exact behaviour is controlled by local variables set on either the creature instance or template (see table below). All other local variables with the prefix AMBIENT_* are used internally by the ambient behaviour system (see script [[sys_ambient_h]].nss) and should not be manually modified. Never directly modify AMBIENT_* local variables at run time using [[SetLocalInteger]]() - always use the functions [[Ambient_Start]](), [[Ambient_Stop]](), [[Ambient_OverrideBehaviour]](), and [[Ambient_RestoreBehaviour]]() instead.
 The actions used in an animation phase are listed in the ambient_anim_patterns worksheet of ambient_ai.xls. Each row defines a series actions, each composed of an animation (left of the decimal) and a loop count (right of decimal). For example, 619.02 will play a sleeping animation for 2 loops and 619.99 will play an infinitely looping sleeping animation. Non-looping animations require no looping (i.e. decimal) component. The list of all available animations is located in [[ANIM_base.xls]].

@@ Line 1: / Line 1: @@
-See [[Ambient behaviour]] for details on how this information is used.
+The [[ambient_ai.xls]] file contains the [[2da]] files that define the ambient animation patterns which form part of the [[ambient behaviour]]s for non-player characters and creatures.
-{{2da start|ambient_anim_patterns}}
+The workbook contains the following worksheets:
-{{2da column|Label|string|Anything in green MUST be played in order.}}
-{{2da column|NoPlayNext|int|Sets bPlayNext parameter used with CommandPlayAnimation() function to FALSE.}}
-{{2da column|ActionTotal|int|}}
-{{2da column|Action0|float|Format: Animation.Loops}}
-{{2da column|Action1|float|}}
-{{2da column|Action2|float|}}
-{{2da column|Action3|float|}}
-{{2da column|Action4|float|}}
-{{2da column|Action5|float|}}
-{{2da column|Action6|float|}}
-{{2da column|Action7|float|}}
-{{2da column|Action8|float|}}
-{{2da column|Action9|float|}}
-{{2da column|Action10|float|}}
-{{2da column|Action11|float|}}
-{{2da column|Action12|float|}}
-{{2da end}}
-[https://spreadsheets.google.com/ccc?key=0AsMdSm0VGixjdGtKRzJnaC0xcWhsQUlNZnpLMkRJTHc&hl=en&authkey=CNrsmsQI#gid=1 ambient_ai.xls on Google Docs.]
+* _read_me
-[[Category:Ambient behavior]]
+[[Category:Ambient behaviours]]
 [[Category:XLS files]]

@@ Line 1: / Line 1: @@
-Ambient Behaviour System
+See [[Ambient behaviour]] for details on how this information is used.
-−
-Ambient behaviour begins when the player moves within 50m of a creature and ceases when the player remains more than 50m away for at least 40s. Ambient behaviour alternates between a movement phase and an animation phase, simulating a bubble of activity around the player. In a movement phase, the creature (optionally) moves to a new waypoint or location. In an animation phase, the creature (optionally) performs one or more animations either in sequence or at random. Exact behaviour is controlled by local variables set on either the creature instance or template (see table below). All other local variables with the prefix AMBIENT_* are used internally by the ambient behaviour system (see script [[sys_ambient_h]].nss) and should not be manually modified. Never directly modify AMBIENT_* local variables at run time using [[SetLocalInteger]]() - always use the functions [[Ambient_Start]](), [[Ambient_Stop]](), [[Ambient_OverrideBehaviour]](), and [[Ambient_RestoreBehaviour]]() instead.
-−
-The actions used in an animation phase are listed in the ambient_anim_patterns worksheet of ambient_ai.xls. Each row defines a series actions, each composed of an animation (left of the decimal) and a loop count (right of decimal). For example, 619.02 will play a sleeping animation for 2 loops and 619.99 will play an infinitely looping sleeping animation. Non-looping animations require no looping (i.e. decimal) component. The list of all available animations is located in [[ANIM_base.xls]].
-−
-{| cellpadding="2" cellspacing="0" border="1"
-|-
-! Local Variable Name !! Type !! Default !! Description
-|-
-| AMBIENT_SYSTEM_STATE
-| align=center | int
-| align=center | 0
-| Bitmask controlling ambient system operation (ergo, values below are in hexadecimal).
-* 0x01 (AMBIENT_SYSTEM_ENABLED) = Ambient behaviour enabled.
-* 0x02 (AMBIENT_SYSTEM_SPAWNSTART) = Begin ambient behaviour immediately after spawning.
-* 0x04 (AMBIENT_SYSTEM_NOPLAYNEXT) = Sets PlayNext parameter to CommandPlayAnimation() to false.
-* 0x08 (AMBIENT_SYSTEM_NOBLEND) = Sets BlendIn parameter to CommandPlayAnimation to false.
-* 0x10 (AMBIENT_SYSTEM_ALWAYSON) = Ambient behaviour never stops, regardless of distance to player.
-|-
-| AMBIENT_MOVE_PATTERN
-| align=center | int
-| align=center | 0
-| Dictates how the creature moves. Add 100 to values below make creature run instead of walk.
-* 0 (AMBIENT_MOVE_NONE) = No movement
-* 1 (AMBIENT_MOVE_PATROL) = Patrol waypoints (1, 2, 3, 2, 1, …)
-* 2 (AMBIENT_MOVE_LOOP) = Loop through waypoints (1, 2, 3, 1, 2, 3, ...)
-* 3 (AMBIENT_MOVE_WARP) = Jump creature from the last waypoint to the first (1, 2, 3, jump to 1, 2, 3, …)
-* 4 (AMBIENT_MOVE_RANDOM) = Walk to random waypoints
-* 5 (AMBIENT_MOVE_WANDER) = Walk to random location within 5m of home location
-* 6 (AMBIENT_MOVE_WANDER_FAR) = Walk to random location within 20m of home location
-* 7 (AMBIENT_MOVE_PATH_PATROL) = Patrol waypoints using CommandMoveToMultiLocations() (1-2-3, 1-2-3, ...)
-* 8 (AMBIENT_MOVE_PATH_LOOP) = Loop through waypoints using CommandMoveToMultiLocations() (1-2-3, 1-2-3, ...)
-* 9 (AMBIENT_MOVE_ONCE) = Walk through the waypoint set once (1-2-3)
-|-
-| AMBIENT_MOVE_PREFIX
-| align=center | string
-| align=center | ap_<tag>
-| The prefix used to determine the waypoints the creature travels to. Note that '<tag>' is a placeholder filled in at run-time with the tag of the creature. Hence, if a creature has the tag 'dog' and AMBIENT_MOVE_PREFIX is set to 'ap_<tag>', the system will first look for waypoints with tags corresponding to; ap_dog_01, ap_dog_02, etc. If no such waypoints are found, it will attempt to look for waypoints with the tag 'ap_dog'.
-|-
-| AMBIENT_ANIM_PATTERN
-| align=center | int
-| align=center | 0
-| Index into ambient_ai.xls specifiying list of possible actions to perform during an animation phase.
-|-
-| AMBIENT_ANIM_FREQ
-| align=center | float
-| align=center | -1.0
-| Animation frequency. The portion left of decimal specifies the minimum and the portion right of the decimal specifies the maximum number of animations to play during an animation phase (e.g. 2.4 will play between 2 and 4 animations randomly selected from the appropriate animation pattern). A value of -1.0 causes all animations for an animation pattern to play in the order listed in ambient_ai.xls. Animation pattens that are highlighted in green on the worksheeet should always be played in order (i.e. AMBIENT_ANIM_FREQ = -1.0).
-|-
-| AMBIENT_COMMAND
-| align=center | int
-| align=center | 0
-| If non-zero, this value forces the creature to perform a specific command (instead of moving and animating).
-*1 = Attack target, waiting 1-4s between attacks. Target's tag must be: <attacker tag>_target
-*2 = Attack a target. Target's tag must be: <attacker tag>_target
-|}
 {{2da start|ambient_anim_patterns}}
@@ Line 75: / Line 19: @@
 {{2da column|Action12|float|}}
 {{2da end}}