# TravelRun 설계도

이 문서는 프로젝트를 다시 열었을 때 가장 먼저 보는 전체 설계도입니다. 세부 내용은 각 문서로 분리하고, 여기서는 어디를 보면 되는지와 현재 구조만 정리합니다.

## 읽는 순서

```text
README.md
-> Docs/blueprint.md
-> 필요한 세부 문서
```

세부 문서:

| 문서 | 확인할 내용 |
| --- | --- |
| [design.md](design.md) | 화면 구성, UX, 아트 방향 |
| [assets.md](assets.md) | 현재 이미지 에셋, 사용 위치, 교체 기준 |
| [gameplay.md](gameplay.md) | 조작, 장애물, 아이템, 클리어 조건 |
| [maps.md](maps.md) | 맵별 배경, 도착 지점, 패턴 방향 |
| [systems.md](systems.md) | 씬 흐름, 저장/로드, 면세점, 맵 해금 |
| [feedback.md](feedback.md) | 날짜별 수정 기록과 다음 할 일 |

## 게임 핵심

TravelRun은 여행 테마 2D 러너입니다.

플레이어는 집에서 여행 영상을 보고 출발하며, 인천공항 튜토리얼을 지나 일본, 중국, 미국으로 이동합니다. 각 맵은 정해진 시간 안에 목적지까지 도착하는 구조입니다.

핵심 재미:

- 점프, 2단 점프, 슬라이드의 명확한 체험
- 클리어 가능한 패턴 기반 코스
- 마일리지 수집과 면세점 준비
- 국가별 배경, 장애물, 도착 지점 이미지
- 여행지 클리어와 다음 여행지 해금

## 전체 씬 흐름

```text
Intro
-> Opening Story
-> MapPreview
-> Main(Game)
-> Result
-> DutyFreeShop
-> MapPreview
```

역할:

| 씬 | 역할 |
| --- | --- |
| `Intro` | 세계지도 기반 타이틀, 시작/이어하기/설정 |
| `Opening Story` | 처음 시작 시 만화 컷신 |
| `MapPreview` | 다음 목적지와 목표 확인 |
| `Main` | 실제 러너 플레이 |
| `Result` | 클리어/실패 결과, 보상 |
| `DutyFreeShop` | 마일리지로 다음 스테이지 준비 |

## 현재 맵 구성

| 순서 | 맵 | 목적 |
| --- | --- | --- |
| 0 | Tutorial / Incheon | 조작과 아이템 학습 |
| 1 | Japan | 첫 일반 맵 |
| 2 | China | 지역 스킨과 난이도 확장 |
| 3 | America | 뉴욕/자유의 여신상 도착 |

자세한 맵별 자료는 [maps.md](maps.md)를 봅니다.

## 코스 설계 원칙

랜덤 배치가 아니라 검증된 패턴을 이어붙이는 방식으로 갑니다.

```text
기본 발판
-> 점프 장애물
-> 2단 점프 거리
-> 슬라이드 장애물
-> 강제 피격 체험
-> 아이템 체험
-> 도착 지점
```

이 방식은 플레이어가 왜 그 조작을 해야 하는지 실제로 체험하게 만듭니다.

## 문서 운영 규칙

- `README.md`는 짧은 입구로 유지합니다.
- 실제 전체 구조는 이 `blueprint.md`에 정리합니다.
- 구현 기록은 `feedback.md`에 날짜별로 남깁니다.
- 이미지 목록과 사용 여부는 `assets.md`에만 적습니다.
- 맵별 수치와 방향은 `maps.md`에만 적습니다.
- 시스템 구조는 `systems.md`에만 적습니다.

## 다음 작업 우선순위

1. 면세점 구매 아이템을 장착 슬롯과 연결
2. 일본, 중국, 미국 맵의 실제 반복 패턴과 난이도 차별화
3. 도착 지점 이미지의 실제 화면 크기를 플레이하면서 세부 조정