24강. 최종 실습: 탑다운 생존 게임

?1. 이번 강의에서 해결할 문제

각 기능은 따로 동작하지만 적 사망 점수가 오르지 않거나 게임 오버 뒤에도 생성과 입력이 계속됩니다. 이벤트 경계를 연결하고 정상·경계 상황을 테스트해 플레이 가능한 한 판을 완성합니다.

✓2. 학습 목표

✓이 강의를 마치면

• 플레이어, 적, Spawner, HealthComponent, DataAsset, Subsystem과 UI를 통합합니다.
• 적 사망과 플레이어 사망을 Delegate로 서로 다른 규칙에 연결합니다.
• 구조 선택 이유, 테스트 체크리스트와 후속 확장 아이디어를 문서화합니다.

◇3. 핵심 개념

최종 통합의 핵심은 클래스 수가 아니라 의존 방향입니다.

상태와 이벤트 흐름

Enhanced Input → PlayerController → SurvivalCharacter.Move / PerformAttack
PerformAttack → ApplyDamage → HealthComponent
Enemy HealthComponent.OnDeath → EnemyBase → GameSubsystem.AddScore
Player HealthComponent.OnDeath → GameSubsystem.EndGame
GameSubsystem Delegate → HUD 갱신 / Controller 입력 차단 / Spawner Timer 중단
EnemySpawner → EnemyDataAsset → EnemyBase 초기화

Tick은 이동을 수행하는 엔진 Movement 경로에 맡기고, AI 판단과 생성은 Timer, 재사용 체력은 Component, 한 판의 공유 상태는 GameInstance Subsystem을 사용했습니다.

✎4. 단계별 실습

4-1. 적 사망과 점수 연결

파일 경로: Source/TopDownSurvival/Enemies/EnemyBase.h · 추가

EnemyBase.h · 사망 Handler

UFUNCTION()
void HandleDeath();

파일 경로: Source/TopDownSurvival/Enemies/EnemyBase.cpp

EnemyBase.cpp · BeginPlay와 HandleDeath

#include "Systems/SurvivalGameSubsystem.h"

void AEnemyBase::BeginPlay()
{
    Super::BeginPlay();
    HealthComponent->OnDeath.AddDynamic(this, &AEnemyBase::HandleDeath);
    TargetPawn = UGameplayStatics::GetPlayerPawn(this, 0);
    GetWorldTimerManager().SetTimer(
        ThinkTimerHandle, this, &AEnemyBase::Think, ThinkInterval, true);
}

void AEnemyBase::HandleDeath()
{
    GetWorldTimerManager().ClearTimer(ThinkTimerHandle);

    if (AAIController* AI = Cast<AAIController>(GetController()))
    {
        AI->StopMovement();
    }

    if (USurvivalGameSubsystem* Game =
        GetGameInstance()->GetSubsystem<USurvivalGameSubsystem>())
    {
        Game->AddScore(EnemyData ? EnemyData->ScoreValue : 0);
    }

    SetActorEnableCollision(false);
    Destroy();
}

Pool을 실제 사용한다면 Destroy 대신 EnemyPool.Release를 호출하되 점수 이벤트와 AI·Timer 정리는 동일하게 유지합니다.

4-2. 플레이어 사망과 게임 오버 연결

파일 경로: Source/TopDownSurvival/Characters/SurvivalCharacter.h

SurvivalCharacter.h · 추가

protected:
    virtual void BeginPlay() override;

private:
    UFUNCTION()
    void HandleDeath();

파일 경로: Source/TopDownSurvival/Characters/SurvivalCharacter.cpp

SurvivalCharacter.cpp · 사망 연결

#include "Systems/SurvivalGameSubsystem.h"

void ASurvivalCharacter::BeginPlay()
{
    Super::BeginPlay();
    HealthComponent->OnDeath.AddDynamic(this, &ASurvivalCharacter::HandleDeath);
}

void ASurvivalCharacter::HandleDeath()
{
    GetCharacterMovement()->DisableMovement();
    if (USurvivalGameSubsystem* Game =
        GetGameInstance()->GetSubsystem<USurvivalGameSubsystem>())
    {
        Game->EndGame();
    }
}

PlayerController는 19강의 HandleGameOver에서 SetIgnoreMoveInput(true)를 호출하고 HUD Game Over Panel을 표시합니다. HandleAttack 시작에도 Game->IsGameOver 검사를 추가해 공격을 막습니다.

4-3. 새 게임 초기화와 Spawner 중단

파일 경로: Source/TopDownSurvival/Game/SurvivalGameMode.cpp

SurvivalGameMode.cpp

#include "Game/SurvivalGameMode.h"

#include "Systems/SurvivalGameSubsystem.h"

void ASurvivalGameMode::BeginPlay()
{
    Super::BeginPlay();
    if (USurvivalGameSubsystem* Game =
        GetGameInstance()->GetSubsystem<USurvivalGameSubsystem>())
    {
        Game->ResetRun();
    }
}

Spawner의 SpawnEnemy 시작에서 IsGameOver를 검사하는 21강 코드를 유지합니다. 더 즉각적인 중단이 필요하면 BeginPlay에서 OnGameOver Delegate를 구독하고 Handler에서 ClearTimer합니다.

4-4. Blueprint와 레벨 연결

