📘TIL - 에픽 몬스터 구현 및 드래곤 전투 개선

1. 에픽 몬스터 그로기 시스템 구현

배경

에픽 몬스터는 일반 몬스터보다 전투 패턴이 길고, 플레이어가 특정 조건을 만족했을 때 그로기 상태로 진입하는 구조가 필요했다.

기존 NormalMonsterHealthBarComponent는 HP만 표시하고 있었기 때문에, 그로기 누적 상태는 별도 컴포넌트로 분리했다.

구현

EpicMonsterGroggyComponent를 추가해 강공격 피격 횟수를 누적하고, 일정 횟수 이상 누적되면 GameplayEvent.GroggyTrigger를 발생시키도록 했다.

GAS의 OnGameplayEffectAppliedDelegateToSelf를 구독하고, 적용된 GE의 DynamicAssetTags에 Attack.Type.Heavy가 있는지 확인하는 방식으로 강공격을 판정했다.

if (Spec.DynamicAssetTags.HasTag(RetrieveGameplayTags::Attack_Type_Heavy))
{
    OnHeavyAttackReceived();
}

그로기 종료는 State.Enemy.Groggy 태그 변화 콜백으로 감지했다.

배운 점

GAS에서 특정 공격 타입을 구분할 때 GE 클래스를 늘리는 것보다 DynamicAssetTags 기반으로 분기하는 방식이 더 유연하다.

---

2. 에픽 몬스터 체력바에 그로기 게이지 연동

배경

에픽 몬스터는 HP뿐 아니라 그로기 누적 상태도 UI에 표시해야 했다.

하지만 모든 몬스터가 그로기 게이지를 가지는 것은 아니므로, 일반 몬스터 UI 구조를 크게 바꾸지 않고 확장할 필요가 있었다.

구현

NormalMonsterHealthBarComponent에서 EpicMonsterGroggyComponent가 존재하는 경우에만 그로기 게이지 업데이트 델리게이트를 바인딩했다.

UEpicMonsterGroggyComponent* GroggyComp =
    GetOwner()->FindComponentByClass<UEpicMonsterGroggyComponent>();

if (GroggyComp)
{
    GroggyComp->OnGroggyGaugeUpdated.AddDynamic(
        this, &UNormalMonsterHealthBarComponent::HandleGroggyGaugeUpdated);
}

배운 점

컴포넌트 존재 여부를 기능 활성화 조건으로 사용하면 일반 몬스터와 에픽 몬스터를 별도 클래스로 과하게 분리하지 않아도 된다.

---

3. 데이터 테이블 구조와 드래곤 패턴 처리 방향 정리

배경

드래곤은 일반 몬스터와 동일하게 DT_MonsterData, DT_MonsterPattern, StateTree 기반으로 동작해야 했다.

초기에는 드래곤 전용 애니메이션 시퀀스, 히트박스 타이밍, 공중 페이즈 여부 등을 데이터 테이블 필드로 확장하는 방향도 검토했다.

최종 방향

프로젝트 기준상 기존 DT_MonsterData, DT_MonsterPattern 구조를 고정하기로 했기 때문에, 최종 구현에서는 데이터 테이블 구조를 변경하지 않았다.

대신 드래곤 전용 예외는 RowName 기반 런타임 보정으로 처리했다.

예를 들어 Dragon_Bite는 AttackMontage가 없어도 코드에서 드래곤 바이트 시퀀스를 동적 몽타주로 재생하도록 했다.

Polygonal_Dragon_AnimationBite_Attack
HitboxStartTime = 0.38f
HitboxDuration = 0.28f

배운 점

공용 데이터 테이블은 여러 몬스터가 의존하므로, 특정 몬스터 요구사항만 보고 구조를 확장하면 유지보수 비용이 커질 수 있다.

---

4. CSV 리임포트 과정에서 컬럼 개수 오류 수정

문제

DT_MonsterPattern.csv 리임포트 중 다음 오류가 발생했다.

