📘TIL-RTS 기본 UI 데이터 연동 테스트 및 버그 수정

문제

UI 스켈레톤 구조를 기준으로 WBP와 C++을 연결한 뒤 실제 테스트를 진행했을 때,
단순 표시 수준에서는 정상처럼 보였지만, 실제 입력 기반으로 상태를 바꿔보면 UI가 정상적으로 갱신되지 않는 문제가 발생했다.

---

발생한 증상 정리

구분	증상
입력 처리	키 입력 로그는 정상적으로 출력됨
SelectionPanel	상태 변경 후 즉시 반영되지 않거나 일부만 반영
CommandPanel	Selection 변경과 동기화되지 않음
TopBar	자원 값 변경 시 UI 갱신 안됨
Notification	호출은 되지만 흐름과 연결되지 않음
전체 흐름	입력 → 데이터 변경 → UI 반영까지 이어지지 않음

---

문제 상황 흐름

실제 내부 흐름을 보면 아래처럼 끊겨 있었다.

입력 (PlayerController)
→ Mock 데이터 변경
→ (UI 갱신 없음)

즉 구조는 있었지만 실행 루프가 완성되지 않은 상태였다.

---

분석

문제를 구조 기준으로 분해해보면, 원인은 명확하게 4가지로 나눌 수 있었다.

---

1. UI 갱신 트리거 부재

현재 구조는 아래와 같이 설계되어 있었다.

Provider → Coordinator → ViewModel → HUDRoot → Panel

이 구조 자체는 문제가 없었지만,
핵심 문제는 데이터가 바뀌었을 때 Coordinator가 다시 실행되지 않는 것이었다.

---

실제 상태

MockSelection 상태 변경됨
→ Provider 값은 바뀜
→ Coordinator는 다시 호출되지 않음
→ UI 그대로 유지

즉 구조는 맞는데 “언제 갱신할지”가 정의되지 않은 상태였다.

---

2. PlayerController에서 갱신 호출 누락

입력 처리 로직을 보면 아래처럼 되어 있었다.

Input → Mock 데이터 변경 → 끝

여기서 빠진 핵심 단계는 이것이다.

→ Coordinator Refresh 호출

---

정상적인 흐름 (의도)

입력
→ 데이터 변경
→ Coordinator.RefreshXXX()
→ HUDRoot 전달
→ Panel 갱신

이 한 줄이 빠져서 UI가 정지 상태처럼 보였던 것이다.

---

3. Selection과 CommandPanel 갱신 분리 문제

Selection 상태와 CommandPanel은 강하게 연결되어야 한다.

하지만 실제 구현에서는

• SelectionPanel은 갱신되거나
• CommandPanel은 갱신 안 되는

비동기 상태가 발생했다.

---

문제 구조

Selection 변경
→ SelectionPanel만 갱신
→ CommandPanel 그대로 유지

---

기대 구조

Selection 변경
→ SelectionPanel 갱신
→ CommandPanel 갱신 (항상 같이)

---

4. WBP 바인딩 및 위젯 연결 문제

일부 UI가 아예 반영되지 않는 케이스는
코드 문제가 아니라 WBP 설정 문제였다.

---

주요 원인

항목	문제
BindWidget 이름	C++과 불일치
부모 클래스	잘못된 Widget 클래스 사용
IsVariable	체크 안됨
위젯 트리	참조 끊김

---

해결

문제 해결 방향은 단순하게 잡았다.

“데이터 변경 이후 반드시 UI 갱신 함수까지 연결한다”

---

1. PlayerController 중심 갱신 흐름 정리

입력 처리 이후 흐름을 명확하게 연결했다.

---

수정된 흐름

입력
→ Mock 데이터 변경
→ Coordinator.Refresh 호출
→ HUDRoot 전달
→ Panel 갱신

---

실제 적용 구조

입력	처리
F1/F2/F3	Selection 상태 변경 + Selection/Command Refresh
1/2/3	Resource 값 변경 + TopBar Refresh
F8	Notification 호출

---

2. Selection → CommandPanel 강제 동기화

Selection 변경 시 항상 아래 두 개를 같이 호출하도록 고정했다.

RefreshSelectionPanel()
RefreshCommandPanel()

---

결과

상태	변경 전	변경 후
Selection 변경	UI 불일치 발생	항상 동기화
CommandPanel	갱신 누락	항상 갱신

---

3. 초기화 흐름 분리

초기 진입 시에는 전체 갱신을 한 번만 수행하도록 구조를 정리했다.

---

초기화 흐름

BeginPlay
→ Coordinator.Initialize
→ RefreshAll (1회)

---

이후 흐름

데이터 변경 시
→ 필요한 부분만 Refresh

---

4. Mock Provider 역할 강화

Mock 객체를 단순 데이터 저장이 아니라
테스트 가능한 상태 머신으로 수정했다.

---

MockSelection 개선

기능	내용
상태 관리	None / Unit / Building
ViewModel 반환	상태별 데이터 구성
CommandId 반환	상태별 다른 Command 리스트

---

MockResource 개선

기능	내용
내부 값	Wood / Gas / Population
변경 함수	AddWood / AddGas / AddPopulation
ViewModel 반환	TopBar 데이터 구성

---

5. WBP 바인딩 문제 해결

아래 기준으로 전부 재점검했다.

---

체크리스트

항목	확인
BindWidget 이름	정확히 일치
부모 클래스	올바른 Widget 클래스
IsVariable	필요한 요소 체크
Layout	실제 화면 표시 확인

---

결과

수정 이후 전체 흐름이 정상적으로 연결되었다.

---

최종 동작 흐름

입력
→ Mock 데이터 변경
→ Coordinator.RefreshXXX()
→ ViewModel 생성
→ HUDRoot 전달
→ Panel UI 갱신

---

기능별 정상 동작

기능	결과
Selection 변경	SelectionPanel 즉시 반영
Command 변경	CommandPanel 즉시 반영
Resource 변경	TopBar 즉시 반영
Notification	메시지 + 색상 정상 출력
전체 HUD	상태 변화에 따라 정상 유지

---

오늘의 정리

1. UI는 자동으로 갱신되지 않는다
2. 데이터 변경 이후 반드시 Refresh를 호출해야 한다
3. Selection과 Command는 항상 같이 움직여야 한다
4. 구조보다 “갱신 타이밍”이 더 중요하다

---