Использовать NavigationObstacles

2D- и 3D-версии узлов NavigationObstacles доступны как NavigationObstacle2D и NavigationObstacle3D соответственно.

Навигационные препятствия имеют двойное назначение, поскольку они могут влиять как на выпечку навигационной сетки, так и на уклонение агента.

• При включенном affect_navigation_mesh препятствие будет влиять на навигационную сетку при запекании.

• При avoidance_enabled препятствие будет влиять на агентов избегания.

Совет

Функция избегания включена по умолчанию. Если препятствие не используется для избегания, отключите enabled_avoidance для экономии производительности.

Препятствия и навигационная сетка

Навигационные препятствия, влияющие на запекание навигационной сетки.

При запекании навигационной сетки препятствия можно использовать для отбрасывания частей всей другой исходной геометрии внутри формы препятствия.

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

Препятствия к навигации: отбрасывание ненужной навигационной сетки.

Препятствие не добавляет геометрию в процессе запекания, а только удаляет её. Это достигается путём аннулирования всех ячеек (вокселей) с растеризованной исходной геометрией, находящихся внутри препятствия. Таким образом, его эффект и детализация формы ограничены разрешением ячеек, используемым в процессе запекания.

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

Свойство affect_navigation_mesh позволяет препятствию участвовать в процессе запекания навигационной сетки. Оно будет подвергнуто или не подвергнуто анализу, как и все остальные объекты-узлы в процессе запекания навигационной сетки.

Свойство carve_navigation_mesh делает форму невосприимчивой к смещениям при запекании, например, к смещению, добавленному навигационной сеткой agent_radius. По сути, оно действует как трафарет и вырезает уже смещенную поверхность навигационной сетки. На него по-прежнему будет влиять дальнейшая постобработка процесса запекания, например, упрощение рёбер.

Форма и расположение препятствия определяются свойствами height и vertices, а также global_position препятствия. Значение по оси Y любого Vector3, используемого для вершин, игнорируется, поскольку препятствие проецируется на плоскую горизонтальную плоскость.

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

2D GDScript2D C#3D GDScript3D C#

var obstacle_outline = PackedVector2Array([
    Vector2(-50, -50),
    Vector2(50, -50),
    Vector2(50, 50),
    Vector2(-50, 50)
])

var navigation_mesh = NavigationPolygon.new()
var source_geometry = NavigationMeshSourceGeometryData2D.new()

NavigationServer2D.parse_source_geometry_data(navigation_mesh, source_geometry, $MyTestRootNode)

var obstacle_carve: bool = true

source_geometry.add_projected_obstruction(obstacle_outline, obstacle_carve)

NavigationServer2D.bake_from_source_geometry_data(navigation_mesh, source_geometry)

Препятствия и избегание агента

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

• При статическом использовании NavigationObstacles ограничивает контролируемые агенты, находящиеся вне или внутри области, определенной многоугольником.

• При динамическом использовании NavigationObstacles отталкивают агентов, контролируемых уклонением, в радиусе вокруг них.

Статические препятствия для избегания

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

Статическое препятствие, нарисованное в редакторе для блокировки или сдерживания навигационных агентов.

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

• Статичные препятствия определяют свои границы с помощью массива вершин контура (позиций), а в случае 3D — с помощью дополнительного свойства высоты.

• Статичные препятствия работают только для агентов, использующих режим 2D-избегания.

• Статические препятствия определяют посредством порядка обхода вершин, выталкиваются ли агенты или засасываются.

• Статичные препятствия не могут менять своё положение. Их можно только переместить в новое положение и перестроить заново. Поэтому статические препятствия плохо подходят для ситуаций, где положение меняется в каждом кадре, поскольку постоянное перестроение приводит к высоким потерям производительности.

• Агенты не могут предсказать, где находятся статические препятствия, деформированные в другое положение. Это создаёт риск застревания агентов, если статическое препятствие деформируется на них.

При использовании 2D-обхода в 3D ось Y вершин Vector3 игнорируется. Вместо этого в качестве уровня высоты используется глобальное положение препятствия по оси Y. Агенты будут игнорировать статические препятствия в 3D, находящиеся ниже или выше них. Это автоматически определяется глобальным положением препятствия и агента по оси Y, а также их соответствующими свойствами высоты.

Динамические препятствия для избегания

Препятствие для избегания считается динамическим, если его свойство радиус больше нуля.

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

• Границы динамических препятствий определяются единым радиусом для двухмерного круга или, в случае трехмерного обхода, формой сферы.

• Динамические препятствия могут менять свое положение в каждом кадре без дополнительных затрат производительности.

• Динамические препятствия с заданной скоростью могут быть спрогнозированы агентами по их движению.

• Динамические препятствия не являются надежным способом ограничения движения агентов в людных или узких пространствах.

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

Подобно агентам, препятствия могут использовать битовую маску avoidance_layers. Все агенты с соответствующим битом в своей маске избегания будут избегать препятствия.

Процедурные препятствия

Новые препятствия можно создавать в скрипте без узла, используя напрямую NavigationServer.

Для создания препятствий с помощью скриптов требуется как минимум карта и позиция. Для динамического использования требуется радиус. Для статического использования требуется массив вершин.

2D GDScript2D C#3D GDScript3D C#

# create a new "obstacle" and place it on the default navigation map.
var new_obstacle_rid: RID = NavigationServer2D.obstacle_create()
var default_map_rid: RID = get_world_2d().get_navigation_map()

NavigationServer2D.obstacle_set_map(new_obstacle_rid, default_map_rid)
NavigationServer2D.obstacle_set_position(new_obstacle_rid, global_position)

# Use obstacle dynamic by increasing radius above zero.
NavigationServer2D.obstacle_set_radius(new_obstacle_rid, 5.0)

# Use obstacle static by adding a square that pushes agents out.
var outline = PackedVector2Array([Vector2(-100, -100), Vector2(100, -100), Vector2(100, 100), Vector2(-100, 100)])
NavigationServer2D.obstacle_set_vertices(new_obstacle_rid, outline)

# Enable the obstacle.
NavigationServer2D.obstacle_set_avoidance_enabled(new_obstacle_rid, true)