# 🎮 웰컴스 한글 타자 게임 — 사용 설명서

> 화면에 떨어지는 단어를 빠르게 타이핑하여 레이저로 파괴하는 타자 연습 게임입니다.

---

## 📋 목차

1. [게임 시작하기](#-게임-시작하기)

2. [게임 방법](#-게임-방법)

3. [템플릿 (난이도)](#-템플릿-난이도)

4. [아이템 & 특수 기능](#-아이템--특수-기능)

5. [점수 & 콤보 시스템](#-점수--콤보-시스템)

6. [등급 시스템](#-등급-시스템)

7. [회원 기능](#-회원-기능)

8. [리더보드](#-리더보드)

9. [단축키 모음](#-단축키-모음)

10. [자주 묻는 질문](#-자주-묻는-질문)

---

## 🚀 게임 시작하기

```mermaid

flowchart TD

    A[페이지 접속] --> B[시작 화면]

    B --> C{템플릿 선택}

    C -->|초보| D[게임 시작]

    C -->|컴퓨터| D

    C -->|코딩개발| D

    C -->|사무용| D

    C -->|사자성어| D

    C -->|일상| D

    D --> E[게임 진행]

    E --> F[게임 오버]

    F --> G{선택}

    G -->|다시 하기| D

    G -->|이어서 하기| H[점수 초기화, 스테이지 유지]

    G -->|템플릿 선택| B

    G -->|종료하기| I[홈으로]

```

1. **게임 페이지에 접속**합니다.

2. **원하는 템플릿(주제)**을 선택합니다.

3. **`▶ 게임 시작`** 버튼을 누릅니다.

4. 화면 위에서 단어가 떨어집니다. 아래 입력창에 타이핑하세요!

---

## ⌨️ 게임 방법

### 기본 조작

| 조작 | 방법 |

|------|------|

| 단어 입력 | 키보드로 타이팅 |

| 단어 제출 | `Enter` 키 |

| 일시정지 / 해제 | `ESC` 키 또는 ⏸ 버튼 |

| 폭탄 사용 | `1` 키 |

| 슬로우 사용 | `2` 키 |

### 게임 진행 흐름

```mermaid

flowchart LR

    A[단어 등장] --> B[타이핑]

    B --> C{정확?}

    C -->|YES| D[레이저 파괴 ✨]

    D --> E[점수 획득 + 콤보 증가]

    C -->|NO| B

    A --> F[화면 하단 도달]

    F --> G[❌ 생명 -1]

    G --> H{남은 생명?}

    H -->|0| I[게임 오버 💀]

    H -->|1+| A

```

### 생명 (라이프)

| 템플릿 난이도 | 초기 생명 |

|:---:|:---:|

| 초보 (★★☆☆☆) | **5개** |

| 나머지 모두 | **3개** |

단어가 화면 맨 아래까지 떨어지면 생명이 1개 감소합니다.

생명이 0이 되면 **게임 오버**!

---

## 📚 템플릿 (난이도)

6가지 주제별 템플릿이 있습니다. 각각 다른 단어장과 난이도를 가집니다.

| 템플릿 | 아이콘 | 설명 | 난이도 | 단어 예시 |

|--------|--------|------|:------:|-----------|

| **초보** | 📝 | 기본 일상어 | ★☆☆☆☆ | 안녕, 감사, 사랑 |

| **일상** | ☀️ | 일상생활 어휘 | ★★☆☆☆ | 출근, 저녁, 운동 |

| **컴퓨터** | 💻 | 부품·하드웨어 | ★★★☆☆ | 마우스, 키보드, 모니터 |

| **사무용** | 📄 | 사무·업무 용어 | ★★★☆☆ | 회의, 보고서, 결재 |

| **코딩개발** | 💻 | 개발·기술 용어 | ★★★★☆ | 함수, 변수, 알고리즘 |

| **사자성어** | 📖 | 한자 사자성어 | ★★★★★ | 일석이조, 사면초가 |

> 💡 **초보** 템플릿은 단어가 천천히 떨어지고 짧은 단어 위주로 나옵니다.

> 처음이시라면 **초보** 또는 **일상**부터 시작하세요!

---

## 🎁 아이템 & 특수 기능

게임 중 특별한 **UFO**가 등장합니다! UFO를 타이핑하면 보상을 얻습니다.

```mermaid

flowchart TD

    A["🛸 UFO 등장!"] --> B{UFO 종류}

    B -->|웰컴스 로고| C["💣 폭탄 +1"]

    B -->|컴퓨터 아이콘| D["🐢 슬로우 +1"]

    B -->|❤️ 하트| E["❤️ 라이프 +1"]

```

### 아이템 사용

| 아이템 | 키 | 효과 |

|--------|:---:|------|

| 💣 **폭탄** | `1` | 화면의 **모든 단어**를 한 번에 파괴 |

| 🐢 **슬로우** | `2` | **10초간** 단어 떨어지는 속도 느려짐 |

> ⚠️ 아이템은 게임 시작 시 폭탄 1개, 슬로우 1개로 시작합니다.

> UFO를 잡아서 추가로 획득하세요!

---

## 🏆 점수 & 콤보 시스템

### 점수 계산

```

기본 점수 = 단어 길이 × 10

콤보 보너스 = 기본 점수 × (1 + 콤보 × 0.1)

```

| 단어 길이 | 기본 점수 |

|:---------:|:---------:|

| 2글자 | 20점 |

| 3글자 | 30점 |

| 4글자 | 40점 |

| 5글자 | 50점 |

| 6글자 | 60점 |

| 7글자 | 70점 |

### 콤보

- 단어를 **연속으로** 성공할 때마다 콤보가 쌓입니다

- 콤보가 높을수록 **보너스 점수**가 큽니다

- 단어를 놓치면 콤보가 **0**으로 초기화됩니다

### 스테이지 진행

```mermaid

flowchart LR

    A["Stage 1"] -->|단어 8개 완료| B["Stage 2"]

    B -->|단어 8개 완료| C["Stage 3"]

    C -->|...| D["Stage N"]

    D -->|스테이지가 올라갈수록| E["⚡ 속도 증가"]

    D -->|스테이지가 올라갈수록| F["📝 단어 길어짐"]

```

- 스테이지마다 **8개 단어**를 완료하면 다음 스테이지

- 높은 스테이지일수록 단어가 **빨리** 떨어지고 **긴 단어**가 등장

---

## 🎖️ 등급 시스템

게임을 많이 할수록 **누적 점수**가 쌓이고 등급이 올라갑니다!

```mermaid

flowchart LR

    A["🪨 아이언<br/>0점 ~"] -->|50,000점| B["🥉 브론즈"]

    B -->|200,000점| C["🥈 실버"]

    C -->|500,000점| D["🥇 골드"]

    D -->|1,200,000점| E["💎 다이아몬드"]

```

| 등급 | 필요 누적 점수 | 메달 |

|:----:|:---:|:---:|

| 🪨 아이언 | 0점 ~ | 회색 메달 |

| 🥉 브론즈 | 50,000점 ~ | 구리 메달 |

| 🥈 실버 | 200,000점 ~ | 은 메달 |

| 🥇 골드 | 500,000점 ~ | 금 메달 |

| 💎 다이아몬드 | 1,200,000점 ~ | 크리스탈 메달 |

> 💡 등급은 **회원만** 적용됩니다. 게스트는 등급이 없습니다.

> 프로필 카드에 **다음 등급까지 남은 점수**가 진행률 바로 표시됩니다!

---

## 👤 회원 기능

### 소셜 로그인

3가지 소셜 계정으로 간편하게 로그인할 수 있습니다.

| 서비스 | 버튼 색상 |

|--------|----------|

| 🟡 카카오 | 노란색 |

| 🟢 네이버 | 초록색 |

| 🔵 구글 | 파란색 |

### 회원 전용 기능

```mermaid

flowchart TD

    A[회원 로그인] --> B[게임 기록 자동 저장]

    B --> C[등급 시스템 적용]

    B --> D[리더보드 등록]

    B --> E[개인 통계 확인]

    E --> F[게임 횟수]

    E --> G[최고 점수]

    E --> H[평균/최고 타수]

    E --> I[최고 스테이지]

    E --> J[총 플레이 시간]

```

### 프로필 카드 정보

| 항목 | 설명 |

|------|------|

| 🎮 게임 횟수 | 총 플레이한 게임 수 |

| 🏆 최고 점수 | 역대 최고 점수 |

| ⌨️ 평균 타수 | 분당 평균 타자 수 |

| ⚡ 최고 타수 | 분당 최고 타자 수 |

| 🚀 최고 스테이지 | 도달한 최고 스테이지 |

| ⏱️ 총 플레이 | 총 플레이 시간 |

> 📌 게스트도 게임을 즐길 수 있지만, **기록이 저장되지 않습니다**.

---

## 📊 리더보드

3가지 기간으로 순위를 확인할 수 있습니다.

| 탭 | 기간 |

|----|------|

| **통합** | 전체 기간 |

| **주간** | 최근 7일 |

| **월간** | 최근 30일 |

- 선택한 **템플릿별**로 순위가 표시됩니다

- **회원과 게스트** 모두 순위에 올라갈 수 있습니다

- 각 사용자 옆에 **등급 메달**이 표시됩니다

---

## ⌨️ 단축키 모음

| 키 | 기능 |

|:---:|------|

| `A-Z` / `가-힣` | 단어 입력 |

| `Enter` | 단어 제출 |

| `ESC` | 일시정지 / 해제 |

| `1` | 폭탄 사용 |

| `2` | 슬로우 사용 |

---

## ❓ 자주 묻는 질문

### Q: 생명은 어떻게 회복하나요?

게임 중 ❤️ **생명 UFO**가 랜덤하게 등장합니다. 이를 타이핑하면 생명이 +1 됩니다.

### Q: "이어서 하기"와 "다시 하기"의 차이는?

- **다시 하기**: 점수, 스테이지, 모든 상태 초기화 후 처음부터

- **이어서 하기**: 점수만 초기화, **스테이지는 유지** (높은 스테이지에서 계속)

### Q: 등급은 어떻게 빨리 올리나요?

- 어려운 템플릿(코딩개발, 사자성어)을 선택하세요

- 콤보를 유지하면 보너스 점수가 높습니다

- 높은 스테이지까지 가면 한 게임에서 많은 점수를 얻을 수 있습니다

### Q: 게스트로도 리더보드에 오를 수 있나요?

네! 하지만 브라우저를 바꾸면 다른 사용자로 인식됩니다.

기록을 안전하게 저장하려면 **소셜 로그인**을 하세요.

### Q: 여러 템플릿의 점수가 합산되나요?

- **등급**: 모든 템플릿의 점수가 합산됩니다

- **리더보드**: 선택한 템플릿별 최고 점수로 순위가 매겨집니다

---

> 🎯 **Tip**: 처음이라면 **초보** 템플릿으로 시작해서, 익숙해지면 **컴퓨터** → **사자성어** 순으로 도전해보세요!