第一次提交

Plugins/GCS/Source/GenericGameplayAttributes/Public/GGA_AttributeSystemComponent.h

@@ -0,0 +1,98 @@
+// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.
+
+#pragma once
+
+#include "CoreMinimal.h"
+#include "GGA_GameplayAttributeStructLibrary.h"
+#include "Components/ActorComponent.h"
+#include "GGA_AttributeSystemComponent.generated.h"
+
+DECLARE_DYNAMIC_MULTICAST_DELEGATE_FourParams(FGGA_OnPostAttributeChangeSignature, UAttributeSet*, AttributeSet, const FGameplayAttribute&, Attribute, const float, OldValue, const float, NewValue);
+
+DECLARE_DYNAMIC_MULTICAST_DELEGATE_FourParams(FGGA_OnAttributeChangedSignature, UAttributeSet*, AttributeSet, const FGameplayAttribute&, Attribute, const float, NewValue, float, PrevValue);
+
+DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FGGA_OnPostGameplayEffectExecuteSignature, const FGGA_GameplayEffectModCallbackData&, Data);
+
+/**
+ * The main component for reacting to changes in gameplay attributes.
+ * 对游戏属性变化做出反应的主要组件。
+ */
+UCLASS(ClassGroup=(GGA), BlueprintType, Blueprintable, meta=(BlueprintSpawnableComponent))
+class GENERICGAMEPLAYATTRIBUTES_API UGGA_AttributeSystemComponent : public UActorComponent
+{
+	GENERATED_BODY()
+
+public:
+	// Sets default values for this component's properties
+	UGGA_AttributeSystemComponent();
+
+	void ReceivePreAttributeChange(UAttributeSet* AttributeSet, const FGameplayAttribute& Attribute, float& NewValue);
+
+	void ReceivePostAttributeChange(UAttributeSet* AttributeSet, const FGameplayAttribute& Attribute, float OldValue, float NewValue);
+
+	bool ReceivePreGameplayEffectExecute(UAttributeSet* AttributeSet, FGameplayEffectModCallbackData& Data);
+
+	void ReceivePostGameplayEffectExecute(UAttributeSet* AttributeSet, const FGameplayEffectModCallbackData& Data);
+
+	void ReceiveAttributeChange(UAttributeSet* AttributeSet, const FGameplayAttribute& Attribute, const float& NewValue, const float& OldValue);
+
+
+	UPROPERTY(BlueprintAssignable, Category="Event")
+	FGGA_OnPostGameplayEffectExecuteSignature OnPostGameplayEffectExecute;
+
+	UPROPERTY(BlueprintAssignable, Category="Event")
+	FGGA_OnPostAttributeChangeSignature OnPostAttributeChange;
+
+	/**
+	 * Called whenever an attribute changed, And this event will be fired on both serve and client.
+	 * 属性发生任意变化后调用，此事件会在服务端和客户端都进行调用。
+	 */
+	UPROPERTY(BlueprintAssignable, Category="Event")
+	FGGA_OnAttributeChangedSignature OnAttributeChanged;
+
+protected:
+	/**
+	 *	Called just before any modification happens to an attribute. This is lower level than PreAttributeChange/PostAttributeChange.
+	 *	There is no additional context provided here since anything can trigger this. Executed effects, duration based effects, effects being removed, immunity being applied, stacking rules changing, etc.
+	 *	This function is meant to enforce things like "Health = Clamp(Health, 0, MaxHealth)" and NOT things like "trigger this extra thing if damage is applied, etc".
+	 *	You should return your modified new value.
+	 *	
+	 *  在对属性进行任何修改之前调用。它比 PreAttributeChange/PostAttributeChange 更底层。
+	 *  这里没有提供额外的上下文，因为任何事情都可能触发它。已执行的效果、基于持续时间的效果、效果被移除、豁免被应用、堆叠规则改变等。
+	 *  该函数旨在执行 “Health = Clamp(Health,0,MaxHealth) ”之类的操作，而不是 “如果受到伤害，则触发该额外操作 ”之类的操作。
+	 *	你应返回修改后的新值。	
+	 */
+	UFUNCTION(BlueprintNativeEvent, Category="GGA")
+	float HandlePreAttributeChange(UAttributeSet* AttributeSet, const FGameplayAttribute& Attribute, float NewValue);
+	virtual float HandlePreAttributeChange_Implementation(UAttributeSet* AttributeSet, const FGameplayAttribute& Attribute, float NewValue);
+
+	/**
+	 * Called just after any modification happens to an attribute.
+	 * 在属性被修改后调用。
+	 */
+	UFUNCTION(BlueprintNativeEvent, Category="GGA")
+	void HandlePostAttributeChange(UAttributeSet* AttributeSet, const FGameplayAttribute& Attribute, float OldValue, float NewValue);
+	virtual void HandlePostAttributeChange_Implementation(UAttributeSet* AttributeSet, const FGameplayAttribute& Attribute, float OldValue, float NewValue);
+
+	/**
+	 *	Called just after a GameplayEffect is executed to modify the base value of an attribute. No more changes can be made.
+	 *	Note this is only called during an 'execute'. E.g., a modification to the 'base value' of an attribute. It is not called during an application of a GameplayEffect, such as a 5 ssecond +10 movement speed buff.
+	 *	在执行 GameplayEffect 之后调用，以修改属性的基本值。不能再做任何更改。
+	 *  注意只有在 “执行 ”过程中才会调用。例如，修改属性的 “基本值”。在应用 GameplayEffect（如 5 秒 +10 移动速度的缓冲）时不会调用。
+	 */
+	UFUNCTION(BlueprintNativeEvent, Category="GGA")
+	void HandlePostGameplayEffectExecute(const FGGA_GameplayEffectModCallbackData& Payload);
+	virtual void HandlePostGameplayEffectExecute_Implementation(const FGGA_GameplayEffectModCallbackData& Payload);
+
+
+	/**
+	 * Called whenever an attribute changed, And this event will be fired on both serve and client.
+	 * 属性发生任意变化后调用，此事件会在服务端和客户端都进行调用。
+	 */
+	UFUNCTION(BlueprintNativeEvent, Category="GGA")
+	void HandleAttributeChange(UAttributeSet* AttributeSet, const FGameplayAttribute& Attribute, const float& NewValue, const float& OldValue);
+	virtual void HandleAttributeChange_Implementation(UAttributeSet* AttributeSet, const FGameplayAttribute& Attribute, const float& NewValue, const float& OldValue);
+
+	// Called when the game starts
+	virtual void BeginPlay() override;
+};