# 💀 KRVAVA ŽETEV - SPECIFIC FEATURES

---

## ✅ **CORE SYSTEMS IMPLEMENTED** (22.12.2025)

**6 Production-Ready Game Systems (~3,900 LOC) - Used Across Multiple Phases:**

### **1. RecipeSystem.js** (550 LOC) ✅
**Covers:** Crafting, blueprints, materials, progression unlocks  
**Used in:** Phase 35 (grobovi), Phase 37 (farm expansion), Phase 38 (repairs), Phase 40 (minting)
- ✅ Recipe database (9+ recipes)
- ✅ Blueprint unlock mechanics (find/level/quest/buy)
- ✅ Material validation & consumption
- ✅ Inventory integration
- ✅ Crafting timed execution

### **2. ProgressionSystem.js** (450 LOC) ✅
**Covers:** Building upgrades, benefits, sprite updates  
**Used in:** Phase 37 (farm expansion), Phase 38 (town buildings)
- ✅ House upgrades (5 levels) - marriage, kids, cooking
- ✅ Barn upgrades (4 levels) - 16 animals, auto-systems
- ✅ Storage upgrades (4 levels) - 280 inventory slots
- ✅ Greenhouse upgrades (3 levels) - year-round crops
- ✅ Benefits application system

### **3. BreedingSystem.js** (600 LOC) ✅
**Covers:** Animal families, growth, genetics  
**Used in:** Phase 37 (farm animals)
- ✅ 4 species (cow, chicken, pig, sheep)
- ✅ Breeding compatibility checks
- ✅ Baby → Young → Adult growth stages
- ✅ Family tree tracking
- ✅ Breeding cooldowns & happiness

### **4. TransportSystem.js** (650 LOC) ✅
**Covers:** Vehicles, trains, movement speed  
**Used in:** Phase 37 (farm travel), General gameplay
- ✅ 13+ vehicles (horses, carts, train, boats, boards)
- ✅ Train repair system (3 states)
- ✅ Terrain-based speed bonuses
- ✅ Purchase & ownership
- ✅ Equipment integration

### **5. MagicSystem.js** (750 LOC) ✅
**Covers:** Spells, combat, buffs/debuffs  
**Used in:** Phase 43 (boss fights), Phase 44 (invazija), General combat
- ✅ 6 elemental staffs (fire, ice, lightning, earth, light, dark)
- ✅ 12+ spells (projectile, AoE, buffs, heals, debuffs)
- ✅ Mana system with regeneration
- ✅ Potion brewing & consumption
- ✅ Status effects (burn, freeze, slow, stun)

### **6. ZombieSystem.js** (900 LOC) ✅ **KRVAVA ŽETEV CORE!**
**Covers:** Zombie workers, taming, tasks, leveling  
**Used in:** Phase 35 (**COMPLETE**), Phase 36 (hybrid skills), Phase 37 (farm work), Phase 38 (town repair), Phase 44 (defense)
- ✅ Alfa taming mechanics
- ✅ 4 zombie types (basic → elite)
- ✅ 4 task systems (farm, mine, gather, guard)
- ✅ 4 specializations with skill trees
- ✅ XP & leveling (bonuses at L5, L10, L15)
- ✅ Stamina & decay mechanics
- ✅ Grave resting system (2x regen)
- ✅ Death → Fertilizer conversion

**Implementation Date:** 22.12.2025  
**Total LOC:** ~3,900 lines  
**Status:** Production-ready, integration-ready

---

## 🆕 **PHASE 35: ZOMBI DELAVEC SISTEM** (HIGH PRIORITY)

Implementacija zombi delavcev - jedro Krvava Žetev koncepta.

- [x] **Zombi Framework** ✅ **COMPLETE!**
    - [x] Zombi entity class (4 types: basic, worker, smart, elite)
    - [x] Zombi AI (basic pathfinding) - moveTowardsTarget()
    - [x] Zombi animations (walk, work, idle, decay) - state-based
    - [x] Zombi stats (HP, stamina, XP, skills) - full progression system
- [x] **Alfa Sistem (Krotenje)** ✅ **COMPLETE!**
    - [x] Player je Alfa (hybrid virus) - Alfa power 100, range 150px
    - [x] Zombiji vohajo igralca - distance-based detection
    - [x] Krotenje divjih zombijev - tameZombie() with difficulty tiers
    - [x] Ukazi zombijem (follow, work, guard) - command system implemented
