This commit is contained in:
2025-12-09 01:04:14 +09:00
parent f49902c067
commit d544f46766
8 changed files with 302 additions and 208 deletions
+25 -20
View File
@@ -28,39 +28,39 @@
- **턴제 전투:** 플레이어 턴 -> 적 턴.
- **행동 선택:** 공격(Attack) / 방어(Defend).
- **리스크 시스템 (Risk System):**
- **Safe:** 성공률 100%+, 효율 50%.
- **Normal:** 성공률 80%+, 효율 100%.
- **Risky:** 성공률 40%+, 효율 200% (성공 시 강력한 이펙트).
- **Luck 보정:** `totalLuck` 1당 성공률 +1%.
- **Safe:** 성공률 100%+, 효율 50%.
- **Normal:** 성공률 80%+, 효율 100%.
- **Risky:** 성공률 40%+, 효율 200% (성공 시 강력한 이펙트).
- **Luck 보정:** `totalLuck` 1당 성공률 +1%.
- **적 인공지능 (Enemy AI & Intent):**
- **Intent UI:** 적의 다음 행동(공격/방어, 데미지/방어도) 미리 표시.
- **동기화된 애니메이션:** 적 행동 결정(`_generateEnemyIntent`)은 이전 애니메이션이 완전히 끝난 후 이루어짐.
- **선제 방어:** 적이 방어 행동을 선택하면 턴 시작 시 즉시 방어도가 적용됨.
- **Intent UI:** 적의 다음 행동(공격/방어, 데미지/방어도) 미리 표시.
- **동기화된 애니메이션:** 적 행동 결정(`_generateEnemyIntent`)은 이전 애니메이션이 완전히 끝난 후 이루어짐.
- **선제 방어:** 적이 방어 행동을 선택하면 턴 시작 시 **데이터상으로 즉시 방어도가 적용되나, 시각적 애니메이션은 플레이어가 행동을 선택하는 시점에 발동됨.**
- **애니메이션 및 타격감 (Visuals & Impact):**
- **UI 주도 Impact 처리:** 애니메이션 타격 시점(`onImpact`)에 정확히 데미지가 적용되고 텍스트가 뜸 (완벽한 동기화).
- **적 돌진:** 적도 공격 시 플레이어 위치로 돌진함 (설정에서 끄기 가능).
- **이펙트:** 타격 아이콘, 데미지 텍스트(Floating Text), 화면 흔들림(`ShakeWidget`), 폭발(`ExplosionWidget`).
- **UI 주도 Impact 처리:** 애니메이션 타격 시점(`onImpact`)에 정확히 데미지가 적용되고 텍스트가 뜸 (완벽한 동기화).
- **적 돌진:** 적도 공격 시 플레이어 위치로 돌진함 (설정에서 끄기 가능).
- **이펙트:** 타격 아이콘, 데미지 텍스트(Floating Text, Risky 공격 시 크기 확대), 화면 흔들림(`ShakeWidget`), 폭발(`ExplosionWidget`). **적 방어 시 성공/실패 이펙트 추가.**
- **상태이상:** `Stun`, `Bleed`, `Vulnerable`, `DefenseForbidden`.
### C. 데이터 및 로직 (Architecture)
- **Data-Driven:** `items.json`, `enemies.json`, `players.json`.
- **Logic 분리:**
- `BattleProvider`: UI 상태 관리 및 이벤트 스트림(`damageStream`, `effectStream`) 발송.
- `CombatCalculator`: 데미지 공식, 확률 계산, 상태이상 로직 순수 함수화.
- `BattleLogManager`: 전투 로그 관리.
- `LootGenerator`: 아이템 생성, 접두사(Prefix) 부여, 랜덤 스탯 로직.
- `SettingsProvider`: 전역 설정(애니메이션 on/off 등) 관리 및 영구 저장.
- `BattleProvider`: UI 상태 관리 및 이벤트 스트림(`damageStream`, `effectStream`) 발송.
- `CombatCalculator`: 데미지 공식, 확률 계산, 상태이상 로직 순수 함수화. **공격/방어 액션 타입별 효율 분리.**
- `BattleLogManager`: 전투 로그 관리.
- `LootGenerator`: 아이템 생성, 접두사(Prefix) 부여, 랜덤 스탯 로직.
- `SettingsProvider`: 전역 설정(애니메이션 on/off 등) 관리 및 영구 저장.
- **Soft i18n:** UI 텍스트는 `lib/game/config/app_strings.dart`에서 통합 관리.
- **Config:** `GameConfig`, `BattleConfig`, `ItemConfig` 등 설정 값 중앙화.
- **Config:** `GameConfig`, `BattleConfig`, `ItemConfig` 등 설정 값 중앙화. **BattleConfig의 공격/방어 효율 분리.**
### D. 아이템 및 경제
- **장비:** 무기, 방어구, 방패, 장신구.
- **시스템:**
- **Rarity:** Common ~ Unique.
- **Tier:** 라운드 진행도에 따라 상위 티어 아이템 등장.
- **Prefix:** Rarity에 따라 접두사가 붙으며 스탯이 변형됨 (예: "Sharp Wooden Sword").
- **Rarity:** Common ~ Unique.
- **Tier:** 라운드 진행도에 따라 상위 티어 아이템 등장.
- **Prefix:** Rarity에 따라 접두사가 붙으며 스탯이 변형됨 (예: "Sharp Wooden Sword").
- **상점 (`ShopProvider`):** 아이템 구매/판매, 리롤(Reroll), 인벤토리 관리.
### E. 저장 및 진행 (Persistence)
@@ -82,9 +82,14 @@
- **[Refactor] Animation Sync:** `Future.delayed` 예측 방식을 버리고, UI 애니메이션 콜백(`onImpact`)을 통해 로직을 트리거하는 방식으로 변경하여 타격감 동기화 해결.
- **[Refactor] Settings:** `SettingsProvider` 도입 및 적 애니메이션 토글 기능 추가.
- **[Fix] Bugs:** 아이템 이름 생성 오류 수정, 리워드 팝업 깜빡임 및 중복 생성 수정, 앱 크래시(Null Safety) 수정.
- **[Feature] Interactive Enemy Defense Animation:** 플레이어 행동(버튼 클릭) 시점에 적 방어 애니메이션 및 이펙트(`Icon`/`FAILED` 텍스트)가 발동되도록 구현. (데이터는 턴 시작 시 선적용)
- **[Improvement] Turn Responsiveness:** 적 턴 종료 후 플레이어 턴 활성화까지의 불필요한 딜레이 제거 (`_processMiddleTurn`).
- **[Improvement] Visual Impact:** Risky 공격 및 높은 데미지 시 Floating Damage Text의 크기 확대. Floating Effect/Feedback Text의 위치 조정.
- **[Refactor] Balancing System:** `BattleConfig`에서 공격/방어 효율 상수를 분리하고 `CombatCalculator` 및 관련 로직에 적용하여 밸런싱의 유연성 확보.
- **[Fix] UI Stability:** `CharacterStatusCard`의 Intent UI 텍스트 길이에 따른 레이아웃 흔들림 방지 (`FittedBox`). `BattleScreen``Stack` 위젯 구성 문법 오류 수정.
## 5. 다음 단계 (Next Steps)
1. **밸런싱:** 현재 몬스터 및 아이템 스탯 미세 조정.
2. **콘텐츠 확장:** 더 많은 아이템, 적, 스킬 패턴 추가.
3. **튜토리얼:** 신규 유저를 위한 가이드 추가.
3. **튜토리얼:** 신규 유저를 위한 가이드 추가.