Class FollowerEntity Extends VersionedMonoBehaviour, IAstarAI, ISerializationCallbackReceiver

void DrawGizmos ()

void GetRemainingPath (

List<Vector3>	buffer	The buffer will be cleared and replaced with the path. The first point is the current position of the agent.
out bool	stale	May be true if the path is invalid in some way. For example if the agent has no path or (for the RichAI script only) if the agent has detected that some nodes in the path have been destroyed.

)

Fills buffer with the remaining path.

var buffer = new List<Vector3>();

ai.GetRemainingPath(buffer, out bool stale);
for (int i = 0; i < buffer.Count - 1; i++) {
Debug.DrawLine(buffer[i], buffer[i+1], Color.red);
}


void Move (

Vector3

deltaPosition

Direction and distance to move the agent in world space.

)

Move the agent.

This is intended for external movement forces such as those applied by wind, conveyor belts, knockbacks etc.

Some movement scripts may ignore this completely (notably the AILerp script) if it does not have any concept of being moved externally.

The agent will not be moved immediately when calling this method. Instead this offset will be stored and then applied the next time the agent runs its movement calculations (which is usually later this frame or the next frame). If you want to move the agent immediately then call: ai.Move(someVector);
ai.FinalizeMovement(ai.position, ai.rotation);


void SearchPath ()

Recalculate the current path.

You can for example use this if you want very quick reaction times when you have changed the destination so that the agent does not have to wait until the next automatic path recalculation (see canSearch).

If there is an ongoing path calculation, it will be canceled, so make sure you leave time for the paths to get calculated before calling this function again. A canceled path will show up in the log with the message "Canceled by script" (see Seeker.CancelCurrentPathRequest).

If no destination has been set yet then nothing will be done.

void SetDestination (

float3	destination
float3	facingDirection=default

)

Set the position in the world that this agent should move to.

Note that setting this property does not immediately cause the agent to recalculate its path. So it may take some time before the agent starts to move towards this point. How often the agent searches for a new path is controlled by the autoRepath property.

If you are setting a destination and then want to know when the agent has reached that destination then you could either use reachedDestination or reachedEndOfPath. Check the documentation for the respective fields to learn about their differences.

You may also set a facing direction for the agent. If set, the agent will try to approach the destination point with the given heading. Note that reachedDestination and reachedEndOfPath do not take the facing direction into account. The MovementSettings.follower.leadInRadiusWhenApproachingDestination field controls how wide an arc the agent will try to use when approaching the destination.

void SetPath (

Path	path	The path to follow.
bool	updateDestinationFromPath=true	If true, the destination property will be set to the end point of the path. If false, the previous destination value will be kept.

)

Make the AI follow the specified path.

In case the path has not been calculated, the script will call seeker.StartPath to calculate it. This means the AI may not actually start to follow the path until in a few frames when the path has been calculated. The pathPending field will as usual return true while the path is being calculated.

In case the path has already been calculated it will immediately replace the current path the AI is following. This is useful if you want to replace how the AI calculates its paths. Note that if you calculate the path using seeker.StartPath then this script will already pick it up because it is listening for all paths that the Seeker finishes calculating. In that case you do not need to call this function.

If you pass null as a parameter then the current path will be cleared and the agent will stop moving. Note than unless you have also disabled canSearch then the agent will soon recalculate its path and start moving again.

You can disable the automatic path recalculation by setting the canSearch field to false.

// Disable the automatic path recalculation
ai.canSearch = false;
var pointToAvoid = enemy.position;
// Make the AI flee from the enemy.
// The path will be about 20 world units long (the default cost of moving 1 world unit is 1000).
var path = FleePath.Construct(ai.position, pointToAvoid, 1000 * 20);
ai.SetPath(path);

// If you want to make use of properties like ai.reachedDestination or ai.remainingDistance or similar
// you should also set the destination property to something reasonable.
// Since the agent's own path recalculation is disabled, setting this will not affect how the paths are calculated.
// ai.destination = ...


void Teleport (

Vector3	newPosition
bool	clearPath=true

)

