225 lines
7.2 KiB
C++
225 lines
7.2 KiB
C++
// Copyright 2025 https://yuewu.dev/en All Rights Reserved.
|
||
|
||
#pragma once
|
||
|
||
#include "CoreMinimal.h"
|
||
#include "GameplayTagContainer.h"
|
||
#include "Bullet/GCS_BulletStructLibrary.h"
|
||
#include "GCS_AttackDefinition.h"
|
||
#include "UObject/Object.h"
|
||
#include "GCS_AttackRequest.generated.h"
|
||
|
||
/**
|
||
* Base class for all attack request types.
|
||
* 所有攻击请求类型的基类。
|
||
*/
|
||
UCLASS(Abstract, Blueprintable, BlueprintType, Const, DefaultToInstanced, EditInlineNew, meta=(DisplayName="GCS Attack Request"))
|
||
class UGCS_AttackRequest_Base : public UObject
|
||
{
|
||
GENERATED_BODY()
|
||
|
||
public:
|
||
/**
|
||
* Gets the attack definition handle.
|
||
* 获取攻击定义句柄。
|
||
* @return The attack definition handle. 攻击定义句柄。
|
||
*/
|
||
UFUNCTION(BlueprintCallable, BlueprintPure, BlueprintNativeEvent, Category="GCS|Attack")
|
||
FDataTableRowHandle GetAttackDefinitionHandle() const;
|
||
|
||
/**
|
||
* Gets the attack definition.
|
||
* 获取攻击定义。
|
||
* @return The attack definition. 攻击定义。
|
||
*/
|
||
UFUNCTION(BlueprintCallable, BlueprintPure, Category="GCS|Attack")
|
||
FGCS_AttackDefinition GetAttackDefinition() const;
|
||
};
|
||
|
||
/**
|
||
* Attack request for melee attacks.
|
||
* 近战攻击请求。
|
||
*/
|
||
UCLASS(meta=(DisplayName="GCS Attack Request (Melee)"))
|
||
class GENERICCOMBATSYSTEM_API UGCS_AttackRequest_Melee : public UGCS_AttackRequest_Base
|
||
{
|
||
GENERATED_BODY()
|
||
|
||
public:
|
||
/**
|
||
* Gets the attack definition handle.
|
||
* 获取攻击定义句柄。
|
||
* @return The attack definition handle. 攻击定义句柄。
|
||
*/
|
||
virtual FDataTableRowHandle GetAttackDefinitionHandle_Implementation() const override;
|
||
|
||
/**
|
||
* Tags for traces activated during the notify state.
|
||
* 在通知状态期间激活的追踪标签。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Attack")
|
||
FGameplayTagContainer TracesToControl;
|
||
|
||
protected:
|
||
/**
|
||
* Handle to the attack definition.
|
||
* 攻击定义的句柄。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Attack", meta=(RowType="/Script/GenericCombatSystem.GCS_AttackDefinition"))
|
||
FDataTableRowHandle AttackDefinitionHandle;
|
||
};
|
||
|
||
/**
|
||
* Enum for ability targeting source types.
|
||
* 能力目标来源类型的枚举。
|
||
*/
|
||
UENUM(BlueprintType)
|
||
enum class EGCS_AbilityTargetingSourceType : uint8
|
||
{
|
||
/**
|
||
* From the player's camera towards camera focus.
|
||
* 从玩家相机朝向相机焦点。
|
||
*/
|
||
CameraTowardsFocus,
|
||
|
||
/**
|
||
* From the pawn's location/socket, in the pawn's orientation.
|
||
* 从Pawn的位置/插槽，沿Pawn的朝向。
|
||
*/
|
||
PawnForward,
|
||
|
||
/**
|
||
* From the pawn's location/socket, oriented towards camera focus.
|
||
* 从Pawn的位置/插槽，朝向相机焦点。
|
||
*/
|
||
PawnTowardsFocus,
|
||
|
||
/**
|
||
* From the weapon's location/socket, in the pawn's orientation.
|
||
* 从武器的位置/插槽，沿Pawn的朝向。
|
||
*/
|
||
WeaponForward,
|
||
|
||
/**
|
||
* From the weapon's location/socket, towards camera focus.
|
||
* 从武器的位置/插槽，朝向相机焦点。
|
||
*/
|
||
WeaponTowardsFocus,
|
||
|
||
/**
|
||
* Custom targeting, requires overriding GetTargetingTransform.
|
||
* 自定义目标，需重写GetTargetingTransform。
|
||
*/
|
||
Custom
|
||
};
|
||
|
||
/**
|
||
* Attack request for firing bullets.
|
||
* 发射子弹的攻击请求。
|
||
*/
|
||
UCLASS(Blueprintable, BlueprintType, Const, EditInlineNew, meta=(DisplayName="GCS Attack Request (Bullet)"))
|
||
class GENERICCOMBATSYSTEM_API UGCS_AttackRequest_Bullet : public UGCS_AttackRequest_Base
|
||
{
|
||
GENERATED_BODY()
|
||
|
||
public:
|
||
/**
|
||
* Gets the bullet definition.
|
||
* 获取子弹定义。
|
||
* @return The bullet definition. 子弹定义。
|
||
*/
|
||
UFUNCTION(BlueprintCallable, BlueprintPure, Category = "GCS|Attack")
|
||
FGCS_BulletDefinition GetBulletDefinition() const;
|
||
|
||
/**
|
||
* Gets the attack definition handle.
|
||
* 获取攻击定义句柄。
|
||
* @return The attack definition handle. 攻击定义句柄。
|
||
*/
|
||
virtual FDataTableRowHandle GetAttackDefinitionHandle_Implementation() const override;
|
||
|
||
/**
|
||
* Gets the targeting transform for the attack.
|
||
* 获取攻击的目标变换。
|
||
* @param SourcePawn The source pawn. 来源Pawn。
|
||
* @param Source The targeting source type. 目标来源类型。
|
||
* @return The targeting transform. 目标变换。
|
||
*/
|
||
UFUNCTION(BlueprintCallable, BlueprintPure, BlueprintNativeEvent, Category = "GCS|Attack")
|
||
FTransform GetTargetingTransform(APawn* SourcePawn, EGCS_AbilityTargetingSourceType Source) const;
|
||
|
||
/**
|
||
* Gets the weapon targeting source location.
|
||
* 获取武器目标来源位置。
|
||
* @param SourcePawn The source pawn. 来源Pawn。
|
||
* @return The weapon source location. 武器来源位置。
|
||
*/
|
||
UFUNCTION(BlueprintCallable, BlueprintPure, BlueprintNativeEvent, Category = "GCS|Attack")
|
||
FVector GetWeaponTargetingSourceLocation(APawn* SourcePawn) const;
|
||
|
||
/**
|
||
* Gets the pawn targeting source location.
|
||
* 获取Pawn目标来源位置。
|
||
* @param SourcePawn The source pawn. 来源Pawn。
|
||
* @return The pawn source location. Pawn来源位置。
|
||
*/
|
||
UFUNCTION(BlueprintCallable, BlueprintPure, BlueprintNativeEvent, Category = "GCS|Attack")
|
||
FVector GetPawnTargetingSourceLocation(APawn* SourcePawn) const;
|
||
|
||
/**
|
||
* Handle to the bullet definition.
|
||
* 子弹定义的句柄。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = Parameters, meta=(RowType="/Script/GenericCombatSystem.GCS_BulletDefinition"))
|
||
FDataTableRowHandle BulletDefinitionHandle;
|
||
|
||
/**
|
||
* Type of targeting source for the attack.
|
||
* 攻击的目标来源类型。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, meta = (ExposeOnSpawn = true), Category = Parameters)
|
||
EGCS_AbilityTargetingSourceType TargetingSourceType{EGCS_AbilityTargetingSourceType::PawnForward};
|
||
|
||
/**
|
||
* Tag name for looking up the source component.
|
||
* 用于查找来源组件的标签名称。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, meta = (ExposeOnSpawn = true), Category = Parameters, meta=(EditCondition="TargetingSourceType != EGCS_AbilityTargetingSourceType::CameraTowardsFocus"))
|
||
FName SourceComponentLookupTagName{NAME_None};
|
||
|
||
/**
|
||
* Source socket name, falls back to source location if not found.
|
||
* 来源插槽名称，如果未找到则回退到来源位置。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, meta = (ExposeOnSpawn = true), Category = Parameters, meta=(EditCondition="TargetingSourceType != EGCS_AbilityTargetingSourceType::CameraTowardsFocus"))
|
||
FName SourceSocketName{NAME_None};
|
||
|
||
/**
|
||
* Weapon socket name, falls back to source location if not found.
|
||
* 武器插槽名称，如果未找到则回退到来源位置。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, meta = (ExposeOnSpawn = true), Category = Parameters, meta=(EditCondition="TargetingSourceType != EGCS_AbilityTargetingSourceType::CameraTowardsFocus"))
|
||
FName SourceWeaponSocketName{NAME_None};
|
||
|
||
/**
|
||
* Additional offset to the source location.
|
||
* 来源位置的附加偏移。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadWrite, meta = (ExposeOnSpawn = true), Category = Parameters)
|
||
FVector LocationOffset{FVector::Zero()};
|
||
|
||
/**
|
||
* Whether targeting is required for the attack.
|
||
* 攻击是否需要目标。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = Parameters)
|
||
bool bRequireTargeting{false};
|
||
|
||
/**
|
||
* Targeting preset for the attack.
|
||
* 攻击的目标预设。
|
||
*/
|
||
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = Parameters)
|
||
TObjectPtr<UTargetingPreset> TargetingPreset;
|
||
};
|