# Corridor Commander (v0.1) README

---

**Corridor Commander**는 좁은 복도와 제한된 구역에서 밀려오는 좀비 웨이브를 막아내며 살아남는 타워 디펜스 및 3인칭/1인칭 슈팅 합본 액션 게임입니다. 플레이어는 지휘관이 되어 직접 화기를 사용해 적을 사살하는 동시에, 분대원에게 명령을 내리고 바리케이트와 터렛을 배치 및 업그레이드하여 거점을 방어해야 합니다.

현재 버전은 0.1(초기 구현 단계)이며, 핵심적인 전투 메커니즘과 배치, 상점, AI 시스템의 프로토타입이 포함되어 있습니다.

---

## 🎮 주요 구현 기능 (v0.1)

* **좀비 웨이브 시스템**: 순차적으로 밀려오는 좀비 무리를 방어하고 다음 웨이브를 준비하는 핵심 루프가 구현되어 있습니다.
* **슈팅 및 전투**: 마우스 우클릭 조준과 좌클릭 사격을 기반으로 하는 화기 전투 시스템을 지원합니다.
* **플레이어 애니메이션**: 사격, 이동, 조준 등 전투 및 기동에 필요한 일부 핵심 애니메이션이 적용되었습니다.
* **상점 시스템**: 지원 트럭을 통해 무기, 보급품 및 전술 자산을 구매하거나 호출할 수 있습니다.
* **분대 AI**: 지휘관의 명령에 따라 유기적으로 움직이며 방어선을 보조하는 분대원 AI가 포함되어 있습니다.
* **플레이어 스테이터스**: 플레이어의 체력, 스태미나 등 생존에 직결되는 기본 능력치 시스템이 작동하며, 별도의 UI 창을 통해 상세 정보를 확인할 수 있습니다.
* **건설 및 배치**: 건설 포인트를 활용하여 터렛과 바리케이트를 원하는 위치에 배치하고, 설치된 구조물을 업그레이드하거나 수리할 수 있습니다.

---

## ⌨️ 조작 가이드 (Key Mapping)

### 1. 기본 이동 및 시점 (Movement & Camera)

| 키 (Key) | 행동 (Action) |
| --- | --- |
| **W, A, S, D** | 플레이어 이동 |
| **Mouse Move** | 시점 회전 |
| **Space** | 점프 |
| **Left Shift / Right Shift** | 달리기 |
| **Esc** | 마우스 커서 잠금 해제 |

### 2. 전투 및 아이템 (Combat & Items)

| 키 (Key) | 행동 (Action) |
| --- | --- |
| **Mouse 1 (좌클릭)** | 사격 |
| **Mouse 2 (우클릭)** | 조준 |
| **F (짧게 누름)** | 퀵 아이템 사용 |
| **F (0.35초 길게 누름)** | 아이템 라디얼 메뉴 열기 (마우스로 선택 후 **F**를 떼면 사용) |

### 3. 분대 지휘 및 상태 관리 (Squad Command & Status)

| 키 (Key) | 행동 (Action) |
| --- | --- |
| **Q (짧게 누름)** | 명령 카테고리 순환 (Category Cycle) |
| **Q (0.35초 길게 누름)** | 명령 라디얼 메뉴 열기 (마우스 선택 후 **Q**를 떼거나 **좌클릭**으로 확정) |
| **1 ~ 9 / Numpad 1 ~ 9** | 지정된 명령 슬롯 즉시 실행 |
| **U** | 플레이어 스테이터스 창 열기 / 닫기 |

### 4. 월드 상호작용 (World Interaction)

| 대상 / 상황 | 키 (Key) | 행동 (Action) |
| --- | --- | --- |
| **공통** | **E** | 가까운 오브젝트 상호작용 열기 / 닫기 |
| **건설 포인트** | **E** | 건설 메뉴 진입 |
| **설치물 (터렛/바리케이트)** | **E** | 업그레이드 / 수리 액션 메뉴 진입 |
| **지원 트럭** | **E** | 상점 메뉴 진입 |
| **보물상자** | **E** | 보상 선택 화면 진입 |
| **맵 확장 문** | **E** | 문 열기 (구역 확장) |

### 5. 메뉴별 세부 조작 (Menu Controls)

#### 🏗️ 건설 및 배치 (Construction & Placement)

* **건설 메뉴:** `1` / `2` / `3` 번 키로 리스트 및 슬롯 선택 | `Esc` 뒤로 가기 및 닫기
* **배치 미리보기 상태:**
* `R` 또는 `마우스 휠 회전`: 설치물 방향 회전
* `Enter` 또는 `마우스 우클릭`: 배치 확정
* `Esc`: 배치 취소



#### 🛠️ 설치물 액션 메뉴 (Structure Actions)

* `1` / `2` / `3`: 수리, 업그레이드 등 지정된 액션 실행
* `Esc`: 메뉴 닫기

#### 🛒 상점 - 지원 트럭 (Shop - Supply Truck)

* `1` / `2` / `3`: 상품 카테고리 변경
* `1` ~ `5`: 해당 번호의 아이템 구매 또는 자원 호출
* `Esc`: 뒤로 가기 및 상점 닫기

#### 🎁 보상 선택 (Rewards)

* `1` / `2` / `3`: 원하는 보상 항목 선택
* `Esc`: 선택 메뉴 닫기

#### 🧟 웨이브 컨트롤 (Wave Control)

* `P`: 웨이브 준비 팝업 열기
* `Enter` / `Y`: 웨이브 시작 확정
* `Esc` / `N`: 웨이브 시작 취소

---

## 📌 개발자 노트 (v0.1 기준 알고 계실 점)

* 본 게임은 개발 초기 단계(v0.1) 프로젝트로, 일부 애니메이션이 매끄럽지 않거나 UI 연출이 완성되지 않았을 수 있습니다.
* 전투 도중이나 웨이브 정비 시간에 **U** 키를 눌러 현재 플레이어의 세부 스태미나 및 체력 상태를 주기적으로 점검하는 것이 생존에 유리합니다.
* 라디얼 메뉴(**Q**, **F**) 사용 시 0.35초간 홀드하는 조작 감각에 익숙해지면 더욱 신속한 분대 지휘와 아이템 보급이 가능합니다.