Instantly move the agent to a new position.

This will trigger a path recalculation (if clearPath is true, which is the default) so if you want to teleport the agent and change its destination it is recommended that you set the destination before calling this method.

The current path will be cleared by default.

This method is preferred for long distance teleports. If you only move the agent a very small distance (so that it is reasonable that it can keep its current path), then setting the position property is preferred. When using the FollowerEntity movement script, setting the position property when using a long distance teleport could cause the agent to fail to move the full distance, as it can get blocked by the navmesh.

AutoRepathPolicy autoRepath

Policy for when the agent recalculates its path.

bool canMove

Enables or disables movement completely.

If you want the agent to stand still, but still react to local avoidance and use gravity: use isStopped instead.

This is also useful if you want to have full control over when the movement calculations run. Take a look at MovementUpdate

GraphNode currentNode

Node which the agent is currently traversing.

You can for example use this to make the agent use a different animation when traversing nodes with a specific tag.

When traversing off-mesh links, this will return the final non-link node in the path before the agent starts traversing the link.

PIDMovement.DebugFlags debugFlags

Enables or disables debug drawing for this agent.

This is a bitmask with multiple flags so that you can choose exactly what you want to debug.

Vector3 desiredVelocity

Velocity that this agent wants to move with.

Includes gravity and local avoidance if applicable. In world units per second.

Vector3 desiredVelocityWithoutLocalAvoidance

Velocity that this agent wants to move with before taking local avoidance into account.

Includes gravity. In world units per second.

Setting this property will set the current velocity that the agent is trying to move with, including gravity. This can be useful if you want to make the agent come to a complete stop in a single frame or if you want to modify the velocity in some way.

// Set the velocity to zero, but keep the current gravity
var newVelocity = new Vector3(0, ai.desiredVelocityWithoutLocalAvoidance.y, 0);

ai.desiredVelocityWithoutLocalAvoidance = newVelocity;


If you are not using local avoidance then this property will in almost all cases be identical to desiredVelocity plus some noise due to floating point math.

Vector3? destination

Position in the world that this agent should move to.

If no destination has been set yet, then (+infinity, +infinity, +infinity) will be returned.

Note that setting this property does not immediately cause the agent to recalculate its path. So it may take some time before the agent starts to move towards this point. Most movement scripts have a repathRate field which indicates how often the agent looks for a new path. You can also call the SearchPath method to immediately start to search for a new path. Paths are calculated asynchronously so when an agent starts to search for path it may take a few frames (usually 1 or 2) until the result is available. During this time the pathPending property will return true.

If you are setting a destination and then want to know when the agent has reached that destination then you could either use reachedDestination (recommended) or check both pathPending and reachedEndOfPath. Check the documentation for the respective fields to learn about their differences.

IEnumerator Start () {
ai.destination = somePoint;
// Start to search for a path to the destination immediately
ai.SearchPath();
// Wait until the agent has reached the destination
while (!ai.reachedDestination) {
yield return null;
}
// The agent has reached the destination now
}
IEnumerator Start () {
ai.destination = somePoint;
// Start to search for a path to the destination immediately
// Note that the result may not become available until after a few frames
// ai.pathPending will be true while the path is being calculated
ai.SearchPath();
// Wait until we know for sure that the agent has calculated a path to the destination we set above
while (ai.pathPending || !ai.reachedEndOfPath) {
yield return null;
}
// The agent has reached the destination now
}


bool enableGravity

Enables or disables movement completely.

If you want the agent to stand still, but still react to local avoidance and use gravity: use isStopped instead.

This is also useful if you want to have full control over when the movement calculations run. Take a look at MovementUpdate

bool enableLocalAvoidance

True if local avoidance is enabled for this agent.

Enabling this will automatically add a Pathfinding.ECS.RVO.RVOAgent component to the entity.

Vector3? endOfPath

End point of path the agent is currently following.

If the agent has no path (or it might not be calculated yet), this will return the destination instead. If the agent has no destination it either it will return (+inf,+inf,+inf).

