Sphere Trace By Profile
KismetSystemLibraryЧто это
Выполняет трассировку сферой по заданному профилю коллизий. Возвращает первый попавшийся объект (одиночный хит). Exec-функция (не pure, не async).
Пины
Exec-входы:
- execute (exec) — запуск трассировки
Exec-выходы:
- then (exec) — продолжение выполнения после завершения трассировки
Входы (данные):
- Start (Vector) — начальная точка трассировки
- End (Vector) — конечная точка трассировки
- Radius (float) — радиус сферы
- ProfileName (Name) — имя профиля коллизий (например,
Pawn,Visibility) - bTraceComplex (bool) — учитывать сложную геометрию (true — детальные коллизии, false — упрощённые)
- bIgnoreSelf (bool) — игнорировать вызывающий актор
- ActorsToIgnore (Array of Actor) — массив акторов, которые не должны учитываться при попадании
- DrawDebugType (EDrawDebugTrace) — режим отладки (None, ForOneFrame, ForDuration, Persistent)
- TraceColor (LinearColor) — цвет отладочной линии (если отладка включена)
- TraceHitColor (LinearColor) — цвет линии при попадании
- DrawTime (float) — длительность отображения отладки (если DrawDebugType == ForDuration)
Выходы (данные):
- OutHit (Hit Result) — структура с информацией о попадании (актор, точка, нормаль, кость и т.д.)
- ReturnValue (bool) — true, если было попадание; false — если нет
Пины отладки: DrawDebugType (EDrawDebugTrace), TraceColor (LinearColor), TraceHitColor (LinearColor), DrawTime (float) — уже перечислены во входах.
Когда используется
- Проверка, есть ли объект на пути сферы (например, для атак AoE, проверки видимости, физических взаимодействий).
- Поиск первого препятствия между двумя точками с учётом профиля коллизий (например, луч с радиусом для имитации «толстого» луча).
Типичные проблемы
- Неправильный ProfileName — если профиль не задан в проекте или не соответствует ожидаемым коллизиям, трассировка может не находить объекты.
- Забытый ActorsToIgnore — при многократных вызовах в одном кадре (например, в цикле) без игнорирования уже проверенных акторов можно получить ложные попадания.
- Слишком большой Radius — сфера может захватывать объекты, которые визуально не должны пересекаться с лучом, что приводит к неожиданным результатам.