1. Epic GamesDeveloper
  3. UGameplayStatics

UGameplayStatics

Static class with useful gameplay utility functions that can be called from both Blueprint and C++

Unreal Engine C++ API Reference > Runtime > Engine > Kismet

Inheritance Hierarchy

References

   
Module Engine
Header /Engine/Source/Runtime/Engine/Classes/Kismet/GameplayStatics.h
Include #include "Kismet/GameplayStatics.h"

Syntax

UCLASS (MinimalAPI)  
class UGameplayStatics : public UBlueprintFunctionLibrary

Remarks

Static class with useful gameplay utility functions that can be called from both Blueprint and C++

Constructors

  Type Name Description
Public function  

UGameplayStatics ( const FObjectInitializer& ObjectInitializer
)

  

Functions

  Type Name Description
Public function Static UFunction BlueprintCallable, Category, Meta void

ActivateReverbEffect ( const UObject* WorldContextObject,
UReverbEffect* ReverbEffect,
FName TagName,
float Priority,
float Volume,
float FadeTime
)

 Activates a Reverb Effect without the need for an Audio Volume
Public function Static UFunction BlueprintCallable, Category void

AnnounceAccessibleString ( const FString& AnnouncementString
)

 If accessibility is enabled, have the platform announce a string to the player.
Public function Static UFunction BlueprintCallable, BlueprintAuthorityOnly, Category float

ApplyDamage ( AActor* DamagedActor,
float BaseDamage,
AController* EventInstigator,
AActor* DamageCauser,
TSubclassOf< class UDamageType > DamageTypeClass
)

 Hurts the specified actor with generic damage.
Public function Static UFunction BlueprintCallable, BlueprintAuthorityOnly, Category float

ApplyPointDamage ( AActor* DamagedActor,
float BaseDamage,
const FVector& HitFromDirection,
const FHitResult& HitInfo,
AController* EventInstigator,
AActor* DamageCauser,
TSubclassOf< class UDamageType > DamageTypeClass
)

 Hurts the specified actor with the specified impact.
Public function Static UFunction BlueprintCallable, BlueprintAuthorityOnly, Category, Meta bool

ApplyRadialDamage ( const UObject* WorldContextObject,
float BaseDamage,
const FVector& Origin,
float DamageRadius,
TSubclassOf< class UDamageType > DamageTypeClass,
const TArray< AActor* >& IgnoreActors,
AActor* DamageCauser,
AController* InstigatedByController,
bool bDoFullDamage,
ECollisionChannel DamagePreventionChannel
)

 Hurt locally authoritative actors within the radius.
Public function Static UFunction BlueprintCallable, BlueprintAuthorityOnly, Category, Meta bool

ApplyRadialDamageWithFalloff ( const UObject* WorldContextObject,
float BaseDamage,
float MinimumDamage,
const FVector& Origin,
float DamageInnerRadius,
float DamageOuterRadius,
float DamageFalloff,
TSubclassOf< class UDamageType > DamageTypeClass,
const TArray< AActor* >& IgnoreActors,
AActor* DamageCauser,
AController* InstigatedByController,
ECollisionChannel DamagePreventionChannel
)

 Hurt locally authoritative actors within the radius.
Public function Static UFunction BlueprintCallable, Category, Meta bool

AreAnyListenersWithinRange ( const UObject* WorldContextObject,
const FVector& Location,
float MaximumRange
)

 Determines if any audio listeners are within range of the specified location
Public function Static UFunction BlueprintPure, Category bool Returns whether or not subtitles are currently enabled.
Public function Static void

AsyncLoadGameFromSlot ( const FString& SlotName,
const int32 UserIndex,
FAsyncLoadGameFromSlotDelegate LoadedDelegate
)

 Schedule an async load of a specific slot.
Public function Static void

AsyncSaveGameToSlot ( USaveGame* SaveGameObject,
const FString& SlotName,
const int32 UserIndex,
FAsyncSaveGameToSlotDelegate SavedDelegate
)

 Schedule an async save to a specific slot.
Public function Static UFunction BlueprintCallable, Category, Meta AActor *

BeginDeferredActorSpawnFromClass ( const UObject* WorldContextObject,
TSubclassOf< AActor > ActorClass,
const FTransform& SpawnTransform,
ESpawnActorCollisionHandlingMethod CollisionHandlingOverride,
AActor* Owner,
ESpawnActorScaleMethod TransformScaleMethod
)

 Spawns an instance of an actor class, but does not automatically run its construction script.
Public function Static UFunction BlueprintCallable, Category, Meta AActor *

BeginSpawningActorFromBlueprint ( const UObject* WorldContextObject,
const UBlueprint* Blueprint,
const FTransform& SpawnTransform,
bool bNoCollisionFail
)

 Spawns an instance of a blueprint, but does not automatically run its construction script.
Public function Static UFunction BlueprintCallable, Category, Meta displayname bool

Blueprint_PredictProjectilePath_Advanced ( const UObject* WorldContextObject,
const FPredictProjectilePathParams& PredictParams,
FPredictProjectilePathResult& PredictResult
)

 Predict the arc of a virtual projectile affected by gravity with collision checks along the arc.
Public function Static UFunction BlueprintCallable, Category, Meta displayname bool

Blueprint_PredictProjectilePath_ByObjectType ( const UObject* WorldContextObject,
FHitResult& OutHit,
TArray< FVector >& OutPathPositions,
FVector& OutLastTraceDestination,
FVector StartPos,
FVector LaunchVelocity,
bool bTracePath,
float ProjectileRadius,
const TArray< TEnumAsByte< EObjectTypeQuery > >& ObjectTypes,
bool bTraceComplex,
const TArray< AActor* >& ActorsToIgnore,
EDrawDebugTrace::Type DrawDebugType,
float DrawDebugTime,
float SimFrequency,
float MaxSimTime,
float OverrideGravityZ
)

 Predict the arc of a virtual projectile affected by gravity with collision checks along the arc.
