99 lines
5.6 KiB
C++
99 lines
5.6 KiB
C++
// 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;
|
||
};
|