1. BP_SurvivalCharacter에 Capsule 또는 기본 Mesh와 HealthComponent 기본값을 확인합니다.
2. BP_SurvivalPlayerController에 IMC_Player, IA_Move, IA_Attack, WBP_SurvivalHUD를 연결합니다.
3. BP_EnemyBase와 두 EnemyDataAsset을 연결합니다.
4. BP_EnemySpawner의 EnemyTypes와 생성 설정을 연결합니다.
5. SurvivalGameMode를 프로젝트 또는 World 기본 GameMode로 지정합니다.
6. PlayerStart, 바닥, 장애물, NavMeshBoundsVolume과 Spawner를 레벨에 배치합니다.

4-5. PowerShell 전체 빌드

실행 위치: C:\UnrealProjects\TopDownSurvival

PowerShell

Set-Location C:\UnrealProjects\TopDownSurvival
$ProjectFile = (Resolve-Path .\TopDownSurvival.uproject).Path
$EngineRoot = "C:\Program Files\Epic Games\UE_5.x"
& "$EngineRoot\Engine\Build\BatchFiles\Build.bat" TopDownSurvivalEditor Win64 Development $ProjectFile -WaitMutex

실제 엔진 폴더 이름으로 UE_5.x를 교체합니다. Editor를 닫은 전체 빌드와 Editor 실행 테스트를 모두 통과해야 완료입니다.

→5. 코드가 동작하는 이유

ApplyDamage는 HealthComponent로 들어가고 Component는 체력 변경과 사망 사실만 Broadcast합니다. 적은 자신의 사망을 점수 규칙에 연결하고 플레이어는 게임 오버에 연결합니다. GameSubsystem은 상태 변경을 UI, 입력과 생성 시스템에 알리므로 서로 구체 클래스를 직접 찾는 의존이 줄어듭니다.

구조 선택 근거:

구조	선택한 곳	이유
Tick	사용자 코드에서는 기본 비활성	매 프레임 직접 갱신할 규칙이 없음
Timer	적 AI 판단, 생성, 공격 쿨다운	일정 간격 작업의 의도가 명확함
Component	체력	플레이어와 적에서 재사용
Subsystem	점수, 게임 오버	한 Actor보다 긴 게임 세션 상태

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• 사망 Delegate를 여러 번 바인딩: BeginPlay 한 곳에서 연결하고 Pool 재사용 시 중복 바인딩을 점검합니다.
• 게임 오버 뒤 공격만 막고 생성은 유지: 입력, Spawner Timer, 적 AI를 각각 중단합니다.
• 점수를 Character에 저장: Character 교체와 사망에 영향을 받지 않는 Subsystem에 둡니다.
• 최종 통합에서 모든 코드를 한 파일로 합침: 기존 Component, DataAsset, Spawner와 Subsystem 경계를 유지합니다.
• 멀티플레이 RPC를 억지로 추가: 이 과정은 싱글플레이 구조 검증에 집중하고 네트워크 권한은 후속 과정에서 다룹니다.

✎7. 직접 실습

✎완료 체크리스트

기능

• Enhanced Input으로 플레이어가 평면 이동한다.
• 공격 Trace 또는 Collision 판정이 적 HealthComponent에 피해를 준다.
• EnemyBase가 DataAsset의 이동 속도, 체력, 공격력과 점수를 읽는다.
• 적이 Navigation으로 플레이어를 추적하고 범위에서 공격한다.
• EnemySpawner가 Timer로 생성하고 시간이 지나며 간격을 조절한다.
• 적 사망 시 점수가 한 번만 오르고 HUD에 표시된다.
• 플레이어 체력과 Game Over가 HUD에 표시된다.
• Game Over 뒤 입력과 추가 생성이 멈춘다.

경계 상황

• 일반 상황: 2분 동안 이동, 공격, 생성, 점수가 동작한다.
• 적이 없는 상황: 공격해도 오류와 잘못된 점수가 없다.
• 체력 0 상황: 사망과 Game Over가 한 번만 발생한다.
• 빠른 생성 상황: 최소 간격과 최대 활성 수가 폭주를 막는다.
• EnemyData 또는 Widget 연결 누락: 크래시 대신 진단 로그가 남는다.

구조 설명

README에 Tick, Timer, Component, Subsystem을 선택한 이유를 위 표를 참고해 자신의 말로 작성합니다. Object Pool은 측정 결과를 근거로 사용 또는 보류 결정을 남깁니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 적 사망과 플레이어 사망이 같은 HealthComponent 이벤트에서 서로 다른 결과로 이어지는 이유는 무엇인가요?
2. 게임 오버를 완성하려면 UI 표시 외에 어떤 시스템을 중단해야 하나요?
3. 현재 구조를 멀티플레이로 옮길 때 GameInstance Subsystem 점수를 그대로 사용할 수 없는 이유는 무엇인가요?

■9. 핵심 요약

■핵심 요약

탑다운 생존 게임은 입력, 이동, AI, 체력, 데이터, 생성, 점수와 UI가 책임별 클래스로 연결된 작은 완성 프로젝트입니다. Delegate로 상태 변화를 전달하고 Timer, Component, Subsystem을 수명과 호출 빈도에 맞게 선택했습니다.

게임 수학·AI 확장 3가지: 조향 행동과 벡터 기반 회피, 거리·위험도를 고려한 Utility AI, Nav Mesh와 EQS를 활용한 위치 선택.

네트워크 심화 확장 3가지: 서버 권한 피해·Spawn, PlayerState와 GameState 점수 복제, RPC와 예측을 고려한 입력·이펙트 분리.