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`
- 맵별 `CourseProfile` 구조와 fallback 코스 분리
- 면세점 구매 제한, 가방 슬롯, 도시락/마일리지 카드 장착, 영양제 최대 HP 증가
- 맵별 배경과 도착 지점 이미지, 도착용 착지 발판, 게이트 뒤 스폰 중지 연결
- 인천 튜토리얼 배경 조각 순환 구조와 점프/2단 점프/슬라이딩 전용 SFX
- 저장/로드, 맵 해금, 결과 화면, 면세점 기본 흐름

## 다음 우선순위

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

1. 인천 튜토리얼 배경을 현재 화면비에 맞춘 새 16:9 배경 조각으로 다시 제작
2. Unity Play 모드에서 결과/면세점/맵 프리뷰 화면을 실제 해상도로 확인
3. `GameManager`의 HUD와 튜토리얼 안내창을 별도 스크립트로 분리
4. 일본, 중국, 미국 맵의 반복 패턴과 난이도를 플레이 테스트로 미세 조정

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