CharacterControlData.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 "StructUtils/InstancedStruct.h"
#include "TweenTypes.h"
#include "CharacterControlData.generated.h"
 
class UInputMappingContext;
class UInputAction;
class UGameplayAbility;
class UGameplayEffect;
class UAnimMontage;
class UDataTable;
 
USTRUCT(BlueprintType)
struct FCharacterExtendedDataBase
{
    GENERATED_BODY()
};
 
// 피격 메시 확대 연출의 재생 방식.
UENUM(BlueprintType)
enum class EHitPulseMode : uint8
{
    // 첫 프레임에 즉시 확대된 뒤 남은 시간 동안 원래 크기로 감쇠한다. 타격 순간이 가장 또렷하다.
    OneWay      UMETA(DisplayName = "단방향 (즉시 확대 후 감쇠)"),
 
    // 원본에서 커졌다가 되돌아온다. 상승과 하강에 같은 시간이 배분된다.
    PingPong    UMETA(DisplayName = "PingPong (대칭)"),
 
    // 왕복 모양을 곡선으로 직접 그린다. 상승과 하강 시간을 다르게 줄 수 있다.
    CustomCurve UMETA(DisplayName = "PingPong (곡선 직접 지정)")
};
 
// 피격 시 메시만 순간 커졌다 원래 크기로 돌아오는 연출 설정.
// 액터와 캡슐 크기는 건드리지 않으므로 공격 판정에 영향을 주지 않는다.
USTRUCT(BlueprintType)
struct FHitMeshPulseData
{
    GENERATED_BODY()
 
    // 연출 사용 여부.
    UPROPERTY(EditDefaultsOnly, Category = "Hit Mesh Pulse")
    uint8 bEnabled : 1 = false;
 
    // 재생 방식.
    UPROPERTY(EditDefaultsOnly, Category = "Hit Mesh Pulse", meta = (EditCondition = "bEnabled"))
    EHitPulseMode Mode = EHitPulseMode::OneWay;
 
    // 원본 메시 크기 대비 축별 배율. 1보다 크면 늘어나고 작으면 눌린다.
    // X/Y를 키우고 Z를 줄이면 옆으로 퍼지며 납작해지는 Squash, 반대로 하면 위로 솟는 Stretch가 된다.
    // 모든 축을 같은 값으로 두면 균등 확대로 동작한다.
    UPROPERTY(EditDefaultsOnly, Category = "Hit Mesh Pulse", meta = (EditCondition = "bEnabled"))
    FVector ScaleMultiplier = FVector(1.08f, 1.08f, 0.94f);
 
    // 확대에서 원래 크기 복귀까지의 전체 시간.
    UPROPERTY(EditDefaultsOnly, Category = "Hit Mesh Pulse", meta = (ClampMin = "0.0", EditCondition = "bEnabled"))
    float Duration = 0.1f;
 
    // 왕복에서 정점에 머무는 시간. 히트스톱과 겹치면 타격감이 살아난다.
    UPROPERTY(EditDefaultsOnly, Category = "Hit Mesh Pulse", meta = (ClampMin = "0.0", EditCondition = "bEnabled && Mode == EHitPulseMode::PingPong"))
    float PeakHoldTime = 0.03f;
 
    // 보간 곡선. 왕복이면 InOut 계열(InOutSine 등), 단방향이면 Out 계열(OutQuart 등)이 어울린다.
    UPROPERTY(EditDefaultsOnly, Category = "Hit Mesh Pulse", meta = (EditCondition = "bEnabled && Mode != EHitPulseMode::CustomCurve"))
    ETweenEase Ease = ETweenEase::OutExpo;
 
    // 왕복 모양을 담은 곡선. 0에서 1로 올랐다가 0으로 내려오도록 그린다.
    // 정점 키의 시간 위치가 상승과 하강의 시간 비율이 되므로, 뒤로 옮길수록 천천히 부풀었다 빠르게 꺼진다.
    // 키가 2개 미만이면 Linear로 폴백하므로 최소 3개(시작 / 정점 / 끝)를 찍어야 한다.
    UPROPERTY(EditDefaultsOnly, Category = "Hit Mesh Pulse", meta = (EditCondition = "bEnabled && Mode == EHitPulseMode::CustomCurve"))
    FRuntimeFloatCurve CustomCurve;
};
 
// 플레이어 전용 확장 데이터
USTRUCT(BlueprintType)
struct FPlayerExtendedData : public FCharacterExtendedDataBase
{
    GENERATED_BODY()
 
    // --- 입력 ---
    UPROPERTY(EditDefaultsOnly)
    TObjectPtr<UInputMappingContext> DefaultMappingContext;
 
    UPROPERTY(EditDefaultsOnly)
    TObjectPtr<UInputAction> DashAction;
 
    UPROPERTY(EditDefaultsOnly)
    TObjectPtr<UInputAction> MoveAction;
 
    UPROPERTY(EditDefaultsOnly)
    TObjectPtr<UInputAction> AttackAction;
 
