Sphere Overlap Actors
KismetSystemLibraryЧто это
Sphere Overlap Actors — exec-функция (не pure) из библиотеки KismetSystemLibrary. Выполняет сферическую проверку на перекрытие (overlap) в мире и возвращает массив всех акторов, чьи коллизии пересекаются с заданной сферой. Используется для поиска объектов радиусе вокруг точки без физического столкновения (трассировки).
Пины
Exec-входы:
- execute (exec) — запуск функции.
Exec-выходы:
- then (exec) — продолжение выполнения после завершения проверки.
Входы (данные):
- Object Types (Array of EObjectTypeQuery) — типы объектов, которые проверяются (например, WorldStatic, Pawn).
- Actor Class Filter (Class Reference) — фильтр по классу актора. Если оставить None, проверяются все акторы подходящих Object Types.
- Actors to Ignore (Array of Actor) — акторы, которые будут исключены из результатов.
- Sphere Center (Vector) — центр сферы в мировых координатах.
- Sphere Radius (Float) — радиус сферы.
- Debug Draw (EDrawDebugTrace) — режим отладки (None, ForOneFrame, ForDuration, Persistent).
Выходы (данные):
- Out Actors (Array of Actor) — массив акторов, попавших в сферу.
- Return Value (Bool) — true, если хотя бы один актор найден (то есть массив не пуст).
Пины отладки:
- Trace Color (LinearColor) — цвет отладки при нормальном проходе.
- Trace Hit Color (LinearColor) — цвет при обнаружении перекрытия.
- Draw Time (Float) — длительность отображения отладочной сферы (если Debug Draw = ForDuration).
Когда используется
- Поиск всех врагов или объектов в радиусе от персонажа (например, AoE-способности, область захвата).
- Проверка нахождения актора в зоне без использования коллизий (например, датчики присутствия).
- Отладка и визуализация зон действия с помощью параметра Debug Draw.
Типичные проблемы
- Неправильно выбран Object Types. Если тип объекта не совпадает с настройками коллизии актора (например, вместо Pawn выбран WorldStatic), функция не вернёт нужных акторов.
- Нулевой радиус. При радиусе 0 сфера превращается в точку, и результат будет пустым, если в этой точке нет актора.
- Не задан Actor Class Filter, но ожидается только определённый класс. Если не указать фильтр, функция вернёт все акторы с подходящим Object Type, что может привести к неожиданной производительности или логике.