Skip to content

운동 데이터를 기반으로 우주 소년 ‘미로’의 여정을 따라 달까지 걷는 여정을 그린 스토리 기반 홈 피트니스 게임 (Unity + BLE 센서 연동)

Notifications You must be signed in to change notification settings

BUGISU/BMF-Run.to.the.Moon

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📘 보자마자 피트니스 - 런 투 더 문(Run to the Moon)

달을 향해 날아가던 중 사고로 인해 소행성에 불시착하게 된 우주 소년 ‘미로’. 광활하고 몽환적인 우주의 길을 걸으며 달을 향해 걸어가는 스페이스 로드 무비 형식의 홈 피트니스 게임입니다.

스토리 기반 플레이, 다양한 맵 디자인(20종), 돌발 미션, 산소 시스템, 운동량 조절 아이템, 운동 데이터 기록, 명예의 전당 랭킹 시스템을 제공합니다.

앱과 센서를 블루투스로 연결해 달까지 걸어가는 컨셉.

Run to the Moon은 운동 데이터를 게임화하여 몰입감 있게 소화할 수 있는 홈 피트니스 콘텐츠입니다. 스토리 중심의 구간 진행, 센서 연동, 다양한 시각적 요소, 유저 맞춤 랭킹 시스템을 통해 운동 지속성과 몰입을 함께 유도합니다.

📅 개발 개요

