322 lines
10 KiB
C++
322 lines
10 KiB
C++
// Copyright 2025 https://yuewu.dev/en All Rights Reserved.
|
|
|
|
#pragma once
|
|
|
|
#include "ActiveGameplayEffectHandle.h"
|
|
#include "Engine/DataAsset.h"
|
|
#include "AttributeSet.h"
|
|
#include "GameplayTagContainer.h"
|
|
#include "GameplayAbilitySpecHandle.h"
|
|
#include "GGA_AbilitySet.generated.h"
|
|
|
|
DECLARE_LOG_CATEGORY_EXTERN(LogGGA_AbilitySet, Log, All)
|
|
|
|
class UGameplayEffect;
|
|
class UGameplayAbility;
|
|
class UGAbilitySystemComponent;
|
|
class UObject;
|
|
|
|
/**
|
|
* Struct for granting gameplay abilities in an ability set.
|
|
* 用于在技能集赋予游戏技能的结构体。
|
|
*/
|
|
USTRUCT(BlueprintType)
|
|
struct GENERICGAMEPLAYABILITIES_API FGGA_AbilitySet_GameplayAbility
|
|
{
|
|
GENERATED_BODY()
|
|
|
|
/**
|
|
* The gameplay ability class to grant.
|
|
* 要赋予的技能类。
|
|
*/
|
|
UPROPERTY(EditAnywhere, Category = "GGA", BlueprintReadWrite, meta=(AllowAbstract=false))
|
|
TSoftClassPtr<UGameplayAbility> Ability = nullptr;
|
|
|
|
/**
|
|
* The level of the ability to grant.
|
|
* 要赋予的技能等级。
|
|
*/
|
|
UPROPERTY(EditAnywhere, Category = "GGA", BlueprintReadWrite)
|
|
int32 AbilityLevel = 1;
|
|
|
|
/**
|
|
* The input ID for activating/cancelling the ability.
|
|
* 用于激活/取消技能的输入ID。
|
|
*/
|
|
UPROPERTY(EditAnywhere, Category = "GGA", BlueprintReadWrite)
|
|
int32 InputID = -1;
|
|
|
|
/**
|
|
* Dynamic tags to add to the ability.
|
|
* 添加到技能的动态标签。
|
|
*/
|
|
UPROPERTY(EditAnywhere, Category = "GGA", BlueprintReadWrite)
|
|
FGameplayTagContainer DynamicTags;
|
|
|
|
#if WITH_EDITORONLY_DATA
|
|
/**
|
|
* Generates an editor-friendly name.
|
|
* 生成编辑器友好的名称。
|
|
*/
|
|
void MakeEditorFriendlyName();
|
|
|
|
/**
|
|
* Editor-friendly name for the ability.
|
|
* 技能的编辑器友好名称。
|
|
*/
|
|
UPROPERTY(VisibleAnywhere, Category=AlwaysHidden, Meta=(EditCondition=False, EditConditionHides))
|
|
FString EditorFriendlyName;
|
|
|
|
/**
|
|
* Toggles whether the ability is granted (editor-only, for debugging).
|
|
* 切换是否赋予技能（仅编辑器，用于调试）。
|
|
*/
|
|
UPROPERTY(EditAnywhere, Category = "GGA")
|
|
bool bAbilityEnabled{true};
|
|
#endif
|
|
};
|
|
|
|
/**
|
|
* Struct for granting gameplay effects in an ability set.
|
|
* 用于在技能集赋予游戏效果的结构体。
|
|
*/
|
|
USTRUCT(BlueprintType)
|
|
struct GENERICGAMEPLAYABILITIES_API FGGA_AbilitySet_GameplayEffect
|
|
{
|
|
GENERATED_BODY()
|
|
|
|
/**
|
|
* The gameplay effect class to grant.
|
|
* 要赋予的效果类。
|
|
*/
|
|
UPROPERTY(EditDefaultsOnly, Category = "GGA")
|
|
TSoftClassPtr<UGameplayEffect> GameplayEffect = nullptr;
|
|
|
|
/**
|
|
* The level of the gameplay effect to grant.
|
|
* 要赋予的效果等级。
|
|
*/
|
|
UPROPERTY(EditDefaultsOnly, Category = "GGA")
|
|
float EffectLevel = 1.0f;
|
|
|
|
#if WITH_EDITORONLY_DATA
|
|
/**
|
|
* Generates an editor-friendly name.
|
|
* 生成编辑器友好的名称。
|
|
*/
|
|
void MakeEditorFriendlyName();
|
|
|
|
/**
|
|
* Editor-friendly name for the effect.
|
|
* 效果的编辑器友好名称。
|
|
*/
|
|
UPROPERTY(VisibleAnywhere, Category=AlwaysHidden, Meta=(EditCondition=False, EditConditionHides))
|
|
FString EditorFriendlyName;
|
|
|
|
/**
|
|
* Toggles whether the effect is granted (editor-only, for debugging).
|
|
* 切换是否赋予效果（仅编辑器，用于调试）。
|
|
*/
|
|
UPROPERTY(EditAnywhere, Category = "GGA")
|
|
bool bEffectEnabled{true};
|
|
#endif
|
|
};
|
|
|
|
/**
|
|
* Struct for granting attribute sets in an ability set.
|
|
* 用于在技能集赋予属性集的结构体。
|
|
*/
|
|
USTRUCT(BlueprintType)
|
|
struct GENERICGAMEPLAYABILITIES_API FGGA_AbilitySet_AttributeSet
|
|
{
|
|
GENERATED_BODY()
|
|
|
|
/**
|
|
* The attribute set class to grant.
|
|
* 要赋予的属性集类。
|
|
*/
|
|
UPROPERTY(EditDefaultsOnly, Category = "GGA")
|
|
TSoftClassPtr<UAttributeSet> AttributeSet;
|
|
|
|
#if WITH_EDITORONLY_DATA
|
|
/**
|
|
* Generates an editor-friendly name.
|
|
* 生成编辑器友好的名称。
|
|
*/
|
|
void MakeEditorFriendlyName();
|
|
|
|
/**
|
|
* Editor-friendly name for the attribute set.
|
|
* 属性集的编辑器友好名称。
|
|
*/
|
|
UPROPERTY(VisibleAnywhere, Category=AlwaysHidden, Meta=(EditCondition=False, EditConditionHides))
|
|
FString EditorFriendlyName;
|
|
|
|
/**
|
|
* Toggles whether the attribute set is granted (editor-only, for debugging).
|
|
* 切换是否赋予属性集（仅编辑器，用于调试）。
|
|
*/
|
|
UPROPERTY(EditAnywhere, Category = "GGA")
|
|
bool bAttributeSetEnabled{true};
|
|
#endif
|
|
};
|
|
|
|
/**
|
|
* Struct for storing handles to granted abilities, effects, and attribute sets.
|
|
* 存储已赋予的技能、效果和属性集句柄的结构体。
|
|
*/
|
|
USTRUCT(BlueprintType)
|
|
struct GENERICGAMEPLAYABILITIES_API FGGA_AbilitySet_GrantedHandles
|
|
{
|
|
GENERATED_BODY()
|
|
|
|
/**
|
|
* Adds an ability spec handle.
|
|
* 添加技能句柄。
|
|
* @param Handle The ability spec handle. 技能句柄。
|
|
*/
|
|
void AddAbilitySpecHandle(const FGameplayAbilitySpecHandle& Handle);
|
|
|
|
/**
|
|
* Adds a gameplay effect handle.
|
|
* 添加游戏效果句柄。
|
|
* @param Handle The gameplay effect handle. 游戏效果句柄。
|
|
*/
|
|
void AddGameplayEffectHandle(const FActiveGameplayEffectHandle& Handle);
|
|
|
|
/**
|
|
* Adds an attribute set.
|
|
* 添加属性集。
|
|
* @param Set The attribute set to add. 要添加的属性集。
|
|
*/
|
|
void AddAttributeSet(UAttributeSet* Set);
|
|
|
|
/**
|
|
* Removes granted items from an ability system component.
|
|
* 从技能系统组件移除已赋予的项。
|
|
* @param ASC The ability system component. 技能系统组件。
|
|
*/
|
|
void TakeFromAbilitySystem(UAbilitySystemComponent* ASC);
|
|
|
|
protected:
|
|
/**
|
|
* Handles to granted abilities.
|
|
* 已赋予的技能句柄。
|
|
*/
|
|
UPROPERTY(BlueprintReadOnly, Category="GGA")
|
|
TArray<FGameplayAbilitySpecHandle> AbilitySpecHandles;
|
|
|
|
/**
|
|
* Handles to granted gameplay effects.
|
|
* 已赋予的游戏效果句柄。
|
|
*/
|
|
UPROPERTY(BlueprintReadOnly, Category="GGA")
|
|
TArray<FActiveGameplayEffectHandle> GameplayEffectHandles;
|
|
|
|
/**
|
|
* Pointers to granted attribute sets.
|
|
* 已赋予的属性集指针。
|
|
*/
|
|
UPROPERTY()
|
|
TArray<TObjectPtr<UAttributeSet>> GrantedAttributeSets;
|
|
};
|
|
|
|
/**
|
|
* Data asset for granting gameplay abilities, effects, and attribute sets.
|
|
* 用于赋予游戏技能、效果和属性集的数据资产。
|
|
*/
|
|
UCLASS(BlueprintType, Const)
|
|
class GENERICGAMEPLAYABILITIES_API UGGA_AbilitySet : public UPrimaryDataAsset
|
|
{
|
|
GENERATED_BODY()
|
|
|
|
public:
|
|
/**
|
|
* Constructor for the ability set.
|
|
* 技能集构造函数。
|
|
*/
|
|
UGGA_AbilitySet(const FObjectInitializer& ObjectInitializer = FObjectInitializer::Get());
|
|
|
|
/**
|
|
* Grants the ability set to an ability system component.
|
|
* 将技能集赋予技能系统组件。
|
|
* @param ASC The ability system component. 技能系统组件。
|
|
* @param OutGrantedHandles Handles for granted items (output). 已赋予项的句柄（输出）。
|
|
* @param SourceObject Optional source object. 可选的源对象。
|
|
* @param OverrideLevel Optional level override. 可选的等级覆盖。
|
|
*/
|
|
void GiveToAbilitySystem(UAbilitySystemComponent* ASC, FGGA_AbilitySet_GrantedHandles* OutGrantedHandles, UObject* SourceObject = nullptr, int32 OverrideLevel = -1) const;
|
|
|
|
/**
|
|
* Grants an ability set to an ability system component (static).
|
|
* 将技能集赋予技能系统组件（静态）。
|
|
* @param AbilitySet The ability set to grant. 要赋予的技能集。
|
|
* @param ASC The ability system component. 技能系统组件。
|
|
* @param SourceObject Optional source object. 可选的源对象。
|
|
* @param OverrideLevel Optional level override. 可选的等级覆盖。
|
|
* @return Handles for granted items. 已赋予项的句柄。
|
|
*/
|
|
UFUNCTION(BlueprintCallable, Category = "GGA|AbilitySet", BlueprintAuthorityOnly)
|
|
static FGGA_AbilitySet_GrantedHandles GiveAbilitySetToAbilitySystem(TSoftObjectPtr<UGGA_AbilitySet> AbilitySet, UAbilitySystemComponent* ASC, UObject* SourceObject, int32 OverrideLevel = -1);
|
|
|
|
UFUNCTION(BlueprintCallable, Category = "GGA|AbilitySet", BlueprintAuthorityOnly)
|
|
static TArray<FGGA_AbilitySet_GrantedHandles> GiveAbilitySetsToAbilitySystem(TArray<TSoftObjectPtr<UGGA_AbilitySet>> AbilitySets, UAbilitySystemComponent* ASC, UObject* SourceObject,
|
|
int32 OverrideLevel = -1);
|
|
|
|
/**
|
|
* Removes granted ability sets from an ability system component.
|
|
* 从技能系统组件移除已赋予的技能集。
|
|
* @param GrantedHandles Handles for granted items. 已赋予项的句柄。
|
|
* @param ASC The ability system component. 技能系统组件。
|
|
*/
|
|
UFUNCTION(BlueprintCallable, Category = "GGA|AbilitySet", BlueprintAuthorityOnly)
|
|
static void TakeAbilitySetFromAbilitySystem(UPARAM(ref)
|
|
FGGA_AbilitySet_GrantedHandles& GrantedHandles, UAbilitySystemComponent* ASC);
|
|
|
|
UFUNCTION(BlueprintCallable, Category = "GGA|AbilitySet", BlueprintAuthorityOnly)
|
|
static void TakeAbilitySetsFromAbilitySystem(UPARAM(ref)
|
|
TArray<FGGA_AbilitySet_GrantedHandles>& GrantedHandles, UAbilitySystemComponent* ASC);
|
|
|
|
protected:
|
|
/**
|
|
* Gameplay abilities to grant.
|
|
* 要赋予的游戏技能。
|
|
*/
|
|
UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category = "GGA|AbilitySet", meta=(TitleProperty=EditorFriendlyName, NoElementDuplicate))
|
|
TArray<FGGA_AbilitySet_GameplayAbility> GrantedGameplayAbilities;
|
|
|
|
/**
|
|
* Gameplay effects to grant.
|
|
* 要赋予的游戏效果。
|
|
*/
|
|
UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category = "GGA|AbilitySet", meta=(TitleProperty=EditorFriendlyName, NoElementDuplicate))
|
|
TArray<FGGA_AbilitySet_GameplayEffect> GrantedGameplayEffects;
|
|
|
|
/**
|
|
* Attribute sets to grant.
|
|
* 要赋予的属性集。
|
|
*/
|
|
UPROPERTY(EditDefaultsOnly, BlueprintReadWrite, Category = "GGA|AbilitySet", meta=(TitleProperty=EditorFriendlyName, NoElementDuplicate))
|
|
TArray<FGGA_AbilitySet_AttributeSet> GrantedAttributes;
|
|
|
|
#if WITH_EDITOR
|
|
/**
|
|
* Pre-save processing for editor.
|
|
* 编辑器预保存处理。
|
|
*/
|
|
virtual void PreSave(FObjectPreSaveContext SaveContext) override;
|
|
|
|
/**
|
|
* Handles property changes in the editor.
|
|
* 处理编辑器中的属性更改。
|
|
*/
|
|
virtual void PostEditChangeProperty(FPropertyChangedEvent& PropertyChangedEvent) override;
|
|
|
|
/**
|
|
* Handles chain property changes in the editor.
|
|
* 处理编辑器中的链式属性更改。
|
|
*/
|
|
virtual void PostEditChangeChainProperty(FPropertyChangedChainEvent& PropertyChangedEvent) override;
|
|
#endif
|
|
};
|