Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

NavigationLink3D

Experimental: This class may be changed or removed in future versions.

Hereda: Node3D < Node < Object

Un enlace entre dos posiciones en NavigationRegion3Ds por el que los agentes pueden ser enrutados.

Descripción

Un enlace entre dos posiciones en NavigationRegion3Ds por el que los agentes pueden ser enrutados. Estas posiciones pueden estar en la misma NavigationRegion3D o en dos diferentes. Los enlaces son útiles para expresar métodos de navegación distintos a los de viajar por la superficie de la malla de navegación, como tirolinas, teletransportadores o huecos que se pueden saltar.

Tutoriales

Utilizando NavigationLinks

Propiedades

bool	bidirectional	`true`
bool	enabled	`true`
Vector3	end_position	`Vector3(0, 0, 0)`
float	enter_cost	`0.0`
int	navigation_layers	`1`
Vector3	start_position	`Vector3(0, 0, 0)`
float	travel_cost	`1.0`

Métodos

Vector3	get_global_end_position() const
Vector3	get_global_start_position() const
bool	get_navigation_layer_value(layer_number: int) const
RID	get_navigation_map() const
RID	get_rid() const
void	set_global_end_position(position: Vector3)
void	set_global_start_position(position: Vector3)
void	set_navigation_layer_value(layer_number: int, value: bool)
void	set_navigation_map(navigation_map: RID)

Descripciones de Propiedades

bool bidirectional = true 🔗

void set_bidirectional(value: bool)
bool is_bidirectional()

Indica si este enlace puede ser recorrido en ambas direcciones o solo desde start_position hasta end_position.

bool enabled = true 🔗

void set_enabled(value: bool)
bool is_enabled()

Está este enlace activo actualmente? Si es false, NavigationServer3D.map_get_path() ignorará este enlace.

Vector3 end_position = Vector3(0, 0, 0) 🔗

void set_end_position(value: Vector3)
Vector3 get_end_position()

Posición final del enlace.

Esta posición buscará el polígono más cercano en la malla de navegación para adjuntarse.

La distancia que buscará el enlace está controlada por NavigationServer3D.map_set_link_connection_radius().

float enter_cost = 0.0 🔗

void set_enter_cost(value: float)
float get_enter_cost()

Cuando la búsqueda de trayectos entra en este enlace desde la malla de navegación de otra región, el valor enter_cost se añade a la distancia del trayecto para determinar el trayecto más corto.

int navigation_layers = 1 🔗

void set_navigation_layers(value: int)
int get_navigation_layers()

Un campo de bits que determina todas las capas de navegación a las que pertenece el enlace. Estas capas de navegación se comprobarán al solicitar un trayecto con NavigationServer3D.map_get_path().

Vector3 start_position = Vector3(0, 0, 0) 🔗

void set_start_position(value: Vector3)
Vector3 get_start_position()

Posición inicial del enlace.

Esta posición buscará el polígono más cercano en la malla de navegación para adjuntarse.

La distancia que buscará el enlace está controlada por NavigationServer3D.map_set_link_connection_radius().

float travel_cost = 1.0 🔗

void set_travel_cost(value: float)
float get_travel_cost()

Cuando la búsqueda de trayecto se mueve a lo largo del enlace, la distancia recorrida se multiplica por travel_cost para determinar el trayecto más corto.

Descripciones de Métodos

Vector3 get_global_end_position() const 🔗

Devuelve la end_position que es relativa al enlace como una posición global.

Vector3 get_global_start_position() const 🔗

Devuelve la start_position que es relativa al enlace como una posición global.

Devuelve si la capa especificada de la máscara de bits navigation_layers está habilitada, dado un layer_number entre 1 y 32.

Devuelve el RID del mapa de navegación actual utilizado por este enlace.

RID get_rid() const 🔗

Devuelve el RID de este enlace en NavigationServer3D.

void set_global_end_position(position: Vector3) 🔗

Establece la end_position que es relativa al enlace desde una position global.

void set_global_start_position(position: Vector3) 🔗

Establece la start_position que es relativa al enlace desde una position global.

Based on value, enables or disables the specified layer in the navigation_layers bitmask, given a layer_number between 1 and 32.

Establece el RID del mapa de navegación que este enlace debe usar. Por defecto, el enlace se unirá automáticamente al mapa de navegación predeterminado de World3D, por lo que esta función solo es necesaria para sobrescribir el mapa predeterminado.