📘TIL - 에픽 몬스터 버그 수정 & VFX 적용

배경

오늘은 에픽 몬스터(드래곤·나무 몬스터·바위 몬스터) 전반에 걸쳐 세 가지 큰 주제를 다뤘다.

1. 버그 수정: 투사체 데미지, 패리 반사, 그로기 적용, 지상 이동 애니메이션, 라바 투사체 VFX
2. 코드 격리: 에픽 몬스터 전용 로직이 공통 파일을 오염시키는 문제의 원인 분석 및 아키텍처 분리 방향 수립
3. VFX 구현: Dragon Meteor, Water Projectile 두 투사체의 Niagara VFX 신규 제작

처음에는 각각 독립된 문제처럼 보였지만, 투사체 충돌 처리 → GAS GameplayEffect 적용 → 패리 상태 태그 → 패턴 카운터·그로기 이벤트 → 공중/지상 상태 전환 → AnimBP 속도 변수·슬롯 몽타주 → 커맨드렛을 통한 Blueprint/Asset CDO 설정까지 여러 시스템이 이어져 있었다.

---

목차

1. 투사체 데미지 미적용
2. 패리 반사 미작동
3. 반사 투사체 그로기 적용 문제
4. 드래곤 지상 이동 중 idle 미끄러짐
5. 드래곤 AnimBP/BlendSpace 구조 보정
6. 라바 투사체 VFX 격자 파티클 문제
7. 에픽 몬스터 코드 격리 — 원인 분석 & 아키텍처 분리
8. Dragon Meteor VFX 구현
9. Water Projectile VFX 구현
10. 검증 결과
11. 오늘 배운 점
12. 다음에 비슷한 버그가 나면 볼 체크리스트

---

1. 투사체 데미지 미적용

증상

드래곤이 발사한 라바 투사체가 플레이어에게 닿아도 데미지가 적용되지 않았다. 투사체 자체는 스폰되고 충돌도 발생했지만, GAS 데미지 적용까지 이어지지 않았다.

원인

AEnemyProjectile::OnProjectileOverlap의 충돌 처리 순서 문제다. 투사체 BP CDO에 DamageEffectClass가 없거나, 반사 판정과 데미지 판정의 순서가 충돌하면 데미지가 묻힌다.

올바른 처리 순서:
1. 무시해야 하는 액터인지 확인
2. 이미 반사된 투사체인지 확인 (HandleReflectedOverlap)
3. 대상 ASC 획득
4. 패리 중이면 반사 처리 (TryReflectOnHit)
5. 일반 피격이면 DamageEffect 적용
6. 넉백, Impact VFX, Destroy 처리

구현 수정

Source/Retrieve/AbilitySystem/Enemy/EnemyProjectile.cpp에서 충돌 흐름을 정리했다.

if (HandleReflectedOverlap(OtherActor, SweepResult))
{
    return;
}

UAbilitySystemComponent* TargetASC = ...;
if (!TargetASC)
{
    return;
}

if (HasAuthority() && TryReflectOnHit(OtherActor, TargetASC))
{
    return;
}

if (HasAuthority() && DamageEffectClass)
{
    SourceASC->ApplyGameplayEffectSpecToTarget(*Spec.Data.Get(), TargetASC);
}

RetrieveConfigureEpicMonstersCommandlet.cpp에서 라바/물 투사체 BP CDO에 다음 값을 지정했다.

• DamageEffectClass → /Game/Retrieve/AbilitySystem/Player/GE_BasicHitDamage.GE_BasicHitDamage_C
• FlightVFX, ImpactVFX

---

2. 패리 반사 미작동

증상

플레이어가 R 키로 패리에 성공해도 드래곤 투사체가 되돌아가지 않았다.

원인

반사 가능한 투사체는 데미지 판정보다 먼저 플레이어의 패리 상태(State.Player.Parrying 태그)를 확인해야 한다. 해당 태그가 있으면 데미지를 주지 않고 드래곤을 카운터 타겟으로 삼아 방향을 바꿔야 한다.

구현 수정

Source/Retrieve/AbilitySystem/Enemy/EpicEnemyProjectile.cpp에 에픽 투사체 전용 반사 흐름을 구현했다.

TryReflectOnHit 조건:

