Struct NavMeshAgent 

pub struct NavMeshAgent {
    pub current_path: Vec<Matrix<f32, Const<3>, Const<1>, ArrayStorage<f32, 3, 1>>>,
    pub current_waypoint_index: usize,
    pub target_position: Option<Matrix<f32, Const<3>, Const<1>, ArrayStorage<f32, 3, 1>>>,
    pub movement_speed: f32,
    pub arrival_threshold: f32,
    pub path_recalculation_threshold: f32,
    pub agent_radius: f32,
    pub agent_height: f32,
    pub current_triangle: Option<usize>,
    pub state: NavMeshAgentState,
    pub distance_to_destination: f32,
    pub avoidance_velocity: Matrix<f32, Const<3>, Const<1>, ArrayStorage<f32, 3, 1>>,
}

Navigation agent component for navmesh-based movement.

Attach to an entity with a transform to enable pathfinding. Set a destination via set_destination and the navigation system will compute and follow a path.

Fields

current_path: Vec<Matrix<f32, Const<3>, Const<1>, ArrayStorage<f32, 3, 1>>>

Computed path as a list of waypoints.

current_waypoint_index: usize

Index of the next waypoint to reach.

target_position: Option<Matrix<f32, Const<3>, Const<1>, ArrayStorage<f32, 3, 1>>>

Target destination (if any).

movement_speed: f32

Movement speed in units per second.

arrival_threshold: f32

Distance at which waypoints are considered reached.

path_recalculation_threshold: f32

Distance target must move before path is recalculated.

agent_radius: f32

Agent collision radius for navmesh queries.

agent_height: f32

Agent height for navmesh queries.

current_triangle: Option<usize>

Current navmesh triangle (for height sampling).

state: NavMeshAgentState

Current navigation state.

distance_to_destination: f32

Remaining distance to final destination.

avoidance_velocity: Matrix<f32, Const<3>, Const<1>, ArrayStorage<f32, 3, 1>>

Velocity adjustment for local obstacle avoidance.

Implementations

impl NavMeshAgent

pub fn new() -> NavMeshAgent

Creates a new navigation agent with default settings.

pub fn with_speed(self, speed: f32) -> NavMeshAgent

Sets the movement speed.

pub fn with_radius(self, radius: f32) -> NavMeshAgent

Sets the agent collision radius.

pub fn with_height(self, height: f32) -> NavMeshAgent

Sets the agent height.

pub fn with_arrival_threshold(self, threshold: f32) -> NavMeshAgent

Sets the distance threshold for reaching waypoints.

pub fn set_destination( &mut self, destination: Matrix<f32, Const<3>, Const<1>, ArrayStorage<f32, 3, 1>>, )

Sets a new destination and triggers pathfinding.

pub fn clear_destination(&mut self)

Clears the current destination and stops movement.

pub fn has_path(&self) -> bool

Returns true if a valid path exists.

pub fn is_moving(&self) -> bool

Returns true if the agent is actively navigating.

pub fn current_waypoint( &self, ) -> Option<Matrix<f32, Const<3>, Const<1>, ArrayStorage<f32, 3, 1>>>

Returns the current waypoint position.

pub fn remaining_waypoints(&self) -> usize

Returns the number of waypoints remaining.

pub fn advance_waypoint(&mut self) -> bool

Advances to the next waypoint. Returns true if destination reached.

Trait Implementations

impl Clone for NavMeshAgent

fn clone(&self) -> NavMeshAgent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NavMeshAgent

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for NavMeshAgent

fn default() -> NavMeshAgent

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for NavMeshAgent

fn deserialize<__D>( __deserializer: __D, ) -> Result<NavMeshAgent, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Schema for NavMeshAgent

fn schema() -> Value

impl Serialize for NavMeshAgent

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.