Get All Child Actors
Actor
0
Что это
Возвращает массив всех дочерних акторов, прикреплённых к указанному актору (через Attach или как компоненты-акторы). Чистая (pure) функция — не имеет exec-пинов, вызывается без потока выполнения.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (Actor Object Reference) — актор, чьих потомков нужно получить
- Include Descendants (Boolean, по умолч. false) — если true, включает не только прямых детей, но и всех потомков рекурсивно
Выходы (данные):
- Child Actors (Array of Actor Object Reference) — массив найденных дочерних акторов (порядок не гарантирован)
Когда используется
- Получить список объектов, прикреплённых к персонажу, предмету или триггеру (например, рюкзак, оружие, части конструкции).
- Для рекурсивного обхода иерархии акторов при очистке, перемещении или инспекции сцены.
Типичные проблемы
- Забытый флаг Include Descendants: если нужно собрать всех потомков (а не только прямых детей), флаг должен быть включён — иначе результат будет неполным.
- Изменение массива во время итерации: после вызова функции нельзя удалять или создавать новые дочерние акторы в цикле по полученному массиву без копии.
- Пустой массив может быть нормой — проверять через
Is ValidилиLength, а не полагаться на наличие ненулевых элементов.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.