• bReflectable = true
• bReflected = false (아직 반사 전)
• 서버 권한 있음
• 대상 ASC에 State_Player_Parrying 태그 있음

패리 성공 시 처리:

• 플레이어에게 GameplayEvent_Parry_Success 전송
• OptionalObject에 드래곤(반사 카운터 타겟) 세팅
• ReflectTowardCounterTarget(OtherActor) 호출

ReflectTowardCounterTarget에서 변경하는 값:

• ReflectedInstigator = ParryingActor
• bReflected = true
• 기존 homing 중단
• 드래곤을 더 이상 IgnoreActor로 두지 않음
• ReflectedSpeedMultiplier 적용 후 드래곤 방향으로 재발사

const FVector Direction = (TargetLocation - GetActorLocation()).GetSafeNormal();
const float CurrentSpeed = FMath::Max(ProjectileMovement->Velocity.Size(), ProjectileMovement->MaxSpeed);
const float ReflectedSpeed = FMath::Max(CurrentSpeed * ReflectedSpeedMultiplier, 300.f);
Launch(Direction, ReflectedSpeed);
SetActorRotation(Direction.Rotation());

---

3. 반사 투사체 그로기 적용 문제

증상

반사된 투사체가 드래곤에게 돌아가지만, 공중 상태에서 그로기가 걸려 플레이어가 지상 공격으로 때리기 어려웠다. 패턴 파훼 보상으로 기능하지 못하는 상태.

원인

드래곤은 공중 패턴 중 투사체를 발사하므로, 카운터 타겟 적중 시점에도 AerialMode, MOVE_Flying, 공중 슬롯 애니메이션이 남아 있다. 그로기는 플레이어가 실제로 공격할 수 있는 전투 보상 상태여야 하므로, 적용 전에 위치와 MovementMode를 지상 기준으로 정리해야 한다.

구현 수정

AEpicEnemyProjectile::HandleReflectedOverlap에서 bReflected 상태인 투사체는 베이스 데미지 처리를 타지 않도록 분리했다.

if (!bReflected)
{
    return false;
}

if (TryApplyReflectedCounter(OtherActor))
{
    PlayImpactVFX(...);
    Destroy();
}

return true;

TryApplyReflectedCounter에서 카운터 적용 전 지상 보정:

ForceEnemyToGroundForGroggy(CounterTarget)
  └─ SetAerialMode(false)
  └─ 아래 방향 라인트레이스 → 캡슐 half height 보정으로 지면 배치
  └─ CharacterMovement → MOVE_Walking
  └─ StopMovementImmediately
  └─ DefaultSlot 슬롯 애니메이션 정지

이후 카운터 처리:

PatternCounterComponent->OpenCounterWindow(0.1f)
PatternCounterComponent->TryCounter(Ability_Player_Parry, Element_None, ReflectedInstigator)

PatternCounterComponent.cpp에서 그로기 이벤트 EventMagnitude에 GroggyDuration이 들어가도록 수정해 데이터 기반 그로기 지속 시간 적용.

---

4. 드래곤 지상 이동 중 idle 미끄러짐

증상

드래곤이 지상에서 추적 이동 중인데 걷기 애니메이션 없이 idle 포즈로 미끄러지는 현상이 반복됐다.

분석한 복합 원인

원인	설명
Velocity 기반 Speed 계산	AI 이동·캡슐 보정·StateTree 이동이 섞이면 Actor 위치는 변해도 Velocity가 순간 낮게 잡히는 프레임 발생
DefaultSlot 슬롯 몽타주 충돌	공격·공중·착지·회전 몽타주가 DefaultSlot을 사용하면서 지상 이동 포즈를 덮는 순간 발생
Chase 태그 불일치	공중→지상 전환 중 State.Enemy.Chase 태그와 실제 이동 상태가 순간적으로 불일치
AnimBP Direction 계산	Direction이 타겟 facing이 아닌 이동 방향 기준으로 계산 → 양 방향이 다르면 strafe 블렌드스페이스 입력

1차 수정 — AnimInstance 속도 계산 보강

Source/Retrieve/Animation/RetrieveEnemyAnimInstance.cpp에서 Velocity만 쓰지 않고 Actor 위치 변화량도 함께 샘플링한다.

추가 상태: CachedPawnForMovementSample, LastMovementSampleLocation, bHasMovementSampleLocation

