:github_url: hide .. DO NOT EDIT THIS FILE!!! .. Generated automatically from Godot engine sources. .. Generator: https://github.com/godotengine/godot/tree/3.5/doc/tools/make_rst.py. .. XML source: https://github.com/godotengine/godot/tree/3.5/doc/classes/Navigation.xml. .. _class_Navigation: Navigation ========== **Inherits:** :ref:`Spatial` **<** :ref:`Node` **<** :ref:`Object` Mesh-based navigation and pathfinding node. Description ----------- *Deprecated.* ``Navigation`` node and :ref:`get_simple_path` are deprecated and will be removed in a future version. Use :ref:`NavigationServer.map_get_path` instead. Provides navigation and pathfinding within a collection of :ref:`NavigationMesh`\ es. By default, these will be automatically collected from child :ref:`NavigationMeshInstance` nodes. In addition to basic pathfinding, this class also assists with aligning navigation agents with the meshes they are navigating on. Tutorials --------- - `3D Navmesh Demo `__ Properties ---------- +-------------------------------+---------------------------------------------------------------------------------+------------------------+ | :ref:`float` | :ref:`cell_height` | ``0.25`` | +-------------------------------+---------------------------------------------------------------------------------+------------------------+ | :ref:`float` | :ref:`cell_size` | ``0.25`` | +-------------------------------+---------------------------------------------------------------------------------+------------------------+ | :ref:`float` | :ref:`edge_connection_margin` | ``0.25`` | +-------------------------------+---------------------------------------------------------------------------------+------------------------+ | :ref:`int` | :ref:`navigation_layers` | ``1`` | +-------------------------------+---------------------------------------------------------------------------------+------------------------+ | :ref:`Vector3` | :ref:`up_vector` | ``Vector3( 0, 1, 0 )`` | +-------------------------------+---------------------------------------------------------------------------------+------------------------+ Methods ------- +-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_closest_point` **(** :ref:`Vector3` to_point **)** |const| | +-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_closest_point_normal` **(** :ref:`Vector3` to_point **)** |const| | +-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_closest_point_owner` **(** :ref:`Vector3` to_point **)** |const| | +-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`Vector3` | :ref:`get_closest_point_to_segment` **(** :ref:`Vector3` start, :ref:`Vector3` end, :ref:`bool` use_collision=false **)** |const| | +-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`RID` | :ref:`get_rid` **(** **)** |const| | +-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ | :ref:`PoolVector3Array` | :ref:`get_simple_path` **(** :ref:`Vector3` start, :ref:`Vector3` end, :ref:`bool` optimize=true **)** |const| | +-------------------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+ Signals ------- .. _class_Navigation_signal_map_changed: - **map_changed** **(** :ref:`RID` map **)** Emitted when a navigation map is updated, when a region moves or is modified. Property Descriptions --------------------- .. _class_Navigation_property_cell_height: - :ref:`float` **cell_height** +-----------+------------------------+ | *Default* | ``0.25`` | +-----------+------------------------+ | *Setter* | set_cell_height(value) | +-----------+------------------------+ | *Getter* | get_cell_height() | +-----------+------------------------+ The cell height to use for fields. ---- .. _class_Navigation_property_cell_size: - :ref:`float` **cell_size** +-----------+----------------------+ | *Default* | ``0.25`` | +-----------+----------------------+ | *Setter* | set_cell_size(value) | +-----------+----------------------+ | *Getter* | get_cell_size() | +-----------+----------------------+ The XZ plane cell size to use for fields. ---- .. _class_Navigation_property_edge_connection_margin: - :ref:`float` **edge_connection_margin** +-----------+-----------------------------------+ | *Default* | ``0.25`` | +-----------+-----------------------------------+ | *Setter* | set_edge_connection_margin(value) | +-----------+-----------------------------------+ | *Getter* | get_edge_connection_margin() | +-----------+-----------------------------------+ This value is used to detect the near edges to connect compatible regions. ---- .. _class_Navigation_property_navigation_layers: - :ref:`int` **navigation_layers** +-----------+------------------------------+ | *Default* | ``1`` | +-----------+------------------------------+ | *Setter* | set_navigation_layers(value) | +-----------+------------------------------+ | *Getter* | get_navigation_layers() | +-----------+------------------------------+ A bitfield determining all navigation map layers the navigation can use on a :ref:`get_simple_path` path query. ---- .. _class_Navigation_property_up_vector: - :ref:`Vector3` **up_vector** +-----------+------------------------+ | *Default* | ``Vector3( 0, 1, 0 )`` | +-----------+------------------------+ | *Setter* | set_up_vector(value) | +-----------+------------------------+ | *Getter* | get_up_vector() | +-----------+------------------------+ Defines which direction is up. By default, this is ``(0, 1, 0)``, which is the world's "up" direction. Method Descriptions ------------------- .. _class_Navigation_method_get_closest_point: - :ref:`Vector3` **get_closest_point** **(** :ref:`Vector3` to_point **)** |const| Returns the navigation point closest to the point given. Points are in local coordinate space. ---- .. _class_Navigation_method_get_closest_point_normal: - :ref:`Vector3` **get_closest_point_normal** **(** :ref:`Vector3` to_point **)** |const| Returns the surface normal at the navigation point closest to the point given. Useful for rotating a navigation agent according to the navigation mesh it moves on. ---- .. _class_Navigation_method_get_closest_point_owner: - :ref:`RID` **get_closest_point_owner** **(** :ref:`Vector3` to_point **)** |const| Returns the owner of the :ref:`NavigationMesh` which contains the navigation point closest to the point given. This is usually a :ref:`NavigationMeshInstance`. ---- .. _class_Navigation_method_get_closest_point_to_segment: - :ref:`Vector3` **get_closest_point_to_segment** **(** :ref:`Vector3` start, :ref:`Vector3` end, :ref:`bool` use_collision=false **)** |const| Returns the navigation point closest to the given line segment. When enabling ``use_collision``, only considers intersection points between segment and navigation meshes. If multiple intersection points are found, the one closest to the segment start point is returned. ---- .. _class_Navigation_method_get_rid: - :ref:`RID` **get_rid** **(** **)** |const| Returns the :ref:`RID` of the navigation map on the :ref:`NavigationServer`. ---- .. _class_Navigation_method_get_simple_path: - :ref:`PoolVector3Array` **get_simple_path** **(** :ref:`Vector3` start, :ref:`Vector3` end, :ref:`bool` optimize=true **)** |const| *Deprecated.* ``Navigation`` node and :ref:`get_simple_path` are deprecated and will be removed in a future version. Use :ref:`NavigationServer.map_get_path` instead. Returns the path between two given points. Points are in local coordinate space. If ``optimize`` is ``true`` (the default), the agent properties associated with each :ref:`NavigationMesh` (radius, height, etc.) are considered in the path calculation, otherwise they are ignored. .. |virtual| replace:: :abbr:`virtual (This method should typically be overridden by the user to have any effect.)` .. |const| replace:: :abbr:`const (This method has no side effects. It doesn't modify any of the instance's member variables.)` .. |vararg| replace:: :abbr:`vararg (This method accepts any number of arguments after the ones described here.)`