Apply Damage
GameplayStaticsЧто это
Применяет чистый урон к актёру, вызывая на нём событие TakeDamage. Exec-функция (не pure). Встроена в GameplayStatics, доступна без инстанса.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Damaged Actor (Actor Object Reference) — актёр, получающий урон
- Base Damage (Float) — базовая величина урона (до модификаторов)
- Event Instigator (Controller Reference) — контроллер, инициировавший урон (может быть None)
- Damage Causer (Actor Object Reference) — физический причинитель урона (например, пуля, снаряд)
- Damage Type Class (Damage Type Class Reference) — класс типа урона (например,
UDamageType)
Выходы (данные):
- Return Value (Float) — фактический урон после применения всех модификаторов (возвращается из события
TakeDamage)
Когда используется
Нанесение урона вручную, когда нужно сымитировать попадание или атаку, не используя системный канал повреждений (например, для запуска кастомной реакции или тестирования). Вызов этой функции автоматически вызовет событие TakeDamage на целевом актёре.
Типичные проблемы
- None в Damage Type Class: если тип урона не указан, класс урона будет считаться базовым
UDamageType, что может игнорировать настройки уязвимости или сопротивления. - Пропущен Event Instigator / Damage Causer: многие реакции на урон (например, анимации, отслеживание убийств) зависят от этих пинов — их отсутствие ломает логику.
- Несовпадение Base Damage и Return Value: не стоит полагаться, что фактический урон равен базовому — внутри
TakeDamageможет быть пересчёт, который меняет итоговое значение (например, через Gameplay Effects в проектах с GAS).