Hit
ActorЧто это
Событие, вызываемое движком при физическом столкновении данного актора с другим объектом (попадание пули, удар, касание). Срабатывает только если у объекта включена симуляция физики и флаг «Generate Hit Events» (Simulation Generates Hit Events). Тип: exec-событие (не pure, не async).
Пины
Exec-входы:
(нет – событие вызывается движком, не из графа)
Exec-выходы:
- then (exec) – продолжение выполнения при срабатывании события
Входы (данные):
- Other (Actor) – другой актор, с которым произошло столкновение
- Other Comp (Primitive Component) – компонент другого актора, участвовавший в столкновении
- Normal Impulse (Vector) – импульс, приложенный по нормали к поверхности удара
- Hit (Hit Result) – структура с подробной информацией (локация, нормаль, ударенный компонент, материал и др.)
Выходы (данные):
нет (void)
Когда используется
- Обработка попадания снарядов (пуль, стрел, прожектайлов) в цель.
- Реализация урона при физическом контакте (столкновение машины с препятствием, падение ящика).
- Создание эффектов (взрывы, звуки, VFX) в месте удара.
Типичные проблемы
- Событие не срабатывает – забыто включение симуляции физики на акторе (Simulate Physics) или флаг «Simulation Generates Hit Events» на компоненте (обычно Collision Preset → Overlap/Block).
- Путаница между Normal Impulse и Hit.Normal – Normal Impulse – это сила удара (скаляр в векторной форме), а Hit.Normal – единичная нормаль поверхности. Часто ошибочно используют Normal Impulse как направление отскока.
- Не проверяется Other на null – если объект, вызвавщий событие, был уничтожен во время прохождения физики, Other может быть недействительным; обращение к нему вызовет краш.
- Событие вызывается несколько раз за один коллизионный контакт – это нормальное поведение для физики; нужно фильтровать повторные срабатывания, если логика должна выполниться разово (например, по временному кулдауну).