# DynamicSpawner v1.0.7 - 모드 소개 및 사용 가이드

> **플레이어 중심 동적 봇 스폰 시스템**  
> SPT 3.9 / 3.10 / 4.0 호환

---

## 🎯 모드 소개

DynamicSpawner는 **플레이어 위치를 중심으로 봇을 주기적으로 스폰**하는 모드입니다.

### 핵심 특징

- **플레이어 중심 스폰**: 플레이어 주변 설정된 거리에서 봇 생성
- **웨이브 기반 시스템**: 설정된 간격으로 봇 웨이브 발생
- **그룹 스폰 지원**: 봇들이 팀을 이뤄 함께 스폰
- **커스텀 봇 타입**: PMC/Scav 외에 보스, 레이더, 로그, 컬티스트, 좀비 등 선택 가능
- **난이도 조절**: easy ~ impossible, 또는 랜덤 난이도
- **시야 내 스폰 우선**: 플레이어 시야 방향에서 봇이 나타나도록 설정 가능

---

## ⚙️ 작동 방식

```
레이드 시작 → 15초 대기 → 웨이브 타이머 시작 (기본 180초)
    ↓
웨이브 발생 시:
    1. 봇 수 결정 (Min~Max 범위)
    2. 봇 타입 결정 (PMC/Scav 또는 커스텀 봇)
    3. 플레이어 주변 유효한 위치 탐색
    4. 봇 생성 및 활성화
    ↓
다음 웨이브까지 대기 → 반복
```

---

## 🎮 F12 설정 사용법

게임 내에서 **F12** 키를 눌러 BepInEx Configuration Manager를 열고 **DynamicSpawner** 섹션을 찾습니다.

### 1. General (기본)

| 설정 | 기본값 | 설명 |
|------|--------|------|
| Enabled | true | 모드 활성화/비활성화 |

### 2. Timing (타이밍)

| 설정 | 기본값 | 범위 | 설명 |
|------|--------|------|------|
| Spawn Interval | 180초 | 30~1200 | 웨이브 간격 |
| Spawn Delay | 5초 | 0.5~10 | 개별 봇 스폰 딜레이 |

### 3. Distance (거리)

| 설정 | 기본값 | 범위 | 설명 |
|------|--------|------|------|
| Min Spawn Distance | 200m | 20~900 | 최소 스폰 거리 |
| Max Spawn Distance | 300m | 50~1000 | 최대 스폰 거리 |
| Min Distance Between Spawns | 15m | 5~200 | 그룹 간 최소 간격 |

### 4. Bot Count (봇 수)

| 설정 | 기본값 | 범위 | 설명 |
|------|--------|------|------|
| Min Bots Per Wave | 3 | 1~20 | 웨이브당 최소 봇 수 |
| Max Bots Per Wave | 8 | 1~30 | 웨이브당 최대 봇 수 |
| Spawn Chance Per Slot | 50% | 0~100 | 각 슬롯 스폰 확률 |

### 5. Bot Types (봇 타입) ⭐ 핵심 설정

#### 기본 시스템 (PMC/Scav)

| 설정 | 기본값 | 설명 |
|------|--------|------|
| A. Use Default Bot Types | true | PMC/Scav 시스템 사용 |
| B. PMC Spawn Chance | 30% | PMC 확률 (나머지 Scav) |

#### 커스텀 봇 타입 시스템

| 설정 | 기본값 | 설명 |
|------|--------|------|
| C. Use Custom Bot Types | false | 커스텀 시스템 활성화 |
| D. 1st Bot Type | Raider | 첫 번째 봇 타입 |
| E. 1st Bot Max Cap | 5 | 1st 타입 맵 내 최대 수 |
| F. 2nd Bot Type | PMC/Rogue | 두 번째 봇 타입 |
| G. 2nd Bot Max Cap | 5 | 2nd 타입 맵 내 최대 수 |
| H. 2nd Bot Type Ratio | 50% | 2nd 타입 선택 확률 |
| I. Bot Difficulty | normal | easy/normal/hard/impossible/random |

