RealDocs

UCharacterMovementComponent::GroupsToAvoid

property Engine Blueprint Since 4.0
#include "GameFramework/CharacterMovementComponent.h"
Access: public Specifiers: UPROPERTYEditAnywhereBlueprintReadOnlyAdvancedDisplay

Description

Mask of avoidance groups this character will actively steer around when using RVO avoidance.

Caveats & Gotchas

  • GroupsToIgnore takes priority over this — an agent whose group appears in both masks is ignored, not avoided.
  • Use SetGroupsToAvoidMask() to change this at runtime; direct property assignment doesn't update the registered avoidance state.
  • SetGroupsToAvoid(int32) is deprecated; prefer the FNavAvoidanceMask overload.

Signature

FNavAvoidanceMask GroupsToAvoid

Example

Avoid a specific group C++
GetCharacterMovement()->SetGroupsToAvoidMask(FNavAvoidanceMask(1 << 0));

Version History

Introduced in: 4.0

Version Status Notes
5.6 stable

Feedback

Was this helpful?

Suggest an edit

Select a field above to begin editing.