📘TIL - 오픈월드 RPG 미니맵 구조 실제 구현 및 대형 월드 대응 정리

배경

어제는 기존 RTS 프로젝트의 SceneCapture2D + FogRT 기반 구조를 오픈월드 RPG 방향에 맞게 재설계하면서,
정적 MapTexture + 등록형 아이콘 + 탐험 Overlay 기반 구조로 방향을 정리했다.

오늘은 여기서 한 단계 더 나아가 실제로 동작하는 형태의 미니맵 시스템을 구현하고,
HUD 위젯·Material UV·카메라 회전·1km x 1km 월드 대응까지 포함해서 구조를 실제 프로젝트 기준으로 정리했다.

---

기존 문제점

처음에는 RTS 때 사용했던 방식처럼:

NativePaint
+
MapTexture Draw
+
Slate 회전

구조로 구현하려고 했다.

즉:

맵 텍스쳐 자체를 DrawOffset으로 이동
→ MakeRotatedBox로 회전

시키는 방식이었다.

하지만 실제로 테스트해보니 문제가 꽤 많았다.

플레이어 이동 시 Border 밖으로 튀어나감
회전 Pivot 어긋남
카메라 회전 시 맵 위치 동기화 깨짐
월드 크기 변경 시 Zoom 보정 필요
아이콘 위치와 텍스쳐 위치 불일치

특히 PlayerUp 모드에서:

카메라 회전 기준으로 아이콘은 정상 회전
하지만 맵 텍스쳐는 다른 기준으로 회전

하는 현상이 발생했다.

---

구조 재정리

정리하다 보니 문제의 핵심은:

Slate에서 큰 텍스쳐 자체를 회전시키는 구조

에 있었다.

그래서 방향을 다시 바꿨다.

최종적으로는:

맵 텍스쳐를 직접 이동/회전하지 않는다.
UI Material 내부 UV만 이동/회전한다.

구조로 변경했다.

즉:

MapTexture
→ Material UV 이동
→ Material UV 회전
→ Widget은 고정

구조다.

이 방식으로 바꾸니까:

Pivot 문제
Border 이탈 문제
회전 동기화 문제

가 거의 정리됐다.

---

최종 미니맵 구조

최종 구조는 아래처럼 정리했다.

RTMapSubsystem
 ├─ 월드 좌표 → UV 변환
 ├─ 등록형 아이콘 관리
 └─ 월드 크기 관리

RTMapIconComponent
 └─ BeginPlay / EndPlay 등록

RTMiniMapWidget
 ├─ Material UV 갱신
 ├─ 아이콘 Draw
 ├─ 플레이어 마커 Draw
 └─ 회전 모드 관리

M_UI_Minimap
 ├─ CenterUV
 ├─ Zoom
 └─ Rotation

중요했던 건:

맵 배경은 Material
아이콘은 NativePaint

로 역할을 분리한 점이었다.

---

Material UV 기반 미니맵

이번 구현에서 가장 크게 바뀐 부분은
미니맵 배경을 Slate Draw가 아니라 Material UV 기반으로 바꾼 점이었다.

머티리얼 내부에서는:

TexCoord
→ 중심 기준 이동
→ 회전
→ Zoom
→ CenterUV 이동
→ Texture Sample

흐름으로 처리했다.

즉 실제로 움직이는 건:

Texture 자체가 아니라
UV 좌표

였다.

이 구조로 바꾸니까:

위젯 자체는 고정
플레이어 위치 기준으로 UV 이동
카메라 회전 기준으로 UV 회전

구조가 안정적으로 맞아 떨어졌다.

---

카메라 기준 회전 구조

처음에는:

GetActorRotation().Yaw

기준으로 회전시키고 있었다.

하지만 오픈월드 RPG에서는:

플레이어 몸 방향보다
카메라 방향이 더 중요

하다고 판단했다.

그래서 최종적으로는:

PlayerCameraManager->GetCameraRotation().Yaw

기준으로 회전 구조를 변경했다.

최종 동작은:

NorthUp
→ 맵 고정
→ 플레이어 마커 회전

PlayerUp
→ 맵 회전
→ 아이콘 위치 회전
→ 플레이어 마커는 상단 고정

구조로 정리했다.

---

아이콘 구조 정리

이번에는 아이콘 구조도 실제 프로젝트 기준으로 다시 정리했다.

기존에는 단순히:

Texture + Color

정도만 생각했었는데,
최종적으로는:

ERTMapIconType

기반으로 정리했다.

예를 들면:

Player
POI
Boss
Village
Quest
Campfire

등이다.

그리고:

bShowOnMiniMap
bShowOnWorldMap

를 분리해서:

HUD 미니맵 전용
월드맵 전용

표시도 구분할 수 있게 만들었다.

---

1km x 1km 월드 대응

이번 테스트 월드 기준은:

1km x 1km
≈ 100000uu x 100000uu

규모다.

그래서:

MapOrigin
MapSize
ViewWorldRadius