Public function Static UFunction BlueprintCallable, Category, Meta displayname bool

Blueprint_PredictProjectilePath_ByTraceChannel ( const UObject* WorldContextObject,
FHitResult& OutHit,
TArray< FVector >& OutPathPositions,
FVector& OutLastTraceDestination,
FVector StartPos,
FVector LaunchVelocity,
bool bTracePath,
float ProjectileRadius,
TEnumAsByte< ECollisionChannel > TraceChannel,
bool bTraceComplex,
const TArray< AActor* >& ActorsToIgnore,
EDrawDebugTrace::Type DrawDebugType,
float DrawDebugTime,
float SimFrequency,
float MaxSimTime,
float OverrideGravityZ
)

 Predict the arc of a virtual projectile affected by gravity with collision checks along the arc.
Public function Static UFunction BlueprintCallable, Category, Meta displayname bool

BlueprintSuggestProjectileVelocity ( const UObject* WorldContextObject,
FVector& TossVelocity,
FVector StartLocation,
FVector EndLocation,
float LaunchSpeed,
float OverrideGravityZ,
ESuggestProjVelocityTraceOption::Type TraceOption,
float CollisionRadius,
bool bFavorHighArc,
bool bDrawDebug,
bool bAcceptClosestOnNoSolutions
)

 Calculates an launch velocity for a projectile to hit a specified point.
Public function Static UFunction BlueprintPure, Category, Meta void

BreakHitResult ( const FHitResult& Hit,
bool& bBlockingHit,
bool& bInitialOverlap,
float& Time,
float& Distance,
FVector& Location,
FVector& ImpactPoint,
FVector& Normal,
FVector& ImpactNormal,
UPhysicalMaterial*& PhysMat,
AActor*& HitActor,
UPrimitiveComponent*& HitComponent,
FName& HitBoneName,
FName& BoneName,
int32& HitItem,
int32& ElementIndex,
int32& FaceIndex,
FVector& TraceStart,
FVector& TraceEnd
)

 Extracts data from a HitResult.
Public function Static void

CalculateViewProjectionMatricesFromMinimalView ( const FMinimalViewInfo& MinimalViewInfo,
const TOptional< FMatrix >& CustomProjectionMatrix,
FMatrix& OutViewMatrix,
FMatrix& OutProjectionMatrix,
FMatrix& OutViewProjectionMatrix
)

 Calculate view-projection matrices from a specified MinimalViewInfo and optional custom projection matrix
Public function Static void

CalculateViewProjectionMatricesFromViewTarget ( AActor* InViewTarget,
FMatrix& OutViewMatrix,
FMatrix& OutProjectionMatrix,
FMatrix& OutViewProjectionMatrix
)

 Calculate view-projection matrices from a specified view target
Public function Static UFunction BlueprintCallable, Category void Cancels all currently queued streaming packages
Public function Static UFunction BlueprintCallable, Category, Meta void

ClearSoundMixClassOverride ( const UObject* WorldContextObject,
USoundMix* InSoundMixModifier,
USoundClass* InSoundClass,
float FadeOutTime
)

 Clears any existing override of the Sound Class Adjuster in the given Sound Mix
Public function Static UFunction BlueprintCallable, Category, Meta void

ClearSoundMixModifiers ( const UObject* WorldContextObject
)

 Clear all sound mix modifiers from the audio system
Public function Static UFunction BlueprintCallable, Category, Meta APlayerController *

CreatePlayer ( const UObject* WorldContextObject,
int32 ControllerId,
bool bSpawnPlayerController
)

 Create a new local player for this game, for cases like local multiplayer.
Public function Static UFunction BlueprintCallable, Category, Meta APlayerController *

CreatePlayerFromPlatformUser ( const UObject* WorldContextObject,
FPlatformUserId UserId,
bool bSpawnPlayerController
)

 Create a new local player for this game, for cases like local multiplayer.
Public function Static UFunction BlueprintCallable, Category, Meta USaveGame * Create a new, empty SaveGame object to set data on and then pass to SaveGameToSlot.
Public function Static UFunction BlueprintCallable, Category, Meta blueprintcosmetic UAudioComponent *

CreateSound2D ( const UObject* WorldContextObject,
USoundBase* Sound,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundConcurrency* ConcurrencySettings,
bool bPersistAcrossLevelTransition,
bool bAutoDestroy
)

 This function allows users to create Audio Components in advance of playback with settings specifically for non-spatialized, non-distance-attenuated sounds.
Public function Static UFunction BlueprintCallable, Category, Meta void

DeactivateReverbEffect ( const UObject* WorldContextObject,
FName TagName
)

 Deactivates a Reverb Effect that was applied outside of an Audio Volume
Public function Static UFunction BlueprintCallable, Category bool

DeleteGameInSlot ( const FString& SlotName,
const int32 UserIndex
)

 Delete a save game in a particular slot.
Public function Static UFunction BlueprintPure, Category, Meta bool

DeprojectSceneCaptureComponentToWorld ( USceneCaptureComponent2D* SceneCaptureComponent2D,
const FVector2D& TargetUV,
FVector& WorldPosition,
FVector& WorldDirection
)

 Transforms the given 2D UV coordinate into a 3D world-space point and direction.
Public function Static UFunction BlueprintPure, Category, Meta bool

DeprojectSceneCaptureToWorld ( ASceneCapture2D const* SceneCapture2D,
const FVector2D& TargetUV,
FVector& WorldPosition,
FVector& WorldDirection
)

 Transforms the given 2D UV coordinate into a 3D world-space point and direction.
Public function Static UFunction BlueprintPure, Category, Meta bool

DeprojectScreenToWorld ( APlayerController const* Player,
const FVector2D& ScreenPosition,
FVector& WorldPosition,
FVector& WorldDirection
)

 Transforms the given 2D screen space coordinate into a 3D world-space point and direction.
Public function Static UFunction BlueprintCallable, Category bool

