AActor::SetActorLocation

Move the actor instantly to the specified location.

References

Module

Engine

Header

/Engine/Source/Runtime/Engine/Classes/GameFramework/Actor.h

Include

#include "GameFramework/Actor.h"

Source

/Engine/Source/Runtime/Engine/Private/Actor.cpp

Syntax

bool SetActorLocation
(
    const FVector & NewLocation,
    bool bSweep,
    FHitResult * OutSweepHitResult,
    ETeleportType Teleport
)

Remarks

Move the actor instantly to the specified location.

Returns

Whether the location was successfully set if not swept, or whether movement occurred if swept.

Parameters

Parameter

Description

NewLocation

The new location to teleport the Actor to.

bSweep

Whether we sweep to the destination location, triggering overlaps along the way and stopping short of the target if blocked by something. Only the root component is swept and checked for blocking collision, child components move without sweeping. If collision is off, this has no effect.

Teleport

How we teleport the physics state (if physics collision is enabled for this object). If equal to ETeleportType::TeleportPhysics, physics velocity for this object is unchanged (so ragdoll parts are not affected by change in location). If equal to ETeleportType::None, physics velocity is updated based on the change in position (affecting ragdoll parts). If CCD is on and not teleporting, this will affect objects along the entire swept volume.

OutSweepHitResult

The hit result from the move if swept.

Help shape the future of Unreal Engine documentation! Tell us how we're doing so we can serve you better.
Take our survey
Cancel