Travel_Run/Docs/maps.md

# Maps

맵별 배경, 스킨, 도착 지점, 목적을 정리합니다.

## 공통 구조

각 맵은 `MapDefinition`으로 관리합니다.

주요 필드:

- `mapId`
- `displayName`
- `routeName`
- `platformSkin`
- `backgroundResourcePath`
- `backgroundResourcePaths`
- `backgroundFitScaleMultiplier`
- `backgroundVerticalOffset`
- `finishGateStyle`
- `targetDistance`
- `timeLimit`
- `clearMileageReward`
- `courseProfile`
- `openingSteps`, `loopSteps` fallback

리팩터링 목표:

- `CourseProfile` 기반 코스 구조를 사용합니다.
- `PlatformSpawner.TutorialStep`은 `CourseStep`으로 독립시켰습니다.
- `MapDatabase`는 맵 목록 관리만 담당하고, 실제 맵 정의는 맵별 파일로 나눴습니다.

현재 구조:

```text
MapDatabase
-> Definitions/TutorialIncheonMap.cs
-> Definitions/JapanMap.cs
-> Definitions/ChinaMap.cs
-> Definitions/AmericaMap.cs

Course
-> TutorialCourseProfile.cs
-> JapanCourseProfile.cs
-> ChinaCourseProfile.cs
-> AmericaCourseProfile.cs
```

## 코스 분리 기준

튜토리얼과 일반 맵은 같은 구조를 복사하지 않습니다.

| 코스 | 목적 |
| --- | --- |
| Tutorial / Incheon | 조작 학습, 강제 피격, 아이템 효과 체험, 출국 게이트 실전 연습 |
| Japan | 첫 일반 맵, 쉬운 점프/슬라이드 반복 패턴 |
| China | 간격 변화, 연속 슬라이드/점프 확장 |
| America | 빠른 속도, 후반 난이도, 긴 주행 압박 |

난이도 기준:

| 맵 | 난이도 |
| --- | --- |
| Tutorial / Incheon | 1 / 10 |
| Japan | 3 / 10 |
| China | 5 / 10 |
| America | 8 / 10 |
 
현재 `PlatformSpawner`는 맵이 가진 `CourseProfile`을 실행합니다.
맵별 opening/loop 코스와 fallback 코스는 `Course/Profiles`에서 관리합니다.

## Tutorial / Incheon

역할:

- 기본 조작과 아이템 학습
- 실제 플레이 시작 전 연습 코스

배경:

- 현재 런타임 적용: `Assets/Resources/StageBackgrounds/Incheon/Stage_Incheon_DarkLower_Segment_01_CheckInHall.png`
- 현재 런타임 적용: `Assets/Resources/StageBackgrounds/Incheon/Stage_Incheon_DarkLower_Segment_02_DepartureSecurity.png`
- 현재 런타임 적용: `Assets/Resources/StageBackgrounds/Incheon/Stage_Incheon_DarkLower_Segment_03_DutyFreeConcourse.png`
- 현재 런타임 적용: `Assets/Resources/StageBackgrounds/Incheon/Stage_Incheon_DarkLower_Segment_04_MovingWalkwayWindows.png`
- 현재 런타임 적용: `Assets/Resources/StageBackgrounds/Incheon/Stage_Incheon_DarkLower_Segment_05_BoardingGate.png`
- 이전 단일 배경: `Assets/Resources/Map_Tutorial_Incheon_Airport.png`

현재 인천 배경 조각은 화면비 보정을 위해 임시 런타임 캔버스로 적용되어 있습니다.
상단 늘어남이 보여 최종본은 현재 화면비에 맞춘 새 16:9 배경 조각으로 다시 제작합니다.

도착 지점:

- `Assets/Resources/FinishGate_Tutorial_Incheon.png`
- 출국 심사/보딩 게이트 느낌

체험 순서:

1. 점프
2. 2단 점프
3. 슬라이드
4. 강제 피격
5. 김밥
6. 바나나우유
7. 에너지 드링크
8. 실전 연습 후 출국 게이트

튜토리얼 필드 아이템은 한국/공항 스킨 기준으로 표시합니다.
일반 맵에서는 같은 효과가 맵별 음식/음료 스킨으로 바뀝니다.

