Predict Projectile Path By TraceChannel
GameplayStaticsЧто это
Exec-функция для трассировки снаряда с учётом гравитации и коллизий по указанному TraceChannel. Возвращает точку попадания (если есть) и массив точек траектории. Полезна для прицеливания, предсказания траектории, AI-расчётов.
Пины
Exec-входы:
- execute (exec) — запуск трассировки
Exec-выходы:
- then (exec) — выполнение после завершения
Входы (данные):
- Start Pos (Vector) — начальная точка снаряда
- Launch Velocity (Vector) — начальная скорость (см/с)
- bTracePath (bool) — true = строить полную траекторию, false = только первый хит
- TraceChannel (ETraceTypeQuery) — канал трассировки (например, Visibility, Camera)
- bTraceComplex (bool) — true = сложная коллизия (по полигонам), false = упрощённая (по коллизионным примитивам)
- Actors to Ignore (Array of Actor) — актёры, которые не учитываются при трассировке
- DrawDebugType (EDrawDebugTrace) — тип отладки (None, ForOneFrame, ForDuration, Persistent)
- DrawDebugTime (float) — время отображения отладки (если DrawDebugType != None)
- SimFrequency (float) — частота симуляции (по умолчанию 15 Гц)
- SimStepMaxTime (float) — максимальный шаг симуляции (по умолчанию 0.05 с)
- OverrideGravityZ (float) — переопределение гравитации по Z (0 = использовать мировую)
- ProjectileRadius (float) — радиус снаряда для swept-трассировки
Выходы (данные):
- OutHit (Hit Result) — результат первого столкновения (если есть)
- OutPathPositions (Array of Vector) — массив точек траектории (если bTracePath = true)
- ReturnValue (bool) — true, если было хотя бы одно столкновение
Пины отладки: DrawDebugType (EDrawDebugTrace), DrawDebugTime (float) — уже указаны во входах.
Когда используется
- Предрасчёт траектории для стрельбы (например, AI-персонажи, прицельные маркеры).
- Проверка, достигнет ли снаряд цели с учётом гравитации и препятствий.
- Отладка траектории с визуализацией (DrawDebugType).
Типичные проблемы
- Неправильный TraceChannel — часто используют Visibility вместо Camera (или наоборот), из-за чего трассировка не видит нужные объекты.
- Забытые Actors to Ignore — если не исключить самого стреляющего персонажа, он может блокировать собственную траекторию.
- Неверная Launch Velocity — скорость должна быть в см/с, а не единичный вектор направления; иначе траектория будет слишком короткой или бесконечной.