The end of the path is usually identical or very close to the destination, but it may differ if the path for example was blocked by a wall so that the agent couldn't get any closer.

This is only updated when the path is recalculated.

Entity entity

Entity which this movement script represents.

An entity will be created when this script is enabled, and destroyed when this script is disabled.

See the documentation for this class to see which components it usually has, and what systems typically affect it.

bool entityExists

True if this component's entity exists.

This is typically true if the component is active and enabled and the game is running.

LayerMask groundMask

Determines which layers the agent will stand on.

The agent will use a raycast each frame to see if it should stop falling.

This layer mask should ideally not contain the agent's own layer, if the agent has a collider, as this may cause it to try to stand on top of itself.

bool hasPath

True if this agent currently has a path that it follows.

float height

Height of the agent in world units.

This is visualized in the scene view as a yellow cylinder around the character.

This value is currently only used if an RVOController is attached to the same GameObject, otherwise it is only used for drawing nice gizmos in the scene view. However since the height value is used for some things, the radius field is always visible for consistency and easier visualization of the character. That said, it may be used for something in a future release.

bool isStopped

Gets or sets if the agent should stop moving.

If this is set to true the agent will immediately start to slow down as quickly as it can to come to a full stop. The agent will still react to local avoidance and gravity (if applicable), but it will not try to move in any particular direction.

The current path of the agent will not be cleared, so when this is set to false again the agent will continue moving along the previous path.

This is a purely user-controlled parameter, so for example it is not set automatically when the agent stops moving because it has reached the target. Use reachedEndOfPath for that.

If this property is set to true while the agent is traversing an off-mesh link (RichAI script only), then the agent will continue traversing the link and stop once it has completed it.

The steeringTarget property will continue to indicate the point which the agent would move towards if it would not be stopped.

bool isTraversingOffMeshLink

True if the agent is currently traversing an off-mesh link.

float maxSpeed

Max speed in world units per second.

NativeMovementPlane movementPlane

The plane the agent is moving in.

This is typically the ground plane, which will be the XZ plane in a 3D game, and the XY plane in a 2D game. Ultimately it depends on the graph orientation.

If you are doing pathfinding on a spherical world (see Spherical Worlds), the the movement plane will be the tangent plane of the sphere at the agent's position.

MovementSettings movementSettings

Various movement settings.

Some of these settings are exposed on the FollowerEntity directly. For example maxSpeed.

PathTracer.LinkInfo offMeshLink

The off-mesh link that the agent is currently traversing.

This will be a default PathTracer.LinkInfo if the agent is not traversing an off-mesh link (the PathTracer.LinkInfo.link field will be null).

Action onSearchPath

Called when the agent recalculates its path.

This is called both for automatic path recalculations (see canSearch) and manual ones (see SearchPath).

IOffMeshLinkHandler onTraverseOffMeshLink

Callback to be called when an agent starts traversing an off-mesh link.

The handler will be called when the agent starts traversing an off-mesh link. It allows you to to control the agent for the full duration of the link traversal.

Use the passed context struct to get information about the link and to control the agent.

using UnityEngine;
using Pathfinding;
using System.Collections;
using Pathfinding.ECS;

