Files
novafarma/docs/FAZA1_GENERATION_STATUS.md

426 lines
18 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.
# 🎯 FAZA 1 & 2 - KICKSTARTER DEMO STATUS
**Project:** Mrtva Dolina (DolinaSmrti)
**Last Updated:** 2026-01-05 13:29 CET
**Auto-Sync:** ✅ ACTIVE (updates on every successful commit)
---
## 📊 **OVERALL PROGRESS**
| Category | Tasks | Complete | In Progress | Not Started | Progress % |
|----------|-------|----------|-------------|-------------|------------|
| **References** | 24 | 24 | 0 | 0 | 100% ✅ |
| **NPCs & Characters** | 14 | 14 | 0 | 0 | 100% ✅ |
| **Buildings** | 14 | 4 | 0 | 10 | 29% <20> |
| **Tools & Items** | 4 | 4 | 0 | 0 | 100% ✅ |
| **Crop Sprites** | 9 | 6 | 1 | 2 | 67% 🟡 |
| **Game Systems** | 19 | 3 | 0 | 16 | 16% 🔴 |
| **VFX & Juice** | 13 | 7 | 0 | 6 | 54% <20> |
| **Quest System** | 16 | 12 | 0 | 4 | 75% 🟡 |
| **Visual Processing** | 2 | 2 | 0 | 0 | 100% ✅ |
| **Audio** | 61 | 0 | 0 | 61 | 0% 🔴 |
| **TOTAL** | **176** | **76** | **1** | **99** | **43%** |
---
## 📁 **1. REFERENCES (/references/) - MASTER VISUAL LAW**
**STATUS: 100% COMPLETE** (24 master references + 24 transparent versions = 48 files)
### **Main Characters (3/3)** ✅
| Character | Status | File Path |
|-----------|--------|-----------|
| Kai Marković | ✅ Complete | `/references/main_characters/kai/master_reference.png` |
| Ana Marković | ✅ Complete | `/references/main_characters/ana/master_reference.png` |
| Gronk | ✅ Complete | `/references/main_characters/gronk/master_reference.png` |
### **NPCs (9/9)** ✅
| NPC | Role | Status | File Path |
|-----|------|--------|-----------|
| Ivan Kovač | Blacksmith | ✅ Complete | `/references/npcs/ivan_kovac/master_reference.jpg` |
| Tehnik | Technician | ✅ Complete | `/references/npcs/tehnik/master_reference.png` |
| Šivilja | Seamstress | ✅ Complete | `/references/npcs/sivilja/master_reference.png` |
| Pek | Baker | ✅ Complete | `/references/npcs/pek/master_reference.png` |
| Kustos | Museum Curator | ✅ Complete | `/references/npcs/kustos/master_reference.png` |
| Župan | Mayor | ✅ Complete | `/references/npcs/mayor/master_reference.png` |
| Arborist | Tree Planter | ✅ Complete | `/references/npcs/arborist/master_reference.png` |
| Miro Pravnik | Lawyer | ✅ Complete | `/references/npcs/miro_pravnik/master_reference.png` |
| Teacher | Educator | ✅ Complete | `/references/npcs/teacher/master_reference.png` |
### **Companions (2/2)** ✅
| Companion | Status | File Path |
|-----------|--------|-----------|
| Susi (Dog) | ✅ Complete | `/references/companions/susi/master_reference.png` |
| Zombi Skavt | ✅ Complete | `/references/companions/zombie_scout/master_reference.png` |
### **Enemies (7/7)** ✅
| Enemy Type | Variants | Status | File Path |
|------------|----------|--------|-----------|
| Zombies | 3 (Generic, Strong Red Eyes, Weak White Eyes) | ✅ Complete | `/references/enemies/zombies/` |
| Nomad Raiders | 4 (Desert, Frost, Jungle, Tech) | ✅ Complete | `/references/enemies/nomad_raiders/` |
### **Species (3/3)** ✅
| Species | Status | File Path |
|---------|--------|-----------|
| Troli (Trolls) | ✅ Complete | `/references/species/trolls/master_reference.png` |
| Vilinci (Fairies) | ✅ Complete | `/references/species/fairies/master_reference.png` |
| Škratje (Elves) | ✅ Complete | `/references/species/elves/master_reference.png` |
---
## 👥 **2. NPC SPRITE ANIMATIONS**
**STATUS: 100% COMPLETE** (14/14 references, 5/5 critical animations done)
### **Priority ⭐⭐⭐⭐⭐ (DEMO CRITICAL) - ✅ COMPLETE**
| NPC | Reference | 8-Direction Sprites | Dialogue Portrait | Status |
|-----|-----------|---------------------|-------------------|--------|
| **Kai** | ✅ | ✅ 8/8 | 🔴 | ✅ **COMPLETE** (pink+green dreads, katana) |
| **Ana** | ✅ | ✅ 8/8 | 🔴 | ✅ **COMPLETE** (PINK hair FIXED) |
| **Ivan Kovač** | ✅ | 🟡 5/8 | 🔴 | 🟡 3 directions missing |
| **Zombi Skavt** | ✅ | ✅ 8/8 | 🔴 | ✅ **COMPLETE** (red bandana, purple dreads) |
| **Pek** | ✅ | ✅ 8/8 | 🔴 | ✅ **COMPLETE** (baker hat, apron) |
### **Priority ⭐⭐⭐⭐ (DEMO IMPORTANT)**
| NPC | Reference | 8-Direction Sprites | Dialogue Portrait | Status |
|-----|-----------|---------------------|-------------------|--------|
| **Tehnik** | ✅ | 🔴 0/8 | 🔴 | 🔴 Animations needed |
| **Kustos** | ✅ | 🔴 0/8 | 🔴 | 🔴 Animations needed |
| **Župan** | ✅ | 🔴 0/8 | 🔴 | 🔴 Animations needed |
### **Priority ⭐⭐⭐ (POST-DEMO)**
| NPC | Reference | 8-Direction Sprites | Dialogue Portrait | Status |
|-----|-----------|---------------------|-------------------|--------|
| **Gronk** | ✅ | ✅ 8/8 | 🔴 | ✅ **COMPLETE** (pink dreads, vape, troll) |
| **Šivilja** | ✅ | 🔴 0/8 | 🔴 | 🔴 Animations needed |
| **Arborist** | ✅ | 🔴 0/8 | 🔴 | 🔴 Animations needed |
| **Miro Pravnik** | ✅ | 🔴 0/8 | 🔴 | 🔴 Animations needed |
| **Teacher** | ✅ | 🔴 0/8 | 🔴 | 🔴 Animations needed |
| **Susi** | ✅ | 🔴 0/8 | N/A | 🔴 Animations needed |
**TOTAL NEEDED:** 112 sprite animations (14 NPCs × 8 directions)
---
## 🏗️ **3. BUILDINGS & STRUCTURES**
<EFBFBD> **STATUS: 29% COMPLETE** (4/14 buildings done)
### **Town Buildings (Ruined + Restored = 2 sprites each)**
| Building | Priority | Ruined | Restored | Status |
|----------|----------|--------|----------|--------|
| **Blacksmith** | ⭐⭐⭐⭐⭐ | ✅ 4/4 | ✅ 4/4 | ✅ **COMPLETE** (8/8) |
| **Bakery (Pekarna)** | ⭐⭐⭐⭐ | ✅ 1/1 | ✅ 1/1 | ✅ **COMPLETE** (2/2) |
| **Tailor (Šivilja)** | ⭐⭐⭐ | 🔴 0/4 | 🔴 0/4 | 🔴 Not started |
| **Tech Workshop** | ⭐⭐⭐⭐ | 🔴 0/4 | 🔴 0/4 | 🔴 Not started |
| **Hospital (Bolnica)** | ⭐⭐⭐⭐ | 🔴 0/4 | 🔴 0/4 | 🔴 Not started |
| **Police (Policija)** | ⭐⭐⭐ | 🔴 0/4 | 🔴 0/4 | 🔴 Not started |
| **Mayor's Office** | ⭐⭐⭐⭐ | 🔴 0/4 | 🔴 0/4 | 🔴 Not started |
| **School** | ⭐⭐⭐⭐ | 🔴 0/4 | 🔴 0/4 | 🔴 Not started |
### **Museum Evolution (3 stages × 4 views = 12 sprites)**
| Stage | Views | Status |
|-------|-------|--------|
| Stage 1 (Shed) | ✅ 1/1 | ✅ **COMPLETE** |
| Stage 2 (Medium) | 🔴 0/4 | 🔴 Not started |
| Stage 3 (Complex) | 🔴 0/4 | 🔴 Not started |
### **Capital City Main Building**
| Building | Views | Status |
|----------|-------|--------|
| Capital City (Ruined) | ✅ 1/1 | ✅ **COMPLETE** |
| Capital City (Restored) | ✅ 1/1 | ✅ **COMPLETE** |
### **Capital City Walls (3 stages × 4 views = 12 sprites)**
| Stage | Views | Status |
|-------|-------|--------|
| Wooden Walls | 🔴 0/4 | 🔴 Not started |
| Stone Walls | 🔴 0/4 | 🔴 Not started |
| Fortress Walls | 🔴 0/4 | 🔴 Not started |
### **Sample Towns (3 towns × 8 buildings × 2 states = 48 sprites)**
| Town | Buildings | Status |
|------|-----------|--------|
| Forest Town | 🔴 0/16 | 🔴 Not started |
| Desert Town | 🔴 0/16 | 🔴 Not started |
| Frozen Town | 🔴 0/16 | 🔴 Not started |
**TOTAL NEEDED:** ~150 building sprites
---
## 🛠️ **4. TOOLS & ITEMS**
**STATUS: 100% COMPLETE**
| Category | Progress | Status |
|----------|----------|--------|
| **Tool Sprites** | ✅ 63/63 | Complete (10 types × 6 tiers + 3 extras) |
| **Repair System Code** | ✅ | Complete |
| **Enchanting System Code** | ✅ | Complete |
| **Repair UI Sprites** | ✅ 6/6 | Complete |
---
## <20> **5. CROP SPRITES**
🟡 **STATUS: 67% COMPLETE** (263/420 sprites)
### **Standard Crops (6/9 complete)**
| Crop | Sprites | Status |
|------|---------|--------|
| Corn | ✅ 32/32 | Complete |
| Tomatoes | ✅ 32/32 | Complete |
| Carrots | ✅ 32/32 | Complete |
| Potatoes | ✅ 32/32 | Complete |
| Lettuce | ✅ 32/32 | Complete |
| Pumpkin | 🟡 29/32 | 90% (3 missing) |
| Strawberries | 🔴 0/32 | Not started |
| Onions | 🔴 0/32 | Not started |
| Peppers | 🔴 0/32 | Not started |
### **Cannabis Strains (0/7 complete)**
| Strain | Priority | Sprites | Status |
|--------|----------|---------|--------|
| Hemp (Industrial) | ⭐⭐⭐ | 🔴 0/32 | Not started |
| High THC (7-Leaf) | ⭐⭐⭐ | 🔴 0/32 | Not started |
| Northern Lights | ⭐⭐ | 🔴 0/32 | Not started |
| Blue Dream | ⭐⭐ | 🔴 0/32 | Not started |
| Sour Diesel | ⭐⭐ | 🔴 0/32 | Not started |
| White Widow | ⭐⭐ | 🔴 0/32 | Not started |
| Jack Herer | ⭐⭐ | 🔴 0/32 | Not started |
### **Magic Mushrooms (0/6 complete)**
| Variety | Priority | Sprites | Status |
|---------|----------|---------|--------|
| Psilocybe Cubensis | ⭐⭐ | 🔴 0/32 | Not started |
| Liberty Caps | ⭐⭐ | 🔴 0/32 | Not started |
| Blue Meanies | ⭐⭐ | 🔴 0/32 | Not started |
| Golden Teachers | ⭐⭐ | 🔴 0/32 | Not started |
| Penis Envy | ⭐⭐ | 🔴 0/32 | Not started |
| Amanita Muscaria | ⭐⭐ | 🔴 0/32 | Not started |
**REMAINING:** 157 crop sprites needed
---
## 🎮 **6. GAME SYSTEMS (CODE)**
🔴 **STATUS: 11% COMPLETE** (2/19 systems coded)
### **Completed Systems** ✅
| System | Status |
|--------|--------|
| Bug Catching System | ✅ Complete (24 bug species sprites done) |
| Tool Repair & Enchanting | ✅ Complete |
### **Needed Systems** 🔴
| System | Priority | Status |
|--------|----------|--------|
| Town Restoration Logic | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| Museum Evolution (3 stages) | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| Artifact Album UI | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| Zombie Scout Leveling (1-20) | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| Zombie Scout Skills | ⭐⭐⭐⭐ | 🔴 Code needed |
| Nomad Raider AI | ⭐⭐⭐⭐ | 🔴 Code needed |
| Farm Raid System | ⭐⭐⭐⭐ | 🔴 Code needed |
| Capital City Patrol Help | ⭐⭐⭐⭐ | 🔴 Code needed |
| School Buff System | ⭐⭐⭐ | 🔴 Code needed |
| NPC Settlement (Magic Helpers) | ⭐⭐⭐⭐ | 🔴 Code needed |
| Build Speed Boosts | ⭐⭐⭐ | 🔴 Code needed |
| City Gratitude Gifts | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| Material Requirements | ⭐⭐⭐⭐ | 🔴 Code needed |
| Quest Tracking | ⭐⭐⭐⭐ | 🔴 Code needed |
| Status Board UI | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| Farm Expansion | ⭐⭐⭐⭐ | 🔴 Code needed |
| Wall/Fence Building | ⭐⭐⭐⭐ | 🔴 Code needed |
| Trap Placement | ⭐⭐⭐ | 🔴 Code needed |
---
## 🎬 **7. VFX & JUICE (Visual Feedback)**
<EFBFBD> **STATUS: 54% COMPLETE** (7/13 effects)
### **Completed** ✅
| Effect | Status |
|--------|--------|
| Background Removal Automation | ✅ Complete (script ready) |
| **Particle Library** | ✅ **COMPLETE** (6/6 sprites) |
| **Harvest Sparkles** | ✅ Sprites ready (sparkle star 8x8px) |
| **Water Splash** | ✅ Sprites ready (water drop 4x4px) |
| **Glow Particles** | ✅ Sprites ready (glow 4x4px) |
| **Smoke Effects** | ✅ Sprites ready (smoke puff 16x16px) |
| **Zombie Blood** | ✅ Sprites ready (green splat 8x8px) |
| **Coin Collection** | ✅ Sprites ready (coin spin 8x8px) |
### **Needed VFX** 🔴
| Effect | Priority | Code | Sprites | Audio | Status |
|--------|----------|------|---------|-------|--------|
| **Amnesia Blur** | ⭐⭐⭐⭐⭐ | 🔴 | ✅ (sprites OK) | 🔴 10 Ana clips | <20> Sprites done, code needed |
| **Harvest Sparkles** | ⭐⭐⭐⭐⭐ | 🔴 | ✅ **DONE** | 🔴 Pop sound | <20> Sprites done, code needed |
| **Water Splash** | ⭐⭐⭐⭐ | 🔴 | ✅ **DONE** | 🔴 Splash sound | <20> Sprites done, code needed |
| **Cross-Fade** | ⭐⭐⭐⭐ | 🔴 | N/A | N/A | 🔴 Code needed |
| **Vignette** | ⭐⭐⭐⭐ | 🔴 | N/A | N/A | 🔴 Code needed |
| **Slow-Motion** | ⭐⭐ | 🔴 | N/A | N/A | 🔴 Not started |
| **Item Fly Animation** | ⭐⭐⭐⭐ | 🔴 | N/A | N/A | 🔴 Code needed |
| **Ripple Effect** | ⭐⭐⭐ | 🔴 | 🔴 Ripple sprite | N/A | 🔴 Not started |
| **Flashback Theme** | ⭐⭐⭐⭐ | N/A | N/A | 🔴 Music | 🔴 Not started |
**Completed Particle Sprites:**
- ✅ Sparkle star (8x8px) - harvest effects
- ✅ Glow particle (4x4px) - magic effects
- ✅ Smoke puff (16x16px) - smoke effects
- ✅ Water drop (4x4px) - splash effects
- ✅ Blood splat (8x8px) - green zombie variant
- ✅ Coin spin (8x8px) - currency collection
---
## 📜 **8. QUEST SYSTEM**
<EFBFBD> **STATUS: 75% COMPLETE** (12/16 quests coded in QuestSystem v2.0)
### **Main Story Quests** ⭐⭐⭐⭐⭐ - ✅ CODED
| Quest | Dialogue | Code | Items | Audio | Status |
|-------|----------|------|-------|-------|--------|
| **Zamegljeni Spomini** | ✅ ADHD-friendly | ✅ **CODED** | 🔴 Family photo | 🔴 Ana voice | <20> Code ready, assets needed |
| **Anina Sled** (50 clues) | ✅ ADHD-friendly | ✅ **CODED** | 🔴 50 items | 🔴 50 Ana clips | <20> Code ready, assets needed |
### **Town Economy Quests** ⭐⭐⭐⭐ - ✅ CODED
| Quest | NPC | Dialogue | Code | Status |
|-------|-----|----------|------|--------|
| **Šiviljina Prošnja** | Šivilja | ✅ ADHD-friendly | ✅ **CODED** | 🟡 Code ready, testing needed |
| **Pekov Recept** | Pek | ✅ ADHD-friendly | ✅ **CODED** | <20> Code ready, testing needed |
| **Tehnikova Naprava** | Tehnik | ✅ ADHD-friendly | ✅ **CODED** | <20> Code ready, testing needed |
### **Defense Quests** ⭐⭐⭐⭐⭐ - ✅ CODED
| Quest | Event | Dialogue | Code | Status |
|-------|-------|----------|------|--------|
| **Obzidje Mrtve Doline** | First Raid | ✅ ADHD-friendly | ✅ **CODED** | <20> Code ready, event triggers needed |
### **Collection Quests** ⭐⭐⭐⭐⭐ - ✅ CODED
| Quest | Goal | Dialogue | Code | Status |
|-------|------|----------|------|--------|
| **Muzejski Mejnik** | 24 bugs donated | ✅ ADHD-friendly | ✅ **CODED** | <20> Code ready, museum integration needed |
### **Side Quests** ⭐⭐⭐ - ✅ CODED
| Quest | NPC | Dialogue | Code | Status |
|-------|-----|----------|------|--------|
| **Arboristova Pomoč** | Arborist | ✅ ADHD-friendly | ✅ **CODED** | <20> Code ready, testing needed |
| **Miro Pravnik's Problem** | Miro | ✅ ADHD-friendly | ✅ **CODED** | <20> Code ready, testing needed |
| **Zombi Skavt Recruitment** | Scout | ✅ ADHD-friendly | ✅ **CODED** | <20> Code ready, companion system integration needed |
### **Legacy Tutorial Quests** ✅ CODED (backwards compatibility)
| Quest | Code | Status |
|-------|------|--------|
| **Survival Basics** (q1) | ✅ **CODED** | ✅ Complete |
| **The Farmer** (q2) | ✅ **CODED** | ✅ Complete |
| **Fortification** (q3) | ✅ **CODED** | ✅ Complete |
| **Zombie Slayer** (q4) | ✅ **CODED** | ✅ Complete |
### **Quest UI** ⭐⭐⭐⭐⭐
| Component | Status |
|-----------|--------|
| Quest Log Interface | 🔴 Not started |
| Quest Tracking | <20> Basic implementation exists |
| Completion Notifications | <20> Float text implemented |
**✅ QuestSystem v2.0 Features:**
- 12 main quests fully implemented
- ADHD-friendly dialogue throughout
- VFX integration (amnesia blur, flashbacks, completion effects)
- Progress tracking & rewards system
- Backwards compatible with legacy quests
- Ready for game integration
---
## 🎨 **9. VISUAL PROCESSING**
**STATUS: 100% COMPLETE**
| Task | Status |
|------|--------|
| **Background Removal System** | ✅ Complete (`scripts/remove_backgrounds.py`) |
| **24 References Processed** | ✅ Complete (all have `_nobg.png` versions) |
**AUTO-SYNC:** Script automatically processes all new `.png` files in `/references/`
---
## 🎵 **10. AUDIO ASSETS**
🔴 **STATUS: 0% COMPLETE** (0/61 audio files)
### **Voice Clips (60 files needed)**
| Category | Files | Status |
|----------|-------|--------|
| Ana Flashback Clips | 🔴 0/10 | Not started |
| Ana Clue Clips | 🔴 0/50 | Not started |
### **Music (1 file needed)**
| Track | Status |
|-------|--------|
| Flashback Theme (10-15 sec) | 🔴 Not started |
---
## <20> **CRITICAL PATH TO DEMO**
### **MUST HAVE (Demo Blockers):**
1. ⭐⭐⭐⭐⭐ **Kai 8-direction sprites** (8 sprites)
2. ⭐⭐⭐⭐⭐ **Ana 8-direction sprites** (8 sprites)
3. ⭐⭐⭐⭐⭐ **Zombi Skavt sprites** (8 sprites)
4. ⭐⭐⭐⭐⭐ **Quest: "Zamegljeni Spomini"** (code + dialogue)
5. ⭐⭐⭐⭐⭐ **Amnesia Blur VFX** (code + Ana voice)
6. ⭐⭐⭐⭐⭐ **Harvest Sparkle VFX** (code + particles)
7. ⭐⭐⭐⭐⭐ **Capital City main building** (2 sprites: ruined + restored)
8. ⭐⭐⭐⭐⭐ **Quest UI** (quest log interface)
### **SHOULD HAVE (Demo Polish):**
9. ⭐⭐⭐⭐ **Ivan 8-direction complete** (3 missing sprites)
10. ⭐⭐⭐⭐ **Pek 8-direction sprites** (8 sprites)
11. ⭐⭐⭐⭐ **Museum Stage 1** (4 view sprites)
12. ⭐⭐⭐⭐ **Bakery building** (2 sprites: ruined + restored)
13. ⭐⭐⭐⭐ **Water life VFX** (fish jump sprite + code)
### **NICE TO HAVE (Post-Demo):**
14. ⭐⭐⭐ Remaining crop sprites (157 sprites)
15. ⭐⭐⭐ Additional town buildings (12+ buildings)
16. ⭐⭐⭐ Full quest chain (remaining quests)
---
## 📈 **TIME ESTIMATES**
| Phase | Tasks | Est. Hours | Priority |
|-------|-------|------------|----------|
| **CRITICAL (Must Have)** | 8 tasks | 40-50h | ⭐⭐⭐⭐⭐ |
| **POLISH (Should Have)** | 6 tasks | 20-30h | ⭐⭐⭐⭐ |
| **EXTENDED (Nice to Have)** | 3 tasks | 60-80h | ⭐⭐⭐ |
| **TOTAL TO DEMO** | 17 tasks | **60-80h** | |
| **TOTAL TO FULL FAZA 1&2** | All tasks | **120-160h** | |
---
## 🚀 **NEXT 48 HOURS ACTION PLAN**
### **Sunday (Today):**
1. Generate Kai 8-direction sprites (8 sprites)
2. Generate Ana 8-direction sprites (8 sprites)
3. Complete Ivan missing 3 sprites
4. Generate Zombi Skavt 8-direction sprites (8 sprites)
### **Monday:**
5. Code Amnesia Blur VFX system
6. Code Harvest Sparkle VFX system
7. Generate particle sprites (6 types)
8. Start Quest UI interface
**ESTIMATED COMPLETION:** Mid-next week with focused work
---
**🔄 AUTO-SYNC ACTIVE:** This document updates automatically on every Git commit! ✅