Make Gameplay Tag Query Match Any Tags
BlueprintGameplayTagLibraryЧто это
Pure-функция, создающая запрос GameplayTagQuery в режиме «совпадение хотя бы одного тега» (логическое ИЛИ). Возвращает готовый объект запроса для проверки через DoesContainerMatchTagQuery или другие функции сопоставления. Не имеет пинов выполнения (pure).
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Tags (Array of GameplayTag) — массив тегов; запрос будет считаться успешным, если у проверяемого объекта присутствует хотя бы один из этих тегов.
Выходы (данные):
- Return Value (Gameplay Tag Query) — созданный запрос.
Когда используется
Когда нужно отфильтровать объекты по наличию любого из нескольких тегов (например, «враг ИЛИ союзник», «огонь ИЛИ вода»). Удобно для проверки принадлежности к нескольким категориям без создания составных условий.
Типичные проблемы
- Пустой массив
Tags— запрос никогда не совпадёт (всегда false). Всегда проверяйте, что массив не пуст перед созданием запроса. - Путаница с
MatchAllTags— данная функция работает по принципу ИЛИ (достаточно одного совпадения), а не И (нужны все). Использование не той функции приводит к логическим ошибкам.