CombatDataBase.h

이 파일의 문서화 페이지로 가기

// Fill out your copyright notice in the Description page of Project Settings.
 
#pragma once
 
#include "CoreMinimal.h"
#include "Engine/DataAsset.h"
#include "GameplayTagContainer.h"
#include "ScalableFloat.h"
#include "StructUtils/InstancedStruct.h"
#include "CombatDataBase.generated.h"
 
class ATA_Trace;
class UGameplayEffect;
class UKnockbackDataAsset;
class UDA_MultiHitProfile;
 
 
UENUM()
enum class ECombatHitType : uint8
{
    Single,
    MultiHit
};
 
 
USTRUCT()
struct FSingleHitData
{
    GENERATED_BODY()
 
public:
    FORCEINLINE float GetDamageMultiplier() const { return DamageMultiplier; }
    FORCEINLINE bool ShouldCauseHitStop() const { return bCauseHitStop; }
 
protected:
    UPROPERTY(EditAnywhere, Category = "SingleHit", meta = (ToolTip = "대상별 1회 타격에 적용할 피해 배율입니다. 1.0은 100%입니다.", ClampMin = "0.0"))
    float DamageMultiplier = 1.0f;
 
    UPROPERTY(EditAnywhere, Category = "SingleHit", meta = (ToolTip = "단일 타격 적중 시 히트 스톱 연출을 적용할지 결정합니다."))
    uint8 bCauseHitStop : 1 = true;
};
 
 
USTRUCT()
struct FMultiHitData
{
    GENERATED_BODY()
 
public:
    FORCEINLINE int32 GetMaxHitCountPerTarget() const { return MaxHitCountPerTarget; }
    FORCEINLINE UDA_MultiHitProfile* GetProfile() const { return Profile; }
 
protected:
    UPROPERTY(EditAnywhere, Category = "MultiHit", meta = (ToolTip = "하나의 NotifyState 판정 구간에서 동일 대상을 타격할 수 있는 최대 횟수입니다.", ClampMin = "2"))
    int32 MaxHitCountPerTarget = 2;
 
    UPROPERTY(EditAnywhere, Category = "MultiHit", meta = (ToolTip = "일반 타격과 마지막 타격의 피해 배율, 재타격 간격, 히트 스톱 및 넉백 적용 시점을 정의합니다."))
    TObjectPtr<UDA_MultiHitProfile> Profile;
};
 
 
USTRUCT()
struct FCombatHitData
{
    GENERATED_BODY()
 
public:
    FORCEINLINE float GetCombatDataLevel() const { return CombatDataLevel; }
    FORCEINLINE const FGameplayTag& GetDamageTypeTag() const { return DamageTypeTag; }
    FORCEINLINE ECombatHitType GetHitType() const { return HitType; }
    FORCEINLINE const FSingleHitData& GetSingleHitData() const { return SingleHitData; }
    FORCEINLINE const FMultiHitData& GetMultiHitData() const { return MultiHitData; }
    FORCEINLINE UKnockbackDataAsset* GetKnockbackData() const { return KnockbackData; }
 
protected:
    UPROPERTY(EditAnywhere, Category = "Hit", meta = (ToolTip = "이 타격의 GameplayEffect와 FScalableFloat CurveTable 값을 평가할 때 사용하는 레벨입니다.", ClampMin = "1.0"))
    float CombatDataLevel = 1.0f;
 
    UPROPERTY(EditAnywhere, Category = "Hit", meta = (ToolTip = "피격 모션과 Mesh Pulse 등 피해 연출을 선택합니다. 약 경직과 넉다운 적용 여부는 GameplayEffect 설정을 따릅니다.", Categories = "Damage.Type"))
    FGameplayTag DamageTypeTag;
 
    UPROPERTY(EditAnywhere, Category = "Hit", meta = (ToolTip = "판정 구간에서 동일 대상을 한 번만 타격할지 반복 타격할지 결정합니다. Notify와 NotifyState는 판정 지속 방식을 결정합니다."))
    ECombatHitType HitType = ECombatHitType::Single;
 
    UPROPERTY(EditAnywhere, Category = "Hit", meta = (ToolTip = "대상별 1회 타격에 사용할 피해 배율과 히트 스톱 설정입니다.", EditCondition = "HitType == ECombatHitType::Single", EditConditionHides))
    FSingleHitData SingleHitData;
 
    UPROPERTY(EditAnywhere, Category = "Hit", meta = (ToolTip = "동일 대상을 반복 타격할 때 사용할 최대 횟수와 다단 타격 프로필입니다.", EditCondition = "HitType == ECombatHitType::MultiHit", EditConditionHides))
    FMultiHitData MultiHitData;
 
