RealDocs

UActorComponent::IsUsingRegisteredSubObjectList

function Engine Since unknown
#include "Components/ActorComponent.h"
Access: public Specifiers: inline

Description

Returns true if this component replicates its sub-objects via the registered sub-object list rather than the legacy virtual ReplicateSubObjects method. Requires the owning actor to also have bReplicateUsingRegisteredSubObjectList enabled.

Caveats & Gotchas

  • Both the component and its owning actor must opt in; enabling this flag on the component while the actor still uses the legacy path silently falls back to ReplicateSubObjects().
  • The registered sub-object list path is the preferred modern approach introduced in UE 5.1; the legacy ReplicateSubObjects virtual is still called when this returns false, maintaining backward compatibility.

Signature

bool IsUsingRegisteredSubObjectList() const { return bReplicateUsingRegisteredSubObjectList; }

Return Type

bool

Example

Checking the replication path before registering a sub-object C++
void UMyComponent::BeginPlay()
{
    Super::BeginPlay();
    if (IsUsingRegisteredSubObjectList())
    {
        AddReplicatedSubObject(MySubObject);
    }
}

Version History

Introduced in: unknown

Version Status Notes
5.6 stable

Feedback

Was this helpful?

Suggest an edit

Select a field above to begin editing.