Class RVOController Extends VersionedMonoBehaviour

Vector3 CalculateMovementDelta (

float

deltaTime

How far to move [seconds]. Usually set to Time.deltaTime.

)

Direction and distance to move in a single frame to avoid obstacles.

The position of the agent is taken from the attached movement script's position (see Pathfinding.IAstarAI.position) or if none is attached then transform.position.

Vector3 CalculateMovementDelta (

Vector3	position	Position of the agent.
float	deltaTime	How far to move [seconds]. Usually set to Time.deltaTime.

)

Direction and distance to move in a single frame to avoid obstacles.

void Move (

Vector3

vel

)

Set the desired velocity for the agent.

Note that this is a velocity (units/second), not a movement delta (units/frame).

This is assumed to stay the same until something else is requested (as opposed to being reset every frame).

void SetCollisionNormal (

Vector3

normal

)

Set the normal of a wall (or something else) the agent is currently colliding with.

This is used to make the RVO system aware of things like physics or an agent being clamped to the navmesh. The velocity of this agent that other agents observe will be modified so that there is no component into the wall. The agent will however not start to avoid the wall, for that you will need to add RVO obstacles.

This value will be cleared after the next simulation step, normally it should be set every frame when the collision is still happening.

void SetTarget (

Vector3	pos	Point in world space to move towards.
float	speed	Desired speed in world units per second.
float	maxSpeed	Maximum speed in world units per second. The agent will use this speed if it is necessary to avoid collisions with other agents. Should be at least as high as speed, but it is recommended to use a slightly higher value than speed (for example speed*1.2).

)

Set the target point for the agent to move towards.

Similar to the Move method but this is more flexible. It is also better to use near the end of the path as when using the Move method the agent does not know where to stop, so it may overshoot the target. When using this method the agent will not overshoot the target. The agent will assume that it will stop when it reaches the target so make sure that you don't place the point too close to the agent if you actually just want to move in a particular direction.

The target point is assumed to stay the same until something else is requested (as opposed to being reset every frame).

Vector2 To2D (

Vector3

p

)

Converts a 3D vector to a 2D vector in the movement plane.

If movementPlane is XZ it will be projected onto the XZ plane otherwise it will be projected onto the XY plane.

Vector2 To2D (

Vector3	p
out float	elevation

)

Converts a 3D vector to a 2D vector in the movement plane.

If movementPlane is XZ it will be projected onto the XZ plane and the elevation coordinate will be the Y coordinate otherwise it will be projected onto the XY plane and elevation will be the Z coordinate.

Vector3 To3D (

Vector2	p
float	elevationCoordinate

)

Converts a 2D vector in the movement plane as well as an elevation to a 3D coordinate.

float agentTimeHorizon = 2

How far into the future to look for collisions with other agents (in seconds)

float center

Center of the agent relative to the pivot point of this game object.

RVOLayer collidesWith = (RVOLayer)(-1)

Layer mask specifying which layers this agent will avoid.

You can set it as CollidesWith = RVOLayer.DefaultAgent | RVOLayer.Layer3 | RVOLayer.Layer6 ...

This can be very useful in games which have multiple teams of some sort. For example you usually want the agents in one team to avoid each other, but you do not want them to avoid the enemies.

This field only affects which other agents that this agent will avoid, it does not affect how other agents react to this agent.

bool debug

Enables drawing debug information in the scene view.

float height

Height of the agent in world units.

RVOLayer layer = RVOLayer.DefaultAgent

Specifies the avoidance layer for this agent.

The collidesWith mask on other agents will determine if they will avoid this agent.

bool locked

A locked unit cannot move.

Other units will still avoid it but avoidance quality is not the best.

bool lockWhenNotMoving = false

Automatically set locked to true when desired velocity is approximately zero.

This prevents other units from pushing them away when they are supposed to e.g block a choke point.

When this is true every call to SetTarget or Move will set the locked field to true if the desired velocity was non-zero or false if it was zero.

int maxNeighbours = 10

Max number of other agents to take into account.

A smaller value can reduce CPU load, a higher value can lead to better local avoidance quality.

MovementPlane movementPlane

Determines if the XY (2D) or XZ (3D) plane is used for movement.

float obstacleTimeHorizon = 2

How far into the future to look for collisions with obstacles (in seconds)

Vector3 position

Current position of the agent.

Note that this is only updated every local avoidance simulation step, not every frame.

float priority = 0.5f

How strongly other agents will avoid this agent.

Usually a value between 0 and 1. Agents with similar priorities will avoid each other with an equal strength. If an agent sees another agent with a higher priority than itself it will avoid that agent more strongly. In the extreme case (e.g this agent has a priority of 0 and the other agent has a priority of 1) it will treat the other agent as being a moving obstacle. Similarly if an agent sees another agent with a lower priority than itself it will avoid that agent less.

In general the avoidance strength for this agent is: if this.priority > 0 or other.priority > 0:
avoidanceStrength = other.priority / (this.priority + other.priority);
else:
avoidanceStrength = 0.5


float radius

Radius of the agent in world units.

IAgent rvoAgent

Reference to the internal agent.

Simulator simulator

Reference to the rvo simulator.

Vector3 velocity

Current calculated velocity of the agent.

This is not necessarily the velocity the agent is actually moving with (that is up to the movement script to decide) but it is the velocity that the RVO system has calculated is best for avoiding obstacles and reaching the target.

You can also set the velocity of the agent. This will override the local avoidance input completely. It is useful if you have a player controlled character and want other agents to avoid it.

Setting the velocity using this property will mark the agent as being externally controlled for 1 simulation step. Local avoidance calculations will be skipped for the next simulation step but will be resumed after that unless this property is set again.

Note that if you set the velocity the value that can be read from this property will not change until the next simulation step.

IAstarAI ai

Cached reference to a movement script (if one is used)

IAstarAI aiBackingField

void Awake ()

float centerBackingField = 1

float heightBackingField = 2

void OnDisable ()

void OnDrawGizmos ()

void OnEnable ()

int OnUpgradeSerializedData (

int	version
bool	unityThread

)

Handle serialization backwards compatibility.

float radiusBackingField = 0.5f

void Reset ()

Handle serialization backwards compatibility.

Transform tr

Cached tranform component.

void UpdateAgentProperties ()

bool enableRotation

void ForceSetVelocity (

Vector3

velocity

)

LayerMask mask

float maxSpeed

float rotationSpeed

void Teleport (

Vector3

pos

)

Teleport the agent to a new position.

float wallAvoidFalloff = 1

How much the wallAvoidForce decreases with distance.

The strenght of avoidance is: str = 1/dist*wallAvoidFalloff


float wallAvoidForce = 1

An extra force to avoid walls.

This can be good way to reduce "wall hugging" behaviour.