Class AIPathAlignedToSurface Extends AIPath

Public

Movement script for curved worlds.

This script inherits from AIPath, but adjusts its movement plane every frame using the ground normal.

A* Pro Feature:

This is an A* Pathfinding Project Pro feature only. This function/class/variable might not exist in the Free version of the A* Pathfinding Project or the functionality might be limited.
The Pro version can be bought here

Public Methods

MeshBelowFeetMayHaveChanged ()

Call to indicate that the mesh collider which the agent is standing on may have been updated.

Public

Inherited Public Members

DrawGizmos ()
Public
FinalizeMovement (nextPosition, nextRotation)

Moves the agent to a position.

Public
FindComponents ()

Looks for any attached components like RVOController and CharacterController etc.

Public
GetFeetPosition ()

Position of the base of the character.

Public
GetRemainingPath (buffer, stale)

Fills buffer with the remaining path.

Public
Move (deltaPosition)

Move the agent.

Public
MovementUpdate (deltaTime, nextPosition, nextRotation)

Calculate how the character wants to move during this frame.

Public
OnTargetReached ()

The end of the path has been reached.

Public
SearchPath ()

Recalculate the current path.

Public
SetPath (path, updateDestinationFromPath=true)

Make the AI follow the specified path.

Public
ShapeGizmoColor
Public Static Readonly
SimulateRotationTowards (direction, maxDegrees)

Simulates rotating the agent towards the specified direction and returns the new rotation.

Public
Teleport (newPosition, clearPath=true)

Instantly move the agent to a new position.

Public
alwaysDrawGizmos

Draws detailed gizmos constantly in the scene view instead of only when the agent is selected and settings are being modified.

Public
autoRepath

Determines how the agent recalculates its path automatically.

Public
canMove

Enables or disables movement completely.

Public
constrainInsideGraph

Ensure that the character is always on the traversable surface of the navmesh.

Public
desiredVelocity

Velocity that this agent wants to move with.

Public
desiredVelocityWithoutLocalAvoidance

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

Public
destination

Position in the world that this agent should move to.

Public
enableRotation

If true, the AI will rotate to face the movement direction.

Public
endOfPath

End point of path the agent is currently following.

Public
endReachedDistance

Distance to the end point to consider the end of path to be reached.

Public
gravity

Gravity to use.

Public
groundMask

Layer mask to use for ground placement.

Public
hasPath

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

Public
height

Height of the agent in world units.

Public
isStopped

Gets or sets if the agent should stop moving.

Public
maxAcceleration

How quickly the agent accelerates.

Public
maxSpeed

Max speed in world units per second.

Public
movementPlane

Plane which this agent is moving in.

Public
onSearchPath

Called when the agent recalculates its path.

Public
orientation

Determines which direction the agent moves in.

Public
pathPending

True if a path is currently being calculated.

Public
pickNextWaypointDist

How far the AI looks ahead along the path to determine the point it moves to.

Public
position

Position of the agent.

Public
preventMovingBackwards

Prevent the velocity from being too far away from the forward direction of the character.

Public
radius

Radius of the agent in world units.

Public
reachedDestination

True if the ai has reached the destination.

Public
reachedEndOfPath

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

Public
remainingDistance

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

Public
rotation

Rotation of the agent.

Public
rotationSpeed

Rotation speed in degrees per second.

Public
rvoDensityBehavior

Controls if the agent slows down to a stop if the area around the destination is crowded.

Public
slowWhenNotFacingTarget

Slow down when not facing the target direction.

Public
slowdownDistance

Distance from the end of the path where the AI will start to slow down.

Public
steeringTarget

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

Public
updatePosition

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

Public
updateRotation

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

Public
velocity

Actual velocity that the agent is moving with.

Public
whenCloseToDestination

What to do when within endReachedDistance units from the destination.

Public

Private/Protected Members

ApplyGravity (deltaTime)

Accelerates the agent downwards.

Protected
Awake ()
Protected
CalculateDeltaToMoveThisFrame (position, distanceToEndOfPath, deltaTime)

Calculates how far to move during a single frame.

Protected
CalculateNextRotation (slowdown, nextRotation)
Protected
CalculatePathRequestEndpoints (start, end)

Outputs the start point and end point of the next automatic path request.

Protected
CancelCurrentPathRequest ()
Protected
ClampToNavmesh (position, positionChanged)

Constrains the character's position to lie on the navmesh.

Protected
ClearPath ()

Clears the current path of the agent.

Protected
InterpolateNormal (hit)
Private
MovementUpdateInternal (deltaTime, nextPosition, nextRotation)

Called during either Update or FixedUpdate depending on if rigidbodies are used for movement or not.

Protected
OnDisable ()
Protected
OnDrawGizmosSelected ()
Protected
OnEnable ()

Called when the component is enabled.

Protected
OnPathComplete (newPath)

Called when a requested path has been calculated.

Protected
OnUpdate (dt)

Called every frame.

Protected
OnUpgradeSerializedData (version, unityThread)

Handle serialization backwards compatibility.

Protected
RaycastPosition (position, lastElevation)

Checks if the character is grounded and prevents ground penetration.

Protected
Reset ()

Handle serialization backwards compatibility.

Protected
SimulateRotationTowards (direction, maxDegreesMainAxis, maxDegreesOffAxis=…)

Simulates rotating the agent towards the specified direction and returns the new rotation.

Protected
Start ()

Starts searching for paths.

Protected
UpdateMovementPlane ()

Find the world position of the ground below the character.

Protected
UpdateVelocity ()
Protected
cachedMesh
Private
cachedNormals
Private
cachedTriangles
Private
cachedVertexCount
Private
controller

Cached CharacterController component.

Protected
interpolator

Represents the current steering target for the agent.

Protected
interpolatorPath

Helper which calculates points along the current path.

Protected
lastDeltaPosition

Amount which the character wants or tried to move with during the last frame.

Protected
lastDeltaTime

Delta time used for movement during the last frame.

Protected
lastRaycastHit

Hit info from the last raycast done for ground placement.

Protected
lastRepath

Time when the last path request was started.

Protected
path

Current path which is followed.

Protected
prevFrame

Last frame index when prevPosition1 was updated.

Protected
prevPosition1

Position of the character at the end of the last frame.

Protected
prevPosition2

Position of the character at the end of the frame before the last frame.

Protected
rigid

Cached Rigidbody component.

Protected
rigid2D

Cached Rigidbody component.

Protected
rvoController

Cached RVOController component.

Protected
seeker

Cached Seeker component.

Protected
shouldRecalculatePath

True if the path should be automatically recalculated as soon as possible.

Protected
simulatedPosition

Position of the agent.

Protected
simulatedRotation

Rotation of the agent.

Protected
tr

Cached Transform component.

Protected
usingGravity

Indicates if gravity is used during this frame.

Protected
velocity2D

Current desired velocity of the agent (does not include local avoidance and physics).

Protected
verticalVelocity

Velocity due to gravity.

Protected
waitingForPathCalculation

Only when the previous path has been calculated should the script consider searching for a new path.

Protected