public class FollowerJumpLink : MonoBehaviour, IOffMeshLinkHandler, IOffMeshLinkStateMachine {
// Register this class as the handler for off-mesh links when the component is enabled
void OnEnable() => GetComponent<NodeLink2>().onTraverseOffMeshLink = this;
void OnDisable() => GetComponent<NodeLink2>().onTraverseOffMeshLink = null;

IOffMeshLinkStateMachine IOffMeshLinkHandler.GetOffMeshLinkStateMachine(AgentOffMeshLinkTraversalContext context) => this;

void IOffMeshLinkStateMachine.OnFinishTraversingOffMeshLink (AgentOffMeshLinkTraversalContext context) {
Debug.Log("An agent finished traversing an off-mesh link");
}

void IOffMeshLinkStateMachine.OnAbortTraversingOffMeshLink () {
Debug.Log("An agent aborted traversing an off-mesh link");
}

IEnumerable IOffMeshLinkStateMachine.OnTraverseOffMeshLink (AgentOffMeshLinkTraversalContext ctx) {
var start = (Vector3)ctx.linkInfo.firstPosition;
var end = (Vector3)ctx.linkInfo.secondPosition;
var dir = end - start;

// Disable local avoidance while traversing the off-mesh link.
// If it was enabled, it will be automatically re-enabled when the agent finishes traversing the link.
ctx.DisableLocalAvoidance();

// Move and rotate the agent to face the other side of the link.
// When reaching the off-mesh link, the agent may be facing the wrong direction.
while (!ctx.MoveTowards(
position: start,
rotation: Quaternion.LookRotation(dir, ctx.movementPlane.up),
gravity: true,
slowdown: true).reached) {
yield return null;
}

var bezierP0 = start;
var bezierP1 = start + Vector3.up*5;
var bezierP2 = end + Vector3.up*5;
var bezierP3 = end;
var jumpDuration = 1.0f;

// Animate the AI to jump from the start to the end of the link
for (float t = 0; t < jumpDuration; t += ctx.deltaTime) {
ctx.transform.Position = AstarSplines.CubicBezier(bezierP0, bezierP1, bezierP2, bezierP3, Mathf.SmoothStep(0, 1, t / jumpDuration));
yield return null;
}
}
}


You can alternatively set the corresponding property property on the off-mesh link ( NodeLink2.onTraverseOffMeshLink) to specify a callback for a specific off-mesh link.

bool pathPending

True if a path is currently being calculated.

refPathRequestSettings pathfindingSettings

Pathfinding settings.

Vector3 position

Position of the agent.

In world space.

If you want to move the agent you may use Teleport or Move.

float radius

Radius of the agent in world units.

This is visualized in the scene view as a yellow cylinder around the character.

bool reachedDestination

True if the ai has reached the destination.

This is a best effort calculation to see if the destination has been reached. For the AIPath/RichAI scripts, this is when the character is within AIPath.endReachedDistance world units from the destination. For the AILerp script it is when the character is at the destination (±a very small margin).

This value will be updated immediately when the destination is changed (in contrast to reachedEndOfPath), however since path requests are asynchronous it will use an approximation until it sees the real path result. What this property does is to check the distance to the end of the current path, and add to that the distance from the end of the path to the destination (i.e. is assumes it is possible to move in a straight line between the end of the current path to the destination) and then checks if that total distance is less than AIPath.endReachedDistance. This property is therefore only a best effort, but it will work well for almost all use cases.

Furthermore it will not report that the destination is reached if the destination is above the head of the character or more than half the height of the character below its feet (so if you have a multilevel building, it is important that you configure the height of the character correctly).

The cases which could be problematic are if an agent is standing next to a very thin wall and the destination suddenly changes to the other side of that thin wall. During the time that it takes for the path to be calculated the agent may see itself as alredy having reached the destination because the destination only moved a very small distance (the wall was thin), even though it may actually be quite a long way around the wall to the other side.

In contrast to reachedEndOfPath, this property is immediately updated when the destination is changed.

IEnumerator Start () {
ai.destination = somePoint;
// Start to search for a path to the destination immediately
ai.SearchPath();
// Wait until the agent has reached the destination
while (!ai.reachedDestination) {
yield return null;
}
// The agent has reached the destination now
}


bool reachedEndOfPath

True if the agent has reached the end of the current path.

Note that setting the destination does not immediately update the path, nor is there any guarantee that the AI will actually be able to reach the destination that you set. The AI will try to get as close as possible. Often you want to use reachedDestination instead which is easier to work with.

It is very hard to provide a method for detecting if the AI has reached the destination that works across all different games because the destination may not even lie on the navmesh and how that is handled differs from game to game (see also the code snippet in the docs for destination).

float remainingDistance

Approximate remaining distance along the current path to the end of the path.

The RichAI movement script approximates this distance since it is quite expensive to calculate the real distance. However it will be accurate when the agent is within 1 corner of the destination. You can use GetRemainingPath to calculate the actual remaining path more precisely.

