Sphere Trace By Channel
KismetSystemLibrary
0
Что это
Exec-функция трассировки сферы по заданному каналу коллизий. Запускает луч от Start до End с указанным радиусом и возвращает результат первого пересечения с учётом фильтра актёров и настроек отладки. Относится к группе «Trace» в категории «Collision».
Пины
Exec-входы:
- execute (exec) — запуск трассировки
Exec-выходы:
- then (exec) — продолжение после завершения
Входы (данные):
- Start (Vector) — начальная точка луча
- End (Vector) — конечная точка луча
- Radius (float) — радиус сферы
- TraceChannel (byte) — канал трассировки (0 – Bullet, 1 – Interaction, 2 – Camera)
- bTraceComplex (bool) — учитывать сложные коллизии (например, теллурические поверхности)
- Actors to Ignore (Array of Actor) — массив актёров, исключаемых из проверки
- bIgnoreSelf (bool) — игнорировать актёра, вызвавшего функцию
- DrawDebugType (byte) — режим отладки (0 – нет, 1 – один кадр, 2 – постоянно)
- DrawDebugColor (LinearColor) — цвет отладочной визуализации
- DrawTime (float) — время отображения отладки (сек)
Выходы (данные):
- OutHit (HitResult) — структура с деталями попадания (актёр, дистанция и т.д.)
- OutHitLocation (Vector) — точка пересечения сферы с поверхностью
- OutHitNormal (Vector) — нормаль в точке попадания
- bHit (bool) — true, если было хотя бы одно пересечение
Когда используется
- Проверка видимости между двумя точками с учётом радиуса (например, может ли персонаж пройти в проём).
- Поиск первого препятствия на пути движения объекта (пули, снаряда).
- Детекция столкновений в системах взаимодействия (например, луч для интерактивных объектов).
Типичные проблемы
- Неправильный TraceChannel — если канал не совпадает с тем, который настроен у целевых актёров, трассировка не увидит их. Всегда проверяй соответствие каналов в настройках коллизий.
- Забытый Actors to Ignore — если не исключить самого актёра или другие нерелевантные объекты, результат может быть ложным (попадание в себя).
- Radius = 0 — сфера нулевого радиуса эквивалентна линии, что может пропустить коллизии с тонкими объектами. Указывай осмысленный радиус, соответствующий размеру проверяемого объекта.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.