Files
asciinevrdie/doc/task-phase-07-content.md
JiWoong Sul 9ad0cf4b74 docs(phase7): ASCII 애니메이션 4색 팔레트 시스템 추가
- 흰색: 오브젝트 (캐릭터, 몬스터, 아이템)
- 시안: 포지티브 이펙트 (힐, 버프, 레벨업)
- 마젠타: 네거티브 이펙트 (데미지, 디버프, 사망)
- 검정: 배경
- 색상 변경 버튼 제거 예정
2025-12-17 16:17:35 +09:00

124 lines
3.8 KiB
Markdown

# Phase 7: 콘텐츠 확장
> 메인 문서: [game-system-overhaul-index.md](game-system-overhaul-index.md)
---
## 목표
더 많은 몬스터, 아이템, 애니메이션을 추가한다.
## 몬스터 확장
현재: ~100종
목표: ~200종
추가할 몬스터 카테고리:
- 레벨 81-100 엔드게임 몬스터 (30종)
- 보스 몬스터 (10종, 각 Act 마다)
- 미니 보스 (20종)
- 특수 이벤트 몬스터 (20종)
- 퀘스트 전용 몬스터 (20종)
## 아이템 확장
현재: 이름만 존재
목표: 스탯이 있는 300+ 아이템
카테고리별 추가:
- 무기 (50종): 검, 도끼, 활, 지팡이, 단검 등
- 방어구 (80종): 투구, 갑옷, 장갑, 부츠, 망토
- 방패 (30종)
- 악세서리 (50종): 반지, 목걸이, 귀걸이
- 소모품 (50종): 물약, 스크롤
## ASCII 애니메이션 확장
### 전투 결과별 애니메이션
| 상황 | 애니메이션 |
|------|----------|
| 일반 공격 | 기존 battle_mode |
| 크리티컬 히트 | 화려한 이펙트 |
| 회피 성공 | 살짝 비켜가는 모션 |
| 방패 방어 | 방패 들어올리기 |
| 스킬 사용 | 스킬별 고유 애니메이션 |
| 사망 | 쓰러지는 애니메이션 |
| 레벨업 | 빛나는 이펙트 |
### 몬스터별 애니메이션
```dart
class MonsterAnimation {
final String monsterId;
final List<String> idleFrames;
final List<String> attackFrames;
final List<String> hitFrames;
final List<String> deathFrames;
}
```
카테고리별 기본 애니메이션:
- 버그류 (곤충 형태)
- 언데드류 (좀비, 유령)
- 드래곤류 (대형)
- 휴머노이드류 (NPC형)
- 기계류 (로봇, 바이러스)
### ASCII 애니메이션 색상 시스템
4색 팔레트를 사용하여 시각적 명확성을 확보한다.
| 색상 | 용도 | 예시 |
|------|------|------|
| **흰색** | 오브젝트 (캐릭터, 몬스터, 아이템) | 플레이어, 적, 무기 |
| **시안** | 포지티브 이펙트 | 힐, 버프, 레벨업, 획득 |
| **마젠타** | 네거티브 이펙트 | 데미지, 디버프, 사망, 손실 |
| **검정** | 배경 | 기본 배경색 |
```dart
class AsciiColors {
static const Color object = Colors.white; // 오브젝트
static const Color positive = Colors.cyan; // 포지티브 이펙트
static const Color negative = Colors.magenta; // 네거티브 이펙트
static const Color background = Colors.black; // 배경
}
```
#### 색상 적용 예시
| 상황 | 주 색상 | 보조 색상 |
|------|--------|----------|
| 일반 전투 | 흰색 (캐릭터) | - |
| 크리티컬 히트 | 흰색 (캐릭터) | 마젠타 (이펙트) |
| 힐/버프 획득 | 흰색 (캐릭터) | 시안 (이펙트) |
| 독/저주 | 흰색 (캐릭터) | 마젠타 (이펙트) |
| 레벨업 | 흰색 (캐릭터) | 시안 (빛나는 효과) |
| 사망 | 마젠타 (전체) | - |
| 아이템 획득 | 시안 (하이라이트) | - |
#### UI 변경 사항
- **색상 변경 버튼 제거**: 기존 사용자 색상 선택 기능 삭제
- **고정 팔레트 적용**: 위 4색 체계로 통일
- **기존 설정 마이그레이션**: 저장된 색상 설정 무시, 기본값 사용
## 수정 대상 파일
| 파일 | 변경 내용 |
|------|----------|
| `data/pq_config_data.dart` | 몬스터/아이템 데이터 확장 |
| `data/ascii_animation_data.dart` | 애니메이션 프레임 추가 |
| `data/monster_animations.dart` | **신규** - 몬스터별 애니메이션 |
| `core/constants/ascii_colors.dart` | **신규** - 4색 팔레트 상수 정의 |
| `features/game/widgets/ascii_animation_card.dart` | 상황별 애니메이션 선택, 색상 시스템 적용 |
| `features/game/widgets/color_picker_button.dart` | **삭제** - 색상 변경 버튼 제거 |
## 예상 작업량
- 예상 파일 수: 4-5개
- 신규 코드: ~1000 LOC (대부분 데이터)
- 수정 코드: ~200 LOC
---