Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

NavigationMesh

Inherits: Resource < RefCounted < Object

用于定义可达区域和障碍物的导航网格。

Description

导航网格是多边形的集合，用于定义环境中的哪些区域是可以穿越的，帮助代理在复杂的空间中寻路。

Tutorials

• 使用 NavigationMesh

• 3D 导航网格演示

Properties

float	agent_height	1.5
float	agent_max_climb	0.25
float	agent_max_slope	45.0
float	agent_radius	0.5
float	cell_height	0.25
float	cell_size	0.25
float	detail_sample_distance	6.0
float	detail_sample_max_error	1.0
float	edge_max_error	1.3
float	edge_max_length	0.0
AABB	filter_baking_aabb	AABB(0, 0, 0, 0, 0, 0)
Vector3	filter_baking_aabb_offset	Vector3(0, 0, 0)
bool	filter_ledge_spans	false
bool	filter_low_hanging_obstacles	false
bool	filter_walkable_low_height_spans	false
int	geometry_collision_mask	4294967295
ParsedGeometryType	geometry_parsed_geometry_type	0
SourceGeometryMode	geometry_source_geometry_mode	0
StringName	geometry_source_group_name	&"navigation_mesh_source_group"
float	region_merge_size	20.0
float	region_min_size	2.0
SamplePartitionType	sample_partition_type	0
float	vertices_per_polygon	6.0

Methods

void	add_polygon ( PackedInt32Array polygon )
void	clear ( )
void	clear_polygons ( )
void	create_from_mesh ( Mesh mesh )
bool	get_collision_mask_value ( int layer_number ) const
PackedInt32Array	get_polygon ( int idx )
int	get_polygon_count ( ) const
PackedVector3Array	get_vertices ( ) const
void	set_collision_mask_value ( int layer_number, bool value )
void	set_vertices ( PackedVector3Array vertices )

---

Enumerations

enum SamplePartitionType:

SamplePartitionType SAMPLE_PARTITION_WATERSHED = 0

分水岭分区。如果你预先计算导航网格，通常是最佳选择，如果你有大的开放区域，请使用它。

SamplePartitionType SAMPLE_PARTITION_MONOTONE = 1

单调分区。如果你想要快速生成导航网格，请使用此选项。

SamplePartitionType SAMPLE_PARTITION_LAYERS = 2

层分区。用于具有中小型图块的平铺导航网格的不错选择。

SamplePartitionType SAMPLE_PARTITION_MAX = 3

代表 SamplePartitionType 枚举的大小。

---

enum ParsedGeometryType:

ParsedGeometryType PARSED_GEOMETRY_MESH_INSTANCES = 0

将网格实例解析为几何体。包括 MeshInstance3D、CSGShape3D、GridMap 等节点。

ParsedGeometryType PARSED_GEOMETRY_STATIC_COLLIDERS = 1

将 StaticBody3D 碰撞器解析为几何体。碰撞器应在由 geometry_collision_mask 指定的层中。

ParsedGeometryType PARSED_GEOMETRY_BOTH = 2

PARSED_GEOMETRY_MESH_INSTANCES 和 PARSED_GEOMETRY_STATIC_COLL