🧩 Unity Maze Horror Prototype

Unity Version: 6000.2.14f1
Input System: Both (Old + New Input System Enabled)

혹시 모를 오류를 예방하기 위해 유니티에디터 버전과 설정을 맞추어주세요.

본 프로젝트는 절차적 미로 생성, 다양한 타입의 문(페이크/호러/골) 상호작용,
패널티 시스템, 랜덤 텔레포트, 공포 맵 전환 등의 기능을 포함한
1인칭 미로 탐험 게임(Horror Prototype) 입니다.

📚 목차

• 현재 구현된 핵심 기능
  • 미로 생성 시스템
  • 문 시스템
  • 문 상호작용
  • 패널티 시스템
  • 텔레포트 유틸리티
• 플레이어 이동
• 프로젝트 디렉토리 구조
• GitHub 레포지토리 클론 방법 (비개발자용)
  • 준비물
  • GitHub Desktop 설치
  • 레포지토리 클론
  • [Unity 프로젝트 열기
  • 작업 후 GitHub에 올리기
  • 절대 하면 안 되는 것
  • 기억하면 좋은 한 줄 요약

---

🚀 현재 구현된 핵심 기능

✔ 미로 생성 시스템 (MazeGenerator / MazeRenderer)

• 셀 기반 랜덤 미로 생성
• 바닥, 벽 생성
• 문(Fake / Horror / Goal) 자동 배치
• walkableCells 등록 → 랜덤 텔레포트 기능 연동

✔ 문 시스템 (Door Framework)

모든 문은 DoorBase 를 상속하며 다음 타입을 가짐:

문 종류	설명
FakeDoor	패널티 증가 + 랜덤 텔레포트
HorrorDoor	패널티 증가 + 공포씬(HorrorScene) 이동
GoalDoor	패널티 초기화 + 씬 재시작 / 추후 다음 레벨 이동

✔ 문 상호작용 (DoorInteraction)

• Trigger 방식 상호작용
• 문 근처에서 E 키 입력 (WASD 이동 포함)
• Canvas UI 연동 가능

✔ 패널티 시스템 (PenaltyManager)

• 레벨 내부(Local) 패널티만 존재
• 임계치 도달 시 FakeDoor → HorrorDoor 변환
• MazeRenderer 생성 시 FakeDoor 자동 등록

✔ 텔레포트 유틸리티 (TeleportUtility)

• 미로 내부 walkableCells 기반 랜덤 텔레포트
• CharacterController 정상 이동 처리 포함

---

🎮 플레이어 이동 (WASD + 마우스)

플레이어는 Unity Input System 설정을 Both로 적용하여
Old/New Input System 둘 다 사용 가능하도록 구성함.

포함된 기능:

• WASD 이동
• 마우스 시점 회전
• CharacterController 기반

---

📁 프로젝트 디렉토리 구조

Assets/
├─ Scripts/
│  ├─ Maze/
│  │  ├─ Maze.cs
│  │  ├─ MazeGenerator.cs
│  │  ├─ MazeRenderer.cs
│  │
│  ├─ Door/
│  │  ├─ DoorBase.cs
│  │  ├─ FakeDoor.cs
│  │  ├─ HorrorDoor.cs
│  │  ├─ GoalDoor.cs
│  │  ├─ DoorInteraction.cs
│  │
│  ├─ Managers/
│  │  ├─ PenaltyManager.cs
│  │
│  ├─ Utility/
│     ├─ TeleportUtility.cs
│
├─ Prefabs/
│  ├─ Door.prefab
│  ├─ Wall.prefab
│  ├─ Floor.prefab
│  ├─ Player.prefab

📦 GitHub 레포지토리 클론하는 방법 (비개발자용)

이 문서는 처음 GitHub를 쓰는 팀원이
프로젝트 파일을 내 컴퓨터로 내려받는 방법을 설명합니다.

---

✅ 준비물

• GitHub 계정
• GitHub Desktop 설치
• Unity Hub 설치 (Unity 작업자만)

---

1️⃣ GitHub Desktop 설치

아래 사이트에 접속해서 다운로드 후 설치하세요.

👉 https://desktop.github.com

설치 후 GitHub 계정으로 로그인합니다.

---

2️⃣ 레포지토리 클론 (내 컴퓨터로 복사)

1. GitHub Desktop 실행

2. 상단 메뉴에서 File → Clone repository 클릭

3. URL 탭 선택

4. 아래 정보를 입력

   • Repository URL:

     https://github.com/Team-BeBee/MazeGame
     

   • Local Path:
     👉 원하는 폴더 위치 선택

5. Clone 버튼 클릭

⏳ 잠시 기다리면 프로젝트가 내려받아집니다.

---

3️⃣ Unity 프로젝트 열기 (Unity 작업자만)

1. Unity Hub 실행
2. Projects → Add
3. 방금 클론한 폴더 선택
4. 프로젝트 열기

⚠️ Unity 버전이 다르면 자동으로 안내가 뜹니다.

---

4️⃣ 작업 후 GitHub에 올리기 (기본 흐름)

1. Unity에서 작업 후 저장
2. GitHub Desktop으로 이동
3. 왼쪽에 변경된 파일 목록 확인
4. 아래에 변경 내용 간단히 작성
   • 예시:

     art: 배경 이미지 추가
     

5. Commit to main 클릭
6. Push origin 클릭

✅ 여기까지 하면 업로드 완료

---

❗ 절대 하면 안 되는 것

• ❌ .meta 파일 삭제
• ❌ 충돌(conflict) 발생 시 혼자 해결하려 하지 말 것
• ❌ Scripts / Scenes 폴더 임의 수정
• ❌ Force Push 누르기

👉 문제 생기면 바로 담당 개발자에게 연락

---

📌 기억하면 좋은 한 줄 요약

Clone → 작업 → Commit → Push
버튼만 누르면 됩니다 😊

│ ├─ Scenes/ │ ├─ TestScene.unity │ ├─ HorrorScene.unity (예정)