Up to date

This page is up to date for Godot 4.3. If you still find outdated information, please open an issue.

使用 NavigationRegion

NavigationRegions are the visual Node representation of a region of the navigation map on the NavigationServer. Each NavigationRegion node holds a resource for the navigation mesh data.

2D 和 3D 版本分別為 NavigationRegion2D 和 NavigationRegion3D。

各個NavigationRegions將其2D NavigationPolygon或3D NavigationMesh資源資料上傳到NavigationServer。導覽伺服器地圖將這些資訊轉換為組合導覽地圖以供尋路。

To create a navigation region using the scene tree add a NavigationRegion2D or NavigationRegion3D node to the scene. All regions require a navigation mesh resource to function. See Using navigation meshes to learn how to create and apply navigation meshes.

NavigationRegions will automatically push global_transform changes to the region on the NavigationServer which makes them suitable for moving platforms. The NavigationServer will attempt to connect the navigation meshes of individual regions when they are close enough. For more details see Connecting navigation meshes. To connect NavigationRegions over arbitrary distances see 使用 NavigationLink to learn how to create and use NavigationLinks.

警告

While changing the transform of a NavigationRegion node does update the region position on the NavigationServer, changing the scale does not. A navigation mesh resource has no scale and needs to be fully updated when source geometry changes scale.

可以啟用/停用區域，如果停用，將不會對未來的尋路查詢做出貢獻。

備註

當區域啟用/停用時，現有路徑不會自動更新。

建立內容

新的 NavigationRegion 節點將自動註冊到其 2D/3D 維度的預設世界導覽地圖。

The region RID can then be obtained from NavigationRegion Nodes with get_rid().

extends NavigationRegion2D

var navigationserver_region_rid: RID = get_rid()

public partial class MyNavigationRegion2D : NavigationRegion2D
{
    public override void _Ready()
    {
        Rid navigationServerRegionRid = GetRid();
    }
}

extends NavigationRegion3D

var navigationserver_region_rid: RID = get_rid()

public partial class MyNavigationRegion3D : NavigationRegion3D
{
    public override void _Ready()
    {
        Rid navigationServerRegionRid = GetRid();
    }
}

也可以使用 NavigationServer API 建立新區域並將其新增到任何現有地圖中。

如果直接使用 NavigationServer API 建立區域，則需要手動為其指派導覽地圖。

extends Node2D

func _ready() -> void:
    var new_region_rid: RID = NavigationServer2D.region_create()
    var default_map_rid: RID = get_world_2d().get_navigation_map()
    NavigationServer2D.region_set_map(new_region_rid, default_map_rid)

public partial class MyNode2D : Node2D
{
    public override void _Ready()
    {
        Rid newRegionRid = NavigationServer2D.RegionCreate();
        Rid defaultMapRid = GetWorld2D().NavigationMap;
        NavigationServer2D.RegionSetMap(newRegionRid, defaultMapRid);
    }
}

extends Node3D

func _ready() -> void:
    var new_region_rid: RID = NavigationServer3D.region_create()
    var default_map_rid: RID = get_world_3d().get_navigation_map()
    NavigationServer3D.region_set_map(new_region_rid, default_map_rid)

public partial class MyNode3D : Node3D
{
    public override void _Ready()
    {
        Rid newRegionRid = NavigationServer3D.RegionCreate();
        Rid defaultMapRid = GetWorld3D().NavigationMap;
        NavigationServer3D.RegionSetMap(newRegionRid, defaultMapRid);
    }
}

備註

Navigation regions can only be assigned to a single navigation map. If an existing region is assigned to a new navigation map it will leave the old map.