From bcb4ee80ba1a57265c44099c548d90ec6de25f80 Mon Sep 17 00:00:00 2001 From: skyace65 Date: Sun, 11 Sep 2022 20:25:07 -0400 Subject: [PATCH] Improve navigation section pages Co-authored-by: smix8 <52464204+smix8@users.noreply.github.com> --- tutorials/navigation/img/bake_navmesh.png | Bin 1466 -> 0 bytes tutorials/navigation/img/baked_navmesh.png | Bin 28684 -> 0 bytes .../navigation/img/nav_2d_min_setup_step1.png | Bin 0 -> 8598 bytes .../navigation/img/nav_2d_min_setup_step2.png | Bin 0 -> 17807 bytes .../navigation/img/nav_2d_min_setup_step3.png | Bin 0 -> 6942 bytes .../navigation/img/nav_3d_min_setup_step1.png | Bin 0 -> 8559 bytes .../navigation/img/nav_3d_min_setup_step2.png | Bin 0 -> 6119 bytes .../navigation/img/nav_3d_min_setup_step3.png | Bin 0 -> 45410 bytes .../navigation/img/nav_3d_min_setup_step4.png | Bin 0 -> 7638 bytes tutorials/navigation/index.rst | 3 +- .../navigation/navigation_introduction_2d.rst | 147 ++++++++++++++++++ .../navigation/navigation_introduction_3d.rst | 134 ++++++++++++++++ .../navigation/real_time_navigation_3d.rst | 92 ----------- 13 files changed, 283 insertions(+), 93 deletions(-) delete mode 100644 tutorials/navigation/img/bake_navmesh.png delete mode 100644 tutorials/navigation/img/baked_navmesh.png create mode 100644 tutorials/navigation/img/nav_2d_min_setup_step1.png create mode 100644 tutorials/navigation/img/nav_2d_min_setup_step2.png create mode 100644 tutorials/navigation/img/nav_2d_min_setup_step3.png create mode 100644 tutorials/navigation/img/nav_3d_min_setup_step1.png create mode 100644 tutorials/navigation/img/nav_3d_min_setup_step2.png create mode 100644 tutorials/navigation/img/nav_3d_min_setup_step3.png create mode 100644 tutorials/navigation/img/nav_3d_min_setup_step4.png create mode 100644 tutorials/navigation/navigation_introduction_2d.rst create mode 100644 tutorials/navigation/navigation_introduction_3d.rst delete mode 100644 tutorials/navigation/real_time_navigation_3d.rst diff --git a/tutorials/navigation/img/bake_navmesh.png b/tutorials/navigation/img/bake_navmesh.png deleted file mode 100644 index 8b149ad1124b3fcd0f37f56a8fb90b1ed4cea3a3..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 1466 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 diff --git a/tutorials/navigation/img/nav_2d_min_setup_step1.png b/tutorials/navigation/img/nav_2d_min_setup_step1.png new file mode 100644 index 0000000000000000000000000000000000000000..1b102cb44e30ad852b8d97e73f6903943a6255fb GIT binary patch literal 8598 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 VWO=Op40Heh002ovPDHLkV1ikn3ON7( literal 0 HcmV?d00001 diff --git a/tutorials/navigation/img/nav_2d_min_setup_step3.png b/tutorials/navigation/img/nav_2d_min_setup_step3.png new file mode 100644 index 0000000000000000000000000000000000000000..be0ee27ae52516e79fd5d5e754cc8392a50479dc GIT binary patch literal 6942 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 Pn81>kR+g%fGzt1Y{PP7f literal 0 HcmV?d00001 diff --git a/tutorials/navigation/img/nav_3d_min_setup_step2.png b/tutorials/navigation/img/nav_3d_min_setup_step2.png new file mode 100644 index 0000000000000000000000000000000000000000..bec406d8766c1f14bedfa9b9d1d6a8ff96766b46 GIT binary patch literal 6119 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 + ``Astar2D`` objects provide an option to find the shortest path in a graph of weighted **points**. + + The AStar2D class is best suited for cellbased 2D gameplay that does not require actors to reach any possible position within an area but only predefined, distinct positions. + +- :ref:`NavigationServer2D` + ``NavigationServer2D`` provides a powerful server API to find the shortest path between two positions on a area defined by a navigation mesh. + + The NavigationServer is best suited for 2D realtime gameplay that does require actors to reach any possible position within an navmesh defined area. + Meshbased navigation scales well with large gameworlds as a large area can often be defined with a single polygon when it would require many, many grid cells. + + The NavigationServer holds different navigation maps that each consist of regions that hold navigation mesh data. + Agents can be placed on a map for avoidance calculation. + RIDs are used to reference the internal maps, regions and agents when communicating with the server. + + The following NavigationServer RID types are available. + - NavMap RID + Reference to a specific navigation map that holds regions and agents. + The map will attempt to join changed navigation meshes of regions by proximity. + The map will synchronise regions and agents each physics frame. + - NavRegion RID + 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. + - NavAgent RID + Reference to a specific avoidance agent with a radius value use solely in avoidance. + +The following SceneTree Nodes are available as helpers to work with the NavigationServer2D API. + +- :ref:`NavigationRegion2D` Node + 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. + +- :ref:`NavigationAgent2D` Node + An optional helper Node to facilitate common NavigationServer2D API calls for pathfinding and avoidance + for a Node2D inheriting parent Node. + +- :ref:`NavigationObstacle2D` Node + A Node that acts as an agent with avoidance radius, to work it needs to be added under a Node2D + inheriting parent Node. Obstacles are intended as a last resort option for constantly moving objects + that cannot be re(baked) to a navigation mesh efficiently. This node also only works if RVO processing + is being used. + +The 2D navigationm eshes are defined with the following resources: + +- :ref:`NavigationPolygon` Resource + A resource that holds 2D navigation mesh data and provides polygon drawtools to define navigation areas inside the Editor as well as at runtime. + + - The NavigationRegion2D Node uses this resource to define its navigation area. + - The NavigationServer2D uses this resource to update navmesh of individual regions. + - The TileSet Editor creates and uses this resource internally when defining tile navigation areas. + +Setup for 2D scene +------------------ + +The following steps show the basic setup for a minimum viable navigation in 2D that uses the +NavigationServer2D and a NavigationAgent2D for path movement. + +1.) Add a NavigationRegion2D Node to the scene. + +2.) Click on the region node and add a new NavigationPolygon Resource to the region node + +.. image:: img/nav_2d_min_setup_step1.png + +3.) Define the moveable navigation area with the NavigationPolygon draw tool + +.. image:: img/nav_2d_min_setup_step2.png + +.. note:: + + The navigation mesh defines the area where an actor can stand and move with its center. + Leave enough margin between the navpolygon edges and collision objects to not get path following actors repeatedly stuck on collision. + +4.) Add a CharacterBody2D below the region node with a basic collision shape and a sprite or mesh for visuals. + +5.) Add a NavigationAgent2D node below the character node + +.. image:: img/nav_2d_min_setup_step3.png + +6.) Add the following script to the CharacterBody2D node. Set a movement target with the set_movement_target() function after the scene has fully loaded and the NavigationServer had time to sync. + +.. note:: + + On the first frame the NavigationServer map has not synchronised region data and any path query will return empty. + Use ``await get_tree().physics_frame`` to pause scripts until the NavigationServer had time to sync. + +.. tabs:: + .. code-tab:: gdscript GDScript + + extends CharacterBody2D + + var movement_speed : float = 200.0 + var movement_target_position : Vector2 = Vector2(60.0,180.0) + + @onready var navigation_agent : NavigationAgent2D = $NavigationAgent2D + + func _ready(): + # these values need to be adjusted for the actor's speed + # and the navpolygon layout as each crossed edge will create a path point + # If the actor moves to fast it might overshoot + # multiple path points in one frame and start to backtrack + navigation_agent.path_desired_distance = 4.0 + navigation_agent.target_desired_distance = 4.0 + + # make a deferred function call to assure the entire Scenetree is loaded + call_deferred("actor_setup") + + func actor_setup(): + # wait for the first physics frame so the NavigationServer can sync + await get_tree().physics_frame + + # now that the navigation map is no longer empty set the movement target + set_movement_target(movement_target_position) + + func set_movement_target(movement_target : Vector2): + navigation_agent.set_target_location(movement_target) + + func _physics_process(delta): + + if navigation_agent.is_target_reached(): + return + + var current_agent_position : Vector2 = global_transform.origin + var next_path_position : Vector2 = navigation_agent.get_next_location() + + var new_velocity : Vector2 = next_path_position - current_agent_position + new_velocity = new_velocity.normalized() + new_velocity = new_velocity * movement_speed + + set_velocity(new_velocity) + + move_and_slide() diff --git a/tutorials/navigation/navigation_introduction_3d.rst b/tutorials/navigation/navigation_introduction_3d.rst new file mode 100644 index 00000000000..5c1a9ab658a --- /dev/null +++ b/tutorials/navigation/navigation_introduction_3d.rst @@ -0,0 +1,134 @@ +.. _doc_navigation_overview_3d: + +Introduction +=================== + +Godot provides multiple objects, classes and servers to facilitate grid-based or mesh-based navigation +and pathfinding for 2D and 3D games. The following section provides a quick overview over all available +navigation related objects in Godot for 3D scenes and their primary use. + +3D Navigation Overview +---------------------- + +Godot provides the following objects and classes for 3D navigation: + +- :ref:`Astar3D` + ``Astar3D`` objects provide an option to find the shortest path in a graph of weighted **points**. + + The AStar3D class is best suited for cellbased 3D gameplay that does not require actors to reach any + possible position within an area but only predefined, distinct positions. + +- :ref:`NavigationServer3D` + ``NavigationServer3D`` provides a powerful server API to find the shortest path between two positions + on a area defined by a navigation mesh. + + The NavigationServer is best suited for 3D realtime gameplay that does require actors to reach any + possible position within an navmesh defined area. Meshbased navigation scales well with large gameworlds + as a large area can often be defined with a single polygon when it would require many, many grid cells. + + The NavigationServer holds different navigation maps that each consist of regions that hold navigation mesh + data. Agents can be placed on a map for avoidance calculation. RIDs are used to reference the internal maps, + regions and agents when communicating with the server. + + The following NavigationServer RID types are available. + - NavMap RID + Reference to a specific navigation map that holds regions and agents. + The map will attempt to join changed navigation meshes of regions by proximity. + The map will synchronise regions and agents each physics frame. + - NavRegion RID + 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. + - NavAgent RID + Reference to a specific avoidance agent with a radius value use solely in avoidance. + +The following SceneTree Nodes are available as helpers to work with the NavigationServer3D API. + +- :ref:`NavigationRegion3D` Node + 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. + +- :ref:`NavigationAgent3D` Node + An optional helper Node to facilitate common NavigationServer3D API calls for pathfinding and avoidance for + a Node3D inheriting parent Node. + +- :ref:`NavigationObstacle3D` Node + A Node that acts as an agent with avoidance radius, to work it needs to be added under a Node3D + inheriting parent Node. Obstacles are intended as a last resort option for constantly moving objects + that cannot be re(baked) to a navigation mesh efficiently. This node also only works if RVO processing + is being used. + +The 3D navigation meshes are defined with the following resources: + +- :ref:`NavigationMesh` Resource + A resource that holds 3D navigation mesh data and provides 3D geometry baking options to define navigation + areas inside the Editor as well as at runtime. + + - The NavigationRegion3D Node uses this resource to define its navigation area. + - The NavigationServer3D uses this resource to update navmesh of individual regions. + - The GridMap Editor uses this resource when specific navigation meshes are defined for each gridcell. + +Setup for 3D scene +------------------ + +The following steps show how to setup a minimum viable navigation in 3D that uses the NavigationServer3D and +a NavigationAgent3D for path movement. + +1.) Add a NavigationRegion3D Node to the scene. + +2.) Click on the region node and add a new :ref:`NavigationMesh` Resource to the region node + +.. image:: img/nav_3d_min_setup_step1.png + +3.) Add a new MeshInstance node as a child of the region node + +4.) Select the meshinstance node and add a new PlaneMesh and increase the xy size to 10. + +5.) Select the region node again and press the "Bake Navmesh" button on the top bar + +.. image:: img/nav_3d_min_setup_step2.png + +7.) Now a transparent navigation mesh appeared that hovers some distance on top the planemesh. + +.. image:: img/nav_3d_min_setup_step3.png + +8.) Add a CharacterBody3D below the region node with a basic collision shape and some mesh for visuals. + +9.) Add a NavigationAgent3D node below the character node + +.. image:: img/nav_3d_min_setup_step4.png + +10.) Add a script to the CharacterBody3D node with the following content. + +.. tabs:: + .. code-tab:: gdscript GDScript + + extends CharacterBody3D + + var movement_speed : float = 4.0 + + @onready var navigation_agent = $NavigationAgent3D + + func set_movement_target(movement_target : Vector3): + navigation_agent.set_target_location(movement_target) + + func _physics_process(delta): + + var current_agent_position : Vector3 = global_transform.origin + var next_path_position : Vector3 = navigation_agent.get_next_location() + + var new_velocity : Vector3 = next_path_position - current_agent_position + new_velocity = new_velocity.normalized() + new_velocity = new_velocity * movement_speed + + set_velocity(new_velocity) + move_and_slide() + +Set a movement target with the set_movement_target() function after the scene has fully loaded. +Also add a Camera3D and some light and environment to see something. + +.. warning:: + + On the first frame the NavigationServer map has not synchronised region data and any path query will return empty. + Use ``await get_tree().physics_frame`` to pause scripts until the NavigationServer had time to sync. diff --git a/tutorials/navigation/real_time_navigation_3d.rst b/tutorials/navigation/real_time_navigation_3d.rst deleted file mode 100644 index cae201db45f..00000000000 --- a/tutorials/navigation/real_time_navigation_3d.rst +++ /dev/null @@ -1,92 +0,0 @@ -.. _doc_real_time_navigation_3d: - -Real Time Navigation (3D) -========================= - -Introduction ------------- - -Pathfinding in a 3D environment is crucial for many games, it's commonly -how non directly controlled characters or entities find their way around -an environment. Godot provides several nodes for this purpose: - -- :ref:`NavigationRegion3D` -- :ref:`NavigationAgent3D` -- :ref:`NavigationObstacle3D` - -The map and navigation regions ------------------------------- - -The "map" is the entire world for navigation, it's similar to "space" for -the physics engine. It's comprised of navigation regions, these regions -define what parts of the world that can be navigated around by navigation -agents. - -To create a navigation region add the `NavigationRegion3D` -node to a 3D scene. Next in the inspector for that region create or add a -:ref:`NavigationMesh`. The navmesh contains options -for how it will be generated when it's baked. The geometry options control -which nodes, and types of nodes, are used to bake the mesh. A full -description of each setting and how it works can be found in the :ref:`NavigationMesh class reference`. - -Once the settings have been properly configured press the "Bake NavMesh" -button at the top of the inspector to generate it. - -.. image:: img/bake_navmesh.png - -.. note:: - - It can also be generated at runtime using the `bake_navigation_region()` - method of the navigation region node. - -Once the mesh has finished generating you should see the transparent -navigation mesh above the areas in the scene that can be navigated to. - -.. image:: img/baked_navmesh.png - -Keep in mind that the navmesh shows where the center of an entity can -go. For example, if you set the agent radius to 0.5 then the -navigation mesh will have a distance of 0.5 from any ledges or walls -to prevent clipping into the wall or hanging off of the edge. - -Navigation agents can moved from one region to another if they are next -to each other. Additionally A baked navmesh can be moved at runtime and -agents will still be able to navigate onto it from another region. -For example, navigating onto a moving platform that has stopped will work. - -NavigationAgent3D ------------------ - -Navigation agent nodes are what actually does the pathfinding in a scene, -one can be attached to the root node of an entity that needs to navigate. - -To have it pathfind use its `set_target_location` method. Once the target -has been set a path will be generated to the node using navigation regions, -with several points on the way to the final destination. - -RVO processing --------------- - -RVO stands for reciprocal velocity obstacle. RVO processing is a way to -pathfind while taking into account other agents and physics bodies that -are also moving. - -To use it set a target like normal. Then an agent needs to fetch its next -nav path location, and compute its velocity to that location. Instead -of using that value to move use it to set the velocity on the agent -with `set_velocity`. Then a new velocity that takes into account other -agents and obstacles is generated and emitted with the signal `velocity_computed`. - -However agents can only take into account a set number of other nearby -agents, this is the :ref:`max neighbors` -property of an agent and can be adjusted. This is **not** a limit for -how many agents can use a navigation region at the same time. - -NavigationObstacle3D --------------------- - -This node is used to mark physics bodies that move around a navigation area -that agents need to avoid (this will only work if you use RVO processing). -For example, this node would be useful for pieces of debris in a destructible -environment. Add it as the child of a physics body and navigation agent -nodes will avoid it while pathfinding.