Set Avoidance Group Mask
CharacterMovementComponentЧто это
Exec-функция класса CharacterMovementComponent. Устанавливает маску группы избегания (Avoidance Group) для этого персонажа. Используется при работе с системой Crowd Avoidance (RVO). Определяет, к каким группам относится агент — другие агенты с совпадающими масками будут учитываться при расчёте уклонения. Выходных данных не имеет (void).
Пины
Exec-входы:
- execute (exec) — запуск функции.
Exec-выходы:
- then (exec) — продолжение выполнения после установки маски.
Входы (данные):
- Target (CharacterMovementComponent) — объект движения, чья маска изменяется (обычно подключается как self).
- GroupMask (Byte) — битовая маска групп (значения 0–255). Каждый бит соответствует одной из 8 доступных групп избегания.
Выходы (данные):
- нет (void).
Когда используется
- При инициализации или изменении принадлежности агента к группам в сценах с толпой (Crowd Manager).
- Для настройки взаимного уклонения между разными типами юнитов (например, враги игнорируют друг друга, если маски не пересекаются).
- В системах, где нужно гибко управлять, какие объекты будут избегать друг друга (через комбинацию SetAvoidanceGroupMask и SetGroupsToAvoidMask).
Типичные проблемы
- Неправильная маска: передача десятичного числа вместо битового представления (например, 255 вместо
1 | 4). В BP маску проще выставить как константу байта. - Не включён Crowd Manager: без настроенного менеджера толпы или отключённого
bUseAvoidanceнаCharacterMovementComponentфункция не даст эффекта — персонаж всё равно не будет уклоняться. - Путаница с соседними функциями: есть отдельные
SetAvoidanceGroup(имя группы в enum) иSetGroupsToAvoidMask(какие группы избегать) — не перепутайте назначение пинов.