const FVector Velocity2D(Pawn->GetVelocity().X, Pawn->GetVelocity().Y, 0.f);
FVector Movement2D = Velocity2D;

const FVector DeltaLocation2D = ActorLocation - LastMovementSampleLocation;
const FVector LocationDeltaVelocity2D = DeltaLocation2D / DeltaSeconds;

if (LocationDeltaVelocity2D.SizeSquared() > Movement2D.SizeSquared())
{
    Movement2D = LocationDeltaVelocity2D;
}

Speed = Movement2D.Size();

2차 수정 — EpicMonsterCharacter Tick에서 AnimBP 변수 강제 보정

Source/Retrieve/Character/RetrieveEpicMonsterCharacter.cpp의 Tick에서 지상 이동 여부를 별도로 판단해 AnimInstance에 Reflection으로 직접 세팅한다.

이동 판단 제외 조건: Falling/Flying, 공격/특수공격/피격/스태거/그로기/사망 상태

세팅하는 변수 (프로퍼티가 존재하는 경우에만):
Speed, GroundSpeed, Direction, IsMoving, bIsMoving, ShouldMove, bShouldMove, IsChasing, bIsChasing

실제 이동 중인데 State.Enemy.Chase 태그가 없는 경우를 위해 C++에서 임시로 loose tag를 붙인다.

// 이동 감지 시
ASC->AddLooseGameplayTag(State_Enemy_Chase);
bMovementDrivenChaseTagAdded = true;

// 이동 종료 시 (내가 붙인 태그만 제거)
if (bMovementDrivenChaseTagAdded)
{
    ASC->RemoveLooseGameplayTag(State_Enemy_Chase);
    bMovementDrivenChaseTagAdded = false;
}

bMovementDrivenChaseTagAdded를 둔 이유: 다른 시스템이 붙인 Chase 태그를 실수로 제거하지 않기 위함.

3차 수정 — 지상 이동 애니메이션 fallback

RetrieveEpicMonsterCharacter.h에 Dragon BP에서 설정 가능한 fallback 필드를 추가했다.

• ForcedGroundMoveAnimation
• ForcedGroundMovePlayRate
• GroundMoveMontage

지상 이동이 감지되고 상위 상태(공격/피격/그로기 등)가 아니면 ForcedGroundMoveAnimation을 DefaultSlot 동적 몽타주로 반복 재생한다.

GroundMoveMontage = AnimInstance->PlaySlotAnimationAsDynamicMontage(
    MoveSequence,
    TurnAnimationSlot,
    0.12f,   // BlendIn
    0.12f,   // BlendOut
    ForcedGroundMovePlayRate,
    999);    // Priority

StopLocomotionMontages에서 회전 몽타주와 이동 몽타주를 함께 정리하도록 수정:

• GroundTurnMontage
• GroundMoveMontage
• GroundTurnDirection

---

5. 드래곤 AnimBP/BlendSpace 구조 보정

문제

C++에서 Speed를 잘 넣어도 AnimBP 그래프가 해당 값을 제대로 쓰지 않거나, Slot 노드가 Root 앞에 없으면 몽타주 fallback이 최종 포즈에 반영되지 않는다.

구현 수정

RetrieveConfigureEpicMonstersCommandlet.cpp에서 드래곤 AnimBP·BlendSpace를 구성한다.

사용 에셋:

• Idle: Polygonal_Dragon_AnimationIdle
• Move: Polygonal_Dragon_AnimationWalk_Forward_WO_Root
• BlendSpace: /Game/Retrieve/AI/Animations/Dragon/BS_DragonChase
• AnimBP: /Game/Retrieve/AI/Animations/ABP_DragonEnemy

AnimBP AnimGraph 구조:

Speed 변수
  → BlendSpacePlayer(BS_DragonChase)
  → Slot(DefaultSlot)          ← 반드시 Root 앞에
  → Root

DefaultSlot을 Root 앞에 두는 이유: C++에서 재생하는 지상 이동 fallback 몽타주·회전 몽타주·공격/공중 계열 몽타주가 최종 AnimGraph에 반영되도록 하기 위함.

커맨드렛에서 BP_Dragon CDO에 저장한 값:

• Mesh AnimClass
• ForcedGroundMoveAnimation

DumpAnim 검증 결과

