Behavior Simulation Node Library

The omni.anim.behavior.tree extension provides the behavior simulation node library. These are nodes available for use when the Behavior Tree extensions (omni.behavior.tree.bundle) are enabled.

Action Nodes

Action nodes are leaf nodes that perform work and return a status.

Type	Description	Ports
Idle	Agent task to stand idle.	facing · float3 or SdfPath · optional duration · float · default 0.0
MoveTo	Agent task to move to a target.	target · float3 or SdfPath auto_brake · bool · default true
MoveAlong	Agent task to move along a basis curve.	target · SdfPath start_from_closest_point · bool · default false auto_brake · bool · default true
Follow	Agent task to follow a target.	target · SdfPath distance · float · default -1.0
Dodge	Agent task to dodge towards a direction.	direction · float3 · default 0.0, 0.0, 1.0 motion_scale · float · default 1.0
Fall	(Experimental) Agent task to fall to the ground with ragdoll physics. Only available when /exts/omni.anim.behavior.core/enableRagdollPhysics is enabled.	(none)
Sit	Agent task to sit on a target.	target · SdfPath snap_to_seat · bool · default false
PickupObject	Agent task to pick up an object.	target · SdfPath snap_to_hand · bool · default false
PlaceObject	Agent task to place a held object.	target · SdfPath xform · SdfPath
ReleaseObject	Agent task to release a held object.	target · SdfPath
LookAt	Agent task to look at a target.	target · SdfPath duration · float · default 0.0
ReachHand	Agent task to reach a hand towards a target.	hand_usage · enum target · SdfPath palm_direction · float3 · optional finger_direction · float3 · optional duration · float · default 0.0 motion_scale · float · default 1.0
PoseHand	Agent task to pose hands to a preset pose.	hand_usage · enum preset · enum duration · float · default 0.0
CustomAction	Agent task to perform a custom action by imported action name.	action · string root_animation · enum duration · float · default 0.0
Reset	Agent will reset state at a target.	target · float3 or SdfPath facing · float3 or SdfPath · optional
Teleport	Agent will teleport to a target.	target · float3 or SdfPath facing · float3 or SdfPath · optional
SetSpeed	Sets the agent locomotion speed.	speed · float · default -1.0
SetNavMeshAreas	Sets the navmesh areas the agent is allowed to traverse.	areas · string[]

Modifier Types

Modifiers attach to any node and wrap its execution. They support Abort Mode for reactive behavior (see Behavior Simulation User Guide for details on abort modes).

Type	Description	Input Ports	Output Ports
CheckTaskName	Checks the name of the current running task.	task_name · SdfPath invert_condition · bool · false
CheckAgentDistance	Checks agent’s distance to a target within distance.	target · SdfPath distance · float · default 100.0 comparison · enum invert_condition · bool · false
CheckNavMeshPathExists	Checks if navigable path exists to a target.	target · float3 or SdfPath invert_condition · bool · false
RandomNavMeshPoint	Samples a random point on the navmesh. Value is cached until reset.	center · float3 or SdfPath · optional radius · float2 · optional area_probabilities · float[] · optional