Row has more cells than properties, is there a malformed string?

원인은 bCanTriggerGroggy와 HitboxBoneName 사이의 빈 컬럼 개수가 맞지 않았기 때문이다.

Header:
..., bCanBeParried, bCanTriggerGroggy, CounterEventTag, RequiredElementTag, RequiredActionTag, HitboxBoneName, ...

CounterEventTag, RequiredElementTag, RequiredActionTag 3개 빈 값을 표현해야 하는데 쉼표 개수가 잘못되어 행 전체가 밀렸다.

배운 점

UE DataTable CSV 오류에서 more cells than properties가 나오면 실제 값보다 빈 셀 개수를 먼저 확인해야 한다.

---

5. BP_Dragon / BP_Treant / BP_Magma 구성

작업 내용

에픽 몬스터용 블루프린트에 그로기 컴포넌트와 데이터 Row 설정을 적용했다.

BP	작업
BP_Dragon	GroggyComponent 추가, 드래곤 데이터 연결
BP_Treant	RetrieveEnemyCharacter 기반 신규 구성, Treant_Water Row 연결
BP_Magma	RetrieveEnemyCharacter 기반 신규 구성, Magma_Fire Row 연결

문제

블루프린트 CDO 설정 중 DataRowName 프로퍼티를 찾지 못하는 문제가 있었다.

실제 프로퍼티명은 MonsterDataRowName이었다.

배운 점

블루프린트 CDO를 자동화로 수정할 때는 추측한 이름을 쓰기보다 실제 CDO 프로퍼티 목록을 먼저 확인해야 한다.

---

6. 드래곤 공중 모드 전환 처리

문제

StateTreeTask_EnemyAerialPhase에서 드래곤 공중 페이즈 진입/복귀 시 SetAerialMode()를 호출하지만, 머지 과정에서 해당 함수가 누락되어 빌드 오류가 발생했다.

해결

ARetrieveEnemyCharacter에 SetAerialMode(bool bAerial)을 추가했다.

if (bAerial)
{
    MoveComp->SetMovementMode(MOVE_Flying);
    MoveComp->GravityScale = 0.f;
}
else
{
    MoveComp->GravityScale = DefaultGravityScale;
    MoveComp->SetMovementMode(MOVE_Falling);
}

착지 시에는 MOVE_Falling에서 지면 감지 후 자연스럽게 MOVE_Walking으로 돌아가도록 했다.

배운 점

공중 페이즈 종료 시 바로 MOVE_Walking으로 돌리는 것보다 MOVE_Falling을 거쳐 CharacterMovement의 지면 감지를 활용하는 편이 자연스럽다.

---

7. 드래곤 일반 공격 판정 수정

문제

드래곤이 플레이어를 인식하고 공격 모션은 수행하지만 실제 데미지가 들어가지 않았다.

원인은 Dragon_Bite 히트박스가 Head 본에 붙도록 되어 있었지만, 실제 드래곤 스켈레톤의 머리 본은 RigHead였기 때문이다.

해결

Dragon_Bite에 한해 런타임 보정으로 히트박스 본과 판정 크기를 조정했다.

HitboxBoneName = RigHead
HitboxRadius = 200
HitboxOffset = (130, 0, 0)
MaxActivationRange = 520

또한 드래곤 메시 크기에 맞게 캡슐 크기와 메시 상대 위치도 보정했다.

CapsuleRadius = 170
CapsuleHalfHeight = 255
MeshRelativeLocation = (0, 0, -255)

배운 점

공격이 맞지 않는 문제는 데미지 로직보다 먼저 히트박스가 실제 스켈레톤의 올바른 본에 붙는지 확인해야 한다.

---

8. 드래곤 회전 및 이동 애니메이션 개선

문제

드래곤이 공격 전 플레이어를 바라볼 때 발은 움직이지 않고 몸만 회전해 부자연스러웠다.