ABP_DragonEnemy ParentClass: /Script/Retrieve.RetrieveEnemyAnimInstance
AnimGraph Nodes: 4
Root 입력: AnimGraphNode_Slot
BlendSpacePlayer: BS_DragonChase
Slot: DefaultSlot

---

6. 라바 투사체 VFX 격자 파티클 문제

증상

라바 투사체 비행 VFX가 불꽃 트레일이 아니라 화면에서 격자 형태의 파티클 덩어리가 찍히는 것처럼 보였다.

원인

기존 NS_LavaProjectile_Flight의 Niagara 설정이 투사체 비행용 트레일보다 sprite/grid 형태가 두드러지는 구성이었다. 투사체가 빠르게 움직이면 격자감이 더 강하게 보였다.

구현 수정

바이너리 .uasset을 직접 수정하지 않고, 커맨드렛에서 안정적인 외부 Niagara 트레일 에셋을 투사체 BP CDO에 할당했다.

용도	에셋
Flight VFX	/Game/External/PolygonParticleFX/Particles/NS_Trail_Fireball_01
Impact VFX	/Game/External/PolygonFantasyVillage/PolygonGeneric/FX/NS_Fire_01

ConfigureProjectileBlueprintVFX에서 설정한 내용:

• FlightVFXComponent->SetAsset(FlightVFX)
• CDO FlightVFX
• CDO ImpactVFX
• CDO DamageEffectClass

---

7. 에픽 몬스터 코드 격리 — 원인 분석 & 아키텍처 분리

반복되는 버그의 근본 원인

Dragon/Treant/Magma 전용 로직이 공통 파일에 직접 주입된 것이 핵심이다.

공통 파일	문제
RetrieveEnemyCharacter	Dragon 전용 회전/이동 설정, 공중 페이즈 로직이 섞임
EnemyCombatComponent	패턴 Sequence/Hitbox 필드가 Dragon 구조 가정
GA_ShootProjectiles	AerialFireball/Rain/Spread 판별이 row 이름 문자열 하드코딩
StateTreeTask_EnemyAttack	8도 facing 게이트 + Dragon 전용 회전 방식 충돌

세부 버그 원인

공격 발동 실패: FaceTargetForAttack() (직접 회전)과 ApplyDragonGroundMovementSettings() (bOrientRotationToMovement)가 동시에 활성화 → 8도 facing 게이트를 절대 통과 못 함

특수 패턴 미발동: IsDragonAerialFireballPattern()이 row 이름 문자열 비교로 판별 → 새 패턴 추가/리네임 시 코드 수정 불가피

추적 이동 없음: ShiftOrbitSlot의 bOrientRotationToMovement 전환이 EnemyAttack의 직접 회전과 계속 충돌

strafe 애니메이션: Direction이 타겟 facing이 아닌 이동 방향 기준 → 공격 중 이동 방향과 타겟 방향이 달라 strafe 블렌드스페이스 입력

아키텍처 분리 방향

분리 대상	방법
에픽 몬스터 공통 기반	ARetrieveEpicMonsterCharacter : ARetrieveEnemyCharacter 신규 클래스
StateTree 태스크	Monster_Type_Epic 태그로 Epic 클래스 검증 후 분기
어빌리티 시스템	GA_EpicShootProjectiles 별도 구현 + enum 기반 패턴 분기
투사체	AEpicEnemyProjectile 별도 구현 (virtual hook 분리)
DataTable	MonsterPattern row + SpawnPattern enum + VFX 설정으로 새 패턴 추가 가능

수정/생성 대상 파일

• Source/Retrieve/Character/RetrieveEpicMonsterCharacter.h/.cpp (신규)
• Source/Retrieve/Character/RetrieveEnemyCharacter.cpp/.h
• Source/Retrieve/Enemy/StateTree/StateTreeTask_EnemyAttack.cpp
• Source/Retrieve/Enemy/StateTree/StateTreeTask_EnemyPatternAttack.cpp
• Source/Retrieve/Enemy/StateTree/StateTreeTask_ShiftOrbitSlot.cpp
• Source/Retrieve/Components/Enemy/EnemyCombatComponent.cpp
• Source/Retrieve/AbilitySystem/Enemy/GAS/GA_ShootProjectiles.cpp
• Source/Retrieve/AbilitySystem/Enemy/GAS/GA_EpicShootProjectiles.cpp (신규)
• Source/Retrieve/AbilitySystem/Enemy/EnemyProjectile.cpp
• Source/Retrieve/AbilitySystem/Enemy/EpicEnemyProjectile.cpp (신규)
• Source/Retrieve/Data/RetrieveDataTableTypes.h
• Config/DefaultEngine.ini (CoreRedirects)

