NavigationObstacle

Inherits: Node < Object

3D obstacle used in navigation for collision avoidance.

Description

3D obstacle used in navigation for collision avoidance. The obstacle needs navigation data to work correctly. This can be done by having the obstacle as a child of a Navigation node, or using set_navigation. NavigationObstacle is physics safe.

Obstacles don't change the resulting path from the pathfinding, they only affect the navigation agent movement in a radius. Therefore, using obstacles for the static walls in your level won't work because those walls don't exist in the pathfinding. The navigation agent will be pushed in a semi-random direction away while moving inside that radius. Obstacles are intended as a last resort option for constantly moving objects that cannot be (re)baked to a navigation mesh efficiently.

Properties

bool	estimate_radius	true
float	radius	1.0

Methods

Node	get_navigation ( ) const
RID	get_rid ( ) const
void	set_navigation ( Node navigation )

---

Property Descriptions

bool estimate_radius = true

• void set_estimate_radius ( bool value )

• bool is_radius_estimated ( )

Enables radius estimation algorithm which uses parent's collision shapes to determine the obstacle radius.

---

float radius = 1.0

• void set_radius ( float value )

• float get_radius ( )

The radius of the agent. Used only if estimate_radius is set to false.

---

Method Descriptions

Node get_navigation ( ) const

Returns the Navigation node that the obstacle is using for its navigation system.

---

RID get_rid ( ) const

Returns the RID of this obstacle on the NavigationServer.

---

void set_navigation ( Node navigation )

Sets the Navigation node used by the obstacle. Useful when you don't want to make the obstacle a child of a Navigation node.