# Skybound Combat HUD Information Hierarchy Onboarding

작성일: 2026-04-26 17:06 KST

## 요청 요약

- 전투 HUD를 정보 패널이 아니라 플레이 보조 장치로 줄이는 방향으로 진행한다.
- 항상 보이는 정보는 최소화하고, Stage 1 초반에는 핵심 행동을 자연스럽게 안내하는 온보딩이 필요하다.

## 핵심 판단

Skybound는 전술 시뮬레이션이 아니라 `Survivor-like horde survival shooter`에 가깝다.

따라서 전투 중 HUD는 모든 정보를 보여주는 것이 아니라 다음 판단만 빠르게 도와야 한다.

- 지금 몇 스테이지인가
- 내 체력이 위험한가
- Tactical Level이 얼마나 찼는가
- 폭탄과 Lock-on을 쓸 수 있는가
- 초반 사용자는 지금 무엇을 해야 하는가

점수, 베스트런, 세부 상태 정보는 전투 판단보다 결과/성장 확인에 더 적합하므로 전투 중 상시 노출에서 제외하는 것이 맞다.

## 적용한 변경

### 전투 HUD 상시 정보 축소

기존에는 전투 중 HUD에서 점수/베스트런 같은 정보도 함께 노출되었다.

변경:

- `ScoreBoard`를 전투 HUD 상시 노출에서 제거
- `Tactical Level` 라벨을 `Tac Level`로 축약
- Mastery 상태는 전투 중 상시 HUD에서 숨김
- 기존 Stage, HP, Tac Level, Bomb, Lock-on, 설정 버튼 중심으로 정리

의도:

- 전투 화면을 덜 가리게 한다.
- 사용자의 시선을 생존과 성장 루프에 집중시킨다.
- 점수 확인은 결과 화면에서 더 명확하게 하도록 역할을 분리한다.

### Stage 1 Flight Plan 카드 추가

Stage 1 초반에만 작은 목표 카드가 나타나도록 했다.

목표 단계:

- Move: WASD로 거리 유지
- Collect: 청록 크리스탈과 안전 픽업 회수
- Upgrade: Tac Level 상승 시 모듈 선택
- Survive: 포위되면 Space Bomb 사용

표시 조건:

- Stage 1
- 전투 시작 후 약 75초 이내
- Tactical Upgrade 선택 화면이 아닐 때
- 아직 완료되지 않은 목표가 있을 때

의도:

- 긴 튜토리얼 문장 대신 실제 플레이 중 해야 할 행동만 짧게 안내한다.
- 사용자가 시스템을 “읽어서” 배우는 것이 아니라 “하면서” 배우게 한다.
- 전투 흐름을 방해하지 않도록 작은 사이드 카드로 처리한다.

### Desktop/Small 화면 배치 대응

Desktop에서는 기존 side dock 철학을 유지하고, Flight Plan 카드는 반대편 사이드 레일에 배치했다.

작은 화면에서는 카드가 플레이 필드 밖에 나가지 않도록 상단 아래쪽에 배치된다.

## 수정 파일

- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/ui/HUDOverlay.tsx`
- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/ui/HUDOverlay.css`

## 검증

- `npm run build` 성공
- 출력 디렉터리: `dist/42`

## 후속 플레이테스트 체크 포인트

- 전투 중 HUD가 이전보다 덜 부담스럽게 느껴지는지 확인한다.
- Stage 1 초반 Flight Plan 카드가 플레이를 가리지 않는지 확인한다.
- 목표 카드가 너무 오래 남거나 너무 빨리 사라지지 않는지 확인한다.
- 점수/베스트런이 빠진 것이 전투 중 불편하지 않은지 확인한다.
- 결과 화면에서 점수 확인 역할이 충분히 보완되는지 확인한다.