# 🗺️ MRTVA DOLINA - DEVELOPMENT ROADMAP
**Project:** Krvava Žetev (DolinaSmrti / Bloody Harvest)  
**Version:** Alpha 1.2 → Full Release  
**Updated:** January 5th, 2026 11:06 CET

---

## 📊 FAZA 1 & 2: KICKSTARTER DEMO (Current Priority)

### **👥 NPCs & Characters**

| Kategorija | Naloga | Prioriteta | Status |
|------------|--------|------------|--------|
| **Main Characters** | Kai Marković (pink+green dreads, katana) | ⭐⭐⭐⭐⭐ | 🟡 Master reference needed |
| **Main Characters** | Ana Marković (blonde, blue eyes with pupils) | ⭐⭐⭐⭐⭐ | 🟡 Master reference needed |
| **Main Characters** | Gronk (pink dreads, vape, troll) | ⭐⭐⭐⭐⭐ | 🟡 Master reference needed |
| **Town NPCs** | Ivan Kovač (Blacksmith) | ⭐⭐⭐⭐⭐ | ✅ 5/6 sprites done |
| **Town NPCs** | Mayor/Župan (Town permits) | ⭐⭐⭐⭐ | 🔴 Not started |
| **Town NPCs** | Miro Pravnik (Lawyer) | ⭐⭐⭐ | 🔴 Not started |
| **Town NPCs** | Arborist/Gozdar (Tree planter) | ⭐⭐⭐ | 🔴 Not started |
| **NEW - Town NPCs** | Tehnik (Technician - tech repairs) | ⭐⭐⭐⭐ | 🔴 Not started |
| **NEW - Town NPCs** | Šivilja (Seamstress - clothing) | ⭐⭐⭐ | 🔴 Not started |
| **NEW - Town NPCs** | Pek (Baker - food) | ⭐⭐⭐⭐ | 🔴 Not started |
| **NEW - Town NPCs** | Kustos (Museum Curator) | ⭐⭐⭐⭐ | 🔴 Not started |
| **Companions** | Zombi Skavt (Scout with bandana, Level 1-20) | ⭐⭐⭐⭐⭐ | 🔴 Not started |
| **Magic Helpers** | Troli (Town inhabitants) | ⭐⭐⭐ | 🔴 Not started |
| **Magic Helpers** | Vilinci (Fairies - build speed boost) | ⭐⭐ | 🔴 Not started |
| **Magic Helpers** | Škratje (Elves - build speed boost) | ⭐⭐ | 🔴 Not started |

---

### **🏗️ Buildings & Towns**

| Kategorija | Naloga | Prioriteta | Status |
|------------|--------|------------|--------|
| **Capital City** | THE CAPITAL - Massive main city (furthest from farm) | ⭐⭐⭐⭐⭐ | 🔴 Not started |
| **Capital City** | City walls (3 upgrade stages) | ⭐⭐⭐⭐ | 🔴 Not started |
| **Capital City** | Guard patrols (NPC stražarji) | ⭐⭐⭐⭐ | 🔴 Not started |
| **Capital City** | Staged population system (phased NPC arrival) | ⭐⭐⭐⭐ | 🔴 Not started |
| **Capital City** | Legendary reward system (unique tools) | ⭐⭐⭐⭐⭐ | 🔴 Not started |
| **Town Restoration** | 3 Sample towns (Forest, Desert, Frozen) | ⭐⭐⭐⭐ | 🔴 Not started |
| **Town Buildings** | Blacksmith (ruined + restored) | ⭐⭐⭐⭐⭐ | ✅ 8/8 complete |
| **NEW - Town Buildings** | Bakery/Pekarna (ruined + restored) | ⭐⭐⭐⭐ | 🔴 Not started |
| **NEW - Town Buildings** | Tailor/Šivilja (ruined + restored) | ⭐⭐⭐ | 🔴 Not started |
| **NEW - Town Buildings** | Tech Workshop/Tehnikova (ruined + restored) | ⭐⭐⭐⭐ | 🔴 Not started |
| **NEW - Town Buildings** | Hospital/Bolnica (ruined + restored) | ⭐⭐⭐⭐ | 🔴 Not started |
| **NEW - Town Buildings** | Police/Policija (ruined + restored) | ⭐⭐⭐ | 🔴 Not started |
| **NEW - Town Buildings** | Mayor's Office/Županovo (ruined + restored) | ⭐⭐⭐⭐ | 🔴 Not started |
| **NEW - Museum** | Museum Stage 1 (Small shed/lopa) | ⭐⭐⭐⭐⭐ | 🔴 Not started |
| **NEW - Museum** | Museum Stage 2 (Medium building) | ⭐⭐⭐⭐ | 🔴 Not started |
| **NEW - Museum** | Museum Stage 3 (Futuristic complex) | ⭐⭐⭐⭐ | 🔴 Not started |
| **NEW - School** | School (ruined + restored) | ⭐⭐⭐⭐ | 🔴 Not started |
| **NEW - School** | Teacher NPC (wise old man or robot) | ⭐⭐⭐ | 🔴 Not started |
| **Town UI** | Status board (shows populated NPCs/citizens) | ⭐⭐⭐⭐⭐ | 🔴 Not started |

---

### **🌾 Farm & Agriculture**

| Kategorija | Naloga | Prioriteta | Status |
|------------|--------|------------|--------|
| **Crop System** | 8-stage growth cycle | ⭐⭐⭐⭐⭐ | ✅ Complete (code done) |
| **Crop System** | 4 seasonal variations (Spring/Summer/Fall/Winter) | ⭐⭐⭐⭐⭐ | ✅ Complete (code done) |
| **Crop Sprites** | 6 crops × 32 sprites (Faza 1) | ⭐⭐⭐⭐⭐ | 🟡 263/420 done (62%) |
| **Farm Expansion** | Gradual land expansion system | ⭐⭐⭐⭐ | 🔴 Not started |
| **Farm Defense** | Wall/fence building system | ⭐⭐⭐⭐ | 🔴 Not started |
| **Farm Defense** | Trap placement system | ⭐⭐⭐ | 🔴 Not started |

---

### **🛠️ Tools & Items**

| Kategorija | Naloga | Prioriteta | Status |
|------------|--------|------------|--------|
| **Tools** | All 63 tool sprites (10 types × 6 tiers + 3 extras) | ⭐⭐⭐⭐⭐ | ✅ 63/63 complete |
| **Tool System** | Repair system (Ivan's Blacksmith) | ⭐⭐⭐⭐⭐ | ✅ Code complete |
| **Tool System** | Enchanting system (5 types × 3 levels) | ⭐⭐⭐⭐ | ✅ Code complete |
| **Repair UI** | Repair bench interface | ⭐⭐⭐⭐ | ✅ 6/6 sprites done |

---

### **🎮 Game Systems**

| Kategorija | Naloga | Prioriteta | Status |
|------------|--------|------------|--------|
| **Town Restoration** | Restoration logic (ruined → partial → restored) | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| **Town Restoration** | Material requirement system | ⭐⭐⭐⭐ | 🔴 Code needed |
| **Town Restoration** | Quest completion tracking | ⭐⭐⭐⭐ | 🔴 Code needed |
| **Town Restoration** | City Gratitude Gift system | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| **NEW - Population** | NPC settlement system (Troli, Vilinci, Škratje) | ⭐⭐⭐⭐ | 🔴 Code needed |
| **NEW - Population** | Build speed boost (magic helpers) | ⭐⭐⭐ | 🔴 Code needed |
| **NEW - Museum** | Museum evolution (3 stages based on artifacts) | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| **NEW - Museum** | Artifact album UI | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| **NEW - Museum** | Collection tracking (dinosaurs, artifacts, fish, shells, bugs) | ⭐⭐⭐⭐ | 🔴 Code needed |
| **NEW - School** | School buff system (+15% efficiency next generation) | ⭐⭐⭐ | 🔴 Code needed |
| **Zombie Scout** | Leveling system (1-20) | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| **Zombie Scout** | Shortcut discovery | ⭐⭐⭐⭐ | 🔴 Code needed |
| **Zombie Scout** | Treasure hunting skill | ⭐⭐⭐⭐ | 🔴 Code needed |
| **Zombie Scout** | Danger sense warning | ⭐⭐⭐ | 🔴 Code needed |
| **Nomad Raiders** | Dynamic raid system | ⭐⭐⭐⭐ | 🔴 Code needed |
| **Nomad Raiders** | Farm raid logic (1000+ crops trigger) | ⭐⭐⭐⭐ | 🔴 Code needed |
| **Nomad Raiders** | Caravan ambush (30% chance) | ⭐⭐⭐ | 🔴 Code needed |
| **NEW - Capital Help** | Automated patrol assistance (Capital → Farm defense) | ⭐⭐⭐⭐ | 🔴 Code needed |
| **Bug Catching** | Bug catching system | ⭐⭐⭐⭐⭐ | ✅ Code complete |
| **Bug Sprites** | 24 bug species | ⭐⭐⭐⭐⭐ | ✅ 24/24 complete |

---

### **🎬 VFX & Interactive Effects** ✨ NEW

| Kategorija | Naloga | Prioriteta | Status |
|------------|--------|------------|--------|
| **Amnesia Effect** | Blur-to-clear memory flashbacks | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| **Amnesia Effect** | Ana voice clips (10 audio files) | ⭐⭐⭐⭐⭐ | 🔴 Audio needed |
| **Amnesia Effect** | Flashback music theme | ⭐⭐⭐⭐ | 🔴 Audio needed |
| **Harvest VFX** | Stardew Valley style sparkle bounce | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| **Harvest VFX** | Particle system (sparkles, glow) | ⭐⭐⭐⭐ | 🔴 Code needed |
| **Harvest VFX** | Item-to-inventory flying animation | ⭐⭐⭐⭐ | 🔴 Code needed |
| **Water Life** | Fish jump animation | ⭐⭐⭐⭐ | 🔴 Code + sprites needed |
| **Water Life** | Splash particle effects | ⭐⭐⭐ | 🔴 Code needed |
| **Water Life** | Ripple effect system | ⭐⭐⭐ | 🔴 Code needed |
| **Dynamic Visuals** | Cross-fade scene transitions | ⭐⭐⭐⭐ | 🔴 Code needed |
| **Dynamic Visuals** | Vignette effect (story moments) | ⭐⭐⭐⭐ | 🔴 Code needed |
| **Dynamic Visuals** | Slow-motion effect (epic moments) | ⭐⭐ | 🔴 Code needed |
| **Particle Library** | Sparkle, smoke, magic, coins presets | ⭐⭐⭐⭐ | 🔴 Code needed |

---

### **📜 Quest System** ✨ NEW

| Kategorija | Naloga | Prioriteta | Status |
|------------|--------|------------|--------|
| **Main Story** | Quest: "Zamegljeni Spomini" (unlocks Capital) | ⭐⭐⭐⭐⭐ | 🔴 Code + dialogue needed |
| **Main Story** | Quest: "Anina Sled" (50 clues collection) | ⭐⭐⭐⭐⭐ | 🔴 Code + items needed |
| **Main Story** | 50 Family item clue locations | ⭐⭐⭐⭐⭐ | 🔴 Design + placement needed |
| **Main Story** | Ana voice clips for each clue (50 audio files) | ⭐⭐⭐⭐ | 🔴 Audio production needed |
| **Town Economy** | Quest: "Šiviljina Prošnja" (5 raider leathers) | ⭐⭐⭐⭐ | 🔴 Code + dialogue needed |
| **Town Economy** | Quest: "Pekov Recept" (10 wild berries) | ⭐⭐⭐⭐ | 🔴 Code + dialogue needed |
| **Town Economy** | Quest: "Tehnikova Naprava" (ancient battery) | ⭐⭐⭐⭐⭐ | 🔴 Code + dungeon design |
| **Defense** | Quest: "Obzidje Mrtve Doline" (20 steel bars) | ⭐⭐⭐⭐⭐ | 🔴 Code + raid event |
| **Defense** | First Raid Event (5 Desert Nomads attack) | ⭐⭐⭐⭐⭐ | 🔴 Combat + AI needed |
| **Collections** | Quest: "Muzejski Mejnik" (24 bugs) | ⭐⭐⭐⭐⭐ | 🔴 Code + museum growth |
| **Side Quests** | Quest: "Arboristova Pomoč" (50 trees) | ⭐⭐⭐ | 🔴 Code needed |
| **Side Quests** | Quest: "Miro Pravnik's Problem" (legal docs) | ⭐⭐⭐ | 🔴 Code needed |
| **Side Quests** | Quest: "Zombi Skavt" (scout recruitment) | ⭐⭐⭐⭐⭐ | 🔴 Code needed |
| **Quest UI** | Quest log interface | ⭐⭐⭐⭐⭐ | 🔴 UI design + code |
| **Quest UI** | Quest tracking system | ⭐⭐⭐⭐ | 🔴 Code needed |
| **Quest UI** | Quest completion notifications | ⭐⭐⭐⭐ | 🔴 Code + VFX |

---

### **🎨 Visual Assets**

| Kategorija | Naloga | Prioriteta | Status |
|------------|--------|------------|--------|
| **Asset Browser** | Visual gallery for all assets | ⭐⭐⭐⭐⭐ | ✅ Complete |
| **Reference Folder** | Master references (/references/) | ⭐⭐⭐⭐⭐ | ✅ Complete (24 references) |
| **Visual Cleanup** | Batch background removal (ALL asset folders) | ⭐⭐⭐⭐⭐ | ✅ Complete (1411 images scanned) |
| **Background Removal** | Auto-remove green backgrounds (transparent) | ⭐⭐⭐⭐⭐ | ✅ Complete (33 images processed) |
| **Auto-Clean System** | Automated background removal script | ⭐⭐⭐⭐ | ✅ Complete (scripts/batch_cleanup_all_assets.py) |
| **Map Cleanup** | Remove all status dots from maps | ⭐⭐⭐ | 🔴 Not started |
| **Force Render** | Ensure all new buildings/NPCs visible | ⭐⭐⭐⭐ | 🔴 Not started |

---

## 📊 FAZA 3 & 4: FULL GAME (Post-Demo)

### **🏘️ Extended World**

| Kategorija | Naloga | Prioriteta | Status |
|------------|--------|------------|--------|
| **27 Towns** | Remaining 26 towns (resource outposts) | ⭐⭐⭐ | 🔴 Not started |
| **27 Towns** | Biome-specific architecture (20 styles) | ⭐⭐⭐ | 🔴 Design phase |
| **20 Biomes** | All biome terrains & props | ⭐⭐⭐ | 🔴 Not started |
| **180 NPCs** | Generic citizens (6 base × 20 biomes) | ⭐⭐⭐ | 🔴 Not started |

---

### **👨‍👩‍👧‍👦 Family & Generations**

| Kategorija | Naloga | Prioriteta | Status |
|------------|--------|------------|--------|
| **NEW - Generations** | 5-generation family system | ⭐⭐⭐ | 🔴 Not started |
| **NEW - Generations** | Aging & death mechanics | ⭐⭐⭐ | 🔴 Not started |
| **NEW - Generations** | Marriage & children system | ⭐⭐⭐ | 🔴 Not started |
| **NEW - School Impact** | Children must attend school for stat boosts | ⭐⭐⭐ | 🔴 Not started |
| **NEW - Inheritance** | Farm/tools pass to next generation | ⭐⭐⭐ | 🔴 Not started |

---

### **🎯 Story & Quests**

| Kategorija | Naloga | Prioriteta | Status |
|------------|--------|------------|--------|
| **Main Quest** | 50 Ana clues | ⭐⭐⭐⭐⭐ | 🔴 Writing needed |
| **Bosses** | 7 major bosses | ⭐⭐⭐⭐ | 🔴 Not started |
| **Endings** | Multiple endings (4 variants) | ⭐⭐⭐⭐⭐ | 🔴 Not started |
| **Side Quests** | 100+ NPC quests | ⭐⭐⭐ | 🔴 Not started |

---

### **🚗 Transportation & Exploration**

| Kategorija | Naloga | Prioriteta | Status |
|------------|--------|------------|--------|
| **Mounts** | 27 transportation options | ⭐⭐⭐ | 🔴 Not started |
| **Fast Travel** | Portal network system | ⭐⭐⭐ | 🔴 Not started |
| **Submarine** | Ocean/Atlantis exploration | ⭐⭐⭐ | 🔴 Not started |

---

## 📈 DEVELOPMENT METRICS

### **Asset Completion:**
- **Tools:** 100% (63/63) ✅
- **Crops:** 62% (263/420) 🟡
- **Buildings:** 3% (8/~900) 🔴
- **NPCs:** 5% (5/~240) 🔴
- **Bugs:** 100% (24/24) ✅
- **UI:** 30% (6/~20) 🟡

### **Code Systems:**
- **Core Gameplay:** 80% ✅
- **Town Restoration:** 0% 🔴
- **Museum:** 0% 🔴
- **School:** 0% 🔴
- **Generations:** 0% 🔴
- **Capital City:** 0% 🔴

---

## 🎯 IMMEDIATE PRIORITIES (Next 48 Hours)

### **CRITICAL PATH:**

1. ⭐⭐⭐⭐⭐ **Capital City System** (Code + Assets)
   - Main city building assets (ruined + restored)
   - Wall upgrade stages (3 levels)
   - Guard patrol NPCs
   - Status board UI
   - Population tracking

2. ⭐⭐⭐⭐⭐ **Museum Evolution** (Code + Assets)
   - 3 museum stages (sprites)
   - Artifact album UI
   - Collection tracking logic
   - Museum growth triggers

3. ⭐⭐⭐⭐⭐ **Zombi Skavt** (Code + Assets)
   - Base form sprites (8 directions)
   - Level 5, 10, 15, 20 evolution sprites
   - Leveling logic
   - Skill trees implementation

4. ⭐⭐⭐⭐ **New Town NPCs** (Assets)
   - Tehnik (Technician) master reference
   - Šivilja (Seamstress) master reference
   - Pek (Baker) master reference
   - Kustos (Curator) master reference

5. ⭐⭐⭐⭐ **New Town Buildings** (Assets)
   - Bakery (ruined + restored)
   - Tailor (ruined + restored)
   - Tech Workshop (ruined + restored)
   - School (ruined + restored)

---

## 🚀 SUCCESS CRITERIA

### **Kickstarter Demo Ready When:**
- ✅ Capital City is functional & visually impressive
- ✅ Museum shows clear evolution (shed → complex)
- ✅ Zombi Skavt is playable companion
- ✅ 4 new NPCs have services working
- ✅ Farm defense demonstrates raid mechanics
- ✅ Status boards show town progress
- ✅ All new buildings visible in asset browser

---

## 🏙️ **CITY EVOLUTION & POPULATION MILESTONES**

| Milestone | Population | Unlock | Priority | Status |
|-----------|------------|--------|----------|--------|
| **Election System** | 5 NPCs | Volitve za Župana, Social Order | ⭐⭐⭐⭐⭐ | ✅ Implemented |
| **Zombie Economy** | 10 NPCs | Worker Zombies, Sanitation | ⭐⭐⭐⭐ | ✅ Implemented |
| **Vape Factory** | **50 NPCs** | First major industrial building | ⭐⭐⭐⭐ | 🔴 Planned (Faza 3) |
| **Police Force** | 75 NPCs | Drug trade becomes illegal/risky | ⭐⭐⭐⭐ | 🔴 Planned |
| **Full Infrastructure** | 100 NPCs | All systems unlocked | ⭐⭐⭐⭐⭐ | 🔴 Future |

### **Vape Factory (Faza 3 - Industrija)**
- **Unlock:** 50 residents in Capital City
- **Requirements:** Rare chemicals from ruins (Tehnik processing)
- **Features:** Custom liquid crafting, mod building
- **Workforce:** Delovni Zombiji + Tehnik supervision

---

## 🌿 **SOCIAL & ECONOMY SYSTEMS**

### **Drug Effects & Illegal Trade**

| System | Features | Priority | Status |
|--------|----------|----------|--------|
| **Marijuana Effects** | Slow-mo, chill music, energy regen +100%, -15% walk speed | ⭐⭐⭐⭐ | ✅ Implemented |
| **Mushroom Hallucinations** | Psychedelic shader, moving objects, ghost visions, reality warps | ⭐⭐⭐⭐ | ✅ Implemented |
| **Black Market Trade** | Free trade until police established (30% bust risk after) | ⭐⭐⭐⭐ | ✅ Implemented |
| **Crop Systems** | Cannabis & magic mushroom farming | ⭐⭐⭐⭐ | 🟡 In progress |

**Psychedelic Visual Effects:**
- **Marijuana:** Subtle blur, light green tint, chill lo-fi music
- **Mushrooms:** Color cycling, object movement, ghost NPCs, camera distortion

### **Courier Mission System**

| Feature | Details | Priority | Status |
|---------|---------|----------|--------|
| **Delivery Quests** | Random NPC requests for materials (wheat, water, glass, steel) | ⭐⭐⭐⭐ | ✅ Implemented |
| **Hearts Reward** | Social Status increases (+5% per heart) | ⭐⭐⭐⭐ | ✅ Implemented |
| **Material Reward** | Random loot from pools (common/uncommon/rare) | ⭐⭐⭐⭐ | ✅ Implemented |
| **Social Benefits** | Shop discounts, priority quests, VIP access | ⭐⭐⭐ | ✅ Implemented |
| **Quest Expiration** | 10-minute timer per delivery | ⭐⭐⭐ | ✅ Implemented |

**Social Status Tiers:**
- 20%: 5% shop discount
- 40%: Priority quests
- 60%: VIP area access
- 80%: +10% rare gift chance
- 100%: Maximum respect

---

## 📝 NOTES

**Design Philosophy:**
- Start with 1 MASSIVE Capital City (main hub)
- Other 26 towns are resource outposts (simpler)
- Capital sends help when farm is raided
- Museum & School provide clear progression
- Magic helpers (Troli, Vilinci, Škratje) speed up building

**Technical Approach:**
- All assets: Style 32 Dark-Chibi Noir
- Friendly NPCs: Red eyes WITH pupils
- Modular building system (easy biome recolors)
- Reference-based generation (/references/ folder)

---

**Status:** 🟡 **IN ACTIVE DEVELOPMENT**  
**Timeline:** Kickstarter Demo target: 2 weeks  
**Updated:** 2026-01-05 11:06 CET