## Japan

역할:

- 첫 일반 여행 맵
- 튜토리얼에서 배운 조작을 반복 패턴으로 사용
- 튜토리얼 설명, 강제 피격 체험, 아이템 설명 트리거는 사용하지 않음

배경:

- `Assets/Resources/Map_Japan_Fukuoka.png`

도착 지점:

- `Assets/Resources/FinishGate_Japan_Torii.png`
- 토리이

스킨:

- 일본 발판
- 석등 낮은 장애물
- 배너/표지판 슬라이드 장애물

코스 방향:

- 안전 발판으로 시작
- 낮은 점프 장애물과 짧은 슬라이드를 번갈아 배치
- 마일리지 코인은 점프 아크와 안전 라인 중심
- 튜토리얼보다 긴 반복 패턴을 사용하되 난이도는 낮게 유지
- 필드 아이템은 일본 스킨의 초밥, 라멘, 에너지 드링크를 사용
- 난이도 3 기준으로, 액션 뒤에는 대체로 회복용 안전 발판을 둠
- 석등 점프와 표지판 슬라이드는 한 번에 하나씩 읽히게 배치

## China

역할:

- 붉은색/금색 지역감
- 슬라이드와 점프 패턴 확장
- 일본보다 장애물 간격 변화가 큼

배경:

- `Assets/Resources/Map_China_Beijing.png`

도착 지점:

- `Assets/Resources/FinishGate_China_Paifang.png`
- 중국 패방

스킨:

- 중국 발판
- 시장 상자 낮은 장애물
- 홍등 슬라이드 장애물

코스 방향:

- 점프 뒤 슬라이드, 슬라이드 뒤 점프처럼 전환 패턴을 늘림
- 마일리지 라인은 안전 구간과 위험 보상 구간을 구분
- 튜토리얼용 강제 피격 패턴은 사용하지 않음
- 필드 아이템은 중국 스킨의 만두, 훠궈, 에너지 드링크를 사용
- 난이도 5 기준으로, 점프와 슬라이드가 이어지는 구간을 루프마다 포함
- 공중 발판 간격은 일본보다 짧게 잡아 착지 타이밍을 더 요구

## America

역할:

- 뉴욕 도착 맵
- 자유의 여신상에 도착하면 클리어되는 느낌
- 후반 맵답게 속도와 반응 시간을 더 강하게 사용

배경:

- `Assets/Resources/Map_America_NewYork.png`

도착 지점:

- `Assets/Resources/FinishGate_America_Liberty.png`
- 도착 게이트가 나올 때 전용 착지 발판을 함께 깔아 이미지가 공중에 뜬 것처럼 보이지 않게 합니다.
- 도착 게이트 뒤에는 추가 코스가 생성되지 않게 막아 클리어 지점이 끝처럼 보이게 합니다.

스킨:

- 미국 발판
- 콘/도로 장애물
- 배너/표지판 슬라이드 장애물

코스 방향:

- 넓은 점프와 짧은 슬라이드가 빠르게 이어짐
- 안전 발판 비중은 줄이고 패턴 반복 속도를 올림
- 도착 지점 전 마지막 구간은 시야가 복잡하지 않게 정리
- 필드 아이템은 미국 스킨의 햄버거, 핫도그, 에너지 드링크를 사용
- 난이도 8 기준으로, 짧은 간격의 점프/슬라이드 연속 패턴을 사용
- 회복 아이템은 루프 안에 있지만 액션 밀도를 낮추지는 않음

## 맵 추가 규칙

새 맵을 추가할 때:

1. `MapId` 추가
2. `Maps/Definitions`에 맵별 정의 파일 추가
3. 단일 배경은 `Assets/Resources/Map_*.png`로 저장하고, 연결 배경 조각은 `Assets/Resources/StageBackgrounds/<MapName>/`에 저장
4. 도착 지점 이미지를 `Assets/Resources/FinishGate_*.png`로 저장
5. `backgroundResourcePath` 또는 `backgroundResourcePaths`, `finishGateStyle` 연결
6. `Course` 폴더에 해당 맵의 `CourseProfile` 추가
7. `MapDatabase` 목록에 새 맵 연결