simvx.core.navigation3d.server

NavigationServer3D — singleton coordinator across all registered regions.

Module Contents

Classes

NavigationServer3D

Global navigation server that manages all registered navigation regions.

Data

log

API

simvx.core.navigation3d.server.log

‘getLogger(…)’

class simvx.core.navigation3d.server.NavigationServer3D

Global navigation server that manages all registered navigation regions.

Provides unified pathfinding and spatial queries across all active regions.

Initialization

classmethod get_singleton() → simvx.core.navigation3d.server.NavigationServer3D

Return the global NavigationServer3D instance (created on first access).

classmethod reset() → None

Reset the singleton (useful for testing).

register_region(region: simvx.core.navigation3d.nodes.NavigationRegion3D) → None

Register a navigation region.

unregister_region(region: simvx.core.navigation3d.nodes.NavigationRegion3D) → None

Unregister a navigation region.

register_obstacle(obstacle: simvx.core.navigation3d.nodes.NavigationObstacle3D) → None

Register a dynamic obstacle.

unregister_obstacle(obstacle: simvx.core.navigation3d.nodes.NavigationObstacle3D) → None

Unregister a dynamic obstacle.

find_path(start: simvx.core.math.types.Vec3, end: simvx.core.math.types.Vec3) → list[simvx.core.math.types.Vec3]

Find a path from start to end across all active navigation regions.

Queries each enabled region and returns the shortest valid path found.

Args: start: Start position in world space. end: End position in world space.

Returns: List of Vec3 waypoints, or empty list if unreachable.

get_closest_point(point: simvx.core.math.types.Vec3) → simvx.core.math.types.Vec3

Find the closest point on any active navmesh surface.

Args: point: Query point in world space.

Returns: Closest point on any navmesh, or the input point if no regions exist.

property obstacles: list[simvx.core.navigation3d.nodes.NavigationObstacle3D]

All registered dynamic obstacles.