SituationBase.h

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

// Fill out your copyright notice in the Description page of Project Settings.
 
#pragma once
 
#include "CoreMinimal.h"
#include "ActiveGameplayEffectHandle.h"
#include "CKEnumExtensions.h"
#include "Data/Situation/SituationBuffData.h"
#include "DeveloperSettings/EnvironmentPathRegistry.h"
#include "Table/Situation/DT_SituationTable.h"
#include "UObject/Object.h"
#include "SituationBase.generated.h"
 
class APlayerController;
class UAbilitySystemComponent;
class UConstellationBase;
struct FConstellationWeaponMagnitude;
struct FGameplayEffectRemovalInfo;
struct FGameplayEffectSpecHandle;
struct FGameplayModifierInfo;
 
 
UCLASS(Blueprintable)
class CK_UE_API USituationBase : public UObject
{
    GENERATED_BODY()
 
public:
    void Initialize(const FDT_SituationTable& InSituationData, const FSituationBuffData& InBuffData);
 
    // 주기 발동을 시작/중지한다. 스테이지 전환 시 멈춘다.
    void StartTicking(UWorld* World);
    void StopTicking(UWorld* World);
 
public:
    // 카드의 GE 를 플레이어에게 적용한다.
    // 지속 시간(영구/일시)은 GE 의 Duration Policy 가 결정하며, 여기서 강제로 떼지 않는다.
    void ApplyBuff(APlayerController* TargetPC);
 
    // 무기가 바뀌었을 때 호출. 남은 시간을 유지한 채 GE 를 다시 적용해,
    // 무기별 SetByCaller 수치가 새 무기 기준으로 다시 주입되게 한다.
    void RefreshForWeapon(const APlayerController* TargetPC);
 
    // 스테이지 전환이나 상황 해제처럼 GE 수명과 무관하게 즉시 걷어야 할 때만 호출한다.
    void RemoveBuff(APlayerController* TargetPC);
 
    // 남은 시간(초). 영구 GE 나 미적용 상태면 음수를 반환한다.
    float GetBuffRemainingTime(const APlayerController* TargetPC) const;
 
    // GE 가 들고 있는 총 지속 시간(초). 영구 GE 나 미적용 상태면 음수를 반환한다.
    // 게이지 비율의 분모로 쓴다. 재적용으로 지속 시간이 바뀌어도 항상 현재 값을 돌려준다.
    float GetBuffDuration(const APlayerController* TargetPC) const;
 
    // 카드에 띄울 설명. Situation_Master 의 Description 에 들어있는 치환자를 채운다.
    // {{name1}} / {{value1}} 은 현재 무기 기준 실제 수치로,
    // {{Alias}} / {{True_Name}} / {{Postposition}} 은 이 카드에 묶인 성좌의 값으로 채운다.
    // 읽어낼 수 없는 치환자는 원문 그대로 남는다.
    FText BuildBuffDescription(const APlayerController* TargetPC) const;
 
public:
    FORCEINLINE const FDT_SituationTable& GetSituationData() const
    {
        return SituationData;
    }
 
    FORCEINLINE const FSituationBuffData& GetBuffData() const
    {
        return BuffData;
    }
 
    // 이 카드를 후원한 성좌. 선택지를 뽑을 때 정해지며, 카드를 고르면 시청자 목록에 합류한다.
    // UConstellationBase 의 완전한 형식이 필요해 .cpp 에서 정의한다.
    UConstellationBase* GetConstellation() const;
    void SetConstellation(UConstellationBase* InConstellation);
 
    FORCEINLINE FName GetSituationID() const
    {
        return SituationData.Situation_ID;
    }
 
    FORCEINLINE ESituationTag GetSituationTags() const
    {
        return SituationData.ParsedTags;
    }
 
    FORCEINLINE int32 GetSituationTagCount() const
    {
        int32 Result = 0, Value = static_cast<int32>(GetSituationTags());
        while (Value) ++Result, Value &= (Value - 1); //While문임.
        return Result;
    }
 