---

8. Dragon Meteor VFX 구현

사용 도구: Monolith MCP + Niagara
구조: Flight VFX + Impact VFX 분리

구현 단계

Phase 1 — NS_DragonMeteor_Flight

• NS_LavaRocks를 duplicate_system으로 복제
• Rock_01~04: Mesh Renderer로 낙하하는 바위 표현
• Smoke Emitter: NS_Smoke_Black_01 기반 검은 궤적 연기
• 파라미터 조정: Lifetime, Spawn Rate, 낙하 방향

Phase 2 — NS_DragonMeteor_Impact

• Burst 모드 Emitter 구성
• M_Burst + M_explosion_subUV 머티리얼로 폭발 표현
• Loop=Once 설정으로 충격 순간만 재생

사용한 Niagara 에셋

에셋	역할
NS_LavaRocks	메테오 기본 구조 (Flight 베이스)
NS_Smoke_Black_01	낙하 궤적 연기
M_Burst	충격 폭발 효과
M_explosion_subUV	폭발 subUV 애니메이션

겪은 문제 & 해결

문제	해결
add_emitter에 NiagaraSystem 타입 전달	NiagaraEmitter 경로로 내부 emitter 직접 참조
Smoke Emitter 경로 불확실	NS_Smoke_Black_01.NS_Smoke_Black_01:Smoke_0 형태로 지정

Monolith 호출 순서

1. niagara_query: list_systems           → 기존 에셋 탐색
2. niagara_query: duplicate_system       → NS_LavaRocks → NS_DragonMeteor_Flight
3. niagara_query: add_emitter            → Smoke emitter 추가
4. niagara_query: set_module_input_value → 파라미터 조정
5. niagara_query: save_system            → 저장

---

9. Water Projectile VFX 구현

참고 문서: C:\Users\lhw45\Downloads\TeamProject\CH5_Project\Docs\VFX_Niagara_Guide.md
구조: Flight / Impact를 별도 시스템으로 분리 (Dragon의 단일 복합 구조와 차이)

기존 상태

BP_WaterProjectile의 FlightVFX/ImpactVFX 필드가 비어 있었고 stub 파일이 남아 있었다.

구현 단계

STEP 1 — NS_WaterProjectile_Flight

• NS_Waterfall_Drops_01 (Realistic Starter VFX Pack Vol2) 복제
• WaterCore Emitter: Sprite Renderer, 밝은 파란색 물 입자
• WaterTrail Emitter: Sprite Renderer, 물 흐름 라인

STEP 2 — NS_WaterProjectile_Impact

• NS_Waterfall_Splashes_01 복제
• WaterSplash Emitter: Burst 방사 패턴 (튀는 효과)
• WaterRipple Emitter: Burst 바닥 파동 효과

STEP 3 — BP_WaterProjectile 연결

• FlightVFX → NS_WaterProjectile_Flight
• ImpactVFX → NS_WaterProjectile_Impact

사용한 에셋

에셋	역할
NS_Waterfall_Drops_01	Flight VFX 베이스
NS_Waterfall_Splashes_01	Impact VFX 베이스
M_WaterDrop_A	현대적 물 머티리얼 (Vol2 pack)

결과

항목	상태
NS_WaterProjectile_Flight 생성	✅
NS_WaterProjectile_Impact 생성	✅
BP_WaterProjectile FlightVFX 연결	✅
BP_WaterProjectile ImpactVFX 연결	✅
컴파일 에러	✅ 0개
VFX 가이드 문서 업데이트	✅ Dragon + Water 구현 절차 추가

---

10. 검증 결과

빌드

& 'C:\Program Files\Epic Games\UE_5.7\Engine\Build\BatchFiles\Build.bat' RetrieveEditor Win64 Development -Project='...\Retrieve.uproject' -WaitMutex -NoHotReload

결과: 성공.

에픽 몬스터 설정 커맨드렛