또한 슬롯 이동 중 플레이어를 바라본 채 옆으로 이동해, 큰 몸집의 드래곤이 미끄러지는 것처럼 보였다.

해결

공격 직전 방향 정렬 중에는 드래곤의 좌/우 스트레이프 애니메이션을 짧은 동적 몽타주로 재생했다.

전용 Turn-in-place 애니메이션이 없었기 때문에 기존 Strafe_Left_WO_Root, Strafe_Right_WO_Root를 보조 턴 애니메이션으로 활용했다.

슬롯 이동과 추적 이동에서는 드래곤에 한해 스트레이프를 끄고 이동 방향으로 회전하도록 했다.

bOrientRotationToMovement = true
bUseControllerDesiredRotation = false
ClearFocus()
MoveToLocation(..., bCanStrafe = false)

배운 점

일반 몬스터에게 자연스러운 스트레이프 이동도 대형 몬스터에게는 어색할 수 있다. 몬스터 체형에 따라 회전 정책과 이동 애니메이션 사용 방식을 다르게 가져가야 한다.

---

9. 드래곤 특수공격 투사체 반사 및 그로기 연동

문제

드래곤 특수공격 투사체는 플레이어가 패링하면 GameplayEvent.Parry.Success까지는 발생했지만, 투사체가 드래곤에게 되돌아가 그로기를 유발하는 흐름은 없었다.

또한 가디언도 같은 EnemyProjectile을 사용할 수 있어, 공통 투사체에 반사 기능을 무조건 넣으면 다른 몬스터 동작이 깨질 수 있었다.

해결

EnemyProjectile에는 공통 반사 기능만 추가하고, 기본값은 비활성화했다.

GA_ShootProjectiles에서 현재 패턴이 Dragon_AerialFireball일 때만 반사 기능을 활성화했다.

if (IsDragonAerialFireballPattern())
{
    Projectile->ConfigureReflection(AvatarActor);
}

패링 성공 시 투사체는 파괴되지 않고 드래곤 방향으로 되돌아간다.

반사된 투사체가 드래곤에게 적중하면 PatternCounterComponent를 통해 카운터/그로기 처리를 수행한다.

배운 점

공용 클래스에 기능을 추가할 때는 기능 자체와 활성화 조건을 분리해야 한다.
이번 경우 EnemyProjectile은 반사 기능을 제공만 하고, 드래곤 패턴에서만 opt-in 방식으로 켜는 구조가 가장 안전했다.

---

오늘의 정리

1. 공용 구조는 유지하고, 특수 케이스는 좁게 보정한다

드래곤은 기존 몬스터 시스템을 재사용해야 했지만, 크기와 패턴 특성 때문에 예외 처리가 필요했다.

데이터 테이블 구조를 확장하기보다 Dragon_Bite, Dragon_AerialFireball 같은 특정 RowName 기준으로 런타임 보정을 제한했다.

2. GAS 이벤트는 태그 기반으로 연결하면 확장성이 좋다

강공격 감지, 패링 성공, 그로기 트리거 모두 GameplayTag를 기준으로 연결했다.

GE 종류를 늘리는 것보다 태그를 기반으로 흐름을 분기하는 쪽이 데이터 드리븐 구조와 더 잘 맞았다.

3. 대형 몬스터는 이동/회전 정책이 중요하다

드래곤은 일반 몬스터처럼 스트레이프하면 오히려 부자연스럽다.

대형 몬스터는 이동 방향으로 몸을 돌리고 전진 애니메이션을 사용하는 쪽이 더 안정적이다.

4. 공용 투사체 기능은 opt-in으로 설계해야 한다

드래곤과 가디언이 같은 투사체 클래스를 사용할 수 있기 때문에, 반사 기능을 기본 동작으로 넣지 않았다.

공통 기능은 EnemyProjectile에 두되, Dragon_AerialFireball에서만 명시적으로 켜는 구조로 다른 몬스터에 대한 부작용을 줄였다.