Spawn Actor for Gameplay Task
GameplayTask_SpawnActorЧто это
Асинхронная задача (latent), которая спавнит актор заданного класса в указанной трансформации. Используется внутри Gameplay Ability System (GAS) для спавна с учётом авторитетности сервера и асинхронной загрузки. Не является pure-функцией — требует exec-соединений.
Пины
Exec-входы:
- Execute (exec) — запуск задачи
Exec-выходы:
- On Success (exec) — спавн выполнен успешно
- On Failure (exec) — спавн не удался (например, класс не загружен или нет прав)
Входы (данные):
- Task Owner (GameplayTaskOwnerInterface) — владелец задачи (обычно AbilitySystemComponent)
- Class (Actor Class) — класс спавнимого актора
- Spawn Transform (Transform) — положение, поворот и масштаб спавна
- bSpawn Only On Authority (bool) — true: спавнить только на сервере (клиенты пропускают)
- bUse Async Spawn (bool) — true: использовать асинхронный спавн (полезно для больших миров)
Выходы (данные):
- Spawned Actor (Actor Reference) — ссылка на созданный актор (доступна только при успехе)
Когда используется
Внутри Gameplay Ability, когда нужно создать актор (например, снаряд, зону эффекта) с гарантией, что спавн произойдёт на сервере, и с возможностью асинхронной загрузки класса. Удобно заменяет стандартный SpawnActor в контексте способностей.
Типичные проблемы
- Забывают подключить On Failure — при ошибке спавна задача просто завершится без уведомления, что может привести к зависанию логики.
- Неправильный Task Owner — если передан неверный владелец (не AbilitySystemComponent), задача не запустится.
- bSpawn Only On Authority = false на клиенте может привести к спавну на всех машинах, что нарушает сетевую синхронизацию.