DoesSaveGameExist ( const FString& SlotName,
const int32 UserIndex
)

 See if a save game exists with the specified name.
Public function Static UFunction BlueprintCallable, Category, Meta void

EnableLiveStreaming ( bool Enable
)

 Toggle live DVR streaming.
Public function Static UFunction BlueprintPure, Category bool

FindCollisionUV ( const FHitResult& Hit,
int32 UVChannel,
FVector2D& UV
)

 Try and find the UV for a collision impact.
Public function Static UFunction BlueprintPure, Category AActor *

FindNearestActor ( FVector Origin,
const TArray< AActor* >& ActorsToCheck,
float& Distance
)

 Returns an Actor nearest to Origin from ActorsToCheck array.
Public function Static UFunction BlueprintCallable, Category, Meta AActor *

FinishSpawningActor ( AActor* Actor,
const FTransform& SpawnTransform,
ESpawnActorScaleMethod TransformScaleMethod
)

 'Finish' spawning an actor. This will run the construction script.
Public function Static UFunction BlueprintCallable, Category, Meta void

FlushLevelStreaming ( const UObject* WorldContextObject
)

 Flushes level streaming in blocking fashion and returns when all sub-levels are loaded / visible / hidden
Public function Static UFunction BlueprintPure, Category void

GetAccurateRealTime ( int32& Seconds,
double& PartialSeconds
)

 Returns time in seconds since the application was started.
Public function Static void

GetAccurateRealTime ( int32& Seconds,
float& PartialSeconds
)

  
Public function Static UFunction BlueprintCallable, Category, Meta FName

GetActiveSpatialPluginName ( const UObject* WorldContextObject
)

 Get currently active Audio Spatialization Plugin name
Public function Static UFunction BlueprintCallable, Category FVector Find the average location (centroid) of an array of Actors
Public function Static UFunction BlueprintCallable, Category void

GetActorArrayBounds ( const TArray< AActor* >& Actors,
bool bOnlyCollidingComponents,
FVector& Center,
FVector& BoxExtent
)

 Bind the bounds of an array of Actors
Public function Static UFunction BlueprintCallable, Category, Meta AActor *

GetActorOfClass ( const UObject* WorldContextObject,
TSubclassOf< AActor > ActorClass
)

 Find the first Actor in the world of the specified class.
Public function Static UFunction BlueprintCallable, Category, Meta void

GetAllActorsOfClass ( const UObject* WorldContextObject,
TSubclassOf< AActor > ActorClass,
TArray< AActor* >& OutActors
)

 Find all Actors in the world of the specified class.
Public function Static UFunction BlueprintCallable, Category, Meta void

GetAllActorsOfClassWithTag ( const UObject* WorldContextObject,
TSubclassOf< AActor > ActorClass,
FName Tag,
TArray< AActor* >& OutActors
)

 Find all Actors in the world of the specified class with the specified tag.
Public function Static UFunction BlueprintCallable, Category, Meta void

GetAllActorsWithInterface ( const UObject* WorldContextObject,
TSubclassOf< UInterface > Interface,
TArray< AActor* >& OutActors
)

 Find all Actors in the world with the specified interface.
Public function Static UFunction BlueprintCallable, Category, Meta void

GetAllActorsWithTag ( const UObject* WorldContextObject,
FName Tag,
TArray< AActor* >& OutActors
)

 Find all Actors in the world with the specified tag.
Public function Static UFunction BlueprintPure, Category, Meta double

GetAudioTimeSeconds ( const UObject* WorldContextObject
)

 Returns time in seconds since world was brought up for play, IS stopped when game pauses, NOT dilated/clamped.
Public function Static UFunction BlueprintCallable, Category, Meta TArray< FName >

GetAvailableSpatialPluginNames ( const UObject* WorldContextObject
)

 Get list of available Audio Spatialization Plugin names
Public function Static UFunction BlueprintCallable, Category, Meta bool

GetClosestListenerLocation ( const UObject* WorldContextObject,
const FVector& Location,
float MaximumRange,
const bool bAllowAttenuationOverride,
FVector& ListenerPosition
)

 Finds and returns the position of the closest listener to the specified location
Public function Static UFunction BlueprintCallable, Category, Meta FString

GetCurrentLevelName ( const UObject* WorldContextObject,
bool bRemovePrefixString
)

 Get the name of the currently-open level.
Public function Static UFunction BlueprintCallable, Category, Meta UReverbEffect *

GetCurrentReverbEffect ( const UObject* WorldContextObject
)

 Returns the highest priority reverb settings currently active from any source (Audio Volumes or manual settings).
Public function Static UFunction BlueprintCallable, Category, Meta bool

GetEnableWorldRendering ( const UObject* WorldContextObject
)

 Returns the world rendering state
Public function Static UFunction BlueprintPure, Category, Meta UGameInstance *

GetGameInstance ( const UObject* WorldContextObject
)

 Returns the game instance object
Public function Static UFunction BlueprintPure, Category, Meta AGameModeBase *

GetGameMode ( const UObject* WorldContextObject
)

 Returns the current GameModeBase or Null if it can't be retrieved, such as on the client
Public function Static UFunction BlueprintPure, Category, Meta AGameStateBase *

GetGameState ( const UObject* WorldContextObject
)

 Returns the current GameStateBase or Null if it can't be retrieved
Public function Static UFunction BlueprintPure, Category, Meta float

GetGlobalTimeDilation ( const UObject* WorldContextObject
)

 Gets the current global time dilation.
Public function Static UFunction BlueprintPure, Category, Meta int32

GetIntOption ( const FString& Options,
const FString& Key,
int32 DefaultValue
)

 Find an option in the options string and return it as an integer.
Public function Static UFunction BlueprintPure, Category, Meta void

GetKeyValue ( const FString& Pair,
FString& Key,
FString& Value
)

 Break up a key=value pair into its key and value.
Public function Static UFunction BlueprintCallable, Category, Meta int32