    UPROPERTY(EditDefaultsOnly)
    TObjectPtr<UInputAction> WarpStrikeAction;
 
    UPROPERTY(EditDefaultsOnly)
    TObjectPtr<UInputAction> WeaponRequestSkillAction;
 
    UPROPERTY(EditDefaultsOnly)
    TObjectPtr<UInputAction> Weapon_SkillAction;
 
    UPROPERTY(EditDefaultsOnly)
    TObjectPtr<UInputAction> Cam_LockOnAction;
 
    UPROPERTY(EditDefaultsOnly)
    TObjectPtr<UInputAction> Cam_RotationAction;
 
    UPROPERTY(EditDefaultsOnly)
    TObjectPtr<UInputAction> Cam_WheelAction;
 
    // --- GAS ---
    UPROPERTY(EditDefaultsOnly, meta = (Categories = "Input", ForceInlineRow))
    TMap<FGameplayTag, TSubclassOf<UGameplayAbility>> StartInputAbilities;
 
    // 피격 시 적용할 GE. 일정 시간 Attack Idle 상태를 유지.
    UPROPERTY(EditDefaultsOnly, Category = "HitReact")
    TSubclassOf<UGameplayEffect> DamageTakenEffectClass;
 
    // 히트 -> KnockDown 유효 시간 
    UPROPERTY(EditDefaultsOnly, Category = "HitReact|KnockDown", meta = (ClampMin = "0.0"))
    float HitToKnockDownWindow = 5.0f;
 
    // 히트 -> KnockDown 횟수
    UPROPERTY(EditDefaultsOnly, Category = "HitReact|KnockDown", meta = (ClampMin = "2"))
    int32 HitToKnockDownThreshold = 5;
 
    // --- 시작 무기 ---
    // 비어 있으면 시작 시점 자동 장착을 건너뛴다.
    UPROPERTY(EditDefaultsOnly, Category = "Weapon", meta = (Categories = "Weapon"))
    FGameplayTag DefaultWeaponTag;
};
 
 
// 적 전용 확장 데이터
USTRUCT(BlueprintType)
struct FEnemyExtendedData : public FCharacterExtendedDataBase
{
    GENERATED_BODY()
 
    // --- AI 데이터 테이블 ---
    UPROPERTY(EditDefaultsOnly, Category = "AI")
    TObjectPtr<UDataTable> EnemyAICombatTable;
 
    UPROPERTY(EditDefaultsOnly, Category = "AI")
    TObjectPtr<UDataTable> EnemyAIRetreatTable;
 
    UPROPERTY(EditDefaultsOnly, Category = "AI")
    TObjectPtr<UDataTable> EnemyAIStrafeTable;
 
    UPROPERTY(EditDefaultsOnly, Category = "Animation")
    TObjectPtr<UAnimMontage> HitReactMontage;
 
    UPROPERTY(EditDefaultsOnly, Category = "Animation")
    TObjectPtr<UAnimMontage> DeadMontage;
 
    UPROPERTY(EditDefaultsOnly, Category = "Groggy")
    TObjectPtr<UDataTable> GroggyTable;
 
    UPROPERTY(EditDefaultsOnly, Category = "Groggy")
    TObjectPtr<UAnimMontage> GroggyMontage;
 
    UPROPERTY(EditDefaultsOnly, Category = "Groggy")
    FName GroggyEndSectionName = FName("Groggy_End");
 
    UPROPERTY(EditDefaultsOnly, Category = "Hit Visual", meta = (Categories = "Damage.Type"))
    TMap<FGameplayTag, FHitMeshPulseData> HitMeshPulseByDamageType;
};
 
USTRUCT(BlueprintType)
struct FBossExtendedData : public FEnemyExtendedData
{
    GENERATED_BODY()
};
 
UCLASS()
class CK_UE_API UCharacterControlData : public UPrimaryDataAsset
{
    GENERATED_BODY()
 
public:
    UCharacterControlData();
 
public:
    // 확장 데이터 검색 헬퍼 함수
    template <class T>
    const T* FindExtendedData() const;
 
    // --- 데이터 테이블 ---
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = Stat)
    TObjectPtr<UDataTable> StatTable;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = Stat)
    FName StatRowName;
 
    // --- GAS ---
    UPROPERTY(EditAnywhere, Category = GAS)
    TArray<TSubclassOf<UGameplayAbility>> StartAbilities;
 
    // --- 확장 데이터 ---
    UPROPERTY(EditAnywhere, Category = "Extended", meta = (BaseStruct = "/Script/CK_UE.CharacterExtendedDataBase", ExcludeBaseStruct))
    TArray<FInstancedStruct> ExtendedData;
 
protected:
    UPROPERTY(Transient)
    mutable TMap<TObjectPtr<UScriptStruct>, int32> CachedIndices;
};
 
 
// 확장 데이터 검색 헬퍼 함수
template <typename T>
inline const T* UCharacterControlData::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;
}