novafarma/docs/CHARACTER_ANIMATION_MANIFEST.md

🎬 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