# 🎬 COMPLETE ANIMATION MANIFEST
**Main Characters**: Kai, Ana, Gronk  
**Styles**: A (cartoon) & B (noir)  
**Target**: Full game-ready animation sets

---

## 📊 ANIMATION BREAKDOWN

### **PRIORITY 1: CORE MOVEMENT** (Essential for gameplay)

#### **Walk Cycle** (4 directions × 4 frames = 16 frames)
- `walk_north_1.png` through `walk_north_4.png`
- `walk_south_1.png` through `walk_south_4.png`
- `walk_east_1.png` through `walk_east_4.png`
- `walk_west_1.png` through `walk_west_4.png`

#### **Idle Stance** (4 directions × 1 frame = 4 frames)
- `idle_north.png`
- `idle_south.png`
- `idle_east.png`
- `idle_west.png`

**Subtotal Priority 1**: 20 frames × 2 styles = **40 PNG per character**  
**Total Priority 1**: 40 × 3 characters = **120 PNG**

---

### **PRIORITY 2: FARMING ACTIONS** (Core gameplay)

#### **Hoeing** (4 directions × 2 frames = 8 frames)
- `hoe_north_1.png`, `hoe_north_2.png`
- `hoe_south_1.png`, `hoe_south_2.png`
- `hoe_east_1.png`, `hoe_east_2.png`
- `hoe_west_1.png`, `hoe_west_2.png`

#### **Watering** (4 directions × 2 frames = 8 frames)
- `water_north_1.png`, `water_north_2.png`
- `water_south_1.png`, `water_south_2.png`
- `water_east_1.png`, `water_east_2.png`
- `water_west_1.png`, `water_west_2.png`

#### **Planting/Picking** (4 directions × 2 frames = 8 frames)
- `plant_north_1.png`, `plant_north_2.png`
- `plant_south_1.png`, `plant_south_2.png`
- `plant_east_1.png`, `plant_east_2.png`
- `plant_west_1.png`, `plant_west_2.png`

**Subtotal Priority 2**: 24 frames × 2 styles = **48 PNG per character**  
**Total Priority 2**: 48 × 3 characters = **144 PNG**

---

### **PRIORITY 3: COMBAT** (Action gameplay)

#### **Melee Attack** (4 directions × 3 frames = 12 frames)
- `attack_north_1.png` through `attack_north_3.png`
- `attack_south_1.png` through `attack_south_3.png`
- `attack_east_1.png` through `attack_east_3.png`
- `attack_west_1.png` through `attack_west_3.png`

#### **Hit/Hurt** (1 universal frame)
- `hurt.png`

#### **Death** (1 frame)
- `death.png`

**Subtotal Priority 3**: 14 frames × 2 styles = **28 PNG per character**  
**Total Priority 3**: 28 × 3 characters = **84 PNG**

---

### **PRIORITY 4: INTERACTIONS** (Polish)

#### **Interact/Pick Up** (4 directions × 1 frame = 4 frames)
- `interact_north.png`
- `interact_south.png`
- `interact_east.png`
- `interact_west.png`

#### **Carry Item** (4 directions × 1 frame = 4 frames)
- `carry_north.png`
- `carry_south.png`
- `carry_east.png`
- `carry_west.png`

**Subtotal Priority 4**: 8 frames × 2 styles = **16 PNG per character**  
**Total Priority 4**: 16 × 3 characters = **48 PNG**

---

### **PRIORITY 5: RUNNING** (Optional enhancement)

#### **Run Cycle** (4 directions × 4 frames = 16 frames)
- `run_north_1.png` through `run_north_4.png`
- `run_south_1.png` through `run_south_4.png`
- `run_east_1.png` through `run_east_4.png`
- `run_west_1.png` through `run_west_4.png`

**Subtotal Priority 5**: 16 frames × 2 styles = **32 PNG per character**  
**Total Priority 5**: 32 × 3 characters = **96 PNG**

---

## 📈 GRAND TOTAL

| Priority | Description | Frames/Char | PNG/Char | Total PNG |
|:---------|:------------|------------:|---------:|----------:|
| **P1** | Core Movement | 20 | 40 | 120 |
| **P2** | Farming Actions | 24 | 48 | 144 |
| **P3** | Combat | 14 | 28 | 84 |
| **P4** | Interactions | 8 | 16 | 48 |
| **P5** | Running | 16 | 32 | 96 |
| **TOTAL** | **All Animations** | **82** | **164** | **492** |

---

## 🎯 GENERATION STRATEGY

### **Phase 1** (Essential - Day 1):
- Priority 1 (Core Movement): **120 PNG**
- Priority 2 (Farming): **144 PNG**  
**= 264 PNG** (Playable demo ready!)

### **Phase 2** (Combat - Day 2):
- Priority 3 (Combat): **84 PNG**

### **Phase 3** (Polish - Day 3):
- Priority 4 (Interactions): **48 PNG**
- Priority 5 (Running): **96 PNG**

---

## 📋 NAMING CONVENTION

Format: `{character}_{action}_{direction}_{frame}_{style}.png`

**Examples**:
- `kai_walk_north_1_stylea.png`
- `ana_hoe_south_2_styleb.png`
- `gronk_attack_east_3_stylea.png`

---

## 🔧 GENERATION PROMPTS

**Base prompt structure**:
```
Character: [Kai/Ana/Gronk] from reference image
Action: [walking/hoeing/attacking] [direction]
Frame: [1/2/3/4] of animation cycle
Style: [Style A cartoon vector / Style B noir gritty]
Maintain exact character consistency with master reference
Full body, centered, isolated white background, game sprite asset
```

---

## ⏱️ TIME ESTIMATES

**With API quota** (5 req/min = 60/hour):
- Phase 1 (264 PNG): ~4.5 hours
- Phase 2 (84 PNG): ~1.5 hours  
- Phase 3 (144 PNG): ~2.5 hours

**Total**: ~8.5 hours for complete animation sets! 

---

## ✅ DELIVERABLES

**Per character** (Kai, Ana, Gronk):
- ✅ 82 unique animation frames
- ✅ 2 styles each (Style A & B)
- ✅ **164 PNG files per character**
- ✅ Complete animation set ready for Phaser/Tiled integration

**All 3 characters**: **492 PNG total** 🎮

---

**Created**: 31.12.2025  
**Ready for**: 01.01.2026 (quota reset)  
**Status**: ⏰ Awaiting generation start