📘 TIL - 일반 몬스터 StateTree 전투 흐름 개선 및 충돌 구조 정리

📘 TIL - 일반 몬스터 StateTree 전투 흐름 개선 및 충돌 구조 정리

배경

오늘은 일반 몬스터 AI 전투 흐름을 중심으로 공격 진입 조건, 공격권 관리 구조, 충돌 채널 구성, 락온 대상 판정 등을 점검했다.

기존에는 소수의 몬스터만 있을 때는 큰 문제가 보이지 않았지만, 여러 마리가 동시에 플레이어를 추적하는 상황에서는 공격 상태 진입이 반복적으로 실패하거나 몬스터끼리 서로 간섭하는 현상이 발생했다. 또한 루멘 NPC가 몬스터 공격 대상이나 락온 대상에 포함되는 문제도 확인되었다.

처음에는 개별 StateTree Task나 공격 애니메이션 문제를 의심했지만, 실제 원인은 공격권 관리 방식과 충돌 채널 구성, 타겟 판정 로직이 서로 맞물려 발생하는 구조적인 문제에 가까웠다. 이번 작업에서는 전투 흐름 자체를 다시 점검하면서 공격 진입 조건과 충돌 구조를 정리하는 방향으로 접근했다.

---

1. 공격권(Token) 관리 구조 개선

원인 분석

기존 EncirclementSubsystem은 공격 가능한 몬스터 수를 단순 카운트 방식으로 관리하고 있었다.

MaxAttackTokens = 3

이 방식은 몬스터 종류와 관계없이 모두 동일한 비용으로 처리되기 때문에 체급이 다른 몬스터를 함께 운용할 경우 전투 밀도를 세밀하게 조절하기 어려웠다.

또한 플레이어 주변 공간이 좁은 상황에서는 여러 몬스터가 동시에 공격 상태로 진입하면서 다음과 같은 문제가 발생했다.

공격 상태 진입
→ 이동 경로 간섭
→ 방향 전환 반복
→ 공격 시작 실패
→ 공격 상태 재진입 반복

결과적으로 전투 흐름이 자연스럽게 이어지지 못하고 공격 상태와 이동 상태를 반복하는 현상이 발생했다.

해결 방법

공격권 구조를 단순 카운트 방식에서 예산(Budget) 기반 구조로 변경했다.

AttackTokenCost
AttackTokenBudget

각 몬스터는 DataTable에 정의된 비용을 사용하고, 공격 가능한 총 예산 범위 안에서만 공격 상태에 진입할 수 있도록 구성했다.

const int32 CurrentCost = GetCurrentAttackTokenCost(Ring);
const int32 RequestCost = GetAttackTokenCost(Requester);
const int32 Budget      = GetAttackTokenBudget(Ring, Requester);

if (CurrentCost + RequestCost > Budget)
{
    return false;
}

이를 통해 몬스터 종류에 따라 공격 밀도를 데이터만으로 조절할 수 있는 기반을 마련했다.

전투 흐름은 다음과 같이 정리된다.

몬스터 추적
    ↓
플레이어 주변 배회
    ↓
공격권 획득
    ↓
공격 상태 진입
    ↓
공격 종료
    ↓
배회 복귀

---

2. StateTree 공격 진입 조건 개선

원인 분석

기존 공격 로직은 공격 범위에 진입하는 순간 즉시 공격을 시도하는 구조였다.

DistanceToTarget <= AttackRange

하지만 실제 플레이 상황에서는 플레이어와 몬스터 사이 거리가 공격 범위 경계에서 계속 변동하기 때문에 공격 시작 직전에 조건이 해제되는 경우가 자주 발생했다.

공격 범위 진입
→ 공격 시작 시도
→ 거리 조건 해제
→ 공격 실패
→ 재진입 반복

특히 여러 몬스터가 동시에 이동하는 상황에서는 이러한 현상이 더욱 자주 발생했다.

해결 방법

StateTreeTask_EnemyAttack에 소프트 진입 구간을 추가했다.

신규 변수:

AttackStartRangeTolerance
AttackStartDelay

동작 방식은 다음과 같다.

Distance > AttackRange + Tolerance
→ 공격 불가

AttackRange < Distance ≤ AttackRange + Tolerance
→ 소프트 진입 구간

AttackRange 이하
→ 즉시 공격 가능

소프트 진입 구간에서는 일정 시간 동안 범위를 유지해야만 공격이 시작된다.

공격 가능 거리 진입
→ AttackStartDelay 체류
→ 공격 시작

또한 EnterState와 ExitState에서 체류 시간을 초기화하도록 수정해 상태 전환 시 이전 값이 남지 않도록 정리했다.

