RealDocs

UActorComponent::IsNavigationRelevant

function Engine Since 4.0
#include "Components/ActorComponent.h"
Access: public Specifiers: virtualconst

Description

Override to indicate that this component actively contributes navigation data. The base implementation returns false; subclasses such as UNavMeshBoundsVolume override it to return true when the component should register geometry in the navigation octree.

Caveats & Gotchas

  • This is distinct from CanEverAffectNavigation: `CanEverAffectNavigation` is a fast flag check, while `IsNavigationRelevant` is a virtual query that can evaluate dynamic conditions (e.g., a component might only be relevant when its owner is active).
  • If you override this and sometimes return true, also ensure `CanEverAffectNavigation` returns true — the navigation system short-circuits on the flag before ever calling this virtual.

Signature

virtual bool IsNavigationRelevant() const { return false; }

Return Type

bool

Example

Override in a custom nav-relevant component C++
virtual bool IsNavigationRelevant() const override
{
    // Only relevant when the zone is active
    return bZoneIsActive && Super::IsNavigationRelevant();
}

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.