Class AICooperative Extends VersionedMonoBehaviour, IAstarAI

void 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 MovementUpdate (

out Vector3	nextPosition
out Quaternion	nextRotation

)

void SearchPath ()

Starts a path request to the destination.

CooperativeContext cooperativeContext

Handles time and space reservations for cooperative pathfinding.

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 should check both pathPending and reachedEndOfPath: 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
}


GraphNode node

System.Action onSearchPath

Called when the agent recalculates its path.

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

bool pathPending

float pathSmoothing = 1f

How much to smooth the path.

The agents position will be calculated as the mean of the path during the last [value] ticks. So if for example this field is set to 2 then the position of the agent will be smoothed over 2 ticks. This necessarily introduces a small time delay as it needs to use the historical information to calculate the current position. The agent will be delayed by roughly pathSmoothing/2 ticks. Due to the time delay it is recommended that all agents use the same amount of path smoothing. Note that a too large value may cause agents to intersect.

Vector3 position

Position of the agent.

In world space.

bool reachedEndOfPath

float repathInterval = 5

Time in seconds between new path requests.

Quaternion rotation

Rotation of the agent.

In world space.

bool rotationIn2D

If true, rotation will only be done along the Z axis so that the Y axis is the forward direction of the character.

This is useful for 2D games in which one often want to have the Y axis as the forward direction to get sprites and 2D colliders to work properly.

Transform target

Vector3 velocity

Actual velocity that the agent is moving with.

In world units per second.

CooperativeContext.IAgent agent

AICooperative ()

void Awake ()

bool IAstarAI. canMove

bool IAstarAI. canSearch

Vector3 IAstarAI. desiredVelocity

bool IAstarAI. hasPath

bool IAstarAI. isStopped

float lastRepath = float.NegativeInfinity

Last time a path request was scheduled.

float IAstarAI. maxSpeed

void IAstarAI. 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 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 OnDisable ()

Clear various fields when the component is disabled.

void OnEnable ()

int OnUpgradeSerializedData (

int	version
bool	unityThread

)

Handle serialization backwards compatibility.

float IAstarAI. remainingDistance

Seeker seeker

Handles path requests for this agent.

void IAstarAI. SetPath (

Path

path

)

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.

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);


void Start ()

Vector3 IAstarAI. steeringTarget

void IAstarAI. Teleport (

Vector3	newPosition
bool	clearPath

)

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.

void Update ()

Update is called once per frame.

void UpdatePosition ()

void Upgrade ()