📘 TIL - MVP 플레이 연결 및 Command/Context/Queue 구조 확장

문제

어제까지는 다음 구조까지는 만들어둔 상태였다.

UI → PlayerController → Dispatcher → Server → Provider → UI

UI에서 시작해서 서버를 거쳐 다시 UI로 돌아오는 흐름 자체는 정상적으로 동작하는 상태였다.

다만 실제 프로젝트 기준으로 보면 몇 가지 빠진 부분이 있었다.

---

구조적 문제

구분	문제
테스트	실제 Actor 기준 테스트 불가
Command	PlayerController 하드코딩
Context	구조만 있고 UI 전환 없음
생산	Queue 개념 없음
데이터 흐름	UI ↔ Gameplay 연결 부족

---

기존 상태

Selection → ViewModel → UI 표시
Command → ViewModel → UI 표시

UI는 정상적으로 출력되지만
실제 유닛이나 건물과 연결된 상태는 아니었다.

---

분석

결국 문제는 하나였다.

구조는 만들어놨는데 실제 게임 흐름으로 이어지지 않는다.

---

구조 vs 실제

[기존]
UI 구조 ✔
실제 게임 흐름 ✖

[목표]
UI 구조 ✔
실제 게임 흐름 ✔

---

해결

---

1. Command 생성 구조 변경 (핵심)

---

기존 구조

// PlayerController.cpp
OutCommandIds = { TEXT("Move"), TEXT("Attack"), TEXT("Hold") };

Command를 PlayerController에서 직접 만들어서 넣는 방식이었다.

---

변경 구조

// PlayerController.cpp
OutCommandIds = Unit->GetAvailableCommandIds();

// UnitActor.cpp
TArray<FName> ATWTestUnitActor::GetAvailableCommandIds() const
{
    return AvailableCommandIds;
}

---

구조 변화

[이전]
PlayerController → Command 생성

[이후]
Actor → Command 제공 → PlayerController 전달

---

의미

Command를 직접 만드는 구조에서
Actor가 들고 있는 데이터를 가져다 쓰는 구조로 바꾼 것이다.

---

2. BuildMenu Context 실제 적용

---

기존

Context 구조만 존재
→ UI 변화 없음

---

적용 코드

if (InCommandId == TEXT("BuildMenu"))
{
    SelectionProvider->PushContext("Build");
}

---

Context Map

ContextCommandMap.Add(
    TEXT("Build"),
    {
        TEXT("BuildBarracks"),
        TEXT("BuildArcheryRange"),
        TEXT("Back")
    }
);

---

흐름

Engineer 선택
→ CommandPanel
→ Build 클릭
→ Context 변경
→ Build 메뉴 표시
→ Back
→ 이전 상태 복귀

---

결과

Context가 실제 UI 전환까지 이어지도록 연결했다.

---

3. 생산 Queue 시스템 추가

---

기존

Train 버튼 → 바로 생성

---

변경 구조

시작 시

++FootmanQueueCount;

완료 시

FootmanQueueCount--;

---

흐름

Command 클릭
→ Queue 증가
→ Timer 동작
→ Unit 생성
→ Queue 감소

---

UI 반영

SlotVM.QueueCount = Building->GetQueueCountForCommand(SlotVM.CommandId);

---

결과

Train Footman x2
Train Archer x1

---

의미

버튼 클릭 → 상태 변경 → UI 갱신 흐름이 실제로 이어지도록 만들었다.

---

4. Coordinator 책임 유지

---

문제

QueueCount를 어디에서 처리할지

---

선택

Coordinator 수정 X
PlayerController에서 후처리

---

코드

TArray<FCommandSlotViewModel> BuiltCommands = HUDCoordinator->GetLastBuiltCommandViewModels();

for (FCommandSlotViewModel& SlotVM : BuiltCommands)
{
    SlotVM.QueueCount = Building->GetQueueCountForCommand(SlotVM.CommandId);
}

HUDRootWidget->SetCommandData(BuiltCommands);

---

이유

항목	이유
책임 분리	Coordinator는 UI 구성만 담당
확장성	구조 변경 시 영향 최소화
속도	MVP 단계에서 빠르게 적용 가능

---

5. 데이터 기반 구조 전환

---

Actor 구조

UPROPERTY(EditAnywhere)
TArray<FName> AvailableCommandIds;

---

결과

BP에서 Command 수정
→ UI 바로 반영

---

의미

하드코딩 제거하고 데이터 기반으로 전환한 상태다.

---

6. MVP 게임 루프 완성

---

전체 흐름

Actor 선택
→ CommandIds 가져오기
→ UI 표시
→ 입력 발생
→ PlayerController 실행
→ 상태 변경
→ UI 갱신

---

실행 흐름 코드

// 1. 클릭
Widget → ExecuteCommandById

// 2. 실행
PlayerController → ExecuteGameplayCommandById

// 3. 상태 변경
Building → Queue 증가

// 4. UI 갱신
Coordinator → CommandPanel 갱신

---

테스트 가능 항목

기능	상태
유닛 선택	✔
이동	✔
공격 (placeholder)	✔
BuildMenu	✔
건물 선택	✔
유닛 생산	✔
Queue 표시	✔

---

7. 구조 변화 요약

---

Before

UI 중심 구조
→ 표시만 되는 상태

---

After

Actor 중심 구조
→ 실제 동작 가능

---

비교

항목	이전	이후
Command 생성	PlayerController	Actor
Context	구조만 존재	실제 동작
생산	즉시 실행	Queue 기반
UI 갱신	수동	상태 기반
테스트	제한적	플레이 가능

---

1. 구조 → 실제 연결

설계 → 실제 플레이 흐름까지 연결 완료

---

2. Command 구조 개선

하드코딩 제거
→ 데이터 기반 전환

---

3. Context 시스템 적용

BuildMenu → 실제 UI 전환 동작

---

4. 생산 시스템 기초

Queue → UI 연결

---

5. MVP 상태 도달

선택 → 명령 → 실행 → UI 갱신

---

전체 구조

Actor
→ CommandIds 제공
→ PlayerController
→ 실행
→ 상태 변경
→ Provider
→ Coordinator
→ UI

---

오늘의 정리

• 구조만 있던 상태에서 실제 게임 흐름까지 연결했다.
• Command를 생성하는 방식에서 데이터로 받아오는 구조로 바꿨고,
• Context와 생산 Queue까지 UI에 실제로 반영되도록 붙였다.