docs: 게임 시스템 개편 계획 문서 분리

- 121KB 단일 문서를 22개 태스크 문서로 분리
- 메인 인덱스 문서 (game-system-overhaul-index.md) 생성
- Phase 1-10 태스크 문서 10개 분리
- 추가 시스템 태스크 문서 10개 분리
- 재미 요소 설계 문서 1개 분리
- 기존 문서는 archive/ 폴더로 이동
This commit is contained in:
JiWoong Sul
2025-12-16 19:33:57 +09:00
parent 9dfa465e0a
commit b110b2dc53
24 changed files with 7142 additions and 1502 deletions

View File

@@ -0,0 +1,66 @@
# Phase 5: 종족/클래스 특화
> 메인 문서: [game-system-overhaul-index.md](game-system-overhaul-index.md)
---
## 목표
종족과 클래스에 고유한 능력치 보정과 특수 능력을 부여한다.
## 종족 특성
```dart
class RaceTraits {
final String raceId;
final Map<StatType, int> statModifiers; // 스탯 보정
final List<PassiveAbility> passives; // 패시브 능력
final double expMultiplier; // 경험치 배율
}
```
| 종족 | STR | CON | DEX | INT | WIS | CHA | 특수 능력 |
|------|-----|-----|-----|-----|-----|-----|----------|
| Byte Human | 0 | 0 | 0 | 0 | 0 | +2 | 경험치 +10% |
| Null Elf | -1 | -1 | +2 | +2 | 0 | 0 | 마법 데미지 +15% |
| Buffer Dwarf | +2 | +2 | -1 | -1 | 0 | 0 | 방어력 +10% |
| Stack Goblin | -1 | -1 | +3 | 0 | 0 | +1 | 크리티컬 확률 +5% |
| Heap Troll | +3 | +3 | -2 | -2 | 0 | 0 | HP +20% |
| Pointer Fairy | -2 | -2 | +2 | +2 | +2 | 0 | MP +20% |
| Coredump Undead | +1 | +2 | -1 | 0 | 0 | -2 | 사망 시 장비 1개 유지 |
## 클래스 특성
```dart
class ClassTraits {
final String classId;
final Map<StatType, int> statModifiers;
final List<String> startingSkills; // 시작 스킬
final List<String> classSkills; // 클래스 전용 스킬
final EquipmentRestriction restrictions; // 장비 제한
}
```
| 클래스 | 주요 스탯 | 장비 제한 | 특수 능력 |
|--------|----------|----------|----------|
| Bug Hunter | STR/DEX | 전체 가능 | 일반 공격 +20% |
| Debugger Paladin | STR/CON | 중갑, 방패 | 방어력 +15%, 회복력 +10% |
| Compiler Mage | INT/WIS | 경갑, 지팡이 | 마법 데미지 +25% |
| Refactor Monk | DEX/WIS | 경갑, 맨손 | 회피율 +15%, 연속 공격 |
| Pointer Assassin | DEX/STR | 경갑, 단검 | 크리티컬 +20%, 첫 공격 2배 |
| Garbage Collector | CON/STR | 중갑 | HP +30%, 전투 후 HP 10% 회복 |
## 수정 대상 파일
| 파일 | 변경 내용 |
|------|----------|
| `core/model/race_traits.dart` | **신규** - 종족 특성 |
| `core/model/class_traits.dart` | **신규** - 클래스 특성 |
| `data/race_data.dart` | **신규** - 종족 데이터 |
| `data/class_data.dart` | **신규** - 클래스 데이터 |
| `core/engine/stat_calculator.dart` | **신규** - 최종 스탯 계산 |
| `features/character/character_creation.dart` | 종족/클래스 선택 UI 개선 |
## 예상 작업량
- 예상 파일 수: 6-7개
- 신규 코드: ~400 LOC
- 수정 코드: ~150 LOC