GetMaxAudioChannelCount ( const UObject* WorldContextObject
)

 Retrieves the max voice count currently used by the audio engine.
Public function Static UFunction BlueprintPure, Category, Meta int32

GetNumLocalPlayerControllers ( const UObject* WorldContextObject
)

 Returns the number of fully initialized local players, this will be 0 on dedicated servers.
Public function Static UFunction BlueprintPure, Category, Meta int32

GetNumPlayerControllers ( const UObject* WorldContextObject
)

 Returns the total number of available player controllers, including remote players when called on a server.
Public function Static UFunction BlueprintPure, Category, Meta int32

GetNumPlayerStates ( const UObject* WorldContextObject
)

 Returns the number of active player states, there is one player state for every connected player even if they are a remote client.
Public function Static UFunction BlueprintPure, Category, Meta UClass *

GetObjectClass ( const UObject* Object
)

 Returns the class of a passed in Object, will always be valid if Object is not NULL
Public function Static UFunction BlueprintPure, Category FString Returns the string name of the current platform, to perform different behavior based on platform.
Public function Static UFunction BlueprintPure, Category, Meta APlayerCameraManager *

GetPlayerCameraManager ( const UObject* WorldContextObject,
int32 PlayerIndex
)

 Returns the camera manager for the Player Controller at the specified player index.
Public function Static UFunction BlueprintPure, Category, Meta ACharacter *

GetPlayerCharacter ( const UObject* WorldContextObject,
int32 PlayerIndex
)

 Returns the pawn for the player controller at the specified player index, will return null if the pawn is not a character.
Public function Static UFunction BlueprintPure, Category, Meta APlayerController *

GetPlayerController ( const UObject* WorldContextObject,
int32 PlayerIndex
)

 Returns the player controller found while iterating through the local and available remote player controllers.
Public function Static UFunction BlueprintPure, Category, Meta APlayerController *

GetPlayerControllerFromID ( const UObject* WorldContextObject,
int32 ControllerID
)

 Returns the player controller with the specified physical controller ID.
Public function Static UFunction BlueprintPure, Category, Meta APlayerController *

GetPlayerControllerFromPlatformUser ( const UObject* WorldContextObject,
FPlatformUserId UserId
)

 Returns the player controller with the specified physical controller ID.
Public function Static UFunction BlueprintPure, Category, Meta int32 Gets what physical controller ID a player is using. This only works for local player controllers.
Public function Static UFunction BlueprintPure, Category, Meta APawn *

GetPlayerPawn ( const UObject* WorldContextObject,
int32 PlayerIndex
)

 Returns the pawn for the player controller at the specified player index.
Public function Static UFunction BlueprintPure, Category, Meta APlayerState *

GetPlayerState ( const UObject* WorldContextObject,
int32 PlayerStateIndex
)

 Returns the player state at the given index in the game state's PlayerArray.
Public function Static UFunction BlueprintPure, Category, Meta APlayerState *

GetPlayerStateFromUniqueNetId ( const UObject* WorldContextObject,
const FUniqueNetIdRepl& UniqueId
)

 Returns the player state that matches the passed in online id, or null for an invalid one.
Public function Static UFunction BlueprintPure, Category, Meta double

GetRealTimeSeconds ( const UObject* WorldContextObject
)

 Returns time in seconds since world was brought up for play, does NOT stop when game pauses, NOT dilated/clamped
Public function Static UFunction BlueprintPure, Category, Meta ULevelStreaming *

GetStreamingLevel ( const UObject* WorldContextObject,
FName PackageName
)

 Returns level streaming object with specified level package name
Public function Static UFunction BlueprintPure, Category EPhysicalSurface

GetSurfaceType ( const FHitResult& Hit
)

 Returns the EPhysicalSurface type of the given Hit.
Public function Static UFunction BlueprintPure, Category, Meta double

GetTimeSeconds ( const UObject* WorldContextObject
)

 Returns time in seconds since world was brought up for play, adjusted by time dilation and IS stopped when game pauses
Public function Static UFunction BlueprintPure, Category, Meta double

GetUnpausedTimeSeconds ( const UObject* WorldContextObject
)

 Returns time in seconds since world was brought up for play, adjusted by time dilation and IS NOT stopped when game pauses
Public function Static UFunction BlueprintPure, Category, Meta EMouseCaptureMode

GetViewportMouseCaptureMode ( const UObject* WorldContextObject
)

 Returns the current viewport mouse capture mode
Public function Static UFunction BlueprintPure, Category void

GetViewProjectionMatrix ( FMinimalViewInfo DesiredView,
FMatrix& ViewMatrix,
FMatrix& ProjectionMatrix,
FMatrix& ViewProjectionMatrix
)

 Returns the View Matrix, Projection Matrix and the View x Projection Matrix for a given view
Public function Static UFunction BlueprintPure, Category, Meta double

GetWorldDeltaSeconds ( const UObject* WorldContextObject
)

 Returns the frame delta time in seconds, adjusted by time dilation.
Public function Static UFunction BlueprintPure, Category, Meta FIntVector

GetWorldOriginLocation ( const UObject* WorldContextObject
)

 Returns world origin current location.
Public function Static bool

GrabOption ( FString& Options,
FString& ResultString
)

  
Public function Static UFunction BlueprintCallable, Category, Meta int32

GrassOverlappingSphereCount ( const UObject* WorldContextObject,
const UStaticMesh* StaticMesh,
FVector CenterPosition,
float Radius
)

 Counts how many grass foliage instances overlap a given sphere.
Public function Static UFunction BlueprintPure, Category bool

HasLaunchOption ( const FString& OptionToCheck
)

 Checks the commandline to see if the desired option was specified on the commandline (e.g. -demobuild)
Public function Static UFunction BlueprintPure, Category, Meta bool

HasOption ( FString Options,
const FString& InKey
)

 Returns whether a key exists in an options string.