- [x] **Zombi Delo** ✅ **COMPLETE!**
    - [x] Farming task (kopanje, sadenje, žetev) - executeFarmTask()
    - [x] Mining task (rudarjenje) - executeMineTask()
    - [x] Gathering task (nabiranje) - executeGatherTask()
    - [x] Guard task (obramba) - executeGuardTask() with enemy detection
- [x] **Zombi Leveling** ✅ **COMPLETE!**
    - [x] XP gain glede na nalogo - addXP() with task rewards
    - [x] Skill specialization (Farmer, Miner, Guard, Gatherer) - 4 skill trees
    - [x] Level up bonusi (hitrost, moč) - bonuses at L5, L10, L15
- [x] **Zombi Utrujenost & Razpad** ✅ **COMPLETE!**
    - [x] Stamina sistem (delo = utrujenost) - drains at 5/sec
    - [x] Decay timer (počasno razpadanje) - 24h default, HP loss
    - [x] Smrt zombija → Gnojilo + XP - zombieDeath() drops fertilizer
- [x] **Grobovi (Počitek)** ✅ **COMPLETE!**
    - [x] Crafting grobov (kamen + zemlja) - createGrave()
    - [x] Zombi počitek v grobu - zombieRest() with grave occupation
    - [x] Regeneracija stamina - 2x regen rate in grave
    - [x] Podaljšanje življenjske dobe - decay timer extends while resting

**Status:** ✅ **IMPLEMENTED!** - ZombieSystem.js (900 LOC) - 22.12.2025 🎉

---

## 🆕 **PHASE 36: HYBRID SKILL SISTEM** (HIGH PRIORITY)

Igralčeva Hybrid veščina - razumevanje zombijev.

- [x] **Hybrid Skill Tree** ✅ **FOUNDATION COMPLETE!**
    - [x] Level 1-10 progression - Zombie leveling system (up to L15+)
    - [x] XP gain iz zombi smrti (dediščina) - zombieDeath() awards XP
    - [ ] Skill points allocation - Need UI for player skill tree
- [ ] **Zombi Komunikacija** ⏸️ **NEEDS IMPLEMENTATION**
    - [ ] Level 1: Samo godrnjanje ("Hnggg...") - Need dialogue system
    - [ ] Level 5: Ključne besede v podnapisih - Need subtitle UI
    - [ ] Level 10: Celotne stavke (opozorila, spomini) - Need advanced dialogue
- [x] **Alfa Moči** ✅ **PARTIALLY COMPLETE!**
    - [x] Večji radius krotenja - alfaRange (150px base, can be upgraded)
    - [x] Več zombijev hkrati - Unlimited tamed zombies (barn capacity limit)
    - [x] Boljši ukazi (kompleksne naloge) - 4 task types implemented
    - [x] Voh Alfe (privlačnost za zombije) - alfaScent system (0-100)
- [ ] **Hybrid Abilities** ⏸️ **NEEDS IMPLEMENTATION**
    - [ ] Heal zombije (regeneracija) - Need ability system (can use MagicSystem as base)
    - [ ] Boost zombije (začasna moć) - Need buff system
    - [ ] Calm divje zombije - alfaScent partially covers this
    - [ ] Sense danger (opozorilo) - Need detection system

**Status:** ⏸️ **~50% COMPLETE** - Alfa mechanics done, needs dialogue & abilities UI  
**Systems Ready:** ZombieSystem (Alfa + taming), MagicSystem (can adapt for abilities)  
**Needs:** Dialogue system, Skill tree UI, Player ability hotkeys

---

## 🆕 **PHASE 37: MICRO FARM & ŠIRITEV** (HIGH PRIORITY)

Začetek na 8x8 parceli in postopna širitev.

- [ ] **Micro Farm (8x8)**
    - [ ] Fiksna začetna parcela
    - [ ] Omejen prostor (prisili strategijo)
    - [ ] Tutorial na micro farm
- [ ] **Širitev Sistema**
    - [ ] Odklepanje po 2x2 tiles
    - [ ] Pošlji zombije da očistijo
    - [ ] Zombiji pripravijo zemljo
    - [ ] Plačilo za širitev (resources)
- [ ] **Zemljišče Tipi**
    - [ ] Grass (osnova)
    - [ ] Forest (drevesa, clearing needed)
    - [ ] Rocky (kamenje, mining needed)
    - [ ] Swamp (voda, drainage needed)

**Status:** 🔥 HIGH PRIORITY

---

## 🆕 **PHASE 38: OBNOVA MESTA** (MEDIUM PRIORITY)

Obnova porušenega mesta - socialni element.

