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

3.8 KiB

Phase 7: 콘텐츠 확장

메인 문서: game-system-overhaul-index.md


목표

더 많은 몬스터, 아이템, 애니메이션을 추가한다.

몬스터 확장

현재: ~100종 목표: ~200종

추가할 몬스터 카테고리:

  • 레벨 81-100 엔드게임 몬스터 (30종)
  • 보스 몬스터 (10종, 각 Act 마다)
  • 미니 보스 (20종)
  • 특수 이벤트 몬스터 (20종)
  • 퀘스트 전용 몬스터 (20종)

아이템 확장

현재: 이름만 존재 목표: 스탯이 있는 300+ 아이템

카테고리별 추가:

  • 무기 (50종): 검, 도끼, 활, 지팡이, 단검 등
  • 방어구 (80종): 투구, 갑옷, 장갑, 부츠, 망토
  • 방패 (30종)
  • 악세서리 (50종): 반지, 목걸이, 귀걸이
  • 소모품 (50종): 물약, 스크롤

ASCII 애니메이션 확장

전투 결과별 애니메이션

상황 애니메이션
일반 공격 기존 battle_mode
크리티컬 히트 화려한 이펙트
회피 성공 살짝 비켜가는 모션
방패 방어 방패 들어올리기
스킬 사용 스킬별 고유 애니메이션
사망 쓰러지는 애니메이션
레벨업 빛나는 이펙트

몬스터별 애니메이션

class MonsterAnimation {
  final String monsterId;
  final List<String> idleFrames;
  final List<String> attackFrames;
  final List<String> hitFrames;
  final List<String> deathFrames;
}

카테고리별 기본 애니메이션:

  • 버그류 (곤충 형태)
  • 언데드류 (좀비, 유령)
  • 드래곤류 (대형)
  • 휴머노이드류 (NPC형)
  • 기계류 (로봇, 바이러스)

ASCII 애니메이션 색상 시스템

4색 팔레트를 사용하여 시각적 명확성을 확보한다.

색상 용도 예시
흰색 오브젝트 (캐릭터, 몬스터, 아이템) 플레이어, 적, 무기
시안 포지티브 이펙트 힐, 버프, 레벨업, 획득
마젠타 네거티브 이펙트 데미지, 디버프, 사망, 손실
검정 배경 기본 배경색
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