Public function Static UFunction BlueprintPure, Category, Meta blueprintcosmetic bool

IsAnyLocalPlayerCameraWithinRange ( const UObject* WorldContextObject,
const FVector& Location,
float MaximumRange
)

 Determines if any local player controller's camera is within range of the specified location.
Public function Static UFunction BlueprintPure, Category, Meta bool

IsGamePaused ( const UObject* WorldContextObject
)

 Returns the game's paused state
Public function Static bool

IsProjectileTrajectoryBlocked ( const UWorld* World,
FVector StartLocation,
FVector& ProjectileVelocity,
float TargetDeltaXY,
float GravityZ,
float CollisionRadius,
ESuggestProjVelocityTraceOption::Type TraceOption,
const FCollisionResponseParams& ResponseParam,
const TArray< AActor* >& ActorsToIgnore,
bool bDrawDebug
)

 Stepwise trace along the path of a given velocity
Public function Static UFunction BlueprintPure, Category, Meta bool

IsSplitscreenForceDisabled ( const UObject* WorldContextObject
)

 Returns the split screen state
Public function Static bool

LoadDataFromSlot ( TArray< uint8 >& OutSaveData,
const FString& SlotName,
const int32 UserIndex
)

 Load contents from a slot/file into a buffer of save data.
Public function Static USaveGame *

LoadGameFromMemory ( const TArray< uint8 >& InSaveData
)

 Tries to load a SaveGame object from a given array of bytes.
Public function Static UFunction BlueprintCallable, Category USaveGame *

LoadGameFromSlot ( const FString& SlotName,
const int32 UserIndex
)

 Load the contents from a given slot.
Public function Static UFunction BlueprintCallable, Category, Meta void

LoadStreamLevel ( const UObject* WorldContextObject,
FName LevelName,
bool bMakeVisibleAfterLoad,
bool bShouldBlockOnLoad,
FLatentActionInfo LatentInfo
)

 Stream the level (by Name); Calling again before it finishes has no effect
Public function Static UFunction BlueprintCallable, Category, Meta void

LoadStreamLevelBySoftObjectPtr ( const UObject* WorldContextObject,
const TSoftObjectPtr< UWorld > Level,
bool bMakeVisibleAfterLoad,
bool bShouldBlockOnLoad,
FLatentActionInfo LatentInfo
)

 Stream the level (by Object Reference); Calling again before it finishes has no effect
Public function Static UFunction BlueprintPure, Category, Meta FHitResult

MakeHitResult ( bool bBlockingHit,
bool bInitialOverlap,
float Time,
float Distance,
FVector Location,
FVector ImpactPoint,
FVector Normal,
FVector ImpactNormal,
UPhysicalMaterial* PhysMat,
AActor* HitActor,
UPrimitiveComponent* HitComponent,
FName HitBoneName,
FName BoneName,
int32 HitItem,
int32 ElementIndex,
int32 FaceIndex,
FVector TraceStart,
FVector TraceEnd
)

 Create a HitResult struct
Public function Static UFunction BlueprintPure, Category, Meta bool
ObjectIsA

( const UObject* Object,
TSubclassOf< UObject > ObjectClass
)

 Returns whether or not the object passed in is of (or inherits from) the class type.
Public function Static UFunction BlueprintCallable, Category, Meta void

OpenLevel ( const UObject* WorldContextObject,
FName LevelName,
bool bAbsolute,
FString Options
)

 Travel to another level
Public function Static UFunction BlueprintCallable, Category, Meta void

OpenLevelBySoftObjectPtr ( const UObject* WorldContextObject,
const TSoftObjectPtr< UWorld > Level,
bool bAbsolute,
FString Options
)

 Travel to another level
Public function Static UFunction BlueprintPure, Category, Meta FString

ParseOption ( FString Options,
const FString& Key
)

 Find an option in the options string and return it.
Public function Static UFunction BlueprintCallable, Category, Meta blueprintcosmetic void

PlayDialogue2D ( const UObject* WorldContextObject,
UDialogueWave* Dialogue,
const FDialogueContext& Context,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime
)

 Plays a dialogue directly with no attenuation, perfect for UI.
Public function Static void

PlayDialogueAtLocation ( const UObject* WorldContextObject,
UDialogueWave* Dialogue,
const FDialogueContext& Context,
FVector Location,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundAttenuation* AttenuationSettings
)

  
Public function Static UFunction BlueprintCallable, Category, Meta void

PlayDialogueAtLocation ( const UObject* WorldContextObject,
UDialogueWave* Dialogue,
const FDialogueContext& Context,
FVector Location,
FRotator Rotation,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundAttenuation* AttenuationSettings
)

 Plays a dialogue at the given location.
Public function Static UFunction BlueprintCallable, Category, Meta blueprintcosmetic void

PlaySound2D ( const UObject* WorldContextObject,
USoundBase* Sound,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundConcurrency* ConcurrencySettings,
const AActor* OwningActor,
bool bIsUISound
)

 Plays a sound directly with no attenuation, perfect for UI sounds.
Public function Static UFunction BlueprintCallable, Category, Meta void

PlaySoundAtLocation ( const UObject* WorldContextObject,
USoundBase* Sound,
FVector Location,
FRotator Rotation,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundAttenuation* AttenuationSettings,
USoundConcurrency* ConcurrencySettings,
const AActor* OwningActor,
const UInitialActiveSoundParams* InitialParams
)

 Plays a sound at the given location.
Public function Static void

PlaySoundAtLocation ( const UObject* WorldContextObject,
USoundBase* Sound,
FVector Location,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundAttenuation* AttenuationSettings,
USoundConcurrency* ConcurrencySettings,
const UInitialActiveSoundParams* InitialParams
)

  
Public function Static UFunction BlueprintCallable, Category, Meta void

PlayWorldCameraShake ( const UObject* WorldContextObject,
TSubclassOf< class UCameraShakeBase > Shake,
FVector Epicenter,
float InnerRadius,
float OuterRadius,
float Falloff,
bool bOrientShakeTowardsEpicenter
)

 Plays an in-world camera shake that affects all nearby local players, with distance-based attenuation.
