Travel_Run/README.md

# Uni-Run / TravelRun

마우스 두 버튼만으로 플레이하는 여행 테마 2D 러너 게임 프로젝트입니다.

플레이어는 인트로에서 여행을 시작하고, 튜토리얼 인천공항을 거쳐 일본, 중국, 미국으로 이동합니다. 각 맵은 정해진 거리와 시간 안에 목적지까지 도착하는 구조이며, 점프, 2단 점프, 슬라이드, 아이템, 면세점, 맵 해금, 기념품 수집으로 확장하는 것을 목표로 합니다.

## 먼저 읽을 문서

작업을 이어갈 때는 아래 순서로 읽으면 됩니다.

1. [Docs/blueprint.md](Docs/blueprint.md)  
   전체 설계도입니다. 현재 구조, 씬 흐름, 문서 위치, 다음 작업 우선순위를 한 번에 확인합니다.

2. 필요한 세부 문서로 이동합니다.

| 문서 | 용도 |
| --- | --- |
| [Docs/design.md](Docs/design.md) | 화면/UX/아트 방향 |
| [Docs/assets.md](Docs/assets.md) | 만들어진 이미지와 실제 사용 파일 |
| [Docs/gameplay.md](Docs/gameplay.md) | 조작, 튜토리얼, 아이템, 클리어 규칙 |
| [Docs/maps.md](Docs/maps.md) | 인천 튜토리얼, 일본, 중국, 미국 맵 구성 |
| [Docs/systems.md](Docs/systems.md) | 씬 전환, 저장/로드, 면세점, 해금 구조 |
| [Docs/feedback.md](Docs/feedback.md) | 날짜별 수정 기록과 다음 할 일 |

## 현재 씬 흐름

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

실제 게임 플레이는 `Assets/Sence/Main.unity`에서 진행되고, 인트로/맵 미리보기/결과/면세점은 별도 씬으로 분리되어 있습니다.

## 핵심 조작

| 입력 | 기능 |
| --- | --- |
| 마우스 왼쪽 클릭 | 점프 |
| 공중에서 왼쪽 클릭 | 2단 점프 |
| 마우스 오른쪽 클릭 유지 | 슬라이드 |

## 현재 구현 핵심

- 인트로 화면과 오프닝 만화 컷신
- 말풍선 없는 오프닝 만화 컷 적용
- 튜토리얼 인천공항 맵
- 패턴 기반 발판/장애물/아이템 배치
- 점프, 2단 점프, 슬라이드 튜토리얼
- 공항 디지털 안내 패널형 튜토리얼 설명창과 클릭 확인 버튼
- 왼쪽 여권형 HUD와 오른쪽 수하물 라벨형 거리/마일리지 HUD
- 속도에 맞춰 가로 폭이 보정되는 점프 마일리지 코인 아크
- 목숨, 속도 감소, 무적, 방어막, 마일리지 카드 등 아이템 효과
- 필드 아이템 가시성 확대
- 아이템 획득/방어 성공 피드백 이펙트
- 맵 데이터 구조: `Tutorial / Incheon`, `Japan`, `China`, `America`
- 맵별 배경과 도착 지점 이미지, 도착용 착지 발판, 게이트 뒤 스폰 중지 연결
- 저장/로드, 맵 해금, 결과 화면, 면세점 기본 흐름

## 다음 우선순위

현재 가장 가까운 작업은 다음입니다.

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

자세한 작업 기록과 다음 할 일은 [Docs/feedback.md](Docs/feedback.md)에 날짜별로 남깁니다.