✍️Today I Learned

📅 2025-07-30

• 팀플 - AI 스포너 구현 완료
• Gameplay Framework - 역할과 책임 분리

Gameplay Framework

4대 클래스

GameMode
- 게임의 심판관 (규칙, 흐름 제어, 승부 판정) -> 결정
GameState
- 게임 상황판 (모든 플레이어가 보는 공통 정보) -> 정보 저장
PlayerState
- 개인 수첩 (각 플레이어만의 정보) -> 개인 데이터
GameInstance
- 게임 관리자 (전체 생명주기, 레벨 간 데이터) -> 전체 관리

GameMode

GameModeBase
기본 기능만 갖고 있으며 단순한 게임 시작과 종료만 갖고 있다. 기본 생명주기만 관리한다.
GameStateBase 와 함께 사용해야 한다.
GameState 쓰면 컴파일 에러가 발생한다.

GameMode
완전한 매치 시스템이다. EMatchState라는 매치 상태 관리가 구현되어있다. 자동 리스폰 시스템과 관전자 모드를 지원한다.
GameState와 함께 사용해야 한다.
GameStateBase 쓰면 기능이 누락된다.

결정만 내린다. 정보는 직접 표시하지 않는다. 정보는 GameState에게 넘긴다. 정보 관리 및 전광판 역할은 GameState.

GameState

정보 제공자: 전광판처럼 정보만 표시한다.
읽기 전용: UI에서 참조만, 직접 수정 불가. 플레이어나 컨트롤러에서 접근해서 수정하면 안된다.
직접 결정하지 않는다. 멀티 플레이어일때 모든 플레이어가 같은 정보를 봐야하기 때문이다.

올바른 사용법
1. GameMode가 상태를 계산해서 GameState에 알려준다.
2. GameState는 그 상탤르 전 클라이언트에 자동으로 복제한다.
3. UI나 애니메이션은 GameState를 보고 표시만한다. GameMode에서 계산하고 GameState에서 표시한걸 UI가 들고가서 출력. UI가 GameMode에서 직접 값을 들고가서 출력하면 안된다.

PlayerState

생명주기 특징
레벨 전환시 유지된다.
GameState, GameMode, Pawn 등 은 레벨전환시 새로 생성된다.

소유권 구조
GameMode(서버)
- PlayerController(각 플레이어마다 존재, 서버/클라이언트 모두 존재)
- PlayerState(각각 모든 유저의 정보, 서버/클라이언트 모두 존재)

GameInstance

게임의 최고 관리자
특징
게임 전체 생명주기: 게임 시작부터 종료까지 살아있다.
레벨 간 데이터 유지: 레벨이 바뀌어도 유지된다.
레벨 전환 권한: GameInstance만 레벨을 바꿀 수 있다.

GameInstance는 일반 액터와 달라 이벤트 바인딩이 안된다. 서버전용이라 멀티 지원이 안된다.
GameState는 클라이언트에 복제가 가능하고 멀티 지원이 된다.

게임모드 점수 계산
게임스테이트 현재 점수
플레이어 스테이트 각 플레이어의 점수
게임인스턴스 최종점수 누적

❗Framework 로딩 순서

게임 시작부터 레벨 로딩까지 완전한 순서

🎮 엔진 부팅 단계
1. 엔진 초기화 (UEngine 생성)
2. GameInstance::Init() ⭐ 가장 먼저!
   - 이 시점: World 없음, GameMode 없음
   - 글로벌 설정, 서브시스템 초기화만 가능

🌍 첫 레벨 로딩 단계
3. World 생성
4. GameMode 생성 → PostInitializeComponents()
5. GameState 생성 → PostInitializeComponents()
6. PlayerController 생성
7. PlayerState 생성
8. Pawn 생성
9. 모든 BeginPlay() 호출 (순서 보장 안됨!)

🔄 레벨 전환 시
10. 기존 World 파괴 (GameMode, GameState 사라짐)
11. PlayerState는 새 World로 이주 ⭐
12. 3~9번 과정 반복

게임 시나리오

1. 플레이어가 아이템 수집
   -> 플레이어 스테이트에 점수 전달
2. 플레이어 스테이트에서 점수 업데이트
   -> 게임모드에 승리 체크 요청
3. 게임모드에서 승리조건 확인
   -> 게임인스턴스에 레벨 완료 보고
4. 게임인스턴스에서 최종 처리
   -> 게임인스턴스에서 다음 레벨 로드

---

💡 느낀 점 (What I Felt)

그동안 각각의 역할이 제대로 이해가 안됐었는데 오늘 강의가 도움이 많이 됐다. 멀티 플레이 구현하다보면 다시 벽을 느낄 것 같지만 문제를 어디서 찾아봐야할지 감을 잡을 수 있을 것 같다.

---

출처: 스파르타코딩 내일배움캠프