From 93c1c7f2d13161723c09ec46c0e0a8d5f9ceecc2 Mon Sep 17 00:00:00 2001
From: David Kotnik <hipodevil666@gmail.com>
Date: Tue, 30 Dec 2025 04:01:32 +0100
Subject: [PATCH] docs: Add exact micro farm demo plan - 247 assets, 10 days,
 organized by batches

---
 MICRO_FARM_EXACT_PLAN.md | 584 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 584 insertions(+)
 create mode 100644 MICRO_FARM_EXACT_PLAN.md

diff --git a/MICRO_FARM_EXACT_PLAN.md b/MICRO_FARM_EXACT_PLAN.md
new file mode 100644
index 000000000..781b9b4ec
--- /dev/null
+++ b/MICRO_FARM_EXACT_PLAN.md
@@ -0,0 +1,584 @@
+# 🌾 MICRO FARM START - EXACT DEMO ASSET COUNT
+
+**Created:** 30.12.2025 04:00  
+**Concept:** Game zачne kot **MAJHNA FARMA** (8×8 tiles), potem se širi
+
+---
+
+## 🎮 GAME START CONCEPT
+
+**Player begins:**
+- ✅ Small 8×8 farm plot
+- ✅ 1 tent (starting shelter)
+- ✅ 1 zombie worker (tutorial)
+- ✅ Basic tools (hoe, watering can)
+- ✅ Seeds for 1 crop type (wheat)
+- ✅ Goal: Build farm, unlock more land, find Ana
+
+**Progression:**
+1. Micro farm (8×8) → Start here!
+2. Small farm (16×16) → Week 1 expansion
+3. Medium farm (32×32) → Week 2 expansion
+4. Large farm (64×64) → End game
+
+---
+
+## 📊 EXACT ASSET COUNT FOR DEMO
+
+### **TOTAL: 247 ASSETS** (exact, not approximate)
+
+---
+
+## 🎯 BREAKDOWN BY CATEGORY
+
+### **1. MAIN CHARACTER - KAI: 45 assets**
+
+**Idle Animation (16 frames):**
+- kai_idle_north_1.png
+- kai_idle_north_2.png
+- kai_idle_north_3.png
+- kai_idle_north_4.png
+- kai_idle_south_1.png (×4 frames)
+- kai_idle_east_1.png (×4 frames)
+- kai_idle_west_1.png (×4 frames)
+
+**Walk Animation (16 frames):**
+- kai_walk_north_1.png (×4 frames)
+- kai_walk_south_1.png (×4 frames)
+- kai_walk_east_1.png (×4 frames)
+- kai_walk_west_1.png (×4 frames)
+
+**Run Animation (8 frames):**
+- kai_run_east_1.png (×4 frames)
+- kai_run_west_1.png (×4 frames)
+
+**Actions (5 frames):**
+- kai_hoe_action.png (digging)
+- kai_watering.png
+- kai_pickup.png
+- kai_portrait.png (dialogue)
+- kai_sleeping.png (in tent)
+
+**SUBTOTAL: 45 assets**
+
+---
+
+### **2. ZOMBIE WORKER: 12 assets**
+
+**Animations:**
+- zombie_idle_1.png (×4 frames)
+- zombie_walk_1.png (×4 frames)
+- zombie_dig_1.png (×4 frames)
+
+**SUBTOTAL: 12 assets**
+
+---
+
+### **3. FARM BUILDINGS: 8 assets**
+
+**Essential Structures:**
+1. tent.png (DONE - already have!)
+2. tent_interior.png (inside view for cutscene)
+3. shack.png (first upgrade)
+4. campfire.png (cooking)
+5. storage_chest.png (DONE - already have!)
+6. water_well.png
+7. scarecrow.png (decoration/function)
+8. compost_bin.png
+
+**SUBTOTAL: 8 assets**
+
+---
+
+### **4. TERRAIN TILES: 24 assets**
+
+**Grass (8 variations):**
+- grass_tile_1.png
+- grass_tile_2.png
+- grass_tile_3.png
+- grass_tile_4.png
+- grass_corner_ne.png
+- grass_corner_nw.png
+- grass_corner_se.png
+- grass_corner_sw.png
+
+**Dirt (8 variations):**
+- dirt_tile_1.png through dirt_tile_4.png
+- dirt_corner_ne/nw/se/sw.png
+
+**Tilled Soil (4):**
+- tilled_dry.png
+- tilled_watered.png
+- tilled_planted.png
+- tilled_growing.png
+
+**Path (4):**
+- stone_path_straight.png
+- stone_path_corner.png
+- stone_path_cross.png
+- stone_path_end.png
+
+**SUBTOTAL: 24 assets**
+
+---
+
+### **5. CROPS - WHEAT (Tutorial Crop): 8 assets**
+
+**Growth Stages:**
+1. wheat_seeds.png (icon)
+2. wheat_stage0.png (just planted, soil bump)
+3. wheat_stage1.png (sprout emerging)
+4. wheat_stage2.png (young plant)
+5. wheat_stage3.png (tall growing)
+6. wheat_stage4.png (golden, ready to harvest)
+7. wheat_harvested.png (cut stalks)
+8. wheat_bundle.png (inventory item)
+
+**SUBTOTAL: 8 assets**
+
+---
+
+### **6. FARM TOOLS & ITEMS: 18 assets**
+
+**Tools:**
+1. wooden_hoe.png
+2. watering_can.png
+3. wooden_axe.png
+4. wooden_pickaxe.png
+5. fishing_rod.png (bonus activity)
+6. scythe.png (harvesting)
+
+**Resources:**
+7. wood_log.png
+8. stone.png
+9. iron_ore.png
+10. stick.png
+11. fiber.png
+
+**Products:**
+12. wheat_flour.png
+13. bread.png
+14. water_bucket.png
+
+**Special Items:**
+15. mothers_locket.png
+16. sleeping_bag.png
+17. backpack.png (Kai's)
+18. coin.png
+
+**SUBTOTAL: 18 assets**
+
+---
+
+### **7. ENVIRONMENT DECORATIONS: 20 assets**
+
+**Trees:**
+1. oak_tree.png (DONE - already have!)
+2. oak_tree_stump.png (after chopping)
+3. pine_tree.png
+4. dead_tree.png
+
+**Rocks & Minerals:**
+5. rock_large.png (DONE - already have!)
+6. rock_medium.png
+7. rock_small.png
+8. iron_ore_deposit.png
+
+**Plants:**
+9. bush_green.png (DONE - already have!)
+10. bush_berries.png
+11. flower_yellow.png
+12. flower_purple.png
+13. grass_tall.png
+14. weeds.png
+
+**Farm Decorations:**
+15. wooden_fence.png (DONE - already have!)
+16. fence_gate.png
+17. fence_corner.png
+18. wooden_sign.png
+19. lantern_post.png
+20. rain_barrel.png
+
+**SUBTOTAL: 20 assets**
+
+---
+
+### **8. NPCs (Demo Essential): 15 assets**
+
+**Trader (3 assets):**
+- npc_trader_idle.png (clearly visible eyes & mouth!)
+- npc_trader_portrait.png
+- npc_trader_happy.png (expression variant)
+
+**Blacksmith (3 assets):**
+- npc_blacksmith_idle.png
+- npc_blacksmith_portrait.png
+- npc_blacksmith_neutral.png
+
+**Healer/Doctor (3 assets):**
+- npc_healer_idle.png
+- npc_healer_portrait.png
+- npc_healer_smile.png
+
+**Mysterious Traveler (3 assets) - Ana clue giver:**
+- npc_traveler_idle.png
+- npc_traveler_portrait.png
+- npc_traveler_mysterious.png
+
+**Ana (3 assets - flashbacks/portrait):**
+- ana_portrait.png (locket photo)
+- ana_child.png (flashback)
+- ana_teen.png (memory)
+
+**SUBTOTAL: 15 assets**
+
+---
+
+### **9. ENEMIES (Basic Combat): 18 assets**
+
+**Basic Zombie (12 frames):**
+- zombie_enemy_idle_1.png (×4 frames)
+- zombie_enemy_walk_1.png (×4 frames)
+- zombie_enemy_attack_1.png (×4 frames)
+
+**Zombie Variants (3):**
+- zombie_runner.png (fast type)
+- zombie_bloated.png (tank type)
+- zombie_corpse.png (dead on ground)
+
+**Wild Animal Threat (3):**
+- wild_wolf.png (aggressive)
+- wolf_attack.png
+- wolf_dead.png
+
+**SUBTOTAL: 18 assets**
+
+---
+
+### **10. UI ELEMENTS: 35 assets**
+
+**HUD (9):**
+1. health_bar_frame.png
+2. health_bar_fill.png (DONE - already have!)
+3. stamina_bar_frame.png
+4. stamina_bar_fill.png
+5. hunger_bar_frame.png
+6. hunger_bar_fill.png
+7. day_indicator.png
+8. time_clock.png
+9. coin_counter_icon.png
+
+**Inventory (8):**
+10. inventory_panel.png
+11. inventory_slot_empty.png (DONE - already have!)
+12. inventory_slot_hover.png
+13. inventory_slot_selected.png
+14. hotbar_panel.png
+15. hotbar_slot.png (×1-9 quickslots)
+16. item_count_bg.png
+17. cursor_normal.png
+
+**Dialogue System (6):**
+18. dialogue_box.png
+19. dialogue_portrait_frame.png
+20. dialogue_continue_arrow.png
+21. dialogue_choice_button.png
+22. name_tag_bg.png
+23. speech_bubble.png
+
+**Quest/Markers (4):**
+24. quest_marker_icon.png
+25. quest_panel.png
+26. quest_complete_check.png
+27. exclamation_mark.png
+
+**Menus (8):**
+28. button_normal.png
+29. button_hover.png
+30. button_pressed.png
+31. panel_background.png
+32. title_card.png
+33. pause_menu_bg.png
+34. settings_icon.png
+35. close_button.png
+
+**SUBTOTAL: 35 assets**
+
+---
+
+### **11. CUTSCENE/SPECIAL ASSETS: 12 assets**
+
+**Opening Sequence:**
+1. tent_interior_dawn.png
+2. locket_open.png (animated)
+3. locket_closed.png
+
+**Flashbacks (5 scenes):**
+4. flashback_babies.png (hospital twins)
+5. flashback_children.png (child Kai protecting Ana)
+6. flashback_family.png (happy family photo)
+7. flashback_troll.png (troll attack scene)
+8. flashback_ana_screaming.png (Ana being taken)
+
+**Effects:**
+9. fade_black_overlay.png
+10. vignette.png
+11. dust_particle.png
+12. sparkle_effect.png
+
+**SUBTOTAL: 12 assets**
+
+---
+
+### **12. EFFECTS & ANIMATIONS: 32 assets**
+
+**Water Animation (4):**
+- water_tile_frame1.png
+- water_tile_frame2.png
+- water_tile_frame3.png
+- water_tile_frame4.png
+
+**Campfire Animation (4):**
+- campfire_flame1.png (DONE - already have!)
+- campfire_flame2.png
+- campfire_flame3.png
+- campfire_flame4.png
+
+**Weather (8):**
+- rain_drop.png (×4 frames)
+- cloud_light.png
+- cloud_dark.png
+- sun_ray.png
+- fog_overlay.png
+
+**Impact Effects (8):**
+- hit_spark1.png
+- hit_spark2.png
+- slash_effect.png
+- dig_dirt_spray.png
+- water_splash.png
+- level_up_glow.png
+- heal_particles.png
+- damage_number_template.png
+
+**UI Animations (8):**
+- loading_spinner_1.png (×4 frames)
+- quest_marker_pulse1.png
+- quest_marker_pulse2.png
+- coin_spin1.png
+- coin_spin2.png
+
+**SUBTOTAL: 32 assets**
+
+---
+
+## 📊 FINAL EXACT COUNT
+
+| Category | Exact Count | Status |
+|:---------|:----------:|:------:|
+| 1. Kai Character | 45 | ⚠️ Need |
+| 2. Zombie Worker | 12 | ⚠️ Need |
+| 3. Buildings | 8 | ⏳ 2/8 done |
+| 4. Terrain Tiles | 24 | ⚠️ Need |
+| 5. Crops (Wheat) | 8 | ⚠️ Need |
+| 6. Tools & Items | 18 | ⏳ 3/18 done |
+| 7. Environment | 20 | ⏳ 4/20 done |
+| 8. NPCs | 15 | ⚠️ Need |
+| 9. Enemies | 18 | ⏳ 1/18 done |
+| 10. UI Elements | 35 | ⏳ 2/35 done |
+| 11. Cutscenes | 12 | ⚠️ Need |
+| 12. Effects/Animations | 32 | ⏳ 1/32 done |
+| **TOTAL** | **247** | **13 done, 234 needed** |
+
+---
+
+## 🎯 WHAT WE ALREADY HAVE (From Tonight)
+
+**Done (13):**
+1. ✅ tent.png
+2. ✅ storage_chest.png
+3. ✅ campfire.png
+4. ✅ fence.png
+5. ✅ oak_tree.png
+6. ✅ rock_large.png
+7. ✅ bush.png
+8. ✅ health_bar.png
+9. ✅ inventory_slot.png
+10. ✅ zombie_sample.png
+11. ✅ campfire_flame1.png
+12. Plus ~60 test samples (various)
+
+**NEED:** 234 more assets
+
+---
+
+## 📅 GENERATION SCHEDULE (Exact Plan)
+
+### **BATCH 1 (Day 1 - Jan 1): Kai Character - 45 assets**
+**All Kai animations + actions**
+- Morning: idle + walk (32 frames)
+- Afternoon: run + actions (13 frames)
+
+**Why first:** Can't test ANYTHING without player character!
+
+---
+
+### **BATCH 2 (Day 2): Core Gameplay - 44 assets**
+**Zombie worker (12) + Terrain tiles (24) + Wheat (8)**
+
+**Why second:** After Kai, need ground to walk on + farming basics!
+
+---
+
+### **BATCH 3 (Day 3): Buildings & Tools - 26 assets**
+**Remaining buildings (6) + All tools & items (18) + Fence pieces (2)**
+
+**Why third:** Can test building & harvesting!
+
+---
+
+### **BATCH 4 (Day 4): Environment - 16 assets**
+**Remaining decorations, trees, rocks**
+
+**Why fourth:** World feels alive!
+
+---
+
+### **BATCH 5 (Day 5): NPCs - 15 assets**
+**All 5 NPCs with expressions**
+
+**Why fifth:** Dialogue & trading functional!
+
+---
+
+### **BATCH 6 (Day 6): Enemies & Combat - 18 assets**
+**All enemy animations**
+
+**Why sixth:** Combat testable!
+
+---
+
+### **BATCH 7 (Day 7): UI Elements - 35 assets**
+**All HUD, inventory, dialogue, menus**
+
+**Why seventh:** Polish the interface!
+
+---
+
+### **BATCH 8 (Week 2 Day 1): Cutscenes - 12 assets**
+**Opening sequence complete!**
+
+---
+
+### **BATCH 9 (Week 2 Day 2-3): Effects - 32 assets**
+**Water, fire, weather, impacts**
+
+**Why last:** Polish, not essential for core gameplay!
+
+---
+
+## ⏰ TIMELINE
+
+**Week 1 (7 days):**
+- Day 1: Batch 1 (45) = 45 total
+- Day 2: Batch 2 (44) = 89 total
+- Day 3: Batch 3 (26) = 115 total
+- Day 4: Batch 4 (16) = 131 total
+- Day 5: Batch 5 (15) = 146 total
+- Day 6: Batch 6 (18) = 164 total
+- Day 7: Batch 7 (35) = 199 total
+
+**Week 2 (2 days):**
+- Day 8: Batch 8 (12) = 211 total
+- Day 9-10: Batch 9 (32) = 243 total
+- Buffer: 4 assets = **247 TOTAL** ✅
+
+---
+
+## ✅ DEMO READY MILESTONES
+
+**Day 1 (45 assets):** Can move Kai around! ✅  
+**Day 2 (89 assets):** Can farm wheat! ✅  
+**Day 3 (115 assets):** Can build & harvest! ✅  
+**Day 7 (199 assets):** Full gameplay loop! ✅  
+**Day 10 (247 assets):** DEMO COMPLETE! 🎉
+
+---
+
+## 💰 COST
+
+**Using Google Free Tier:**
+- 247 assets in 10 days
+- Well within 1,000/month free quota
+- **COST: 0€** ✅
+
+**If using paid (speed boost):**
+- 247 × $0.02 = **$4.94**
+
+---
+
+## 🎮 DEMO GAMEPLAY FEATURES
+
+**With These 247 Assets, Players Can:**
+
+✅ Control Kai (walk, run, idle, actions)  
+✅ Command zombie worker (dig, plant, harvest)  
+✅ Farm wheat (full growth cycle)  
+✅ Build structures (tent → shack upgrade)  
+✅ Gather resources (chop trees, mine rocks)  
+✅ Craft items (bread from wheat)  
+✅ Talk to NPCs (4 characters with dialogue)  
+✅ Trade items (buy/sell with trader)  
+✅ Fight enemies (zombies, wolves)  
+✅ Complete quests (fetch, kill, build)  
+✅ Watch cutscenes (opening + flashbacks)  
+✅ Progress farm (8×8 → 16×16 expansion hint)
+
+**Demo Length:** 15-20 minutes  
+**Gameplay Loop:** ✅ Complete!  
+**Kickstarter Ready:** ✅ YES!
+
+---
+
+## 📋 TOMORROW MORNING START
+
+**When you wake up:**
+
+1. ☐ Open `MICRO_FARM_EXACT_PLAN.md`
+2. ☐ Review tonight's samples
+3. ☐ **Decide:** Google Cloud setup or Manual?
+4. ☐ **START BATCH 1:** Kai animations (45 assets)
+
+**Commands to run:**
+```bash
+# If autonomous:
+python3 scripts/autonomous_generation.py --batch 45
+
+# If manual:
+# Tell me: "Start Batch 1 - Kai animations"
+```
+
+---
+
+## ✅ SUCCESS CRITERIA
+
+**Demo is DONE when you have:**
+- ✅ All 247 assets generated
+- ✅ White backgrounds removed (batch process)
+- ✅ Assets integrated into game
+- ✅ 15-20 min playable demo
+- ✅ Opening cutscene works
+- ✅ Tutorial playable
+- ✅ Can farm, build, fight, trade
+
+**Timeline:** 10 days  
+**Cost:** 0€  
+**Result:** Kickstarter-ready demo! 🚀
+
+---
+
+**Created:** 30.12.2025 04:00  
+**Total Assets:** **247 EXACT**  
+**Timeline:** 10 days  
+**Status:** READY TO START! ✅