**선택 가능한 봇 타입:**
- **PMC**: PMC(랜덤), Bear, Usec
- **Scav**: Scav, CursedScav, Marksman
- **Special**: Raider, Rogue
- **Bosses**: Reshala, Gluhar, Killa, Knight, Shturman, Kolontay, Partisan, Sanitar, Tagilla, Zryachiy, Kaban
- **Cultists**: CultistPriest, CultistWarrior, CultistOni 등
- **Infected(좀비)**: InfectedAssault, InfectedCivil, InfectedPmc 등

### 6. Group Spawning (그룹)

| 설정 | 기본값 | 설명 |
|------|--------|------|
| Disable Scav Group Spawning | false | Scav 그룹 스폰 비활성화 |
| Group Spawn Chance | 25% | 그룹 스폰 확률 |
| Min Group Size | 2 | 최소 그룹 크기 |
| Max Group Size | 5 | 최대 그룹 크기 |

### 7. Advanced (고급)

| 설정 | 기본값 | 설명 |
|------|--------|------|
| Max Spawn Attempts | 3 | 위치 탐색 최대 시도 |
| Debug Mode | false | 상세 로그 출력 |
| Allow Spawn In Player Sight | true | 시야 내 스폰 허용 |
| Player Sight Spawn Priority | 70% | 시야 내 스폰 우선도 |

---

## 🎯 설정 예시

### 예시 1: 레이더 + 로그 전용
```
Use Default Bot Types: OFF
Use Custom Bot Types: ON
1st Bot Type: Raider
1st Bot Max Cap: 5
2nd Bot Type: Rogue
2nd Bot Max Cap: 5
2nd Bot Type Ratio: 45%
```
→ 레이더 55%, 로그 45% 확률, 각각 최대 5명

### 예시 2: 하드코어 보스 사냥
```
Use Default Bot Types: OFF
Use Custom Bot Types: ON
1st Bot Type: BossKilla
1st Bot Max Cap: 2
2nd Bot Type: BossTagilla
2nd Bot Max Cap: 2
2nd Bot Type Ratio: 50%
Bot Difficulty: impossible
```

### 예시 3: 좀비 아포칼립스
```
Use Default Bot Types: OFF
Use Custom Bot Types: ON
1st Bot Type: InfectedAssault
1st Bot Max Cap: 15
2nd Bot Type: InfectedPmc
2nd Bot Max Cap: 5
2nd Bot Type Ratio: 25%
Spawn Interval: 60
```

### 예시 4: 밸런스 혼합 (기본 + 커스텀)
```
Use Default Bot Types: ON
PMC Spawn Chance: 30%
Use Custom Bot Types: ON
1st Bot Type: Raider
1st Bot Max Cap: 3
2nd Bot Type: CultistWarrior
2nd Bot Max Cap: 3
```
→ 50%는 PMC/Scav, 50%는 레이더/컬티스트

---

## ⚠️ 주의사항

1. **다른 스폰 모드와 충돌 가능**: SWAG, Donuts 등과 함께 사용 시 주의
2. **성능 영향**: 많은 봇 + 짧은 간격 설정 시 프레임 저하 가능
3. **보스 스폰 제한**: 일부 보스는 특정 맵에서만 정상 동작
4. **Max Cap 주의**: 너무 높게 설정하면 게임 불안정

---

## 📋 문제 해결

| 증상 | 해결 방법 |
|------|----------|
| 봇이 안 나옴 | Debug Mode 켜고 로그 확인, 거리 설정 확인 |
| 게임 크래시 | Max Cap 낮추기, 스폰 간격 늘리기 |
| 봇끼리 싸움 | 그룹 설정 확인 |

---

**버전**: 1.0.7  
**호환**: SPT 3.9 / 3.10 / 4.0