Predict Projectile Path (Advanced)
GameplayStaticsЧто это
Exec-функция для предсказания траектории снаряда с учётом физики (гравитация, сопротивление воздуха). Позволяет получить массив точек пути и результат первого столкновения. Отличается от обычной версии расширенным набором параметров (выбор канала/профиля коллизий, игнорирование типов хитов).
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Start Position (Vector) — начальная позиция снаряда
- Launch Velocity (Vector) — начальная скорость (вектор)
- bTracePath (bool) — если true, выполняется трассировка пути
- Projectile Radius (float) — радиус сферы для трассировки
- bTraceComplex (bool) — трассировать сложные коллизии (true) или простые (false)
- Max Simulation Time (float) — максимальное время симуляции в секундах
- Sim Frequency (float) — частота симуляции (шаг по времени)
- Override Gravity Z (float) — переопределение гравитации по Z (0 = использовать мировую)
- Draw Debug Type (EDrawDebugTrace) — тип отладки (None, ForOneFrame, ForDuration, Persistent)
- Draw Debug Time (float) — время отображения отладки (если DrawDebugType = ForDuration)
- Trace Channel (ETraceTypeQuery) — канал трассировки (используется при bTraceWithChannel = true)
- Actors to Ignore (Array of Actor) — массив актёров, игнорируемых при трассировке
- bTraceWithChannel (bool) — если true, используется Trace Channel
- bTraceWithCollisionProfile (bool) — если true, используется Collision Profile Name
- Collision Profile Name (Name) — имя профиля коллизий
- bIgnore Blocking Hits (bool) — игнорировать блокирующие хиты
- bIgnore Touches (bool) — игнорировать касания (overlaps)
Выходы (данные):
- Out Hit (Hit Result) — результат первого столкновения (если было)
- Out Path Positions (Array of Vector) — массив точек вдоль траектории
- Return Value (bool) — true, если произошло хотя бы одно столкновение
Когда используется
- Прицеливание с учётом физики (гравитация, сопротивление) для снарядов, ракет, гранат.
- Предварительный просмотр траектории (например, линия прицела с отладкой).
- Проверка возможности броска или выстрела в заданную точку с учётом препятствий.
Типичные проблемы
- Неправильный Trace Channel или Collision Profile — трассировка может не замечать нужные объекты (например, стены, если канал настроен только на персонажей).
- Забытый Projectile Radius — при радиусе 0 трассировка становится точечной (линией), что не учитывает размер снаряда и может пропускать столкновения.
- Слишком маленькое Max Simulation Time или Sim Frequency — траектория обрывается раньше времени или даёт слишком редкие точки, что ломает визуализацию и логику попадания.
- Пустой Actors to Ignore — снаряд может «застрять» в самом стреляющем актёре, если он не исключён из трассировки.