mirror of
https://github.com/godotengine/godot-docs.git
synced 2026-01-04 14:11:02 +03:00
e09439a4e0
Co-authored-by: A Thousand Ships <96648715+AThousandShips@users.noreply.github.com> Co-authored-by: Raul Santos <raulsntos@gmail.com>
78 lines
2.9 KiB
ReStructuredText
78 lines
2.9 KiB
ReStructuredText
.. _doc_navigation_different_actor_locomotion:
|
|
|
|
Support different actor locomotion
|
|
==================================
|
|
|
|
.. image:: img/nav_actor_locomotion.png
|
|
|
|
To support different actor locomotion like crouching and crawling, a similar
|
|
map setup as supporting :ref:`doc_navigation_different_actor_types` is required.
|
|
|
|
Bake different navigation meshes with an appropriate height for crouched
|
|
or crawling actors so they can find paths through those narrow sections in your game world.
|
|
|
|
When an actor changes locomotion state, e.g. stands up, starts
|
|
crouching or crawling, query the appropriate map for a path.
|
|
|
|
If the avoidance behavior should also change with the locomotion e.g. only avoid while standing or only avoid
|
|
other agents in the same locomotion state, switch the actor's avoidance agent to another avoidance map with each locomotion change.
|
|
|
|
.. tabs::
|
|
.. code-tab:: gdscript GDScript
|
|
|
|
func update_path():
|
|
|
|
if actor_standing:
|
|
path = NavigationServer3D.map_get_path(standing_navigation_map_rid, start_position, target_position, true)
|
|
elif actor_crouching:
|
|
path = NavigationServer3D.map_get_path(crouched_navigation_map_rid, start_position, target_position, true)
|
|
elif actor_crawling:
|
|
path = NavigationServer3D.map_get_path(crawling_navigation_map_rid, start_position, target_position, true)
|
|
|
|
func change_agent_avoidance_state():
|
|
|
|
if actor_standing:
|
|
NavigationServer3D.agent_set_map(avoidance_agent_rid, standing_navigation_map_rid)
|
|
elif actor_crouching:
|
|
NavigationServer3D.agent_set_map(avoidance_agent_rid, crouched_navigation_map_rid)
|
|
elif actor_crawling:
|
|
NavigationServer3D.agent_set_map(avoidance_agent_rid, crawling_navigation_map_rid)
|
|
|
|
.. code-tab:: csharp
|
|
|
|
private void UpdatePath()
|
|
{
|
|
if (_actorStanding)
|
|
{
|
|
_path = NavigationServer3D.MapGetPath(_standingNavigationMapRid, _startPosition, _targetPosition, true);
|
|
}
|
|
else if (_actorCrouching)
|
|
{
|
|
_path = NavigationServer3D.MapGetPath(_crouchedNavigationMapRid, _startPosition, _targetPosition, true);
|
|
}
|
|
else if (_actorCrawling)
|
|
{
|
|
_path = NavigationServer3D.MapGetPath(_crawlingNavigationMapRid, _startPosition, _targetPosition, true);
|
|
}
|
|
}
|
|
|
|
private void ChangeAgentAvoidanceState()
|
|
{
|
|
if (_actorStanding)
|
|
{
|
|
NavigationServer3D.AgentSetMap(_avoidanceAgentRid, _standingNavigationMapRid);
|
|
}
|
|
else if (_actorCrouching)
|
|
{
|
|
NavigationServer3D.AgentSetMap(_avoidanceAgentRid, _crouchedNavigationMapRid);
|
|
}
|
|
else if (_actorCrawling)
|
|
{
|
|
NavigationServer3D.AgentSetMap(_avoidanceAgentRid, _crawlingNavigationMapRid);
|
|
}
|
|
}
|
|
|
|
.. note::
|
|
|
|
While a path query can be execute immediately for multiple maps, the avoidance agent map switch will only take effect after the next server synchronization.
|