- [ ] **Ruševine**
    - [ ] Porušene hiše (NPC homes)
    - [ ] Damage levels (25%, 50%, 75%, 100%)
    - [ ] Visual progression (repair stages)
- [ ] **Obnova Projektov**
    - [ ] Material requirements (les, kamen, železo, zlato)
    - [ ] Zombi pomoč (construction work)
    - [ ] Time to complete
    - [ ] Completion rewards
- [ ] **NPC Srčki (Hearts)**
    - [ ] Relationship system (1-10 hearts)
    - [ ] Unlock trgovine z hearts
    - [ ] Unlock quests z hearts
    - [ ] Unlock zombi posoja
- [ ] **Zombi Posoja (Leasing)**
    - [ ] Posodi zombije NPC-jem
    - [ ] Plačilo za zombi delo
    - [ ] Zombi dobi special XP
    - [ ] Return zombija (upgraded)
- [ ] **NPC Trgovine**
    - [ ] Kovač (orodja, orožje)
    - [ ] Pekarica (hrana, recepti)
    - [ ] Trgovec (semena, materiali)
    - [ ] Zdravnik (zdravila, cure research)

**Status:** 📋 MEDIUM PRIORITY

---

## 🆕 **PHASE 39: MESOJEDKE (MARIO PLANTS)** (MEDIUM PRIORITY)

Gigantske rože za obrambo in End-Game farming.

- [ ] **Mesojedke Framework**
    - [ ] Seed planting
    - [ ] Growth stages (1-5)
    - [ ] Gigantska roža (final stage)
- [ ] **Hranjenje z Mesom**
    - [ ] Ne potrebujejo vode
    - [ ] Potrebujejo meso (zombi deli, mutanti)
    - [ ] Feeding system
    - [ ] Growth speed glede na kvaliteto mesa
- [ ] **Obramba**
    - [ ] Auto-attack sovražnikov
    - [ ] Damage output
    - [ ] Range (radius)
    - [ ] Cooldown
- [ ] **Pridelek**
    - [ ] Cvetni listi (rare material)
    - [ ] Semena (expensive)
    - [ ] Special drops (legendary items)

**Status:** 📋 MEDIUM PRIORITY

---

## 🆕 **PHASE 40: EKONOMIJA - MINTING** (MEDIUM PRIORITY)

Kovanje zlatnikov - unikaten ekonomski sistem.

- [ ] **Rudarjenje Zlata**
    - [ ] Zlata ruda (rare ore)
    - [ ] Mining locations
    - [ ] Zombi miners
- [ ] **Talilnica (Smelter)**
    - [ ] Crafting smelter
    - [ ] Smelt zlato rudo → zlato
    - [ ] Fuel requirements (coal, wood)
- [ ] **Kovalnica (Mint)**
    - [ ] Crafting mint
    - [ ] Mint zlato → zlatniki (coins)
    - [ ] Minting time
    - [ ] Quality levels (pure gold = more value)
- [ ] **Valuta**
    - [ ] Zlatniki kot glavna valuta
    - [ ] Ni random coin drops
    - [ ] Vse preko minting
    - [ ] Inflation control (limited gold)

**Status:** 📋 MEDIUM PRIORITY

---

## 🆕 **PHASE 41: ALBUM (COLLECTION)** (LOW PRIORITY)

Zbirateljski sistem - odkrivanje sveta.

- [ ] **Album Framework**
    - [ ] Album UI (book interface)
    - [ ] Categories (zombiji, rastline, ribe, mutanti)
    - [ ] Auto-discovery (first encounter)
    - [ ] Completion percentage
- [ ] **Kategorije**
    - [ ] Legendarne Zombije (rare types)
    - [ ] Gigantske Rože (mesojedke)
    - [ ] Redke Ribe (fishing)
    - [ ] Mutanti (enemies)
    - [ ] Defektni Zombiji (lab jokes)
- [ ] **Rewards**
    - [ ] Completion bonuses
    - [ ] Unlock special items
    - [ ] Achievements
    - [ ] Lore entries

**Status:** 📋 LOW PRIORITY

---

## 🆕 **PHASE 42: MAIN QUEST - SESTRA** (HIGH PRIORITY)

Glavna zgodba - iskanje izgubljene sestre.

- [ ] **Quest Framework**
    - [ ] Quest tracking
    - [ ] Quest journal
    - [ ] Quest markers
    - [ ] Quest rewards