Public function Static UFunction BlueprintCallable, Category, Meta void

PopSoundMixModifier ( const UObject* WorldContextObject,
USoundMix* InSoundMixModifier
)

 Pop a sound mix modifier from the audio system
Public function Static bool

PredictProjectilePath ( const UObject* WorldContextObject,
const FPredictProjectilePathParams& PredictParams,
FPredictProjectilePathResult& PredictResult
)

 Predict the arc of a virtual projectile affected by gravity with collision checks along the arc.
Public function Static UFunction BlueprintCallable, Category void Primes the sound waves in the given USoundClass, caching the first chunk of streamed audio.
Public function Static UFunction BlueprintCallable, Category void

PrimeSound ( USoundBase* InSound
)

 Primes the sound, caching the first chunk of streamed audio.
Public function Static UFunction BlueprintPure, Category bool

ProjectWorldToScreen ( APlayerController const* Player,
const FVector& WorldPosition,
FVector2D& ScreenPosition,
bool bPlayerViewportRelative
)

 Transforms the given 3D world-space point into a its 2D screen space coordinate.
Public function Static UFunction BlueprintCallable, Category, Meta void

PushSoundMixModifier ( const UObject* WorldContextObject,
USoundMix* InSoundMixModifier
)

 Push a sound mix modifier onto the audio system
Public function Static UFunction BlueprintPure, Category, Meta FVector

RebaseLocalOriginOntoZero ( UObject* WorldContextObject,
FVector WorldLocation
)

 Returns origin based position for local world location.
Public function Static UFunction BlueprintPure, Category, Meta FVector

RebaseZeroOriginOntoLocal ( UObject* WorldContextObject,
FVector WorldLocation
)

 Returns local location for origin based position.
Public function Static UFunction BlueprintCallable, Category, Meta void

RemovePlayer ( APlayerController* Player,
bool bDestroyPawn
)

 Removes a local player from this game.
Public function Static bool

SaveDataToSlot ( const TArray< uint8 >& InSaveData,
const FString& SlotName,
const int32 UserIndex
)

 Save the contents of the buffer to a platform-specific save slot/file
Public function Static bool

SaveGameToMemory ( USaveGame* SaveGameObject,
TArray< uint8 >& OutSaveData
)

 Serialize our USaveGame object into a given array of bytes
Public function Static UFunction BlueprintCallable, Category bool

SaveGameToSlot ( USaveGame* SaveGameObject,
const FString& SlotName,
const int32 UserIndex
)

 Save the contents of the SaveGameObject to a platform-specific save slot/file.
Public function Static UFunction BlueprintCallable, Category, Meta bool

SetActiveSpatialPluginByName ( const UObject* WorldContextObject,
FName InPluginName
)

 Get list of available Audio Spatialization Plugins
Public function Static UFunction BlueprintCallable, Category, Meta void

SetBaseSoundMix ( const UObject* WorldContextObject,
USoundMix* InSoundMix
)

 Audio Functions -------------------------
Public function Static UFunction BlueprintCallable, Category, Meta void

SetEnableWorldRendering ( const UObject* WorldContextObject,
bool bEnable
)

 Enabled rendering of the world
Public function Static UFunction BlueprintCallable, Category, Meta void

SetForceDisableSplitscreen ( const UObject* WorldContextObject,
bool bDisable
)

 Enables split screen
Public function Static UFunction BlueprintCallable, Category, Meta bool

SetGamePaused ( const UObject* WorldContextObject,
bool bPaused
)

 Sets the game's paused state
Public function Static UFunction BlueprintCallable, Category, Meta blueprintcosmetic void

SetGlobalListenerFocusParameters ( const UObject* WorldContextObject,
float FocusAzimuthScale,
float NonFocusAzimuthScale,
float FocusDistanceScale,
float NonFocusDistanceScale,
float FocusVolumeScale,
float NonFocusVolumeScale,
float FocusPriorityScale,
float NonFocusPriorityScale
)

 Sets the global listener focus parameters, which will scale focus behavior of sounds based on their focus azimuth settings in their attenuation settings.
Public function Static UFunction BlueprintCallable, Category, Meta blueprintcosmetic void

SetGlobalPitchModulation ( const UObject* WorldContextObject,
float PitchModulation,
float TimeSec
)

 Sets a global pitch modulation scalar that will apply to all non-UI sounds
Public function Static UFunction BlueprintCallable, Category, Meta void

SetGlobalTimeDilation ( const UObject* WorldContextObject,
float TimeDilation
)

 Sets the global time dilation.
Public function Static UFunction BlueprintCallable, Category, Meta void

SetMaxAudioChannelsScaled ( const UObject* WorldContextObject,
float MaxChannelCountScale
)

 Sets the max number of voices (also known as "channels") dynamically by percentage.
Public function Static UFunction BlueprintCallable, Category, Meta void

SetPlayerControllerID ( APlayerController* Player,
int32 ControllerId
)

 Sets what physical controller ID a player should be using.
Public function Static UFunction BlueprintCallable, Category, Meta void Sets what platform user id a player should be using. This only works for local player controllers.
Public function Static UFunction BlueprintCallable, Category, Meta blueprintcosmetic void

SetSoundClassDistanceScale ( const UObject* WorldContextObject,
USoundClass* SoundClass,
float DistanceAttenuationScale,
float TimeSec
)

 Linearly interpolates the attenuation distance scale value from it's current attenuation distance override value (1.0f it not overridden) to its new attenuation distance override, over the given amount of time
Public function Static UFunction BlueprintCallable, Category, Meta void

SetSoundMixClassOverride ( const UObject* WorldContextObject,
USoundMix* InSoundMixModifier,
USoundClass* InSoundClass,
float Volume,
float Pitch,
float FadeInTime,
bool bApplyToChildren
)

 Overrides the sound class adjuster in the given sound mix.