를 모두 1km 월드 기준으로 다시 정리했다.

월드가 원점 중심이라면:

MapOrigin = FVector2D(-50000.0f, -50000.0f);
MapSize = FVector2D(100000.0f, 100000.0f);

월드가 (0, 0)부터 시작한다면:

MapOrigin = FVector2D(0.0f, 0.0f);
MapSize = FVector2D(100000.0f, 100000.0f);

미니맵에서 플레이어 주변을 보여주는 반경은:

ViewWorldRadius = 10000.0f;

정도로 잡았다.

즉:

반경 100m
지름 200m

정도의 영역을 미니맵 안에 확대해서 보여주는 구조다.

Zoom 계산 공식은:

Zoom = MapSize.X / (ViewWorldRadius * 2)

이다.

1km 월드 기준으로 계산하면:

100000 / (10000 * 2) = 5

즉 Zoom = 5가 된다.

이 구조로 정리하니까:

월드 크기가 바뀌어도
ViewWorldRadius만 조정하면
미니맵 확대 범위를 쉽게 관리할 수 있음

을 확인할 수 있었다.

---

SceneCapture 구조 정리

미니맵 구조를 정리하면서
SceneCapture 방향도 같이 정리했다.

최종적으로는:

실시간 SceneCapture 사용 X

방향으로 갔다.

대신:

Orthographic SceneCapture
→ RenderTarget 생성
→ Static Texture Bake
→ MapTexture 사용

구조다.

즉 SceneCapture는:

실시간 렌더링 시스템이 아니라
맵 베이크 생성 도구

가 되었다.

1km x 1km 월드 기준 SceneCapture 설정은:

Projection Type = Orthographic
Ortho Width = 100000
Rotation = Pitch -90

로 맞추면 된다.

월드가 원점 중심이면:

Location = (0, 0, 충분히 높은 Z)

월드가 (0, 0)부터 시작하면:

Location = (50000, 50000, 충분히 높은 Z)

로 배치하면 된다.

---

월드맵 방향

오늘 정리하면서 월드맵 구조 방향도 더 명확해졌다.

중요했던 건:

미니맵과 월드맵은 역할이 다르다.

는 점이었다.

미니맵은:

현재 위치 탐색
근처 정보 확인

이고,

월드맵은:

전체 지역 구조
진행 상태
POI 관리
지역 탐험

에 가까웠다.

그래서:

RTMapSubsystem
RTMapIconComponent

는 공유하되,

WBP_Minimap
WBP_WorldMap

은 분리하는 방향으로 정리했다.

---

구조 단순화

이번 구현에서 가장 중요하게 느낀 건
“기능 추가보다 구조 단순화가 먼저”라는 점이었다.

처음에는:

GridManager
FogSubsystem
MarkerManager
MapRenderer

같이 여러 클래스로 나누려고 했지만,
정리하다 보니 MVP 기준에서는 과할 가능성이 높아 보였다.

그래서 최종적으로는:

RTMapSubsystem
RTMapIconComponent
RTMiniMapWidget
M_UI_Minimap

정도로 최소화했다.

특히:

누가 데이터를 관리하는지
누가 그리는지
누가 등록하는지

를 바로 이해할 수 있게 만드는 걸 가장 중요하게 생각했다.

---

느낀 점

이번 구현을 진행하면서 가장 크게 느낀 건,
오픈월드 RPG 미니맵은 “렌더링 시스템”보다 “UI 정보 시스템”에 더 가깝다는 점이었다.

처음에는 RTS처럼:

실시간 월드 렌더링

중심으로 생각했지만,
정리하다 보니 실제로 중요한 건:

현재 위치
탐험 상태
POI 정보
방향 인지

였다.

그래서:

정적 MapTexture
+
Material UV
+
등록형 아이콘

기반 구조가 훨씬 단순하고 안정적으로 느껴졌다.

특히 이번에는:

확장성보다 먼저
구조를 단순하게 유지하는 것

이 MVP 단계에서 훨씬 중요하다고 느꼈다.

---

오늘의 정리

• Slate에서 텍스쳐 자체를 회전시키는 구조 대신 Material UV 기반 회전 구조로 변경하면서 회전/Pivot/Border 문제를 해결했다.
• 미니맵 배경은 Material, 아이콘과 플레이어 마커는 NativePaint로 분리하면서 역할을 단순화했다.
• 오픈월드 RPG에서는 플레이어 몸 방향보다 카메라 방향 기준 회전이 더 자연스럽다고 판단해 PlayerCameraManager 기반 구조로 변경했다.
• 1km x 1km 월드를 기준으로 MapSize / ViewWorldRadius 기반 Zoom 구조를 정리하면서 플레이어 주변 영역만 확대 표시되도록 구현했다.
• 실시간 SceneCapture 구조 대신 Orthographic Capture → Static Texture Bake 기반 구조로 방향을 정리하면서 성능과 유지보수 측면에서 훨씬 단순한 구조가 되었다.