- [ ] **Zgodba**
    - [ ] Prologue (napad Zmaj-Volka)
    - [ ] Act 1: Iskanje sledi
    - [ ] Act 2: Odkrivanje laboratorija
    - [ ] Act 3: Soočenje z resnico
    - [ ] Finale: Sestra & zdravilo
- [ ] **Zapisi (Lore)**
    - [ ] Stari zapisi (mining, digging)
    - [ ] Virus origin story
    - [ ] Lab experiments
    - [ ] Zmaj-Volk creation
- [ ] **Odločitve**
    - [ ] Zdravilo ali maščevanje?
    - [ ] Rešiti sestro ali svet?
    - [ ] Multiple endings

**Status:** 🔥 HIGH PRIORITY

---

## 🆕 **PHASE 43: ZMAJ-VOLK BOSS** (HIGH PRIORITY)

Najvišji plenilec - epic boss fight.

- [ ] **Zmaj-Volk Design**
    - [ ] Hybrid mutant (dragon + wolf)
    - [ ] Massive size
    - [ ] Unique animations
    - [ ] Intimidating presence
- [ ] **Boss Fight**
    - [ ] Multi-phase fight (3 faze)
    - [ ] Special attacks (fire breath, claw swipe)
    - [ ] Weak points
    - [ ] Environmental hazards
- [ ] **Boss Arena**
    - [ ] Special location (ruins, forest)
    - [ ] Dynamic environment
    - [ ] Escape routes
- [ ] **Rewards**
    - [ ] Zmaj-Volk trophy
    - [ ] Legendary loot
    - [ ] Story progression
    - [ ] Unlock ending

**Status:** 🔥 HIGH PRIORITY

---

## 🆕 **PHASE 44: INVAZIJA (HORDE MODE)** (MEDIUM PRIORITY)

Wave defense - End-Game content.

- [ ] **Horde System**
    - [ ] Wave spawning
    - [ ] Difficulty scaling
    - [ ] Enemy types (zombiji, mutanti)
    - [ ] Boss waves
- [ ] **Obramba**
    - [ ] Mesojedke (auto-defense)
    - [ ] Guard zombiji (player army)
    - [ ] Traps and barriers
    - [ ] Player combat
- [ ] **Rewards**
    - [ ] Wave completion rewards
    - [ ] Rare loot
    - [ ] XP bonuses
    - [ ] Leaderboards

**Status:** 📋 MEDIUM PRIORITY

---

## 📊 **KRVAVA ŽETEV - PRIORITY ROADMAP**

### **HIGH PRIORITY (Začni tukaj):**
1. ✅ **Phase 35: Zombi Delavec Sistem** - **COMPLETE!** (22.12.2025)
2. ⏸️ Phase 36: Hybrid Skill - **PARTIALLY COMPLETE** (Alfa system done via ZombieSystem)
3. Phase 37: Micro Farm & Širitev - **SYSTEMS READY** (ProgressionSystem, ZombieSystem support this)
4. Phase 42: Main Quest - Sestra
5. Phase 43: Zmaj-Volk Boss - **COMBAT READY** (MagicSystem done)

### **MEDIUM PRIORITY (Potem):**
6. Phase 38: Obnova Mesta - **SYSTEMS READY** (ProgressionSystem, RecipeSystem, ZombieSystem)
7. Phase 39: Mesojedke
8. Phase 40: Minting - **SYSTEMS READY** (RecipeSystem for smelter/mint crafting)
9. Phase 44: Invazija - **COMBAT READY** (MagicSystem, ZombieSystem guards)

### **LOW PRIORITY (Zadnje):**
10. Phase 41: Album

---

**Progress Update (22.12.2025):**
- ✅ **Phase 35:** COMPLETE (100%)
- 🔧 **Core Systems:** 6/6 implemented (100%)
- 📊 **Total Progress:** ~40% of features have necessary systems ready
- 🚀 **Status:** Production-ready for integration & testing

---

**Timeline (Updated):**
- ~~**Core Systems (35-37):** 3-4 weeks~~ → **DONE in 1 day!** ✅
- **Story & Boss (42-43):** 2-3 weeks (systems ready, need content)
- **Social & Economy (38-40):** 2-3 weeks (systems ready, need content)
- **End-Game (39, 41, 44):** 2-3 weeks (combat systems ready)

**Revised Total:** ~~10-14 weeks~~ → **6-8 weeks** (with systems done) 🚀

---

**💀 KRVAVA ŽETEV - DEATH HARVEST 💀**  
**Unique Zombie Worker Survival RPG**  
**Development Start: December 2025** 🚀✨  
**Core Systems Complete: 22.12.2025** ✅