Run EQS
AITask_RunEQS
0
Что это
Async-функция (AI Task) для запуска Environmental Query System (EQS) из Blueprint. Выполняет запрос к окружению (например, поиск лучшей позиции, цели или укрытия) и возвращает результат через exec-выходы. Не pure, требует exec-соединения.
Пины
Exec-входы:
- Execute (exec) — запуск задачи
Exec-выходы:
- OnFinished (exec) — EQS успешно завершён, результат доступен
- OnFailed (exec) — EQS не дал результата (пустой запрос, ошибка)
Входы (данные):
- QueryTemplate (EnvQuery) — шаблон EQS-запроса (создаётся в редакторе EQS)
- BlackboardKey (BlackboardKeySelector) — ключ Blackboard, куда будет записан результат (если нужно)
- RunMode (EEnvQueryRunMode) — режим выполнения (один лучший, все результаты, случайный и т.д.)
Выходы (данные):
- Result (EQSQueryResult) — результат запроса (содержит массив найденных объектов/точек; тип зависит от шаблона)
Когда используется
- Поиск укрытия для AI (EQS с тестом на видимость и расстояние).
- Выбор цели атаки (EQS с оценкой здоровья, дистанции, угрозы).
- Динамическое определение точки для перемещения (патруль, фланг).
Типичные проблемы
- Не настроен QueryTemplate — пустой или неправильный шаблон приводит к OnFailed.
- Забыт BlackboardKey — результат не будет записан в Blackboard, если это ожидается.
- Неправильный RunMode — например, «All Results» при ожидании одного лучшего может вызвать путаницу в логике.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.