第一次提交

Plugins/GCS/Source/GenericCombatSystem/Public/CombatFlow/GCS_AttackDefinition.h

@@ -0,0 +1,142 @@
+// 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;
+};