    FORCEINLINE bool IsBuffActive() const
    {
        return AppliedHandle.IsValid();
    }
    
    FORCEINLINE UTexture2D* GetSituationIcon() const
    {
        //태그가 하나만 달려있다면 그 태그에 대응되는 아이콘을 가져옴. 하지만 여러개라면 'Complex'라는 유형의 아이콘을 가져오게 구현.  
        const FName Path = FName(GetSituationTagCount() > 1 ? "Complex" : Utils::EnumToString(GetSituationTags()));
        UTexture2D* IconTextureLocal = GetEnvironmentAssetByKey<UTexture2D>(Path);
        return IconTextureLocal;
    }
 
protected:
    // BP 에서 발동 연출(화면 효과 등)을 붙일 수 있게 열어둔다.
    UFUNCTION(BlueprintImplementableEvent, Category = "Situation")
    void OnTriggered();
 
    void HandleIntervalElapsed();
 
public:
    // 상황이 발동했을 때. 관리 주체가 구독해 성좌 채팅으로 이어준다.
    FSimpleMulticastDelegate OnSituationTriggered;
 
    // GE 가 스스로 만료되거나 제거됐을 때. 서브시스템이 구독해 UI 로 흘린다.
    FSimpleMulticastDelegate OnBuffExpired;
 
protected:
    static UAbilitySystemComponent* ResolveASC(const APlayerController* TargetPC);
 
    // 현재 장착 무기 태그. 소유 태그에서 Weapon 계열을 찾아 해석한다.
    static FGameplayTag ResolveCurrentWeaponTag(const UAbilitySystemComponent* ASC);
 
    // 장착 무기 기준으로 이 모디파이어가 실제로 갖게 될 크기.
    // 항등값으로 무력화되거나 정적으로 읽힐 수 없는 모디파이어면 false.
    static bool ResolveModifierMagnitude(const FGameplayModifierInfo& Modifier, const FConstellationWeaponMagnitude* ActiveEntry, float& OutMagnitude, float SituationRank = 1.0f);
 
protected:
    // GE 제거 델리게이트 콜백. 만료/디스펠 어느 쪽이든 여기로 들어온다.
    void HandleEffectRemoved(const FGameplayEffectRemovalInfo& RemovalInfo);
 
    // 적용 중인 GE 를 만료 통지 없이 걷어낸다. 재적용 직전 정리에 쓴다.
    void ClearAppliedEffect(UAbilitySystemComponent* ASC);
 
    // GE 를 실제로 적용한다. OverrideDuration 이 0보다 크면 그 값으로 지속 시간을 덮어쓴다.
    void ApplyBuffEffect(UAbilitySystemComponent* ASC, float OverrideDuration);
 
    // 장착 무기에 해당하는 모디파이어만 실제 수치로 채우고 나머지는 항등값으로 무력화한다.
    void InjectWeaponMagnitudes(const UAbilitySystemComponent* ASC, const UClass* EffectClass, const FGameplayEffectSpecHandle& SpecHandle) const;
 
    // {{name1}} / {{value1}} 치환자를 현재 무기 기준 수치로 바꾼다. 읽어낼 수 없으면 손대지 않는다.
    void FillMagnitudeTokens(const APlayerController* TargetPC, FString& InOutText) const;
 
protected:
    UPROPERTY(Transient, BlueprintReadOnly, Category = "Situation")
    FDT_SituationTable SituationData;
 
    UPROPERTY(Transient, BlueprintReadOnly, Category = "Situation")
    FSituationBuffData BuffData;
 
    UPROPERTY(Transient, BlueprintReadOnly, Category = "Situation")
    TObjectPtr<UConstellationBase> Constellation;
 
protected:
    // 적용 중인 버프 GE 핸들. FActiveGameplayEffectHandle 은 UObject 참조가 아니라 GC 추적이 필요 없다.
    FActiveGameplayEffectHandle AppliedHandle;
 
private:
    FTimerHandle IntervalTimerHandle;
};