Multi Sphere Trace For Objects
KismetSystemLibrary
0
Что это
Функция трассировки сферы (Sphere Sweep) от Start до End, проверяющая пересечение с объектами по заданным типам объектов (Object Types). Возвращает массив всех попаданий (OutHits) и логический признак успеха (ReturnValue). Это exec-функция (требует подключения exec).
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения после завершения трассировки
Входы (данные):
- Start (Vector) — начальная точка трассировки
- End (Vector) — конечная точка трассировки
- Radius (float) — радиус сферы
- Object Types (Array of EObjectTypeQuery) — типы объектов, с которыми проверять пересечение
- bTraceComplex (bool) — использовать сложную коллизию (True) или простую (False)
- Actors to Ignore (Array of Actor) — массив акторов, исключённых из трассировки
- bIgnore Self (bool) — игнорировать вызывающий актор
- Draw Debug Type (EDrawDebugTrace) — режим отображения отладочной графики (None, ForOneFrame, ForDuration, Persistent)
- Trace Color (LinearColor) — цвет сферы при отсутствии попадания (отладка)
- Trace Hit Color (LinearColor) — цвет сферы при попадании (отладка)
- Draw Time (float) — время отображения отладки (если DrawDebugType != None)
Выходы (данные):
- Out Hits (Array of HitResult) — массив результатов всех попаданий
- Return Value (bool) — true, если хотя бы одно попадание
Когда используется
- Поиск всех объектов с заданными типами (например, все враги или все статические предметы) вдоль отрезка с учётом радиуса сферы.
- Реализация объёмного AoE-сканирования перед применением способностей или проверки видимости.
Типичные проблемы
- Пустой массив Object Types — функция не найдёт ни одного попадания (всегда false в Return Value).
- Radius = 0 или меньше 0 — трассировка вырождается в линию, возможны неожиданные результаты.
- Не указаны Actors to Ignore — трассировка может «поймать» самого выполняющего актора (если bIgnore Self = False) или другие нецелевые объекты.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.