The AIPath and AILerp scripts use a more accurate distance calculation at all times.

If the agent does not currently have a path, then positive infinity will be returned.

Quaternion? rotation

Rotation of the agent.

In world space.

float rotationSmoothing

How much to smooth the visual rotation of the agent.

This does not affect movement, but smoothes out how the agent rotates visually.

Recommended values are between 0.0 and 0.5. A value of zero will disable smoothing completely.

The smoothing is done primarily using an exponential moving average, but with a small linear term to the rotation converge faster when the agent is almost facing the desired direction.

Adding smoothing will make the visual rotation of the agent lag a bit behind the actual rotation. Too much smoothing may make the agent seem sluggish, and appear to move sideways.

The unit for this field is seconds.

refRVOAgent rvoAgent

Local avoidance settings.

Vector3 steeringTarget

Point on the path which the agent is currently moving towards.

This is usually a point a small distance ahead of the agent or the end of the path.

If the agent does not have a path at the moment, then the agent's current position will be returned.

float stopDistance

How far away from the destination should the agent aim to stop, in world units.

If the agent is within this distance from the destination point it will be considered to have reached the destination.

Even if you want the agent to stop precisely at a given point, it is recommended to keep this slightly above zero. If it is exactly zero, the agent may have a hard time deciding that it has actually reached the end of the path, due to floating point errors and such.

bool updatePosition

Determines if the character's position should be coupled to the Transform's position.

If false then all movement calculations will happen as usual, but the object that this component is attached to will not move instead only the position property and the internal entity will change.

This is useful if you want to control the movement of the character using some other means such as for example root motion but still want the AI to move freely.

bool updateRotation

Determines if the character's rotation should be coupled to the Transform's rotation.

If false then all movement calculations will happen as usual, but the object that this component is attached to will not rotate instead only the rotation property and the internal entity's rotation will change.

When this is disabled, a gizmos arrow will be drawn in the scene view to indicate the agent's internal rotation.

Vector3 velocity

Actual velocity that the agent is moving with.

In world units per second.

void AssertEntityExists ()

void Awake ()

void CancelCurrentPathRequest ()

void ClearPath ()

void IAstarAI. FinalizeMovement (

Vector3	nextPosition
Quaternion	nextRotation

)

Move the agent.

To be called as the last step when you are handling movement manually.

The movement will be clamped to the navmesh if applicable (this is done for the RichAI movement script).

void FindComponents ()

FollowerEntityMigrations

void IAstarAI. MovementUpdate (

float	deltaTime	time to simulate movement for. Usually set to Time.deltaTime.
out Vector3	nextPosition	the position that the agent wants to move to during this frame.
out Quaternion	nextRotation	the rotation that the agent wants to rotate to during this frame.

)

Calculate how the character wants to move during this frame.

Note that this does not actually move the character. You need to call FinalizeMovement for that. This is called automatically unless canMove is false.

To handle movement yourself you can disable canMove and call this method manually. This code will replicate the normal behavior of the component: void Update () {
// Disable the AIs own movement code
ai.canMove = false;
Vector3 nextPosition;
Quaternion nextRotation;
// Calculate how the AI wants to move
ai.MovementUpdate(Time.deltaTime, out nextPosition, out nextRotation);
// Modify nextPosition and nextRotation in any way you wish
// Actually move the AI
ai.FinalizeMovement(nextPosition, nextRotation);
}


void ISerializationCallbackReceiver. OnAfterDeserialize ()

void ISerializationCallbackReceiver. OnBeforeSerialize ()

void OnDisable ()

Called when the component is disabled or about to be destroyed.

This is also called by Unity when an undo/redo event is performed. This means that when an undo event happens the entity will get destroyed and then re-created.

void OnEnable ()

void OnUpgradeSerializedData (

refSerialization.Migrations	migrations
bool	unityThread

)

void OnUpgradeSerializedData (

refMigrations	migrations
bool	unityThread

)

Handle serialization backwards compatibility.

