Escape the Cave

Escape the Cave는 플레이어들이 잠수함을 함께 운용하고, 심해 동굴의 적과 환경 위험을 통과해 탈출하는 Unity 팀 프로젝트입니다. 혼자 플레이하거나 최대 4명이 세션에 참가할 수 있으며, 잠수함 안팎을 오가며 탐색·전투·수리·구조를 수행하도록 구성했습니다.

flowchart LR
 A[방 생성 또는 참가] --> B[대기방]
 B --> C[오프닝과 동시 입장]
 C --> D[잠수함으로 동굴 탐색]
 D --> E[자원·아이템 확보]
 E --> F[적·함정·환경 위험 대응]
 F --> G{체크포인트 또는 탈출}
 G -->|계속 탐색| D
 G -->|탈출| H[엔딩]

Status: Team Development Build

저장소에는 핵심 게임플레이와 멀티플레이 시스템이 구현되어 있지만, 별도의 실행 파일이나 GitHub Release는 제공하지 않습니다. Unity 프로젝트를 직접 열고 Photon 설정을 준비해야 하며, 상용 출시가 완료된 게임으로 소개하지 않습니다.

• Host, Client, Single 모드와 최대 4인 세션
• 대기방 플레이어 슬롯, 오프닝 재생, 네트워크 씬 전환 및 스폰 흐름
• 수중 이동과 잠수함 내부 걷기, 1·3인칭 카메라 전환
• 체력, 산소, 배고픔, 기절, 부활, 관전
• 맨손 포함 3슬롯 핫바(아이템 2칸)와 음식, 산소통, 총, 망치, 밧줄 등 상호작용 아이템
• 잠수함 탑승·조종, 선체 체력, 충돌 피해, 수리, 소나
• 상어·문어·성게·물고기와 회오리·환기구·낙석 위험 요소
• 체크포인트, 게임 결과, 인트로·엔딩 시네마틱

• 저장소 기준 패키지 빌드와 배포본은 없음
• Photon App 설정과 네트워크 환경이 필요함
• Unity Play Mode에서의 전체 4인 플레이 흐름은 README 정리 과정에서 다시 검증하지 못함
• 일부 애니메이션·사운드와 세이브 관련 TODO가 코드에 남아 있음

Photon Fusion 2를 사용하며, 상태 권한을 가진 호스트가 주요 판정과 스폰을 처리합니다.

• 플레이어 이동과 입력은 NetworkInputData를 통해 전달
• 체력·생존 스탯과 아이템 소유 상태는 네트워크 값으로 동기화
• 투사체와 구조용 밧줄의 판정은 호스트 중심으로 처리
• 접속·퇴장, 씬 전환, 플레이어 스폰을 NetworkTestStarter에서 관리
• UI는 네트워크 흐름과 분리해 이벤트를 받아 갱신

아래 키는 현재 소스의 기본값이며, Unity Inspector 설정에 따라 달라질 수 있습니다.

• Unity 6000年3月18日f1
• Git LFS
• Photon Fusion 2를 사용할 수 있는 Photon App 설정

git lfs install
git clone https://github.com/TheVarco/TheVarco.git

1. Unity Hub에서 저장소 루트를 프로젝트로 추가합니다.
2. Unity가 패키지와 LFS 에셋을 모두 가져올 때까지 기다립니다.
3. Photon Fusion 설정의 App ID와 접속 환경을 확인합니다.
4. Assets/01.Scenes/IntroScene_final.unity를 엽니다.
5. Play Mode에서 Single 또는 Host/Client 흐름을 시작합니다.

프로젝트 용량이 크고 일부 에셋이 Git LFS로 관리되므로 최초 열기와 임포트에 시간이 걸릴 수 있습니다.

Unity C Sharp Photon URP Cinemachine Unity AI Navigation

Assets/
├── 01.Scenes/ # 인트로, 메인 게임, 엔딩 및 테스트 씬
├── 02.Scripts/
│ ├── Enemy/ # 적 상태와 전투 로직
│ ├── GameFlow/ # 체크포인트와 결과 흐름
│ ├── Item/ # 핫바와 상호작용 아이템
│ ├── Network/ # Photon 세션, 로비, 입력
│ ├── Player/ # 이동, 카메라, 생존, 부활
│ └── Submarine/ # 잠수함 조종, 체력, 수리, 소나
├── 03.Prefabs/
├── 04.Materials/
├── 08.Cinemachine/
└── 99.Resources/

• 플레이어 수중 이동, 걷기 모드, 1·3인칭 카메라
• 상호작용, 핫바, 아이템, 산소·배고픔·체력 시스템
• Photon Fusion 기반 플레이어·스탯·아이템·투사체 동기화
• 기절·부활·관전과 구조용 밧줄·회오리 상호작용
• 방 생성, 대기방, 오프닝, 네트워크 씬 입장 흐름
• 멀티플레이에서 발생한 카메라·스폰·아이템 소유권·판정 문제 수정

• 상어·문어·물고기 같은 적 AI 상태와 공통 탐지·추적·타깃 선정 로직
• 잠수함 좌석별 조종, 선체 부위 피해와 수리, 소나, 선체 HUD
• 움직이는 잠수함 안에서 클라이언트 플레이어가 덜컹거리던 네트워크 물리 문제 해결
• 플레이어·적·잠수함·환경 요소를 대상으로 하는 체크포인트 저장·복원 구조 설계
• 멀티플레이와 싱글 모드를 같은 인터페이스로 처리하는 게임 흐름 브리지
• 낙석, 열수구 등 환경 위험 요소 패턴 시스템 및 파티클 시스템 적용
• 엔딩 시네마틱과 제작용 에디터 툴

• cseo0dev
• JoonyoungSeo
• taehuni
• knok1211