    UPROPERTY(EditAnywhere, Instanced, Category = "Hit|Impact", meta = (ToolTip = "적중 대상에게 적용할 넉백 설정입니다. 비워두면 넉백을 적용하지 않습니다."))
    TObjectPtr<UKnockbackDataAsset> KnockbackData;
};
 
 
USTRUCT()
struct FCombatEffectData
{
    GENERATED_BODY()
 
public:
    FORCEINLINE TSubclassOf<UGameplayEffect> GetEffectClass() const { return EffectClass; }
    FORCEINLINE const TMap<FGameplayTag, FScalableFloat>& GetSetByCallerMagnitudes() const { return SetByCallerMagnitudes; }
 
protected:
    UPROPERTY(EditAnywhere, Category = "Effect", meta = (ToolTip = "적중한 대상에게 적용할 GameplayEffect입니다."))
    TSubclassOf<UGameplayEffect> EffectClass;
 
    UPROPERTY(EditAnywhere, Category = "Effect", meta = (ToolTip = "GameplayEffect에 전달할 Data 태그별 기본값입니다.", Categories = "Data"))
    TMap<FGameplayTag, FScalableFloat> SetByCallerMagnitudes;
};
 
 
UCLASS()
class CK_UE_API UCombatDataBase : public UPrimaryDataAsset
{
    GENERATED_BODY()
 
public:
    template <typename T>
    const T* FindExtendedData() const;
 
    FORCEINLINE const FCombatEffectData& GetDamageEffect() const { return DamageEffect; }
    FORCEINLINE const TArray<FCombatEffectData>& GetAdditionalTargetEffects() const { return AdditionalTargetEffects; }
    FORCEINLINE const FCombatHitData* FindCombatHitData(const int32 CombatHitDataIndex) const
    {
        const int32 ArrayIndex = CombatHitDataIndex - 1;
        return CombatHitData.IsValidIndex(ArrayIndex) ? &CombatHitData[ArrayIndex] : nullptr;
    }
 
public:
    // --- Combat ---
    UPROPERTY(EditDefaultsOnly, Category = "Combat", meta = (ToolTip = "공격의 충돌 검사에 사용할 Collision Trace Channel입니다."))
    TEnumAsByte<ECollisionChannel> TraceChannel;
 
    UPROPERTY(EditDefaultsOnly, Category = "Combat", meta = (ToolTip = "공격의 충돌 판정을 수행할 Trace Actor 클래스입니다."))
    TSubclassOf<ATA_Trace> HitTraceClass;
 
    UPROPERTY(EditDefaultsOnly, Category = "Combat", meta = (ToolTip = "Ability 실행 시 시전자 자신에게 적용할 GameplayEffect 목록입니다."))
    TArray<TSubclassOf<UGameplayEffect>> SelfEffectClasses;
 
protected:
    UPROPERTY(EditDefaultsOnly, Category = "Combat|Effect", meta = (ToolTip = "피해 계산과 HitEffect, DamageType 전달에 사용할 GameplayEffect입니다."))
    FCombatEffectData DamageEffect;
 
    UPROPERTY(EditDefaultsOnly, Category = "Combat|Effect", meta = (ToolTip = "피해 외에 적중 대상에게 적용할 HitStun, Groggy, KnockDown 등의 GameplayEffect 목록입니다."))
    TArray<FCombatEffectData> AdditionalTargetEffects;
 
    // CombatHitDataIndex 1은 [0], 2는 [1], 3은 [2]에 대응한다.
    UPROPERTY(EditDefaultsOnly, Category = "Combat|Hit", meta = (ToolTip = "공격의 타격 단계별 설정입니다. Notify의 CombatHitDataIndex 1은 배열 요소 0에 대응합니다."))
    TArray<FCombatHitData> CombatHitData;
 
    // --- Payload ---
    UPROPERTY(EditDefaultsOnly, Category = "Payload", meta = (ToolTip = "몽타주, 스킬, 돌진, 보스 패턴처럼 해당 Ability에만 필요한 확장 데이터를 추가합니다.", BaseStruct = "/Script/CK_UE.CombatExtendedData", ExcludeBaseStruct))
    TArray<FInstancedStruct> ExtendedData;
 
protected:
    UPROPERTY(Transient)
    mutable TMap<TObjectPtr<UScriptStruct>, int32> CachedIndices;
};
 
 
// 확장 데이터 검색 헬퍼 함수
template <typename T>
inline const T* UCombatDataBase::FindExtendedData() const
{
    if (const int32* CachedIndex = CachedIndices.Find(T::StaticStruct()))
    {
        return ExtendedData[*CachedIndex].GetPtr<T>();
    }
 
    for (int32 i = 0; i < ExtendedData.Num(); ++i)
    {
        if (const T* Data = ExtendedData[i].GetPtr<T>())
        {
            CachedIndices.Add(T::StaticStruct(), i);
            return Data;
        }
    }
 
    return nullptr;
}