Multi Line Trace By Profile
KismetSystemLibraryЧто это
Multi Line Trace By Profile — exec-функция (не pure), выполняющая множественный рейкаст (лучевую трассировку) по заданному профилю коллизий. Возвращает массив всех объектов, пересечённых лучом от Start до End, отсортированных по расстоянию. Позволяет отладочную визуализацию.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- World Context (Object Reference) — контекст мира (обычно self)
- Start (Vector) — начальная точка трассировки
- End (Vector) — конечная точка трассировки
- Profile Name (Name) — имя профиля коллизий (например,
"BlockAll","Visibility") - bTraceComplex (Boolean) — true = трассировка по сложной геометрии (каждый полигон), false = по упрощённой
- Actors to Ignore (Array of Actor References) — массив актёров, которые игнорируются
- Ignore Self (Boolean) — игнорировать ли вызывающий объект
- Draw Debug Type (EDrawDebugTrace) — тип отладочной отрисовки: For Duration, Persistent, None и т.д.
Выходы (данные):
- Out Hits (Array of Hit Results) — массив результатов попаданий
- Return Value (Boolean) — true, если есть хотя бы одно попадание
Пины отладки:
Trace Color (LinearColor) — цвет линии при отладке, Trace Hit Color (LinearColor) — цвет в точке попадания, Draw Time (float) — время отображения отладки (сек.)
Когда используется
- Поиск всех актёров на линии прицела (сквозные попадания через нескольких врагов).
- Проверка прямой видимости с возвратом всех преград (стены, персонажи).
- Мгновенное сканирование области (например, для Area of Effect без учёта радиуса).
Типичные проблемы
- Указан несуществующий
Profile Name— трассировка не сработает; профиль должен быть определён в Project Settings → Collision. - Забыт массив
Actors to IgnoreприIgnore Self = false— функция может задетектить самого себя (если Own Actor стоит на пути). - Отрисовка отладки включена постоянно (
Draw Debug Type = For Durationс большимDraw Time) — засоряется экран; для продакшена рекомендуетсяNone.