فهرست منبع

Add NavigationLinks to navigation overviews

Adds NavigationLinks to navigation overviews.
smix8 2 سال پیش
والد
کامیت
ca66575498
2فایلهای تغییر یافته به همراه30 افزوده شده و 6 حذف شده
  1. 15 3
      tutorials/navigation/navigation_introduction_2d.rst
  2. 15 3
      tutorials/navigation/navigation_introduction_3d.rst

+ 15 - 3
tutorials/navigation/navigation_introduction_2d.rst

@@ -31,6 +31,8 @@ Godot provides the following objects and classes for 2D navigation:
         - NavRegion RID
         - NavRegion RID
             Reference to a specific navigation region that can hold navigation mesh data.
             Reference to a specific navigation region that can hold navigation mesh data.
             The region can be enabled / disabled or the use restricted with a navigationlayer bitmask.
             The region can be enabled / disabled or the use restricted with a navigationlayer bitmask.
+        - NavLink RID
+            Reference to a specific navigation link that connects two navigation mesh positions over arbitrary distances.
         - NavAgent RID
         - NavAgent RID
             Reference to a specific avoidance agent with a radius value use solely in avoidance.
             Reference to a specific avoidance agent with a radius value use solely in avoidance.
 
 
@@ -38,9 +40,19 @@ The following SceneTree Nodes are available as helpers to work with the Navigati
 
 
 - :ref:`NavigationRegion2D<class_NavigationRegion2D>` Node
 - :ref:`NavigationRegion2D<class_NavigationRegion2D>` Node
     A Node that holds a NavigationPolygon resource that defines a navigation mesh for the NavigationServer2D.
     A Node that holds a NavigationPolygon resource that defines a navigation mesh for the NavigationServer2D.
-    The region can be enabled / disabled.
-    The use in pathfinding can be further restricted through the navigationlayers bitmask.
-    Regions can join their navigation meshes by proximity for a combined navigation mesh.
+
+    - The region can be enabled / disabled.
+    - The use in pathfinding can be further restricted through the navigationlayers bitmask.
+    - Regions can join their navigation meshes by proximity for a combined navigation mesh.
+
+- :ref:`NavigationLink2D<class_NavigationLink2D>` Node
+    A Node that connects two positions on navigation mesh over arbitrary distances for pathfinding.
+
+    - The link can be enabled / disabled.
+    - The link can be made one-way or bidirectional.
+    - The use in pathfinding can be further restricted through the navigationlayers bitmask.
+
+    Links tell the pathfinding that a connection exists and at what cost. The actual agent handling and movement needs to happen in custom scripts.
 
 
 -  :ref:`NavigationAgent2D<class_NavigationAgent2D>` Node
 -  :ref:`NavigationAgent2D<class_NavigationAgent2D>` Node
     An optional helper Node to facilitate common NavigationServer2D API calls for pathfinding and avoidance
     An optional helper Node to facilitate common NavigationServer2D API calls for pathfinding and avoidance

+ 15 - 3
tutorials/navigation/navigation_introduction_3d.rst

@@ -34,6 +34,8 @@ Godot provides the following objects and classes for 3D navigation:
         - NavRegion RID
         - NavRegion RID
             Reference to a specific navigation region that can hold navigation mesh data.
             Reference to a specific navigation region that can hold navigation mesh data.
             The region can be enabled / disabled or the use restricted with a navigationlayer bitmask.
             The region can be enabled / disabled or the use restricted with a navigationlayer bitmask.
+        - NavLink RID
+            Reference to a specific navigation link that connects two navigation mesh positions over arbitrary distances.
         - NavAgent RID
         - NavAgent RID
             Reference to a specific avoidance agent with a radius value use solely in avoidance.
             Reference to a specific avoidance agent with a radius value use solely in avoidance.
 
 
@@ -41,9 +43,19 @@ The following SceneTree Nodes are available as helpers to work with the Navigati
 
 
 - :ref:`NavigationRegion3D<class_NavigationRegion3D>` Node
 - :ref:`NavigationRegion3D<class_NavigationRegion3D>` Node
     A Node that holds a Navigation Mesh resource that defines a navigation mesh for the NavigationServer3D.
     A Node that holds a Navigation Mesh resource that defines a navigation mesh for the NavigationServer3D.
-    The region can be enabled / disabled.
-    The use in pathfinding can be further restricted through the navigationlayers bitmask.
-    Regions can join their navigation meshes by proximity for a combined navigation mesh.
+
+    - The region can be enabled / disabled.
+    - The use in pathfinding can be further restricted through the navigationlayers bitmask.
+    - Regions can join their navigation meshes by proximity for a combined navigation mesh.
+
+- :ref:`NavigationLink3D<class_NavigationLink3D>` Node
+    A Node that connects two positions on navigation mesh over arbitrary distances for pathfinding.
+
+    - The link can be enabled / disabled.
+    - The link can be made one-way or bidirectional.
+    - The use in pathfinding can be further restricted through the navigationlayers bitmask.
+
+    Links tell the pathfinding that a connection exists and at what cost. The actual agent handling and movement needs to happen in custom scripts.
 
 
 -  :ref:`NavigationAgent3D<class_NavigationAgent3D>` Node
 -  :ref:`NavigationAgent3D<class_NavigationAgent3D>` Node
     An optional helper Node to facilitate common NavigationServer3D API calls for pathfinding and avoidance for
     An optional helper Node to facilitate common NavigationServer3D API calls for pathfinding and avoidance for