UActorComponent::CanEverAffectNavigation

function Engine Since 4.0

#include "Components/ActorComponent.h"

Access: public Specifiers: inlineconst

Description

Returns whether this component can potentially influence the navigation system. This is a fast inline getter for the internal `bCanEverAffectNavigation` flag.

Caveats & Gotchas

• Returns false by default for the base UActorComponent; only primitive components and geometry-aware subclasses set this to true.
• This flag is checked by the navigation system before registering the component in the navigation octree — setting it to false after registration does not automatically unregister; call SetCanEverAffectNavigation(false) instead to trigger the proper update.

Signature

bool CanEverAffectNavigation() const

Return Type

bool

Example

Check before nav relevance query C++

if (MyComponent->CanEverAffectNavigation())
{
    // Safe to query navigation-specific data
    UNavigationSystemV1::UpdateComponentInNavOctree(*MyComponent);
}

Version History

Introduced in: 4.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?