Unreal Engine 4.26 Documentation

Unreal Engine 4.27 Documentation

Unreal Engine 5.0 Documentation

Unreal Engine 5.1 Documentation

Unreal Engine 5.2 Documentation

Unreal Engine 5.3 Documentation

> Unreal Engine API Reference > Plugins > GameplayAbilities > FGameplayAbilitySpec

Light Theme

Dark Theme

FGameplayAbilitySpec

An activatable ability spec, hosted on the ability system component.

Choose your operating system:

Windows

macOS

Linux

Inheritance Hierarchy

FFastArraySerializerItem

FGameplayAbilitySpec

References

Module	GameplayAbilities
Header	/Engine/Plugins/Runtime/GameplayAbilities/Source/GameplayAbilities/Public/GameplayAbilitySpec.h
Include	#include "GameplayAbilitySpec.h"

Syntax

USTRUCT(BlueprintType)
struct FGameplayAbilitySpec : public FFastArraySerializerItem

Remarks

An activatable ability spec, hosted on the ability system component. This defines both what the ability is (what class, what level, input binding etc) and also holds runtime state that must be kept outside of the ability being instanced/activated.

Variables

	Name	Description
UGameplayAbilit...	Ability	Ability of the spec (Always the CDO. This should be const but too many things modify it currently)
FGameplayAbilit...	ActivationInfo	Activation state of this ability.
uint8	ActiveCount	A count of the number of times this ability has been activated minus the number of times it has been ended.
uint8: 1	bActivateOnce	This ability should be activated once when it is granted.
FGameplayTagCon...	DynamicAbilityTags	Optional ability tags that are replicated.
FActiveGameplay...	GameplayEffectHandle	Handle to GE that granted us (usually invalid)
FGameplayAbilit...	Handle	Handle for outside sources to refer to this spec by
int32	InputID	InputID, if bound
uint8: 1	InputPressed	Is input currently pressed. Set to false when input is released
int32	Level	Level of Ability
TArray< UGamepl...	NonReplicatedInstances	Non replicating instances of this ability.
uint8: 1	PendingRemove	Pending removal due to scope lock
uint8: 1	RemoveAfterActivation	If true, this ability should be removed as soon as it finishes executing
TArray< UGamepl...	ReplicatedInstances	Replicated instances of this ability..
TMap< FGameplay...	SetByCallerTagMagnitudes	Passed on SetByCaller magnitudes if this ability was granted by a GE
UObject *	SourceObject	Object this ability was created from, can be an actor or static object.

Constructors

	Name	Description
	FGameplayAbilitySpec()
	FGameplayAbilitySpec ( FGameplayAbilitySpecDef& InDef, int32 InGameplayEffectLevel, FActiveGameplayEffectHandle InGamep... )	Version that takes an existing spec def
	FGameplayAbilitySpec ( TSubclassOf< UGameplayAbility > InA..., int32 InLevel, int32 InInputID, UObject* InSourceObject )	Version that takes an ability class
	FGameplayAbilitySpec ( UGameplayAbility* InAbility, int32 InLevel, int32 InInputID, UObject* InSourceObject )	Version that takes an ability CDO, this exists for backward compatibility

Functions

	Name	Description
TArray< UGam...	GetAbilityInstances()	Returns all instances, which can include instance per execution abilities
FString	GetDebugString()
UGameplayAbi...	GetPrimaryInstance()	Returns the primary instance, used for instance once abilities
bool	IsActive()	Returns true if this ability is active in any way
void	PostReplicatedAdd ( const FGameplayAbilitySpecContainer... )
void	PreReplicatedRemove ( const FGameplayAbilitySpecContainer... )
bool	ShouldReplicateAbilitySpec()	Interface function to see if the ability should replicated the ability spec or not