#include <GA_Skill_StarField.h>

UGA_Skill_StarField에 대한 상속 다이어그램 :

UGA_Skill_StarField에 대한 협력 다이어그램:

Public 멤버 함수
virtual void	ActivateAbility (const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo ActorInfo, const FGameplayAbilityActivationInfo ActivationInfo, const FGameplayEventData TriggerEventData) override

virtual void	EndAbility (const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo *ActorInfo, const FGameplayAbilityActivationInfo ActivationInfo, bool bReplicateEndAbility, bool bWasCancelled) override

UGA_SkillBase(으)로부터 상속된 Public 멤버 함수
virtual void	ApplyCooldown (const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo *ActorInfo, const FGameplayAbilityActivationInfo ActivationInfo) const override

const FGameplayTagContainer *	GetCooldownTags () const

UGA_CombatBase(으)로부터 상속된 Public 멤버 함수
virtual void	OnGiveAbility (const FGameplayAbilityActorInfo *ActorInfo, const FGameplayAbilitySpec &Spec) override

UGA_Base(으)로부터 상속된 Public 멤버 함수
	UGA_Base ()

Protected 멤버 함수
virtual void	ApplyCombatData () override

bool	ResolveWeaponLocation (const FGameplayEventData *TriggerEventData, FVector &OutLocation) const

void	PerformPullAtLocation (const FVector &WeaponLocation, AActor *Avatar, bool bApplyAreaEffects)

void	OnPullDurationFinished ()

void	OnPullTick ()

void	ClearPullState ()

UGA_SkillBase(으)로부터 상속된 Protected 멤버 함수
virtual bool	CheckCost (const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo ActorInfo, FGameplayTagContainer OptionalRelevantTags) const override

virtual void	ApplyCost (const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo *ActorInfo, const FGameplayAbilityActivationInfo ActivationInfo) const override

float	GetSkillMontageSectionLength (const UAnimMontage *Montage, FName SectionName, bool bApplyPlayRate=false, float PlayRate=1.0f) const

bool	HasClearStrikePath (const AMainPlayerCharacter Player, const AActor TargetActor) const

void	SetAvatarPawnCollisionResponse (ECollisionResponse Response) const

float	GetPlayerCurrentWeaponAttackRange () const

void	SetAvatarMeshHidden (bool bHidden) const

void	ResetSkillMontagePlayRate () const

AActor *	GetTargetActor () const

UAnimMontage *	GetSkillMontage (FGameplayTag PlayMontageTag=FGameplayTag::EmptyTag) const

bool	ContainsAllMontageSections (const UAnimMontage *Montage, TArray< FName > SectionNames) const

template<typename T >
const T *	GetExtendedData () const

template<typename T >
bool	HasExtendedData () const

UGA_CombatBase(으)로부터 상속된 Protected 멤버 함수
void	SetupHitCheckListener ()

void	OnHitCheckStart (FGameplayEventData Payload)

void	OnHitCheckEnd (FGameplayEventData Payload)

void	OnTraceResultCallback (const FGameplayAbilityTargetDataHandle &TargetDataHandle, float CombatDataLevel, int32 CombatHitDataIndex)

void	OnFinisherResultCallback (const FGameplayAbilityTargetDataHandle &TargetDataHandle, float CombatDataLevel, int32 CombatHitDataIndex)

virtual TOptional< FTransform >	GetTraceTransformForHitCheck () const

void	ApplyEffectsToSelf (const FGameplayAbilitySpecHandle Handle, const FGameplayAbilityActorInfo *ActorInfo, const FGameplayAbilityActivationInfo ActivationInfo)

FCombatHitPayload	BuildCombatHitPayload (const FCombatHitData &HitData, float DamageMultiplier, bool bRequestKnockback)

TArray< FGameplayEffectSpecHandle >	BuildCombatEffectSpecs (const FCombatHitData &HitData, float DamageMultiplier)

FGameplayEffectSpecHandle	BuildEffectSpec (const FCombatEffectData &EffectData, float CombatDataLevel)

void	PlayCombatHitAudio (const FVector &HitLocation)

void	CacheAudioTagComponents ()

const FKnockbackData *	FindKnockbackData (const FCombatHitData &HitData) const