void RegisterRuntimeBaker (

IRuntimeBaker

baker

)

void Reset ()

Handle serialization backwards compatibility.

Color ShapeGizmoColor = new Color(240/255f, 213/255f, 30/255f)

void Start ()

void SyncWithEntities ()

void UpgradeSerializedData (

bool

isUnityThread

)

World achetypeWorld

EntityAccess<AgentCylinderShape> agentCylinderShapeAccessRO = new EntityAccess<AgentCylinderShape>(true)

EntityAccess<AgentCylinderShape> agentCylinderShapeAccessRW = new EntityAccess<AgentCylinderShape>(false)

EntityAccess<AgentOffMeshLinkTraversal> agentOffMeshLinkTraversalRO = new EntityAccess<AgentOffMeshLinkTraversal>(true)

EntityArchetype archetype

EntityAccess<DestinationPoint> destinationPointAccessRO = new EntityAccess<DestinationPoint>(true)

EntityAccess<DestinationPoint> destinationPointAccessRW = new EntityAccess<DestinationPoint>(false)

EntityStorageCache entityStorageCache

NativeArray<int> indicesScratch

EntityAccess<LocalTransform> localTransformAccessRO = new EntityAccess<LocalTransform>(true)

EntityAccess<LocalTransform> localTransformAccessRW = new EntityAccess<LocalTransform>(false)

ManagedState managedState = new ManagedState { enableLocalAvoidance = false, pathfindingSettings = PathRequestSettings.Default, }

ManagedEntityAccess<ManagedState> managedStateAccessRO = new ManagedEntityAccess<ManagedState>(true)

ManagedEntityAccess<ManagedState> managedStateAccessRW = new ManagedEntityAccess<ManagedState>(false)

MovementSettings movement = new MovementSettings { follower = new PIDMovement { rotationSpeed = 600, speed = 5, maxRotationSpeed = 720, maxOnSpotRotationSpeed = 720, slowdownTime = 0.5f, desiredWallDistance = 0.5f, allowRotatingOnSpot = true, leadInRadiusWhenApproachingDestination = 1f, }, movementPlaneSource = MovementPlaneSource.Graph, stopDistance = 0.2f, rotationSmoothing = 0f, groundMask = -1, isStopped = false, }

EntityAccess<MovementControl> movementControlAccessRO = new EntityAccess<MovementControl>(true)

EntityAccess<MovementControl> movementControlAccessRW = new EntityAccess<MovementControl>(false)

EntityAccess<MovementStatistics> movementOutputAccessRW = new EntityAccess<MovementStatistics>(false)

EntityAccess<AgentMovementPlane> movementPlaneAccessRO = new EntityAccess<AgentMovementPlane>(false)

EntityAccess<AgentMovementPlane> movementPlaneAccessRW = new EntityAccess<AgentMovementPlane>(false)

EntityAccess<MovementSettings> movementSettingsAccessRO = new EntityAccess<MovementSettings>(true)

EntityAccess<MovementSettings> movementSettingsAccessRW = new EntityAccess<MovementSettings>(false)

EntityAccess<MovementState> movementStateAccessRO = new EntityAccess<MovementState>(true)

EntityAccess<MovementState> movementStateAccessRW = new EntityAccess<MovementState>(false)

List<FollowerEntity> needsSyncWithEntityList = new List<FollowerEntity>()

NativeList<float3> nextCornersScratch

EntityAccess<ResolvedMovement> resolvedMovementAccessRO = new EntityAccess<ResolvedMovement>(true)

EntityAccess<ResolvedMovement> resolvedMovementAccessRW = new EntityAccess<ResolvedMovement>(false)

int scratchReferenceCount = 0

AgentCylinderShape shape = new AgentCylinderShape { height = 2, radius = 0.5f, }

Transform tr

Cached transform component.

bool canSearch

Enables or disables recalculating the path at regular intervals.

Setting this to false does not stop any active path requests from being calculated or stop it from continuing to follow the current path.

Note that this only disables automatic path recalculations. If you call the SearchPath() method a path will still be calculated.