143 lines
4.8 KiB
C
143 lines
4.8 KiB
C
// Copyright 2025 https://yuewu.dev/en All Rights Reserved.
|
||
|
||
#pragma once
|
||
|
||
#include "CoreMinimal.h"
|
||
#include "GameplayEffect.h"
|
||
#include "Engine/DataTable.h"
|
||
#include "GameplayTagContainer.h"
|
||
#include "GGA_AbilitySystemStructLibrary.h"
|
||
#include "Runtime/Launch/Resources/Version.h"
|
||
#if ENGINE_MINOR_VERSION < 5
|
||
#include "InstancedStruct.h"
|
||
#else
|
||
#include "StructUtils/InstancedStruct.h"
|
||
#endif
|
||
#include "GCS_AttackDefinition.generated.h"
|
||
|
||
|
||
/**
|
||
* Base struct allow you to extend the attack definition's fields using C++.
|
||
* 基础结构体，允许你通过C++拓展攻击定义的字段。
|
||
*/
|
||
USTRUCT(BlueprintType, meta=(Hidden))
|
||
struct GENERICCOMBATSYSTEM_API FGCS_AttackDefinitionExtension
|
||
{
|
||
GENERATED_BODY()
|
||
};
|
||
|
||
|
||
/**
|
||
* Structure defining an attack's properties.
|
||
* 定义攻击属性的结构。
|
||
*/
|
||
USTRUCT(BlueprintType, meta=(DisplayName="GCS Attack Definition"))
|
||
struct GENERICCOMBATSYSTEM_API FGCS_AttackDefinition : public FTableRowBase
|
||
{
|
||
GENERATED_BODY()
|
||
|
||
/**
|
||
* Tags describing the attack (e.g., Melee/Ranged, Slash/Strike).
|
||
* 描述攻击的标签（例如近战/远程、劈砍/打击）。
|
||
* @note Added as dynamic AssetTags to the gameplay effect spec.
|
||
* @注意 作为动态AssetTags添加到游戏效果规格。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Common")
|
||
FGameplayTagContainer AttackTags;
|
||
|
||
/**
|
||
* SetByCaller tag-to-float mappings for gameplay effect specs.
|
||
* 用于游戏效果规格的SetByCaller标签到浮点映射。
|
||
* @note Usage is flexible (e.g., damage correction factors).
|
||
* @注意 使用灵活（例如伤害修正系数）。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Common", meta=(ForceInlineRow))
|
||
TMap<FGameplayTag, float> SetByCallerMagnitudes;
|
||
|
||
/**
|
||
* Gameplay effect to apply to the hit target.
|
||
* 应用于命中目标的游戏效果。
|
||
* @note Modified during attack request processing.
|
||
* @注意 在攻击请求处理期间修改。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Gameplay Effects")
|
||
TSoftClassPtr<UGameplayEffect> TargetEffectClass;
|
||
|
||
/**
|
||
* Level of the target gameplay effect.
|
||
* 目标游戏效果的等级。
|
||
* @note If < 1, uses the ability's level.
|
||
* @注意 如果<1，使用能力的等级。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Gameplay Effects")
|
||
int32 TargetEffectClassLevel{1};
|
||
|
||
/**
|
||
* Effect container to apply to the target.
|
||
* 应用于目标的效果容器。
|
||
* @note Used for instant targeting; ability level determines effect level.
|
||
* @注意 用于即时目标；能力等级决定效果等级。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Gameplay Effects", meta=(ForceInlineRow))
|
||
FGGA_GameplayEffectContainer TargetEffectContainer;
|
||
|
||
/**
|
||
* Gameplay cues to trigger on the target upon hit.
|
||
* 命中目标时触发的游戏反馈。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Gameplay Cues", meta=(Categories="GameplayCue"))
|
||
TArray<FGameplayTag> TargetGameplayCues;
|
||
|
||
/**
|
||
* Knockback distance applied to the target.
|
||
* 应用于目标的击退距离。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "HitReaction", meta=(Units="cm"))
|
||
float KnockbackDistance{100};
|
||
|
||
/**
|
||
* Multiplier for knockback effect.
|
||
* 击退效果的倍增器。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "HitReaction", meta=(ClampMin=1))
|
||
float KnockbackMultiplier{1};
|
||
|
||
/**
|
||
* Duration of animation stall on hit (disabled if <= 0).
|
||
* 命中时动画停滞的持续时间（<=0时禁用）。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Feedback", meta=(ClampMin=0, Units="s"))
|
||
float HitStallingDuration{0};
|
||
|
||
/**
|
||
* Play rate factor for hit animation.
|
||
* 命中动画的播放速率因子。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Feedback", meta=(ClampMin=0.1, ClampMax=0.9))
|
||
float HitPlayRateFactor{0.1};
|
||
|
||
/**
|
||
* Native Instanced struct for extending the attack definition.
|
||
* 实例化结构体用于扩充攻击定义的字段。
|
||
* @attention For C++ users only. 仅针对C++用户。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Extension")
|
||
TInstancedStruct<FGCS_AttackDefinitionExtension> NativeExtension;
|
||
|
||
/**
|
||
* Blueprint Instanced struct for extending the attack definition.
|
||
* 实例化结构体用于扩充攻击定义的字段。
|
||
* @attention For blueprint users only. 仅针对蓝图用户。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Extension")
|
||
FInstancedStruct Extension;
|
||
|
||
/**
|
||
* User-defined settings for the attack.
|
||
* 攻击的用户定义设置。
|
||
*/
|
||
UE_DEPRECATED(1.5, "Using extension field to add custom fields!")
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Deprecated", meta=(ForceInlineRow, BaseStruct = "/Script/GenericCombatSystem.GCS_UserSetting"))
|
||
TMap<FGameplayTag, FInstancedStruct> UserSettings;
|
||
};
|