GA_Skill_StrikeBase.h

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

// Fill out your copyright notice in the Description page of Project Settings.
 
#pragma once
 
#include "GAS/GA/GA_SkillBase.h"
#include "GA_Skill_StrikeBase.generated.h"
 
class ACharacter;
class AMainPlayerCharacter;
class UAT_MoveToLocationCurve;
class UAbilityTask_PlayMontageAndWait;
class UAbilityTask_WaitDelay;
class UAnimMontage;
class UCurveFloat;
struct FSkillStrikeBaseData;
 
UCLASS(Abstract)
class CK_UE_API UGA_Skill_StrikeBase : public UGA_SkillBase
{
    GENERATED_BODY()
 
public:
    virtual void EndAbility(const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo* ActorInfo, const FGameplayAbilityActivationInfo ActivationInfo, bool bReplicateEndAbility, bool bWasCancelled) override;
 
protected:
    virtual void ApplyCombatData() override;
 
    // 이 클래스(및 자식)가 실제로 사용하는 Strike 계열 확장 데이터를 조회하는 지점.
    // 기본은 FSkillStrikeBaseData 자신이며, 자식은 이를 상속한 고유 구조체(FSkillStrikeData, FSkillStarFallData 등)로 오버라이드해 조회한다.
    virtual const FSkillStrikeBaseData* FindStrikeData() const;
 
protected:
    // 자식 ActivateAbility에서 고유 준비/검증을 마친 뒤 호출하는 공통 시동부.
    // 섹션/페이즈 길이 검증 → CommitAbility → Preparing 몽타주 → 섹션 체이닝 순서로 진행하며,
    // 실패 시 내부에서 EndAbility까지 처리하고 false를 반환한다.
    bool StartStrikePhaseChain(AMainPlayerCharacter* Player, const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo* ActorInfo, const FGameplayAbilityActivationInfo ActivationInfo);
 
protected:
    UFUNCTION()
    virtual void OnPreparingCompleted();
 
    UFUNCTION()
    virtual void OnHoldingCompleted();
 
    UFUNCTION()
    virtual void OnStrikeMoveCompleted();
 
    UFUNCTION()
    virtual void OnStrikeMotionWarpDelayCompleted();
 
    // Strike 몽타주 완료 콜백. 기본 구현은 OnAbilityMontageCompleted에 위임.
    UFUNCTION()
    virtual void OnStrikeMontageCompleted();
 
protected:
    // 이동 목적지 계산. 자식별 사전 재검증을 포함하며, 실패 시 베이스가 취소 종료한다.
    virtual bool ComputeStrikeMoveTarget(AMainPlayerCharacter* Player, FVector& OutMoveTarget) PURE_VIRTUAL(UGA_Skill_StrikeBase::ComputeStrikeMoveTarget, return false;);
 
    // Strike 섹션 중 모션워프 타겟 갱신. 실패 시 베이스가 취소 종료한다.
    virtual bool UpdateStrikeWarpTarget() PURE_VIRTUAL(UGA_Skill_StrikeBase::UpdateStrikeWarpTarget, return false;);
 
    // 이동 완료 직후 호출. false 반환 시 자식이 흐름 종료를 직접 처리한 것으로 보고 Strike 몽타주를 진행하지 않는다.
    virtual bool OnStrikeArrived(AMainPlayerCharacter* Player);
 
    // Strike 몽타주 태스크 생성 직후 알림.
    virtual void OnStrikeMontageStarted();
 
    // CommitAbility 직후 자식 고유 이벤트 리스너 등록 지점.
    virtual void SetupStrikeEventListeners();
 
    // EndAbility 공통 정리 후, 무브먼트 모드 복원 전에 호출되는 자식 정리 지점.
    virtual void OnStrikeCleanup(ACharacter* Character, bool bWasCancelled);
 
    // 활성화 시점에 몽타주에 존재해야 하는 섹션 목록.
    virtual TArray<FName> GetRequiredMontageSections() const;
 
protected:
    float GetEffectiveHoldingDuration() const;
    bool PlayHoldingSection(float DesiredHoldingDuration) const;
    void SetCurrentWeaponHidden(bool bHidden) const;
 
protected:
    FORCEINLINE float GetStrikeMoveNormalizationFactor(const float Duration, const float Distance) const
    {
        //Normalizer는 0 ~ Distance 이동 범위를 0 ~ 1로 정규화시키는 값임.
        const float Normalizer = Duration * TotalMoveCurveIntegral;
        return Normalizer < KINDA_SMALL_NUMBER ? 0.0f : Distance / Normalizer;
    }
 
    FORCEINLINE void RestorePlayerAndWeaponForStrike()
    {
        SetAvatarMeshHidden(false);
        SetCurrentWeaponHidden(false);
        bCurrentWeaponHiddenBySkill = false;
    }
 
protected:
    // 몽타주의 Preparing 섹션 이름
    UPROPERTY(Transient)
    FName PreparingSectionName;
 
    // 이동 중 재생할 몽타주 섹션 이름
    UPROPERTY(Transient)
    FName HoldingSectionName;
 
    // 몽타주의 Strike 섹션 이름
    UPROPERTY(Transient)
    FName StrikeSectionName;
 
    // 워프 도중 다른 폰을 통과하도록 충돌 무시 처리할지 여부
    UPROPERTY(Transient)
    bool bIgnorePawnCollisionDuringWarp = true;
 
    UPROPERTY(Transient)
    TObjectPtr<UCurveFloat> StrikeMoveProgressCurve;
 
    UPROPERTY(Transient)
    float StrikeMoveDuration = 0.25f;
 
    // Holding 섹션에서 이동 시작 전 대기할 시간
    UPROPERTY(Transient)
    float HoldingDuration = 0.1f;
 
    // Strike 섹션 시작 후 MotionWarping Target을 갱신하기까지의 지연 시간
    UPROPERTY(Transient)
    float StrikeMotionWarpDelay = 0.0f;
 
    // 자식이 ActivateAbility에서 결정해 대입하는 스킬 몽타주
    UPROPERTY(Transient)
    TObjectPtr<UAnimMontage> SkillActionMontage;
 
protected:
    UPROPERTY(Transient)
    TObjectPtr<UAbilityTask_PlayMontageAndWait> ActivePreparingTask;
 
    UPROPERTY(Transient)
    TObjectPtr<UAbilityTask_WaitDelay> ActiveHoldingTask;
 
    UPROPERTY(Transient)
    TObjectPtr<UAT_MoveToLocationCurve> ActiveMoveTask;
 
    UPROPERTY(Transient)
    TObjectPtr<UAbilityTask_WaitDelay> ActiveStrikeMotionWarpDelayTask;
 
protected:
    FRotator CachedStrikeFacingRotation = FRotator::ZeroRotator;
    bool bStrikeStarted = false;
    bool bCurrentWeaponHiddenBySkill = false;
    float TotalMoveCurveIntegral = 0.0f;
};