Public function Static UFunction BlueprintCallable, Category void

SetSubtitlesEnabled ( bool bEnabled
)

 Will set subtitles to be enabled or disabled.
Public function Static UFunction BlueprintCallable, Category, Meta void

SetViewportMouseCaptureMode ( const UObject* WorldContextObject,
const EMouseCaptureMode MouseCaptureMode
)

 Sets the current viewport mouse capture mode
Public function Static UFunction BlueprintCallable, Category, Meta void

SetWorldOriginLocation ( const UObject* WorldContextObject,
FIntVector NewLocation
)

 Requests a new location for a world origin.
Public function Static UFunction BlueprintCallable, Category, Meta blueprintcosmetic UDecalComponent *

SpawnDecalAtLocation ( const UObject* WorldContextObject,
UMaterialInterface* DecalMaterial,
FVector DecalSize,
FVector Location,
FRotator Rotation,
float LifeSpan
)

 Spawns a decal at the given location and rotation, fire and forget. Does not replicate.
Public function Static UFunction BlueprintCallable, Category, Meta blueprintcosmetic UDecalComponent *

SpawnDecalAttached ( UMaterialInterface* DecalMaterial,
FVector DecalSize,
USceneComponent* AttachToComponent,
FName AttachPointName,
FVector Location,
FRotator Rotation,
EAttachLocation::Type LocationType,
float LifeSpan
)

 Spawns a decal attached to and following the specified component. Does not replicate.
Public function Static UFunction BlueprintCallable, Category, Meta blueprintcosmetic UAudioComponent *

SpawnDialogue2D ( const UObject* WorldContextObject,
UDialogueWave* Dialogue,
const FDialogueContext& Context,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
bool bAutoDestroy
)

 Spawns a DialogueWave, a special type of Asset that requires Context data in order to resolve a specific SoundBase, which is then passed on to the new Audio Component.
Public function Static UFunction BlueprintCallable, Category, Meta UAudioComponent *

SpawnDialogueAtLocation ( const UObject* WorldContextObject,
UDialogueWave* Dialogue,
const FDialogueContext& Context,
FVector Location,
FRotator Rotation,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundAttenuation* AttenuationSettings,
bool bAutoDestroy
)

 Spawns a DialogueWave, a special type of Asset that requires Context data in order to resolve a specific SoundBase, which is then passed on to the new Audio Component.
Public function Static UAudioComponent *

SpawnDialogueAttached ( UDialogueWave* Dialogue,
const FDialogueContext& Context,
USceneComponent* AttachToComponent,
FName AttachPointName,
FVector Location,
EAttachLocation::Type LocationType,
bool bStopWhenAttachedToDestroyed,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundAttenuation* AttenuationSettings,
bool bAutoDestroy
)

  
Public function Static UFunction BlueprintCallable, Category, Meta UAudioComponent *

SpawnDialogueAttached ( UDialogueWave* Dialogue,
const FDialogueContext& Context,
USceneComponent* AttachToComponent,
FName AttachPointName,
FVector Location,
FRotator Rotation,
EAttachLocation::Type LocationType,
bool bStopWhenAttachedToDestroyed,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundAttenuation* AttenuationSettings,
bool bAutoDestroy
)

 Spawns a DialogueWave, a special type of Asset that requires Context data in order to resolve a specific SoundBase, which is then passed on to the new Audio Component.
Public function Static UFunction BlueprintCallable, Category, Meta UParticleSystemComponent *

SpawnEmitterAtLocation ( const UObject* WorldContextObject,
UParticleSystem* EmitterTemplate,
FVector Location,
FRotator Rotation,
FVector Scale,
bool bAutoDestroy,
EPSCPoolMethod PoolingMethod,
bool bAutoActivateSystem
)

 Plays the specified effect at the given location and rotation, fire and forget.
Public function Static UParticleSystemComponent *

SpawnEmitterAtLocation ( const UObject* WorldContextObject,
UParticleSystem* EmitterTemplate,
FVector Location,
FRotator Rotation,
bool bAutoDestroy,
EPSCPoolMethod PoolingMethod,
bool bAutoActivateSystem
)

 Backwards compatible version of SpawnEmitterAttached for C++ without Scale.
Public function Static UParticleSystemComponent *

SpawnEmitterAtLocation ( UWorld* World,
UParticleSystem* EmitterTemplate,
const FTransform& SpawnTransform,
bool bAutoDestroy,
EPSCPoolMethod PoolingMethod,
bool bAutoActivate
)

 Plays the specified effect at the given location and rotation, fire and forget.
Public function Static UParticleSystemComponent *

SpawnEmitterAttached ( UParticleSystem* EmitterTemplate,
USceneComponent* AttachToComponent,
FName AttachPointName,
FVector Location,
FRotator Rotation,
EAttachLocation::Type LocationType,
bool bAutoDestroy,
EPSCPoolMethod PoolingMethod,
bool bAutoActivate
)

 Backwards compatible version of SpawnEmitterAttached for C++ without Scale.
Public function Static UFunction BlueprintCallable, Category, Meta UParticleSystemComponent *

SpawnEmitterAttached ( UParticleSystem* EmitterTemplate,
USceneComponent* AttachToComponent,
FName AttachPointName,
FVector Location,
FRotator Rotation,
FVector Scale,
EAttachLocation::Type LocationType,
bool bAutoDestroy,
EPSCPoolMethod PoolingMethod,
bool bAutoActivate
)

 Plays the specified effect attached to and following the specified component.
Public function Static UFunction BlueprintCallable, Category, Meta UForceFeedbackComponent *

SpawnForceFeedbackAtLocation ( const UObject* WorldContextObject,
UForceFeedbackEffect* ForceFeedbackEffect,
FVector Location,
FRotator Rotation,
bool bLooping,
float IntensityMultiplier,
float StartTime,
UForceFeedbackAttenuation* AttenuationSettings,
bool bAutoDestroy
)

 Plays a force feedback effect at the given location.