void	NotifyCameraHitConfirmed () const

float	GetAttackSpeedRate () const

void	UpdateAttackWarpTargetForRange (FName WarpTargetName=FName("Target"))

void	UpdateAttackWarpTargetForRange (FName WarpTargetName, ITargetableInterface *Target)

UGA_Base(으)로부터 상속된 Protected 멤버 함수
UCharacterMotionWarpingComponentBase *	GetMotionWarpingComponent () const

void	SetupCancelableListener ()

void	OnCancelableInputDetected (FGameplayEventData Payload)

virtual void	HandleCancelable (FGameplayEventData Payload)

virtual void	OnAbilityMontageCompleted ()

virtual void	OnAbilityMontageInterrupted ()

virtual void	OnAbilityMontageCancellable ()

Private 속성
float	PullRadius = 0.0f

float	PullStrength = 0.0f

float	PullZComponent = 0.0f

float	PullDuration = 1.0f

float	PullInterval = 0.0f

TEnumAsByte< ECollisionChannel >	OverlapChannel = ECC_Pawn

TArray< TSubclassOf< UGameplayEffect > >	AreaEffects

TObjectPtr< class UAbilityTask_WaitDelay >	WaitDurationTask = nullptr

FVector	CachedWeaponLocation = FVector::ZeroVector

FTimerHandle	PullTickTimer

추가로 상속된 멤버들
UGA_SkillBase(으)로부터 상속된 Protected 속성
FGameplayTag	CooldownTag

float	CostValue

float	CooldownDuration

UGA_CombatBase(으)로부터 상속된 Protected 속성
TObjectPtr< UCombatDataBase >	CombatData

float	AttackRange = 450.0f

float	AttackRangeCorrectionDistance = 250.0f

float	AttackRangeCorrectionInnerOffset = 30.0f

TObjectPtr< UAT_Trace >	ActiveTraceTask

TArray< TSubclassOf< UGameplayEffect > >	SelfEffectClasses

FGameplayTag	WeaponHitCueTag

TArray< TObjectPtr< UAudioEmitterComponent > >	CachedAudioTagComponents

상세한 설명

무기 투사체 충돌 시점에 플레이어 ASC를 통해 발화되는 단발성 끌어당김 GA.

트리거 방식: AbilityTriggers에 (Tag = TAG_..., TriggerSource = GameplayEvent) 등록. 호출 측(WeaponProjectile)은 OnCollided에서 PlayerASC->HandleGameplayEvent(Tag, EventData)를 호출.
위치 해석 우선순위: TriggerEventData.Target(무기 액터) → TargetData.HitResult.ImpactPoint
적용 대상: 검색 반경 내 살아있는 ACK_CharacterEnemy
효과: (적 → 무기) 방향으로 LaunchCharacter, 선택적 광역 GE 적용

멤버 함수 문서화

◆ ActivateAbility()

void UGA_Skill_StarField::ActivateAbility	(	const FGameplayAbilitySpecHandle	Handle,
		const FGameplayAbilityActorInfo *	ActorInfo,
		const FGameplayAbilityActivationInfo	ActivationInfo,
		const FGameplayEventData *	TriggerEventData
	)

overridevirtual

UGA_SkillBase(으)로부터 재구현되었습니다.

