1강. Unreal Engine C++의 역할

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

Blueprint만으로 빠르게 만든 기능이 커지면서 한 그래프에 입력, 체력, UI와 적 생성 규칙이 뒤섞였습니다. C++로 모두 다시 만드는 대신 무엇을 코드에 두고 무엇을 Blueprint에 남길지 기준을 세웁니다.

✓2. 학습 목표

✓이 강의를 마치면

• C++와 Blueprint의 장점을 프로젝트 변화 속도와 책임 관점에서 비교합니다.
• 탑다운 생존 게임의 기능을 규칙, 데이터, 표현으로 나눕니다.
• 24강 동안 확장할 프로젝트 폴더와 완료 기준을 준비합니다.

◇3. 핵심 개념

Unreal C++는 엔진과 별도로 동작하는 일반 콘솔 프로그램이 아닙니다. Unreal Header Tool이 Reflection 매크로를 읽고, Unreal Build Tool이 모듈 의존성을 구성한 뒤, 컴파일된 클래스가 에디터와 Blueprint에 노출됩니다.

C++는 변경 규칙이 명확하고 재사용해야 하는 시스템에 적합합니다. Blueprint는 레벨 배치, 에셋 연결, 기본값 튜닝과 시각적 흐름 확인에 강합니다. 이 과정은 C++ 부모 클래스로 안전한 경계를 만들고 Blueprint 자식에서 Mesh, Material, 입력 에셋과 Widget을 선택합니다.

기능	주 책임	이유
피해 계산·사망 조건	C++ HealthComponent	플레이어와 적이 같은 규칙 재사용
적 이동 속도·점수	DataAsset	코드 재컴파일 없이 값 조정
입력 키 연결	Input Mapping Context	플랫폼별 키를 데이터로 분리
HUD 배치·색상	Widget Blueprint	빠른 시각 조정
점수·게임 오버	Subsystem	특정 Character 수명에 종속되지 않음

✎4. 단계별 실습

문서 위치: TopDownSurvival/Docs/Architecture.md

Docs/Architecture.md

# TopDownSurvival 책임
- ASurvivalCharacter: 이동과 공격 요청
- UHealthComponent: 체력, 피해, 사망 이벤트
- AEnemyBase: 추적과 공격 규칙
- UEnemyDataAsset: 적 능력치
- AEnemySpawner: 생성 시간과 난이도
- USurvivalGameSubsystem: 점수와 게임 오버
- Widget Blueprint: 화면 표현

PowerShell · 실행 위치: C:\UnrealProjects

New-Item -ItemType Directory -Force .\TopDownSurvival\Docs
Set-Location .\TopDownSurvival
Get-Location

아직 Unreal 프로젝트를 만들지 않았다면 Docs 폴더만 준비합니다. 2강에서 실제 프로젝트를 생성합니다.

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

이번 문서는 코드보다 의존 방향을 먼저 고정합니다. Character는 체력 내부 계산을 몰라도 Delegate를 구독할 수 있고, UI는 EnemyBase를 직접 찾지 않고 Subsystem의 점수 이벤트만 받게 됩니다. 이 방향을 지키면 클래스 하나를 교체할 때 다른 클래스의 수정 범위가 줄어듭니다.

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

!자주 하는 실수

• C++가 Blueprint보다 무조건 빠르다고 판단: 성능 측정 없이 전부 C++로 옮기지 않습니다. 책임과 유지보수 기준을 먼저 봅니다.
• 모든 기능을 Character에 작성: 체력은 Component, 게임 전체 상태는 Subsystem, 생성 규칙은 Spawner로 분리합니다.
• Singleton 전역 객체부터 만듦: 엔진이 관리하는 World, GameInstance, LocalPlayer 수명에 맞는 Subsystem을 검토합니다.

✎7. 직접 실습

✎직접 실습

게임에 필요한 기능 열 가지를 적고 C++, Blueprint, DataAsset 중 한 곳에 배치하세요. 각 선택 옆에 “재사용”, “튜닝”, “표현” 중 한 가지 근거를 씁니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 체력 계산을 Widget Blueprint에 두면 어떤 의존 문제가 생기나요?
2. C++ 부모와 Blueprint 자식을 함께 쓰는 이유는 무엇인가요?
3. 게임 전체 점수를 Character 변수에 두면 Character가 교체될 때 어떤 일이 생기나요?

■9. 핵심 요약

■핵심 요약

C++와 Blueprint는 대체 관계가 아니라 역할이 다른 도구입니다. 규칙과 재사용 경계는 C++, 값과 에셋 연결은 Blueprint와 DataAsset에 두고, 기능마다 수명과 책임을 먼저 결정합니다.