Public function Static UFunction BlueprintCallable, Category, Meta UForceFeedbackComponent *

SpawnForceFeedbackAttached ( UForceFeedbackEffect* ForceFeedbackEffect,
USceneComponent* AttachToComponent,
FName AttachPointName,
FVector Location,
FRotator Rotation,
EAttachLocation::Type LocationType,
bool bStopWhenAttachedToDestroyed,
bool bLooping,
float IntensityMultiplier,
float StartTime,
UForceFeedbackAttenuation* AttenuationSettings,
bool bAutoDestroy
)

 Plays a force feedback effect attached to and following the specified component.
Public function Static UFunction BlueprintCallable, Category, Meta UObject *

SpawnObject ( TSubclassOf< UObject > ObjectClass,
UObject* Outer
)

 Create Object
Public function Static UFunction BlueprintCallable, Category, Meta blueprintcosmetic UAudioComponent *

SpawnSound2D ( const UObject* WorldContextObject,
USoundBase* Sound,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundConcurrency* ConcurrencySettings,
bool bPersistAcrossLevelTransition,
bool bAutoDestroy
)

 This function allows users to create Audio Components with settings specifically for non-spatialized, non-distance-attenuated sounds.
Public function Static UFunction BlueprintCallable, Category, Meta UAudioComponent *

SpawnSoundAtLocation ( const UObject* WorldContextObject,
USoundBase* Sound,
FVector Location,
FRotator Rotation,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundAttenuation* AttenuationSettings,
USoundConcurrency* ConcurrencySettings,
bool bAutoDestroy
)

 Spawns a sound at the given location.
Public function Static UFunction BlueprintCallable, Category, Meta UAudioComponent *

SpawnSoundAttached ( USoundBase* Sound,
USceneComponent* AttachToComponent,
FName AttachPointName,
FVector Location,
FRotator Rotation,
EAttachLocation::Type LocationType,
bool bStopWhenAttachedToDestroyed,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundAttenuation* AttenuationSettings,
USoundConcurrency* ConcurrencySettings,
bool bAutoDestroy
)

 This function allows users to create and play Audio Components attached to a specific Scene Component.
Public function Static UAudioComponent *

SpawnSoundAttached ( USoundBase* Sound,
USceneComponent* AttachToComponent,
FName AttachPointName,
FVector Location,
EAttachLocation::Type LocationType,
bool bStopWhenAttachedToDestroyed,
float VolumeMultiplier,
float PitchMultiplier,
float StartTime,
USoundAttenuation* AttenuationSettings,
USoundConcurrency* ConcurrencySettings,
bool bAutoDestroy
)

  
Public function Static FMemoryReader

StripSaveGameHeader ( const TArray< uint8 >& SaveData
)

 Takes the provided buffer and consumes it, parsing past the internal header data, returning a MemoryReader that has: 1) been set up with all the related header information, and 2) offset to where tagged USaveGame object serialization begins. NOTE: that the returned object has a reference to the supplied data - scope them accordingly.
Public function Static bool

SuggestProjectileVelocity ( const UObject* WorldContextObject,
FVector& TossVelocity,
FVector StartLocation,
FVector EndLocation,
float TossSpeed,
bool bHighArc,
float CollisionRadius,
float OverrideGravityZ,
ESuggestProjVelocityTraceOption::Type TraceOption,
FCollisionResponseParams& ResponseParam,
TArray< AActor* > ActorsToIgnore,
bool bDrawDebug,
bool bAcceptClosestOnNoSolutions
)

  
Public function Static bool

SuggestProjectileVelocity ( const FSuggestProjectileVelocityParameters& ProjectileParams,
FVector& OutTossVelocity
)

 Native version, has more options than the Blueprint version.
Public function Static UFunction BlueprintCallable, Category, Meta displayname bool

SuggestProjectileVelocity_CustomArc ( const UObject* WorldContextObject,
FVector& OutLaunchVelocity,
FVector StartPos,
FVector EndPos,
float OverrideGravityZ,
float ArcParam
)

 Returns the launch velocity needed for a projectile at rest at StartPos to land on EndPos.
Public function Static UFunction BlueprintCallable, Category, Meta displayname bool

SuggestProjectileVelocity_MovingTarget ( const UObject* WorldContextObject,
FVector& OutLaunchVelocity,
FVector ProjectileStartLocation,
AActor* TargetActor,
FVector TargetLocationOffset,
double GravityZOverride,
double TimeToTarget,
EDrawDebugTrace::Type DrawDebugType,
float DrawDebugTime,
FLinearColor DrawDebugColor
)

 Returns a launch velocity need for a projectile to hit the TargetActor in TimeToTarget seconds based on the TargetActor's current velocity.
Public function Static UFunction BlueprintPure, Category FVector

TransformWorldToFirstPerson ( const FMinimalViewInfo& ViewInfo,
const FVector& WorldPosition,
bool bIgnoreFirstPersonScale
)

 Transforms a world space location into "first person space".
Public function Static UFunction BlueprintCallable, Category, Meta void

UnloadStreamLevel ( const UObject* WorldContextObject,
FName LevelName,
FLatentActionInfo LatentInfo,
bool bShouldBlockOnUnload
)

 Unload a streamed in level (by Name)
Public function Static UFunction BlueprintCallable, Category, Meta void

UnloadStreamLevelBySoftObjectPtr ( const UObject* WorldContextObject,
const TSoftObjectPtr< UWorld > Level,
FLatentActionInfo LatentInfo,
bool bShouldBlockOnUnload
)

 Unload a streamed in level (by Object Reference)
Public function Static UFunction BlueprintCallable, Category void Iterate through all sound waves and releases handles to retained chunks.

Classes

  Type Name Description
Public struct FSuggestProjectileVelocityParameters Struct of parameters passed to SuggestProjectileVelocity function.  

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page