// Copyright 2025 https://yuewu.dev/en  All Rights Reserved.

#pragma once

#include "CoreMinimal.h"
#include "GameplayTagContainer.h"
#include "Engine/DataTable.h"
#include "StructUtils/InstancedStruct.h"
#include "GCS_ComboDefinition.generated.h"

/**
 * Base struct allow you to extend the combo definition's fields using C++.
 * 基础结构体，允许你通过C++拓展连击定义的字段。
 */
USTRUCT(BlueprintType, meta=(Hidden))
struct GENERICCOMBATSYSTEM_API FGCS_ComboDefinitionExtension
{
	GENERATED_BODY()
};

/**
 * 
 */
USTRUCT(BlueprintType)
struct FGCS_ComboDefinition : public FTableRowBase
{
	GENERATED_BODY()

public:
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Combo")
	TSoftClassPtr<class UGameplayAbility> AbilityClass;

	/**
	 * Will reset the combo step if this row was selected.(Only works if MinComboStep > 0)
	 * 此行选中则会重置连招步骤。(仅在MinComboStep > 0时生效。)
	 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Combo")
	bool bResetComboStep{false};

	/**
	 * When Current Combo Step > this value, this won't  be selected. 0 means no restriction.
	 * How many combo steps required to select this combo.
	 * 至少执行过几次combo，才能选择此行作为下一个combo。0代表入口。
	 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Requirements", meta=(ClampMin=0))
	int32 MinComboStep = 0;

	/**
	 * The combo event data's event tag must equals to this tag if set, otherwise this combo won't be selected!.
	 * 若有值，连击事件数据的event tag必须与此值相等，否则该连击不会被选择。
	 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Requirements")
	FGameplayTag EventTag;

	/**
	 * The combo event data's instigator tags mush matches this Query if set, otherwise this combo won't be selected!
	 * 若有值，连击事件数据的instigator tags必须匹配此查询，否则该连击不会被选择。
	 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Requirements")
	FGameplayTagQuery EventInstigatorTagQuery;

	/**
	 * The tags owned by the ability system component of the pawn must much this query if set， otherwise this combo won't be selected!
	 * 若有值，Pawn的技能组件所拥有的Tags必须满足此查询，否则该连击不会被选择。
	 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Requirements")
	FGameplayTagQuery TagQuery;

	/**
	 * Should try if this ability can be activated before select it?
	 * 是否在选择Ability之前测试是否可激活？
	 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Activation")
	bool bRunActivationTest{false};

	/**
	 * Should abort the whole combo or just skip this selection when activation test failed?
	 * 若激活测试失败，是放弃整个Combo还是跳过此选择？
	 */
	UPROPERTY(EditAnywhere, BlueprintReadWrite, Category="Activation", meta=(EditCondition="bRunActivationTest"))
	bool bAbortIfActivationTestFailed{false};

	/**
	 * Native Instanced struct for extending the combo definition.
	 * 实例化结构体用于扩充连击定义的字段。
	 * @attention For C++ users only. 仅针对C++用户。
	 */
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Extension")
	TInstancedStruct<FGCS_ComboDefinitionExtension> NativeExtension;

	/**
	 * Blueprint Instanced struct for extending the combo definition.
	 * 实例化结构体用于扩充连击定义的字段。
	 * @attention For blueprint users only. 仅针对蓝图用户。
	 */
	UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Extension")
	FInstancedStruct Extension;

#if WITH_EDITORONLY_DATA
	/**
	 * Description for developers in the editor.
	 * 编辑器中用于开发者的描述。
	 */
	UPROPERTY(EditAnywhere, Category = "Editor")
	FString DevDescription;
#endif
};