Технологии

Соединение точек

• start_position и end_position — начальная и конечная позиции связи. Они привязываются к ближайшим полигонам навигационной сетки в радиусе, заданном в настройках проекта (default_link_connection_radius).
• bidirectional — определяет, можно ли перемещаться по связи в обоих направлениях (по умолчанию true).

Управление стоимостью пути

• enter_cost — стоимость "входа" в связь (добавляется к расстоянию пути при переходе из другого региона).
• travel_cost — множитель для расстояния, пройденного по связи (используется для определения оптимального маршрута).

Слои навигации

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

Активация/деактивация

• enabled — если false, связь игнорируется при поиске пути.

Поиск пути
Находит оптимальный маршрут от текущей позиции объекта до цели, учитывая навигационную сетку (NavigationRegion3D) и динамические препятствия (NavigationObstacle3D).

Сглаживание пути
Устраняет резкие повороты, делая движение более естественным.

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

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

Динамическое обновление навигации
Препятствие автоматически "блокирует" участки навмеша, через которые нельзя пройти, без необходимости пересобирать сетку. Это критически важно для движущихся объектов (например, врагов, дверей, разрушаемых стен).

Работа с NavigationAgent3D
Агенты (NavigationAgent3D) учитывают NavigationObstacle3D при поиске пути, обходя их в реальном времени.

Настройка формы и параметров
Можно задать радиус, высоту и форму препятствия через дочерний узел CollisionShape3D или CollisionPolygon3D.

Навигационная сетка (NavMesh)
Определяет зоны, по которым могут перемещаться агенты (например, полы, платформы, дороги). Непроходимые объекты (стены, пропасти) исключаются из сетки.

Генерация (Baking)
Навигационная сетка автоматически генерируется (выпекается) на основе геометрии уровня. Для этого используется ресурс NavigationMesh, который настраивается через параметры.

Поиск пути
С помощью методов NavigationServer3D или узла NavigationAgent3D можно находить оптимальный маршрут между двумя точками в пределах навигационной сетки.

Динамическое обновление
Навмеш можно перестраивать во время выполнения игры (например, при разрушении объектов или изменении уровня).

Позиционирование звука
Звук меняет громкость и панораму (левый/правый канал) в зависимости от позиции:

• Чем дальше объект от слушателя — тем тише звук.
• Звуки слева будут громче в левом динамике, справа — в правом.

Настройки затухания (Attenuation)
Регулирует, как быстро звук теряет громкость с расстоянием:

• Attenuation Model: алгоритм затухания (Linear, Logarithmic, Disable).
• Max Distance: максимальное расстояние, на котором звук ещё слышен.
• Unit Size: масштаб для корректной работы затухания (соответствует единицам измерения в сцене).

Эффекты и параметры

• Pitch Scale: изменение тональности звука (например, для ускорения/замедления).
• Volume dB: громкость в децибелах.
• Stream: аудиофайл (поддерживает форматы .wav, .ogg, .mp3).

Автовоспроизведение
Можно включить свойство Autoplay, чтобы звук запускался сразу при старте сцены.