Files
novafarma/docs/CHARACTER_ANIMATION_MANIFEST.md
2026-01-20 01:05:17 +01:00

185 lines
4.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 🎬 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