Line Trace By Channel
KismetSystemLibraryЧто это
Лучевая трассировка (line trace) по одному физическому каналу. Exec-функция: при запуске выполняет проверку пересечения отрезка с геометрией мира и возвращает первый попавшийся объект (ближайшее попадание). Используется для лучей прицеливания, проверки видимости, взаимодействия и т.д.
Пины
Exec-входы:
- execute (exec) — запуск трассировки.
Exec-выходы:
- then (exec) — продолжение выполнения после завершения.
Входы (данные):
- Start (Vector) — начальная точка луча.
- End (Vector) — конечная точка луча.
- Trace Channel (byte) — канал трассировки (например, Visibility, Camera).
- bTraceComplex (bool) — true — трассировка по сложным коллизиям (полигонально), false — по упрощённым (примитивным).
- Actors to Ignore (Array of Actor) — список акторов, которые не будут учитываться при попадании.
Выходы (данные):
- Out Hit (Hit Result) — структура с деталями попадания (актор, точка, нормаль, расстояние и др.).
- Return Value (bool) — true, если луч что-то задел, иначе false.
Пины отладки: Trace Color (LinearColor), Trace Hit Color (LinearColor), Draw Time (float), Draw Debug Type (byte) — позволяют визуализировать луч в редакторе/игре.
Когда используется
- Проверка линии видимости (Line of Sight) между двумя точками.
- Определение объекта под прицелом (рейкаст от камеры).
- Взаимодействие с предметами (клик, наведение).
- Построение простых снарядов (лазеры, лучи).
Типичные проблемы
- Неправильно выбран Trace Channel — луч не видит объект, потому что его коллизия настроена на другой канал (например, Visibility вместо Camera).
- Не указан Actors to Ignore при трассировке от персонажа — персонаж может попадать сам в себя (если его коллизия не игнорируется), что даёт ложное срабатывание.
- Ожидание попадания только по акторам с определённым коллиженом — если на объекте не выставлен нужный ответ на канал (Block/Overlap/Ignore), луч пролетит мимо, хотя визуально объект есть.