RealDocs

UActorComponent::ClearUCSModifiedProperties

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

Description

Clears the entire UCS-modified properties list for this component, resetting all property change tracking from the User Construction Script.

Caveats & Gotchas

  • After calling this, all properties previously tracked as UCS-modified are considered 'clean' — subsequent archetype or instance data loads may overwrite them without the UCS-modified guard preventing it.
  • This is called automatically by the engine during Blueprint compilation and component re-registration. Calling it manually can desynchronize the editor's understanding of which properties are instance-overridden.

Signature

ENGINE_API void ClearUCSModifiedProperties();

Return Type

void

Example

Reset UCS tracking before re-running construction script C++
#if WITH_EDITOR
void RerunConstructionScript(UActorComponent* Comp)
{
	Comp->ClearUCSModifiedProperties();
	// Engine will call DetermineUCSModifiedProperties after UCS re-executes
}
#endif

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.