第一次提交

Plugins/GCS/Source/GenericGameplayAbilities/Public/Utilities/GGA_GameplayCueFunctionLibrary.h

@@ -0,0 +1,50 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GameplayEffectTypes.h"
+#include "GameplayTagContainer.h"
+#include "Kismet/BlueprintFunctionLibrary.h"
+#include "GGA_GameplayCueFunctionLibrary.generated.h"
+
+/**
+ * Blueprint function library for gameplay cue operations.
+ * 用于游戏反馈操作的蓝图函数库。
+ */
+UCLASS()
+class GENERICGAMEPLAYABILITIES_API UGGA_GameplayCueFunctionLibrary : public UBlueprintFunctionLibrary
+{
+	GENERATED_BODY()
+
+public:
+	/**
+	 * Executes a local gameplay cue on an actor.
+	 * 在演员上执行本地游戏反馈。
+	 * @param Actor The actor to execute the cue on. 要执行反馈的演员。
+	 * @param GameplayCueTag The gameplay cue tag. 游戏反馈标签。
+	 * @param GameplayCueParameters Parameters for the gameplay cue. 游戏反馈参数。
+	 */
+	UFUNCTION(BlueprintCallable, Category = "GGA|GameplayCue", Meta = (DefaultToSelf="Actor", AutoCreateRefTerm = "GameplayCueParameters", GameplayTagFilter = "GameplayCue"))
+	static void ExecuteGameplayCueLocal(AActor* Actor, const FGameplayTag GameplayCueTag, const FGameplayCueParameters& GameplayCueParameters);
+
+	/**
+	 * Adds a local gameplay cue to an actor.
+	 * 向演员添加本地游戏反馈。
+	 * @param Actor The actor to add the cue to. 要添加反馈的演员。
+	 * @param GameplayCueTag The gameplay cue tag. 游戏反馈标签。
+	 * @param GameplayCueParameters Parameters for the gameplay cue. 游戏反馈参数。
+	 */
+	UFUNCTION(BlueprintCallable, Category = "GGA|GameplayCue", Meta = (DefaultToSelf="Actor", AutoCreateRefTerm = "GameplayCueParameters", GameplayTagFilter = "GameplayCue"))
+	static void AddGameplayCueLocal(AActor* Actor, const FGameplayTag GameplayCueTag, const FGameplayCueParameters& GameplayCueParameters);
+
+	/**
+	 * Removes a local gameplay cue from an actor.
+	 * 从演员移除本地游戏反馈。
+	 * @param Actor The actor to remove the cue from. 要移除反馈的演员。
+	 * @param GameplayCueTag The gameplay cue tag. 游戏反馈标签。
+	 * @param GameplayCueParameters Parameters for the gameplay cue. 游戏反馈参数。
+	 */
+	UFUNCTION(BlueprintCallable, Category = "GGA|GameplayCue", Meta = (DefaultToSelf="Actor", AutoCreateRefTerm = "GameplayCueParameters", GameplayTagFilter = "GameplayCue"))
+	static void RemoveGameplayCueLocal(AActor* Actor, const FGameplayTag GameplayCueTag, const FGameplayCueParameters& GameplayCueParameters);
+};