Predict Projectile Path By ObjectType
GameplayStaticsЧто это
Exec-функция класса GameplayStatics, предсказывающая траекторию снаряда с учётом столкновений с объектами, но игнорирующая акторов указанного типа (по классу). Позволяет получить точку попадания, нормаль, конечную позицию и массив результатов столкновений. Используется для прицеливания, AI-расчётов и отладки траекторий.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Start Position (Vector) — начальная точка траектории
- Launch Velocity (Vector) — начальная скорость (вектор)
- bUseTraceComplex (bool) — использовать сложную трассировку (учитывает геометрию коллизий)
- Trace Channel (ECollisionChannel) — канал коллизий (например, Static, Dynamic)
- Actors to Ignore (Array of Actor) — массив акторов, которые будут проигнорированы при столкновении
- bDrawTrace (bool) — рисовать отладочную линию траектории
- Trace Color (LinearColor) — цвет отладочной линии
- Draw Time (float) — время отображения отладочной линии (сек)
Выходы (данные):
- bHit (bool) — произошло ли столкновение
- Hit Location (Vector) — точка столкновения
- Hit Normal (Vector) — нормаль в точке столкновения
- End Position (Vector) — конечная точка траектории (если столкновения нет — последняя точка по дальности)
- Out Hits (Array of HitResult) — массив результатов всех столкновений вдоль траектории
Когда используется
- Расчёт траектории пули/снаряда с игнорированием дружественных юнитов или самого стреляющего.
- Предварительная проверка линии огня для AI (например, чтобы AI не стрелял сквозь союзников).
- Отладка и визуализация траектории в редакторе или во время игры.
Типичные проблемы
- Неправильный Trace Channel — если выбран канал, не соответствующий настройкам коллизий объектов, траектория может не учитывать нужные столкновения.
- Забытый Actors to Ignore — без указания акторов снаряд может столкнуться с самим стреляющим или с другими нецелевыми объектами, что даст ложное срабатывание.
- bUseTraceComplex = false при сложной геометрии — упрощённая трассировка может пропустить столкновения с мелкими или наклонными поверхностями, что приведёт к неточному результату.