Work in progress
Godot documentation is being updated to reflect the latest changes in version
4.0. Some documentation pages may
still state outdated information. This banner will tell you if you're reading one of such pages.
The contents of this page are up to date. If you can still find outdated information, please open an issue.
Support different actor locomotion¶
To support different actor locomotion like crouching and crawling, a similar map setup as supporting Support 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 actors's avoidance agent to another avoidance map with each locomotion change.
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)
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.