& 'C:\Program Files\Epic Games\UE_5.7\Engine\Binaries\Win64\UnrealEditor-Cmd.exe' '...\Retrieve.uproject' -run=RetrieveConfigureEpicMonsters -unattended -nop4

결과: 성공.

AnimBP Dump

& '...\UnrealEditor-Cmd.exe' '...\Retrieve.uproject' -run=RetrieveConfigureEpicMonsters DumpAnim -unattended -nop4

확인:

• ABP_DragonEnemy ParentClass: /Script/Retrieve.RetrieveEnemyAnimInstance
• AnimGraph: BlendSpacePlayer(BS_DragonChase) → Slot(DefaultSlot) → Root ✅

수정/확인한 주요 파일

파일	작업
AbilitySystem/Enemy/EnemyProjectile.cpp	충돌 처리 순서 정리
AbilitySystem/Enemy/EpicEnemyProjectile.cpp	패리 반사 + 그로기 보정
Components/Enemy/PatternCounterComponent.cpp	그로기 EventMagnitude 데이터 연동
Animation/RetrieveEnemyAnimInstance.cpp/.h	위치 변화량 기반 Speed 보강
Character/RetrieveEpicMonsterCharacter.cpp/.h	Tick 이동 보정 + fallback 몽타주
Commandlets/RetrieveConfigureEpicMonstersCommandlet.cpp	BP CDO 설정, AnimBP 구조
Content/.../BP_Dragon.uasset	CDO 저장
Content/.../ABP_DragonEnemy.uasset	AnimGraph 구조
Content/.../BS_DragonChase.uasset	BlendSpace

---

11. 오늘 배운 점

투사체 충돌 처리 순서가 전부다

투사체처럼 충돌 순간에 여러 기능이 이어지는 액터는 처리 순서가 매우 중요하다. 반사 판정을 데미지보다 먼저 두고, 반사된 투사체는 베이스 데미지 처리를 타지 않도록 분리한 것이 핵심이었다. HandleReflectedOverlap → TryReflectOnHit → ApplyDamage 순서를 지키면 기능이 묻히지 않는다.

공중 보스의 그로기는 위치부터 정리한다

그로기는 단순히 태그만 붙이면 안 된다. 전투 보상 상태로 기능하려면 적용 전에 SetAerialMode(false), 지면 라인트레이스 스냅, MOVE_Walking, 슬롯 애니메이션 정지가 함께 필요하다.

AI 이동 애니메이션은 Velocity 하나만 믿으면 위험하다

Velocity가 낮게 잡히는 프레임이 생길 수 있어서 Actor 위치 변화량을 함께 샘플링해야 "실제로 움직이는데 idle"인 상황을 잡을 수 있다. 그래도 AnimBP 전이나 슬롯 몽타주가 얽히면 C++ fallback이 필요하다.

공통 파일 오염은 회전 충돌로 나타난다

특정 몬스터 전용 로직을 공통 파일에 넣으면 회전 방식이 충돌하고, facing 게이트를 통과하지 못해 공격 자체가 발동하지 않는다. Epic 전용 기반 클래스를 만들고 virtual/override로 분리하는 것이 정답이다.

패턴 판별은 문자열 비교가 아닌 enum/태그로

row 이름 문자열 비교로 패턴을 분기하면 나중에 추가/리네임할 때 반드시 코드를 건드려야 한다. 처음부터 enum 또는 GameplayTag로 판별해야 DataTable 변경에도 코드 수정이 없다.

Blueprint CDO 설정은 커맨드렛으로 검증한다

AnimBP 그래프 구조나 투사체 BP CDO 값처럼 에셋 기본값이 필요한 수정은 C++만 바꿔서는 끝나지 않는다. 커맨드렛으로 CDO를 저장하고 DumpAnim으로 실제 그래프 구조를 확인하는 검증 루틴이 중요하다.

Niagara VFX 구현 패턴

• Monolith 호출 순서: duplicate_system → add_emitter → set_module_input_value → save_system
• add_emitter에는 NiagaraSystem이 아닌 NiagaraEmitter 경로를 넘겨야 한다
• Emitter 내부 경로 형식: NS_SystemName.NS_SystemName:EmitterName_0
• Flight/Impact를 별도 시스템으로 분리하면 각각 독립적으로 재생/중단 가능해 관리가 쉽다