Files
Travel_Run/README.md
T
2026-07-09 02:50:48 +09:00

3.5 KiB

Uni-Run / TravelRun

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

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

먼저 읽을 문서

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

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

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

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

현재 씬 흐름

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에 날짜별로 남깁니다.