EnemyCharacterBase.h

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

// Fill out your copyright notice in the Description page of Project Settings.
 
#pragma once
 
#include "CoreMinimal.h"
#include "Character/CharacterBase.h"
#include "Interface/ObjectPoolingInterface.h"
#include "Interface/Combat/TargetableInterface.h"
#include "GAS/Attribute/BaseAttributeSet.h"
#include "Interface/Constellation/ConstellationInterface.h"
#include "EnemyCharacterBase.generated.h"
 
class IAbilityBasedWidgetInterface;
class UStateTreeAIComponent;
class AAIController;
struct FEnemyExtendedData;
class UEnemyAttributeSet;
class UCharacterControlData;
class UTargetingMarkerComponent;
class UEnemyMotionWarpingComponent;
class UEnemySpawnDefinition;
class UEnemyDespawnDefinition;
class UEnemyGroggyComponent;
enum class EEnemyGroggyState : uint8;
 
namespace TypeTween
{
    class ITweenControl;
}
 
DECLARE_DYNAMIC_MULTICAST_DELEGATE_OneParam(FOnSpawnEnemyDead, AEnemyCharacterBase*, OnEnemySpawned);
 
 
UENUM(BlueprintType)
enum class EEnemyReachType : uint8
{
    None = 0,
    Range = 1,
    Melee = 2,
    Both = 3
};
 
 
UCLASS(Abstract)
class CK_UE_API AEnemyCharacterBase : public ACharacterBase, public IObjectPoolingInterface, public ITargetableInterface, public IConstellationInterface
{
    GENERATED_BODY()
 
public:
    AEnemyCharacterBase(const FObjectInitializer& ObjectInitializer = FObjectInitializer::Get());
 
protected:
    virtual void PostInitializeComponents() override;
    virtual void BeginPlay() override;
    virtual void PossessedBy(AController* NewController) override;
    virtual void EndPlay(const EEndPlayReason::Type EndPlayReason) override;
 
public:
    // 풀 반환 공통 진입점
    virtual void ForceReturnToPool(bool bIsSpawnedEnemy = false);
 
    //~ ITargetableInterface
    virtual void ShowLockOnMarker() override;
    virtual void HideLockOnMarker() override;
    virtual void ShowTargetingMarker(float MarkerAlpha) override;
    virtual void HideTargetingMarker() override;
    virtual bool IsTargetable() const override;
 
    //~ IConstellationInterface
    virtual UConstellationBase* CreateConstellation() override;
 
public:
    FORCEINLINE UEnemyAttributeSet* GetEnemyAttributeSet() const
    {
        return AttributeSet;
    }
 
    // 처치 시 합류할 성좌 ID. 스탯 테이블에서 캐싱된다.
    FORCEINLINE FName GetConstellationID() const
    {
        return ConstellationID;
    }
 
    FORCEINLINE UTargetingMarkerComponent* GetTargetingMarkerComponent() const
    {
        return TargetingMarker;
    }
 
    FORCEINLINE UTargetingMarkerComponent* GetLockOnMarkerComponent() const
    {
        return LockOnMarker;
    }
 
    FORCEINLINE UEnemyMotionWarpingComponent* GetMotionWarpingComponent() const
    {
        return MotionWarpingComponent;
    }
 
    FORCEINLINE UCharacterControlData* GetCharacterControlData() const
    {
        return CharacterControlData.Get();
    }
 
protected:
    //~ 초기화
    virtual void InitializeAttributes() override;
    virtual void GiveDefaultAbilities();
    virtual void RebindHpBarWidget();
    virtual void BindCharacterDelegates();
    virtual void UnbindCharacterDelegates();
 
    // StateTree 시작 전 초기화 함수
    virtual void OnBeforeStateTreeStart() {}
 
    //~ AI
    // StateTree Logic 시작 / 중지 함수
    void StartAILogic();
    void StopAILogic(const FString& Reason);
 
    //~ 풀링
    // 풀링 인터페이스 기본 구현 - 공통 헬퍼만 호출
    virtual void OnSpawnFromPool_Implementation() override;
    virtual void OnReturnToPool_Implementation() override;
 
    // EnemyBehaviorComponent 공통 런타임 리셋 함수.
    void ActivateEnemyState();
    void DeactivateEnemyState();
    virtual void ResetEnemyBehaviorComponents();
 
    //~ 전투 / 사망
    // 데미지 텍스트 / 히트 이펙트
    virtual void OnDamageTaken(const FDamageResultData& DamageResult) override;
 
    UFUNCTION()
    virtual void OnDeath();
 
    virtual void PlayDeadAnimation() override;
    
    //~ UI
    virtual IAbilityBasedWidgetInterface* GetAbilityBasedWidgetInterface() PURE_VIRTUAL(ACK_CharacterEnemy::GetAbilityBasedWidgetInterface, return nullptr;)
 
private:
    void RequestReturnToPool(float DeadEventDelayTime = 2.0f);
    void OnGroggyStateChanged(EEnemyGroggyState NewState);
 
    // 데미지 타입에 해당하는 피격 메시 확대 연출을 재생한다. 진행 중인 연출이 있으면 정리하고 새로 시작
    void PlayMeshPulse(const FGameplayTag& DamageTypeTag);
 
    // 연출을 중단하고 메시를 원본 크기로 되돌린다.
    void StopMeshPulse();
 
    // 처치 시 플레이어에게 방송 경험치를 넘긴다.
    void GrantExpToPlayer() const;
 
public:
    FOnSpawnEnemyDead OnSpawnEnemyDead;
    FTimerHandle DeadTimerHandle;
 
protected:
    UPROPERTY()
    TObjectPtr<UEnemyAttributeSet> AttributeSet;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Category = "Data")
    TObjectPtr<UCharacterControlData> CharacterControlData;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Instanced, Category = "Flow")
    TObjectPtr<UEnemySpawnDefinition> EnemySpawnDefinition;
 
    UPROPERTY(EditAnywhere, BlueprintReadOnly, Instanced, Category = "Flow")
    TObjectPtr<UEnemyDespawnDefinition> EnemyDespawnDefinition;
 
    UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "UI")
    TObjectPtr<UTargetingMarkerComponent> LockOnMarker;
 
    UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "UI")
    TObjectPtr<UTargetingMarkerComponent> TargetingMarker;
 
    UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Component")
    TObjectPtr<UEnemyMotionWarpingComponent> MotionWarpingComponent;
 
    UPROPERTY(Transient)
    TObjectPtr<AAIController> CachedAIController;
 
    UPROPERTY(Transient)
    TObjectPtr<UStateTreeAIComponent> CachedStateTreeComp;
 
protected:
    const FEnemyExtendedData* EnemyExtendedData = nullptr;
 
    FTransform InitialMeshRelativeTransform;
 
    FName ConstellationID; // 캐싱용 성좌 ID
 
    float EnemyExp = 0.0f; // 캐싱용 처치 경험치
 
private:
    TWeakObjectPtr<UEnemyGroggyComponent> CachedGroggyComponent;
 
    // 피격 메시 확대 Tween의 타입 소거 핸들. TypeTween은 소유자 수명을 추적하지 않으므로 직접 정리해야 한다.
    TSharedPtr<TypeTween::ITweenControl> MeshPulseTween;
 
    FDelegateHandle MoveSpeedDelegateHandle;
    FDelegateHandle GroggyStateDelegateHandle;
};