UDocumentation UE5.7 10.02.2026 (Source)
API documentation for Unreal Engine 5.7
BlueprintGameplayTagLibrary.h
Go to the documentation of this file.
1// Copyright Epic Games, Inc. All Rights Reserved.
2
3#pragma once
4
5#include "CoreMinimal.h"
12#include "BlueprintGameplayTagLibrary.generated.h"
13
14UCLASS(meta=(ScriptName="GameplayTagLibrary"), MinimalAPI)
16{
18
19
28 UFUNCTION(BlueprintPure, Category="GameplayTags", meta = (Keywords = "DoGameplayTagsMatch", BlueprintThreadSafe))
29 static GAMEPLAYTAGS_API bool MatchesTag(FGameplayTag TagOne, FGameplayTag TagTwo, bool bExactMatch);
30
40 UFUNCTION(BlueprintPure, Category="GameplayTags", meta = (BlueprintThreadSafe))
41 static GAMEPLAYTAGS_API bool MatchesAnyTags(FGameplayTag TagOne, const FGameplayTagContainer& OtherContainer, bool bExactMatch);
42
44 UFUNCTION(BlueprintPure, meta=(DisplayName="Equal (GameplayTag)", CompactNodeTitle="==", BlueprintThreadSafe), Category="GameplayTags")
46
48 UFUNCTION(BlueprintPure, meta=(DisplayName="Not Equal (GameplayTag)", CompactNodeTitle="!=", BlueprintThreadSafe), Category="GameplayTags")
50
52 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
53 static GAMEPLAYTAGS_API bool IsGameplayTagValid(FGameplayTag GameplayTag);
54
56 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
57 static GAMEPLAYTAGS_API FName GetTagName(const FGameplayTag& GameplayTag);
58
60 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
61 static GAMEPLAYTAGS_API FGameplayTag MakeLiteralGameplayTag(FGameplayTag Value);
62
70 UFUNCTION(BlueprintPure, Category="GameplayTags", meta = (BlueprintThreadSafe))
71 static GAMEPLAYTAGS_API int32 GetNumGameplayTagsInContainer(const FGameplayTagContainer& TagContainer);
72
82 UFUNCTION(BlueprintPure, Category="GameplayTags", meta = (Keywords = "DoesContainerHaveTag", BlueprintThreadSafe))
83 static GAMEPLAYTAGS_API bool HasTag(const FGameplayTagContainer& TagContainer, FGameplayTag Tag, bool bExactMatch);
84
94 UFUNCTION(BlueprintPure, Category="GameplayTags", meta = (Keywords = "DoesContainerMatchAnyTagsInContainer", BlueprintThreadSafe))
95 static GAMEPLAYTAGS_API bool HasAnyTags(const FGameplayTagContainer& TagContainer, const FGameplayTagContainer& OtherContainer, bool bExactMatch);
96
106 UFUNCTION(BlueprintPure, Category="GameplayTags", meta = (Keywords = "DoesContainerMatchAllTagsInContainer", BlueprintThreadSafe))
107 static GAMEPLAYTAGS_API bool HasAllTags(const FGameplayTagContainer& TagContainer, const FGameplayTagContainer& OtherContainer, bool bExactMatch);
108
117 UFUNCTION(BlueprintPure, Category="GameplayTags", meta = (BlueprintThreadSafe))
119
127 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
128 static GAMEPLAYTAGS_API bool IsTagQueryEmpty(const FGameplayTagQuery& TagQuery);
129
138 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
139 static GAMEPLAYTAGS_API bool DoesContainerMatchTagQuery(const FGameplayTagContainer& TagContainer, const FGameplayTagQuery& TagQuery);
140
148 UFUNCTION(BlueprintCallable, Category="GameplayTags", meta=(WorldContext="WorldContextObject", DeterminesOutputType="ActorClass", DynamicOutputParam="OutActors"))
149 static GAMEPLAYTAGS_API void GetAllActorsOfClassMatchingTagQuery(UObject* WorldContextObject, TSubclassOf<AActor> ActorClass, const FGameplayTagQuery& GameplayTagQuery, TArray<AActor*>& OutActors);
150
157 UFUNCTION(BlueprintCallable, Category = "GameplayTags", meta = (BlueprintThreadSafe))
159
166 UFUNCTION(BlueprintCallable, Category = "GameplayTags", meta = (BlueprintThreadSafe))
167 static GAMEPLAYTAGS_API bool RemoveGameplayTag(UPARAM(ref) FGameplayTagContainer& TagContainer, FGameplayTag Tag);
168
175 UFUNCTION(BlueprintCallable, Category = "GameplayTags", meta = (BlueprintThreadSafe))
176 static GAMEPLAYTAGS_API void AppendGameplayTagContainers(UPARAM(ref) FGameplayTagContainer& InOutTagContainer, const FGameplayTagContainer& InTagContainer);
177
179 UFUNCTION(BlueprintPure, meta=(DisplayName="Equal (GameplayTagContainer)", CompactNodeTitle="==", BlueprintThreadSafe), Category="GameplayTags")
181
183 UFUNCTION(BlueprintPure, meta=(DisplayName="Not Equal (GameplayTagContainer)", CompactNodeTitle="!=", BlueprintThreadSafe), Category="GameplayTags")
185
187 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
188 static GAMEPLAYTAGS_API FGameplayTagContainer MakeLiteralGameplayTagContainer(FGameplayTagContainer Value);
189
191 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
192 static GAMEPLAYTAGS_API FGameplayTagContainer MakeGameplayTagContainerFromArray(const TArray<FGameplayTag>& GameplayTags);
193
195 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
196 static GAMEPLAYTAGS_API FGameplayTagContainer MakeGameplayTagContainerFromTag(FGameplayTag SingleTag);
197
199 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
200 static GAMEPLAYTAGS_API void BreakGameplayTagContainer(const FGameplayTagContainer& GameplayTagContainer, TArray<FGameplayTag>& GameplayTags);
201
209 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
211
219 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
220 static GAMEPLAYTAGS_API FGameplayTagQuery MakeGameplayTagQuery_MatchAnyTags(const FGameplayTagContainer& InTags);
221
229 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
230 static GAMEPLAYTAGS_API FGameplayTagQuery MakeGameplayTagQuery_MatchAllTags(const FGameplayTagContainer& InTags);
231
239 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe))
240 static GAMEPLAYTAGS_API FGameplayTagQuery MakeGameplayTagQuery_MatchNoTags(const FGameplayTagContainer& InTags);
241
250 UFUNCTION(BlueprintPure, meta = (BlueprintInternalUseOnly = "TRUE"))
252
261 UFUNCTION(BlueprintPure, meta = (BlueprintInternalUseOnly = "TRUE"))
263
272 UFUNCTION(BlueprintPure, meta = (BlueprintInternalUseOnly = "TRUE"))
274
276 UFUNCTION(BlueprintPure, Category = PinOptions, meta = (BlueprintInternalUseOnly = "TRUE"))
277 static GAMEPLAYTAGS_API bool NotEqual_TagTag(FGameplayTag A, FString B);
278
280 UFUNCTION(BlueprintPure, Category = PinOptions, meta = (BlueprintInternalUseOnly = "TRUE"))
281 static GAMEPLAYTAGS_API bool NotEqual_TagContainerTagContainer(FGameplayTagContainer A, FString B);
282
284 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta=(DefaultToSelf=TagContainerInterface))
286
288 UFUNCTION(BlueprintPure, meta=(DisplayName = "To GameplayTagAssetInterface", CompactNodeTitle = "->", BlueprintAutocast), Category="Utilities|Casting")
289 static GAMEPLAYTAGS_API TScriptInterface<IGameplayTagAssetInterface> Conv_ObjectToGameplayTagAssetInterface(UObject* InObject);
290
296 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe, BlueprintAutocast))
297 static GAMEPLAYTAGS_API FString GetDebugStringFromGameplayTagContainer(const FGameplayTagContainer& TagContainer);
298
304 UFUNCTION(BlueprintPure, Category = "GameplayTags", meta = (BlueprintThreadSafe, BlueprintAutocast))
305 static GAMEPLAYTAGS_API FString GetDebugStringFromGameplayTag(FGameplayTag GameplayTag);
306
307};
FPlatformTypes::int32 int32
A 32-bit signed integer.
Definition Platform.h:1125
UE_FORCEINLINE_HINT TSharedRef< CastToType, Mode > StaticCastSharedRef(TSharedRef< CastFromType, Mode > const &InSharedRef)
Definition SharedPointer.h:127
#define UPARAM(...)
Definition ObjectMacros.h:748
#define UFUNCTION(...)
Definition ObjectMacros.h:745
#define GENERATED_UCLASS_BODY(...)
Definition ObjectMacros.h:768
#define UCLASS(...)
Definition ObjectMacros.h:776
Definition NameTypes.h:617
Definition Array.h:670
Definition ScriptInterface.h:139
Definition SubclassOf.h:30
Definition BlueprintFunctionLibrary.h:16
Definition BlueprintGameplayTagLibrary.h:16
Definition Object.h:95
Definition GameplayTagContainer.h:251
Definition GameplayTagContainer.h:739
Definition GameplayTagContainer.h:45