이를 통해 공격 범위 경계에서 발생하던 실패-재시도 루프를 줄이고 보다 안정적으로 공격이 시작될 수 있도록 개선했다.

---

3. EnemyPawn 채널 분리 및 충돌 구조 정리

원인 분석

일반 몬스터와 보스가 모두 기본 Pawn 채널을 사용하고 있었다.

ECC_Pawn

이 구조에서는 몬스터끼리 서로 Block 충돌이 발생하고, 락온 탐지나 전투 판정에서도 플레이어와 몬스터를 명확하게 구분하기 어려웠다.

해결 방법

일반 몬스터 전용 채널인 EnemyPawn을 적용했다.

ECC_GameTraceChannel1

일반 몬스터는 생성 시 EnemyPawn 채널을 사용하도록 변경했다.

GetCapsuleComponent()->SetCollisionObjectType(ECC_GameTraceChannel1);
GetCapsuleComponent()->SetCollisionResponseToChannel(
    ECC_GameTraceChannel1,
    ECR_Overlap);

또한 LockOnComponent의 SphereTrace에서도 해당 채널을 탐지하도록 수정했다.

SearchObjectTypes.AddUnique(
    UEngineTypes::ConvertToObjectType(
        ECC_GameTraceChannel1));

이를 통해 일반 몬스터끼리는 Overlap으로 처리하면서 플레이어 대상 전투 판정은 유지할 수 있는 구조를 마련했다.

---

4. 루멘 NPC 공격 대상 오식별 문제 수정

원인 분석

루멘 NPC가 몬스터 공격 대상이나 락온 대상으로 잘못 인식되는 문제가 발생했다.

원인은 크게 세 가지였다.

1. Pawn 채널 충돌 유지
2. LockOn ASC 필터 부재
3. NoTeam 판정 처리 미흡

그 결과 루멘이 실제 전투 대상이 아님에도 다음과 같은 상황이 발생했다.

몬스터 히트박스 오버랩
→ 루멘 감지

락온 SphereTrace
→ 루멘 포함

AI 팀 판정
→ Hostile 처리

해결 방법

먼저 루멘의 Pawn 채널 충돌을 무시하도록 수정했다.

Capsule->SetCollisionResponseToChannel(
    ECC_Pawn,
    ECR_Ignore);

또한 LockOnComponent에서는 ASC가 없는 액터를 제외하도록 필터를 추가했다.

if (!ASCIface ||
    !ASCIface->GetAbilitySystemComponent())
{
    continue;
}

마지막으로 팀 판정 로직에서 NoTeam을 Neutral로 처리하도록 수정했다.

if (OtherTeamId == FGenericTeamId::NoTeam)
{
    return ETeamAttitude::Neutral;
}

이를 통해 비전투 NPC가 전투 시스템에 포함되지 않도록 정리했다.

---

5. 일반 몬스터 체력바 구현

작업 내용

일반 몬스터 머리 위에 표시되는 체력바 UI를 새로 구현했다.

신규 생성 파일은 다음과 같다.

NormalMonsterHealthBarComponent
RetrieveNormalMonsterHealthBarWidget
RetrieveElementUILibrary

RetrieveEnemyCharacter 생성자에서 WidgetComponent를 생성하고 캐릭터에 부착했다.

NormalHealthBarComponent =
    CreateDefaultSubobject<
        UNormalMonsterHealthBarComponent>(...);

NormalHealthBarComponent
    ->SetupAttachment(GetRootComponent());

NormalHealthBarComponent
    ->SetRelativeLocation(
        FVector(0.f, 0.f, 120.f));

구현하면서 느낀 점

월드 공간 UI는 WidgetComponent를 직접 부착하는 방식이 가장 단순하고 관리하기 쉽다.

또한 Component는 데이터 갱신과 상태 관리를 담당하고, Widget은 표현만 담당하도록 역할을 분리해두면 이후 원소 상태, 버프 표시, 디버프 아이콘 등의 기능을 확장하기도 수월하다.

---

오늘의 정리

• 일반 몬스터 전투 흐름을 점검하면서 공격 상태 진입 실패의 원인이 단순 StateTree 문제가 아니라 공격권 관리 구조와 거리 조건 경계에 있다는 것을 확인했다.
• 공격권을 Cost/Budget 기반 구조로 변경해 몬스터 종류별 전투 밀도를 데이터만으로 조절할 수 있는 기반을 마련했다.
• EnemyPawn 채널 분리와 루멘 NPC 필터링을 통해 전투 대상 판정 및 충돌 구조를 보다 명확하게 정리했다.
• 일반 몬스터 체력바를 WidgetComponent 기반으로 구현하면서 전투 UI 확장에 필요한 기본 구조도 함께 구축했다.