UPrimitiveComponent

class Engine Blueprint Since unknown

Inherits: UObjectBase › UObjectBaseUtility › UObject › UActorComponent › USceneComponent

#include "Components/PrimitiveComponent.h"

Description

The base class for all components that have a visual representation and can interact with the physics and collision systems. Extends USceneComponent with rendering, collision, and physics capabilities.

Caveats & Gotchas

• Collision and physics settings (simulation, collision profiles, responses) are on UPrimitiveComponent, not on USceneComponent. If you're looking for SetSimulatePhysics or SetCollisionEnabled, they are here.
• Overlap and hit events are only fired when both the component's collision is enabled AND the actor has overlap/hit generation enabled (bGenerateOverlapEvents / simulation for hit). Both sides of the interaction must have compatible settings.
• Physics simulation is incompatible with attachment in most cases — simulating a component while attached to another can produce jitter or incorrect behaviour. Detach before enabling physics simulation at runtime.

Example

Configure collision in BeginPlay C++

void AMyActor::BeginPlay()
{
	Super::BeginPlay();

	if (UPrimitiveComponent* Prim = Cast<UPrimitiveComponent>(GetRootComponent()))
	{
		Prim->SetCollisionProfileName(TEXT("BlockAllDynamic"));
		Prim->OnComponentBeginOverlap.AddDynamic(this, &AMyActor::OnOverlap);
	}
}

Functions (8)

Collision 4 Utility 1 Physics 3

Collision

4 ▼

Access	Type	Name	Description
public	function	UPrimitiveComponent::SetCollisionEnabled	Sets the collision enabled state on the component.
public	function	UPrimitiveComponent::SetCollisionProfileName	Applies a named collision preset to the component, setting its object type, enabled state, and all channel responses in one call.
public	function	UPrimitiveComponent::SetCollisionResponseToAllChannels	Sets this component's response to all collision channels to a single value at once.
public	function	UPrimitiveComponent::SetCollisionResponseToChannel	Sets this component's response to a single collision channel.

Utility

1 ▼

Access	Type	Name	Description
public	function	UPrimitiveComponent::GetBodyInstance	Returns the FBodyInstance for this component's physics body, providing direct access to low-level physics properties and operations.

Physics

3 ▼

Access	Type	Name	Description
public	function	UPrimitiveComponent::AddForce	Applies a continuous force to the physics body each frame it is called.
public	function	UPrimitiveComponent::AddImpulse	Applies an instantaneous impulse to the component's physics body.
public	function	UPrimitiveComponent::SetSimulatePhysics	Enables or disables physics simulation on the component.

Properties

Access	Type	Name	Description
public	property	UPrimitiveComponent::OnComponentBeginOverlap	Delegate fired when another component begins overlapping this component.
public	property	UPrimitiveComponent::OnComponentEndOverlap	Delegate fired when a previously overlapping component stops overlapping.
public	property	UPrimitiveComponent::OnComponentHit	Delegate fired when this component physically hits another.

Events & Delegates

event OnComponentHit event OnComponentBeginOverlap event OnComponentEndOverlap

Version History

Introduced in: unknown

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?