{
    FVector WeaponLocation;
 
    // TriggerEventData가 nullptr이면 일반 Activate 경로로 호출된 것 — 이 GA는 GameplayEvent 트리거 전용이라 비정상.
    if (ResolveWeaponLocation(TriggerEventData, WeaponLocation) == false)
    {
        LOG_ERROR(LogCK, "WeaponPull: 무기 위치 해석 실패. EventData.Target 또는 TargetData.HitResult가 비어있음.");
        EndAbility(Handle, ActorInfo, ActivationInfo, true, true);
        return;
    }
 
    CachedWeaponLocation = WeaponLocation;
    AActor* Avatar = ActorInfo ? ActorInfo->AvatarActor.Get() : nullptr;
 
    // 시작 펄스 + 광역 GE는 1회만 — 펄스마다 재적용 시 슬로우/도트 중첩이 누적되어 의도와 어긋남.
    PerformPullAtLocation(CachedWeaponLocation, Avatar, true);
 
    // 지속 시간이 없거나 비정상이면 과거처럼 1회 펄스 후 즉시 종료 — 기존 동작 호환.
    if (PullDuration < 0.f)
    {
        EndAbility(Handle, ActorInfo, ActivationInfo, true, false);
        return;
    }
 
    // 펄스 반복: PullInterval > 0일 때만 — 0이면 시작 시 1회 펄스만 두고 N초 동안 활성 유지.
    if (PullInterval > 0.f)
    {
        GetWorld()->GetTimerManager().SetTimer(PullTickTimer, this, &ThisClass::OnPullTick, PullInterval, true);
    }
 
    // 종료 시점은 AbilityTask가 담당 — WaitDelay 완료 시 EndAbility.
    WaitDurationTask = UAbilityTask_WaitDelay::WaitDelay(this, PullDuration);
 
    if (WaitDurationTask == nullptr)
    {
        // 태스크 생성 실패는 외부 의존성 문제 — 자원 정리 후 종료.
        ClearPullState();
        EndAbility(Handle, ActorInfo, ActivationInfo, true, true);
        return;
    }
 
    WaitDurationTask->OnFinish.AddDynamic(this, &ThisClass::OnPullDurationFinished);
    WaitDurationTask->ReadyForActivation();
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ ApplyCombatData()

void UGA_Skill_StarField::ApplyCombatData ( )

overrideprotectedvirtual

UGA_SkillBase(으)로부터 재구현되었습니다.

{
    Super::ApplyCombatData();
 
    if (CombatData == nullptr)
    {
        return;
    }
 
    if (const FSkillStarFieldData* Payload = CombatData->FindExtendedData<FSkillStarFieldData>())
    {
        PullRadius = Payload->PullRadius;
        PullStrength = Payload->PullStrength;
        PullZComponent = Payload->PullZComponent;
        OverlapChannel = Payload->OverlapChannel;
        AreaEffects = Payload->AreaEffects;
        PullDuration = Payload->PullDuration;
        PullInterval = Payload->PullInterval;
    }
    else
    {
        LOG_ERROR(LogCK, "%s가 유효하지 않습니다. ", NAMEOF(FSkillStarFieldData));
    }
}

◆ ClearPullState()

void UGA_Skill_StarField::ClearPullState ( )

protected

{
    if (UWorld* World = GetWorld())
    {
        World->GetTimerManager().ClearTimer(PullTickTimer);
    }
 
    if (WaitDurationTask)
    {
        WaitDurationTask->OnFinish.RemoveDynamic(this, &ThisClass::OnPullDurationFinished);
        WaitDurationTask->EndTask();
        WaitDurationTask = nullptr;
    }
}

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ EndAbility()

void UGA_Skill_StarField::EndAbility	(	const FGameplayAbilitySpecHandle	Handle,
		const FGameplayAbilityActorInfo *	ActorInfo,
		const FGameplayAbilityActivationInfo	ActivationInfo,
		bool	bReplicateEndAbility,
		bool	bWasCancelled
	)

overridevirtual

UGA_CombatBase(으)로부터 재구현되었습니다.

{
    ClearPullState();
 
    // 종료 알림: WeaponRequest 등 후속 GA가 WaitGameplayEvent로 동기화하는 핸드오프 지점.
    // 캔슬/정상 종료 어떤 경로에서도 발화 — 대기 측이 무한 대기에 빠지지 않도록.
    if (UAbilitySystemComponent* ASC = GetAbilitySystemComponentFromActorInfo())
    {
        FGameplayEventData FinishedData;
        FinishedData.EventTag = TAG_CHARACTER_STATE_COMBAT_SKILL_PULLENEMIES_FINISHED;
        FinishedData.Instigator = ActorInfo ? ActorInfo->AvatarActor.Get() : nullptr;
        ASC->HandleGameplayEvent(TAG_CHARACTER_STATE_COMBAT_SKILL_PULLENEMIES_FINISHED, &FinishedData);
    }
 
    Super::EndAbility(Handle, ActorInfo, ActivationInfo, bReplicateEndAbility, bWasCancelled);
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ OnPullDurationFinished()

void UGA_Skill_StarField::OnPullDurationFinished ( )

protected

{
    EndAbility(CurrentSpecHandle, CurrentActorInfo, CurrentActivationInfo, true, false);
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ OnPullTick()

void UGA_Skill_StarField::OnPullTick ( )

protected

{
    PerformPullAtLocation(CachedWeaponLocation, GetAvatarActorFromActorInfo(), false);
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

◆ PerformPullAtLocation()

void UGA_Skill_StarField::PerformPullAtLocation	(	const FVector &	WeaponLocation,
		AActor *	Avatar,
		bool	bApplyAreaEffects
	)

protected

{
    UWorld* World = GetWorld();
 
    if (World == nullptr)
    {
        return;
    }
 
    // 구형 영역 검색 — 무기 위치를 중심으로 PullRadius 만큼.
    TArray<FOverlapResult> Overlaps;
    FCollisionQueryParams QueryParams(SCENE_QUERY_STAT(WeaponPull), false);
 
    if (Avatar != nullptr)
    {
        // 시전자(플레이어)는 검색 결과에서 제외 — 자기 자신에게 끌어당김이 적용되는 것 방지.
        QueryParams.AddIgnoredActor(Avatar);
    }
 
    World->OverlapMultiByChannel(Overlaps, WeaponLocation, FQuat::Identity, OverlapChannel, FCollisionShape::MakeSphere(PullRadius), QueryParams);
 
    if (Overlaps.IsEmpty())
    {
        return;
    }
 
    // 적 필터링 + 끌어당김 적용을 한 루프에서 수행. 같은 액터가 여러 컴포넌트로 잡혀도 AddUnique로 중복 차단.
    TArray<AEnemyCharacterBase*> ValidEnemies;
 
    for (const FOverlapResult& Overlap : Overlaps)
    {
        AActor* HitActor = Overlap.GetActor();
 
        if (HitActor == nullptr)
        {
            continue;
        }
 
        AEnemyCharacterBase* Enemy = Cast<AEnemyCharacterBase>(HitActor);
 
        if (Enemy == nullptr)
        {
            continue;
        }
 
        if (Enemy->IsDead() == true)
        {
            continue;
        }
 
        // 같은 적을 두 번 처리하지 않도록 — LaunchCharacter 중복 호출 시 가속이 누적되어 과도한 끌림 발생.
        if (ValidEnemies.AddUnique(Enemy) == INDEX_NONE)
        {
            continue;
        }
 
        // 끌어당김 방향: (적 → 무기). Z는 직접 덮어써서 일정한 띄움 효과 부여.
        const FVector EnemyLocation = Enemy->GetActorLocation();
        FVector PullDir = (WeaponLocation - EnemyLocation).GetSafeNormal();
 
        // 적이 무기와 거의 같은 위치(0거리)에 있는 엣지 케이스 — 방향이 영벡터가 되지 않도록 무방향 위로 띄움.
        if (PullDir.IsNearlyZero())
        {
            PullDir = FVector::UpVector;
        }
        else
        {
            PullDir.Z = PullZComponent;
        }
 
        // bXYOverride/bZOverride = true → 기존 속도를 덮어써 매 충돌마다 일관된 끌어당김을 보장.
        Enemy->LaunchCharacter(PullDir * PullStrength, true, true);
    }
 
    // 광역 GE는 옵션. 비어있으면 스킵 — 본 스킬의 직격 데미지는 무기 CollisionAbilityTag가 별도로 처리.
    // bApplyAreaEffects=false인 경우(=펄스 반복 호출)는 GE 적용 단계 전체를 건너뜀 — 슬로우/도트 중첩 누적 방지.
    if (bApplyAreaEffects == false || AreaEffects.IsEmpty() == true || ValidEnemies.IsEmpty() == true)
    {
        return;
    }
 
    UAbilitySystemComponent* SourceASC = GetAbilitySystemComponentFromActorInfo();
 
    if (SourceASC == nullptr)
    {
        return;
    }
 
    for (const TSubclassOf<UGameplayEffect>& EffectClass : AreaEffects)
    {
        if (EffectClass == nullptr)
        {
            continue;
        }
 
        // 효과 컨텍스트는 매 GE마다 새로 — Instigator/SourceObject 정보가 GE별로 독립되도록.
        FGameplayEffectContextHandle Context = SourceASC->MakeEffectContext();
        Context.AddSourceObject(this);
 
        FGameplayEffectSpecHandle SpecHandle = SourceASC->MakeOutgoingSpec(EffectClass, GetAbilityLevel(), Context);
 
        if (SpecHandle.IsValid() == false)
        {
            continue;
        }
 
        for (AEnemyCharacterBase* Target : ValidEnemies)
        {
            // ApplyGameplayEffectSpecToTarget은 TargetData를 요구하므로, ASC 직접 호출이 더 단순.
            SourceASC->ApplyGameplayEffectSpecToTarget(*SpecHandle.Data.Get(), Target->GetAbilitySystemComponent());
        }
    }
}

이 함수 내부에서 호출하는 함수들에 대한 그래프입니다.:

이 함수를 호출하는 함수들에 대한 그래프입니다.:

◆ ResolveWeaponLocation()

bool UGA_Skill_StarField::ResolveWeaponLocation	(	const FGameplayEventData *	TriggerEventData,
		FVector &	OutLocation
	)		const

protected

{
    if (TriggerEventData == nullptr)
    {
        return false;
    }
 
    if (const AActor* Target = TriggerEventData->Target)
    {
        OutLocation = Target->GetActorLocation();
        return true;
    }
 
    // 우선순위 2: TargetData에 HitResult를 실어 보내는 경우 — 임팩트 지점 자체가 더 정확할 때 폴백 경로로 사용.
    for (const TSharedPtr<FGameplayAbilityTargetData>& Data : TriggerEventData->TargetData.Data)
    {
        if (Data.IsValid() == false)
        {
            LOG_ERROR(LogCK, "%s 가 유효하지 않습니다. ", NAMEOF_VAR(Data));
            continue;
        }
 
        if (const FHitResult* Hit = Data->GetHitResult())
        {
            OutLocation = Hit->ImpactPoint;
            return true;
        }
    }
 
    return false;
}

이 함수를 호출하는 함수들에 대한 그래프입니다.:

멤버 데이터 문서화

◆ AreaEffects

TArray<TSubclassOf<UGameplayEffect> > UGA_Skill_StarField::AreaEffects

private

◆ CachedWeaponLocation

FVector UGA_Skill_StarField::CachedWeaponLocation = FVector::ZeroVector

private

◆ OverlapChannel

TEnumAsByte<ECollisionChannel> UGA_Skill_StarField::OverlapChannel = ECC_Pawn

private

◆ PullDuration

float UGA_Skill_StarField::PullDuration = 1.0f

private

◆ PullInterval

float UGA_Skill_StarField::PullInterval = 0.0f

private

◆ PullRadius

float UGA_Skill_StarField::PullRadius = 0.0f

private

◆ PullStrength

float UGA_Skill_StarField::PullStrength = 0.0f

private

◆ PullTickTimer

FTimerHandle UGA_Skill_StarField::PullTickTimer

private

◆ PullZComponent

float UGA_Skill_StarField::PullZComponent = 0.0f

private

◆ WaitDurationTask

TObjectPtr<class UAbilityTask_WaitDelay> UGA_Skill_StarField::WaitDurationTask = nullptr

private

이 클래스에 대한 문서화 페이지는 다음의 파일들로부터 생성되었습니다.:

Source/CK_UE/GAS/GA/GA_Skill/GA_Skill_StarField.h
Source/CK_UE/GAS/GA/GA_Skill/GA_Skill_StarField.cpp

Public 멤버 함수

Protected 멤버 함수

Private 속성

추가로 상속된 멤버들

상세한 설명

멤버 함수 문서화

◆ ActivateAbility()

◆ ApplyCombatData()

◆ ClearPullState()

◆ EndAbility()

◆ OnPullDurationFinished()

◆ OnPullTick()

◆ PerformPullAtLocation()

◆ ResolveWeaponLocation()

멤버 데이터 문서화

◆ AreaEffects

◆ CachedWeaponLocation

◆ OverlapChannel

◆ PullDuration

◆ PullInterval

◆ PullRadius

◆ PullStrength

◆ PullTickTimer

◆ PullZComponent

◆ WaitDurationTask