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...

Использование NavigationLinks

NavigationLinks используются для соединения полигонов навигационной сетки из NavigationRegion2D и NavigationRegion3D на произвольных расстояниях для поиска пути.

NavigationLinks также используются для учета сокращенных путей перемещения при поиске пути посредством взаимодействия с игровыми объектами, например, лестницами, трамплинами или телепортами.

2D- и 3D-версии узлов NavigationJumplinks доступны как NavigationLink2D и NavigationLink3D соответственно.

Различные навигационные области могут соединять свои навигационные сетки без использования NavigationLink, если у них есть пересекающиеся рёбра или рёбра, находящиеся в пределах edge_connection_margin навигационной карты. Как только расстояние становится слишком большим, построение корректных соединений становится проблемой, которую могут решить NavigationLinks.

Подробнее об использовании навигационных регионов см. в документе Использование NavigationRegions. Подробнее о соединении навигационных сеток см. в документе Подключение навигационных сеток.

Элементы NavigationLinks имеют много общих свойств с NavigationRegions, например, navigation_layers. NavigationLinks добавляют единую связь между двумя точками на произвольном расстоянии в отличие от NavigationRegions, которые добавляют более локальную проходимую область с ресурсом навигационной сетки.

У NavigationLinks есть start_position и end_position, и они могут идти в обоих направлениях, если включено bidirection. При размещении навигационная ссылка соединяет полигоны навигационной сетки, ближайшие к ее start_position и end_position в пределах радиуса поиска пути.

Радиус поиска полигона можно настроить глобально в ProjectSettings в разделе navigation/2d_or_3d/default_link_connection_radius или задать для каждой навигационной карты индивидуально с помощью функции NavigationServer.map_set_link_connection_radius().

В редакторе есть отладочные маркеры для start_position и end_position. Стрелки указывают направление, в котором можно перемещаться по ссылке, а видимый радиус позиции показывает радиус поиска полигонов. Все полигоны навигационной сетки внутри сравниваются, и для соединения с ребром выбирается ближайший из них. Если в радиусе поиска не найдено ни одного подходящего полигона, навигационная ссылка отключается.

Визуальные элементы отладки ссылок можно изменить в редакторе ProjectSettings в разделе debug/shapes/navigation. Видимость отладки также можно контролировать в меню гизмо редактора 3D Viewport.

Навигационная ссылка не обеспечивает какого-либо специального перемещения по ней. Вместо этого, когда агент достигает точки ссылки, игровой код должен отреагировать (например, через триггеры области) и предоставить агенту возможность пройти по ссылке, чтобы оказаться в другой точке ссылки (например, посредством телепортации или анимации). Без этого агент будет пытаться двигаться по пути ссылки самостоятельно. В итоге получится, что агент идёт по бездонной яме вместо того, чтобы дождаться движущейся платформы, или проходит через телепорт и проходит сквозь стену.

Шаблоны сценариев навигационных ссылок

Следующий скрипт использует NavigationServer для создания новой навигационной ссылки.

2D GDScript2D C#3D GDScript3D C#

extends Node2D

var link_rid: RID
var link_start_position: Vector2
var link_end_position: Vector2

func _ready() -> void:
    link_rid = NavigationServer2D.link_create()

    var link_owner_id: int = get_instance_id()
    var link_enter_cost: float = 1.0
    var link_travel_cost: float = 1.0
    var link_navigation_layers: int = 1
    var link_bidirectional: bool = true

    NavigationServer2D.link_set_owner_id(link_rid, link_owner_id)
    NavigationServer2D.link_set_enter_cost(link_rid, link_enter_cost)
    NavigationServer2D.link_set_travel_cost(link_rid, link_travel_cost)
    NavigationServer2D.link_set_navigation_layers(link_rid, link_navigation_layers)
    NavigationServer2D.link_set_bidirectional(link_rid, link_bidirectional)

    # Enable the link and set it to the default navigation map.
    NavigationServer2D.link_set_enabled(link_rid, true)
    NavigationServer2D.link_set_map(link_rid, get_world_2d().get_navigation_map())

    # Move the 2 link positions to their intended global positions.
    NavigationServer2D.link_set_start_position(link_rid, link_start_position)
    NavigationServer2D.link_set_end_position(link_rid, link_end_position)