# 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. 일본, 중국, 미국 맵의 실제 반복 패턴과 난이도 차별화
4. 미국 도착 지점 파일명 정리