구분 내용
개발 기간 / 역할 2021.08 ~ 2022.12 (1년 5개월)
기획·아트 협업, 개발 100% 담당 (맵/이벤트/내러티브/시스템)
기술 스택 Unity3D (C#)
Cinemachine / Timeline – 시네마틱 연출 및 카메라 제어
ESP32 BLE – 걸음/속도 데이터 실시간 수신
Unity UI + Coroutine – 내러티브/튜토리얼 시스템
Addressables – 맵 및 리소스 관리
주요 기여 2021.08~ – UI/UX 적용 및 맵 디자인 20종 구현
2022.01~ – 이벤트 시스템, 산소 시스템, 아이템 상점 기능 개발
2022.05~ – 글로벌 영문 버전 제작 (전체 텍스트 로컬라이징, 다국어 대응)

🗺️ 게임 콘텐츠 맵 (예시)

1. 여정의 시작 (0~50km)
2. 목적없는 발걸음 (50~100km)
...
19. 색을 잃은 빛 (900~950km)
20. 달의 신전 (950~1000km)
21. 명예의 전당

🧱 시스템 구조 요약

  • 데이터 관리: Game_DataManager, O2Timer
  • 씬 로딩/튜토리얼: Loading_SceneManager, Game_HelpManager
  • 맵 이벤트: AroundActiveObject, SpawnBoundingBox
  • 내러티브/사운드: Game_TypeWriterEffect, SoundManager
  • 명예의 전당: HallofFame_UIManager, RankDataManager

📸 게임 주요 화면

화면 설명 이미지
타이틀 화면 게임 시작 화면. “Run to the moon” 로고와 함께 여정을 시작할 수 있음 타이틀
튜토리얼 첫 진입 시 기본 설명 제공. 여정의 구조와 숨겨진 스토리를 안내 튜토리얼
주행 시작 센서 연동 후 캐릭터가 실제 속도에 맞춰 달리며 HUD에 거리·시간·칼로리·산소 표시 주행시작
주행 중 화면 캐릭터 달리기 동작. 산소 게이지 소모, 칼로리 계산 등이 실시간 반영 주행중
아이템 획득 이벤트 맵에서 산소통 등 랜덤 아이템 등장. 상호작용 시 자동 획득 및 내러티브 출력 아이템획득
보유 아이템 창 휴게소에서 구매한 아이템 확인 및 사용 가능. 산소 회복, 보조 아이템 효과 제공 보유아이템
우주 휴게소 도착 일정 거리 도달 시 휴게소 등장. 산소 회복 및 아이템 구매 가능 휴게소도착
아이템 상점 소형/대형 산소통, 별가루 등 구매 가능. 전략적 플레이를 지원 아이템상점
아이템 구매 팝업 아이템 선택 후 수량 지정 및 구매 확정 화면 아이템구매
체크포인트(5km) 특정 구간마다 진행 기록 저장. 중도 종료 후 이어하기 가능 체크포인트
특수 맵 구간 판타지 테마 배경(예: 빛나는 숲). 다양한 연출과 오브젝트 배치 특수맵
내러티브 대사 출력 주행 중 캐릭터의 랜덤/상황별 대사 출력으로 몰입감 강화 내러티브
달 도착 연출 최종 목표인 달에 도착하면 기록과 함께 축하 메시지 출력 달도착
명예의 전당 달 도착 기록이 저장되며 랭킹 보드에 표시 명예의전당

콘텐츠 예시

함께하는 여정 맴도는 공허함 우주를 떠도는 영혼

🧱 핵심 스크립트 상세 설명

1. 데이터 관리

  • Game_DataManager: 거리, 칼로리, 시간, 걸음 수 등의 운동 데이터를 저장 및 서버 전송 처리
  • O2Timer: 산소 시스템 구현 (기본 40분 기준, 아이템으로 보충 가능), 특정 구간에서 산소 소비 가속
  • PlayerAniCheckCtrl: 발소리 효과 및 걸음 수 실시간 계산

2. 씬 로딩 및 UI

  • Loading_SceneManager: Addressables 기반 씬 로딩 처리 및 진행도 연출
  • Lobby_UIManager: 메인 로비에서 유저 정보 및 조각함 UI 제어
  • Lobby_DataManager: 닉네임 필터링, 접속일 관리, 튜토리얼 상태 관리

3. 튜토리얼 및 내러티브

  • Game_HelpManager: 최초 10단계 튜토리얼 팝업 처리 및 일시정지 연출
  • Game_TypeWriterEffect: 타자기 스타일의 내러티브 출력. 특정 아이템 또는 맵 구간 도달 시 텍스트 출력 제어

4. 게임 내 맵 및 이벤트

  • CameraViewPort: Player 위치에 따라 Cinemachine Virtual Camera 우선순위 변경 (좌우 시점 전환)
  • AroundActiveObject: 특정 구역 진입 시 오브젝트 자동 활성화
  • SpawnBoundingBox: BoxCollider 내부에 Addressables 객체를 랜덤 위치에 스폰
  • ItemDescriptionManager: 아이템 설명 팝업 표시, 시간 제한 후 자동 종료 처리

5. 센서 연동 및 이벤트

  • Game_SenesorEvent: BLE 센서 연동 시작 트리거 (ESP32 BLE)
  • App_Manager: 라운드 시작/종료 시 UI, 데이터, 애니메이션 동기화

6. 시각 효과 및 연출

  • RotateSkyBox: Skybox 회전 효과 (우주 느낌 강조)
  • TunnelController: TunnelEffect 시각 효과 적용 (특정 스테이지 전용)

7. 명예의 전당

  • HallofFame_UIManager: 도달 기록 저장, 순위 리스트 생성, Bloom 연출 처리
  • HallofFame_RankDataManager: 랭킹 데이터 세팅 및 UI 반영
  • HallofFame_PlayerCtrl: 도착 연출 및 Victory 애니메이션

🔖 기타 구현 요소 (효과 포함)

  • 타이핑 내러티브 & 라디오 멘트 출력 → 장시간 플레이 시 지루함 방지
  • 아이템 수집 및 사용 시스템 → 플레이 몰입감·전략성 강화
  • 다양한 파티클/비주얼 연출 → 우주 공간의 몽환적 분위기 강화
  • 명예의 전당 랭킹 기록(최대 100인) → 유저 경쟁 요소 강화 및 동기 부여

About

운동 데이터를 기반으로 우주 소년 ‘미로’의 여정을 따라 달까지 걷는 여정을 그린 스토리 기반 홈 피트니스 게임 (Unity + BLE 센서 연동)

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages