Files
novafarma/docs/ROADMAP.md

354 lines
17 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.
# 🗺️ 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