Технологии

Бросок формы

• Форма задаётся через свойство shape (например, SphereShape3D, BoxShape3D, CapsuleShape3D).
• Форма перемещается из начальной позиции узла в направлении target_position.

Обнаружение столкновений

• Если форма пересекает объект, ShapeCast3D возвращает информацию о точке столкновения, нормали и объекте.
• Свойство enabled включает/выключает проверку столкновений.

Фильтрация объектов

• Используйте Collision Mask и Collision Layer, чтобы указать, с какими объектами может сталкиваться форма.
• Исключайте определённые объекты через exclude_parent или exclude (список объектов).

Динамическое обновление

• Форма автоматически обновляется каждый кадр, если enabled = true.

Бросок луча

• Луч начинается в позиции узла и направляется вдоль его оси -Z (по умолчанию).
• Длина луча задаётся через свойство target_position.

Обнаружение столкновений

• Если луч пересекает объект, RayCast3D возвращает информацию о точке столкновения, нормали и объекте.
• Свойство enabled включает/выключает проверку столкновений.

Фильтрация объектов

• Используйте Collision Mask и Collision Layer, чтобы указать, с какими объектами может сталкиваться луч.
• Исключайте определённые объекты через exclude_parent или exclude (список объектов).

Динамическое обновление

• Луч автоматически обновляется каждый кадр, если enabled = true.

Движение по пути

• Управляется через свойство progress (пройденное расстояние в единицах) или progress_ratio (относительное положение от 0 до 1).
• Пример:

  $PathFollow3D.progress += speed * delta  # Движение вперёд

Автоматическое вращение

• Если включено rotation_mode (Rotation Mode), объект поворачивается вдоль кривой (например, поезд следует за изгибами рельсов).
• Доступные режимы: ORIENTATION_NONE, ORIENTATION_Y, ORIENTATION_XYZ.

Зацикливание

• Свойство loop определяет, будет ли объект возвращаться в начало пути после достижения конца.

Смещение и наклон

• position_offset и rotation_offset позволяют корректировать позицию и угол объекта относительно пути.

Создание пути через Curve3D

• Path3D содержит кривую, которая определяет форму пути.
• Кривая состоит из точек (add_point), которые можно редактировать в редакторе или через код.
• Поддерживает создание плавных изгибов с помощью контрольных точек (используйте Shift + перетаскивание в редакторе) .

Интеграция с PathFollow3D

• Дочерние узлы PathFollow3D автоматически перемещаются вдоль кривой.
• Управление движением осуществляется через свойство progress (пройденное расстояние) или progress_ratio (относительное положение от 0 до 1) .

Относительная система координат

• Путь считается относительным к позиции PathFollow3D, поэтому кривая обычно начинается с точки (0, 0, 0) .

События

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

Создание окклюдеров
Окклюдеры — это упрощённые геометрические формы, которые "блокируют" видимость объектов за ними. Godot использует их, чтобы определить, какие части сцены можно не рендерить.

• Автоматическое выпекание (baking) окклюдеров из статичной геометрии сцены (например, стен).
• Ручное добавление примитивов: QuadOccluder3D, BoxOccluder3D, SphereOccluder3D, PolygonOccluder3D.

Работа с CPU
Окклюдеры рендерятся на CPU с помощью библиотеки Embree в низком разрешении. Это позволяет движку быстро проверять, какие объекты скрыты.

Динамическое управление
Окклюдеры можно перемещать или скрывать во время выполнения, но это вызывает пересчёт в фоне (занимает несколько кадров). Рекомендуется использовать их статично или обновлять редко .