ok

docs/FAZA_3_4_DETAILED_PLAN.md

@@ -0,0 +1,539 @@
+# 🗺️ FAZA 3 & 4 - DETAILED EXPANSION PLAN
+
+**Created:** January 12, 2026, 00:27 CET  
+**Focus:** World exploration, systems expansion, memory recovery  
+**Duration:** ~20 hours gameplay (10h per Faza)
+
+---
+
+## 🌍 FAZA 3 - FIRST EXPLORATION (€14 for new buyers, FREE for EA)
+
+**Tagline:** *"The world is bigger than you thought..."*
+
+### 📦 CORE CONTENT:
+
+#### **🏞️ BIOMES (3 Normal + 1 Magical):**
+
+**NORMAL BIOMES (3):**
+1. **Forest** (Endless Forest variant)
+   - Dense woods, tall trees
+   - **Mini-Boss:** Forest Guardian (mutated bear)
+   - Resources: Hardwood, mushrooms, herbs
+2. **Desert** (Egyptian Desert lite)
+   - Sand dunes, ancient ruins
+   - **Mini-Boss:** Sand Worm
+   - Resources: Cacti, rare minerals
+3. **Swamp** 
+   - Murky water, twisted trees
+   - **Mini-Boss:** Swamp Troll
+   - Resources: Rare plants, alchemical ingredients
+
+**MAGICAL BIOME (1) - SURPRISE!:**
+4. **Witch Forest** 🌙✨
+   - Enchanted dark woods
+   - Glowing mushrooms, magical fog
+   - **Mini-Boss:** Corrupted Dryad
+   - Resources: Magical herbs, spell components
+   - **First magical biome!** (Hint at more)
+   - Mysterious portals (inactive, for later)
+
+**Why Witch Forest?**
+- Dark fantasy vibe fits early game
+- Not TOO crazy (still grounded)
+- Sets up magical system
+- Players excited for more!
+
+---
+
+#### **🌀 PORTAL SYSTEM (NEW!):**
+**Broken Portals Discovery:**
+- Each biome has 1 broken portal (4 total)
+- Portals are **inactive** (broken, needs repair)
+- Quest: Find blueprints to fix portals
+- **First Portal Unlock:** After repairing 1st portal
+  - Can teleport back to Farm/Town
+  - Portal becomes **blue teleportation point**
+
+**Mechanics:**
+- Find **Portal Blueprints** (scattered in biomes)
+- Collect **Portal Crystals** (boss drops)
+- Repair portal = Unlock fast travel
+- **Later:** Portals connect to Railway stations (Faza 4!)
+
+---
+
+#### **🚂 RAILWAY PREP (Foundation):**
+**NOT fully unlocked yet, but:**
+- Discover **1 abandoned train station** (in Mountain biome)
+- Station is ruined, unusable
+- **Quest hint:** "The railways once connected this world..."
+- **Blueprint drop:** Railway Station Restoration (for Faza 4)
+
+---
+
+#### **💭 MEMORY SYSTEM (Ana's Memories):**
+**+10 Memories unlocked (Total: 10/50)**
+
+**Found in biomes:**
+1. **Memory #1 (Forest):** Ana's diary page - "I miss the trees..."
+2. **Memory #2 (Desert):** Ana's water bottle - Last family trip
+3. **Memory #3 (Swamp):** Ana's research notes - Plant samples
+4. **Memory #4 (Mountain):** Ana's climbing rope - Adventure together
+5. **Memory #5 (Forest):** Kai+Ana carved tree - "K+A Forever"
+6. **Memory #6 (Desert):** Family photo - Desert vacation
+7. **Memory #7 (Swamp):** Ana's boot - Lost during escape
+8. **Memory #8 (Mountain):** Ana's compass - Father's gift
+9. **Memory #9 (Boss drop):** Ana's necklace - Twin bond symbol
+10. **Memory #10 (Hidden):** Kai's first longboard wheel - Broken
+
+**Memory Effects:**
+- Each memory = **Flashback cutscene**
+- Twin Bond strengthens (+2% range per memory)
+- Kai remembers more about Ana
+
+---
+
+#### **🦌 WILD ANIMALS (NEW!):**
+**Non-hostile creatures (10 species):**
+- Deer, Fox, Wolf, Rabbit, Squirrel
+- Owl, Hawk, Boar, Lynx, Badger
+
+**Huntable for:**
+- Meat (food)
+- Pelts (crafting materials)
+- Bones (tools)
+
+**Taming potential** (hint for later Fazas)
+
+---
+
+#### **🌱 NEW PLANTS (20 varieties):**
+**Biome-specific plants:**
+- Forest: Wild berries, mushrooms (5 types)
+- Desert: Cacti, aloe vera (5 types)
+- Swamp: Lily pads, poisonous herbs (5 types)
+- Mountain: Alpine flowers, medicinal plants (5 types)
+
+**Uses:**
+- Cooking recipes
+- Alchemy (potions)
+- Crafting dyes
+- Medicine
+
+---
+
+#### **👕 CLOTHING SYSTEM (NEW!):**
+**Unlockable cosmetics (15 items):**
+
+**Headwear (5):**
+- Bandana (Desert reward)
+- Forest Hat
+- Mountain Beanie
+- Swamp Hood
+- Explorer Goggles
+
+**Tops (5):**
+- Leather Jacket (Mini-boss drop)
+- Explorer Vest
+- Warm Coat (Mountain)
+- Camouflage Shirt (Forest)
+- Scientist Coat (Ana's memory)
+
+**Accessories (5):**
+- Backpack Upgrade (bigger inventory)
+- Belt Pouches
+- Climbing Gloves
+- Snow Boots
+- Desert Scarf
+
+**System:**
+- Purely cosmetic (no stats)
+- Mix & match
+- Unlocked via quests, boss drops, memory finds
+
+---
+
+#### **🛹 LONGBOARD QUEST (EMOTIONAL!):**
+**"Father's Legacy" Questline:**
+
+1. **Discovery:** Find broken longboard in Forest ruins
+   - Flashback: Kai riding with father
+   - "This was... mine? Or... someone else's?"
+2. **Repair Quest:**
+   - Find wood (Forest)
+   - Find truck parts (Desert scrap)
+   - Find wheel (Mountain)
+   - Find paint (Swamp alchemist)
+3. **Completion:**
+   - Longboard restored!
+   - **Unlocks:** Longboard mount (faster movement!)
+   - Speed: 2x walk speed
+   - Can do tricks (cosmetic)
+4. **Emotional Payoff:**
+   - Flashback memory: Father teaching Kai to ride
+   - "I remember now... Papa loved this board..."
+
+---
+
+#### **📜 BLUEPRINT SYSTEM (NEW!):**
+**Collectible blueprints (10):**
+1. Portal Repair Blueprint
+2. Railway Station Blueprint
+3. Advanced Workbench (Tier 3)
+4. Irrigation System V2
+5. Greenhouse Expansion
+6. Animal Pen (Large)
+7. Smelter
+8. Alchemy Table
+9. Longboard Repair Kit
+10. Teleportation Crystal Forge
+
+**Found in:**
+- Biome exploration (hidden chests)
+- Mini-boss drops
+- NPC quest rewards
+
+---
+
+#### **🧟 ZOMBIE SCOUT SYSTEM (NEW!):**
+**Send zombies to explore!**
+
+**Mechanic:**
+- Unlock after 1st portal repair
+- Send 1 zombie scout to unexplored biome
+- Scout returns after 10 min (real-time or 1 in-game day)
+- Brings back: Resources, map reveal, danger report
+
+**Scout Levels (5 stages):**
+1. **Basic Scout:** Returns with 1-3 resources
+2. **Trained Scout:** Reveals map area
+3. **Expert Scout:** Finds rare items
+4. **Master Scout:** Warns of mini-bosses
+5. **Elite Scout (Zombie Skavt Lv5):** Brings blueprints!
+
+**Evolves into Zombi Skavt system** (Faza 4+)
+
+---
+
+### 🎯 FAZA 3 GOALS:
+
+**Exploration:**
+- ✅ Discover 4 new biomes
+- ✅ Defeat 4 mini-bosses
+- ✅ Repair 4 portals
+- ✅ Find 10 Ana memories (10/50 total)
+
+**Systems:**
+- ✅ Portal fast travel unlocked
+- ✅ Zombie scouts enabled
+- ✅ Blueprint collection started
+- ✅ Clothing customization
+- ✅ Longboard mount acquired
+
+**Preparation for Faza 4:**
+- ⏳ Railway foundation discovered
+- ⏳ Hint at more biomes
+- ⏳ Twin Bond at 20% strength
+
+---
+
+## 🌌 FAZA 4 - EXOTIC LANDS (€16 for new buyers, FREE for EA)
+
+**Tagline:** *"Further than any survivor has gone..."*
+
+### 📦 CORE CONTENT:
+
+#### **🏞️ BIOMES (3 Normal + 1 Magical):**
+
+**NORMAL BIOMES (3):**
+1. **Snow/Arctic**
+   - Frozen wasteland, ice caves
+   - **Mini-Boss:** Ice Drake
+   - Resources: Ice crystals, frozen wood
+2. **Deep Caves** ⛏️ (MINING BIOME!)
+   - Underground caverns, mineshafts
+   - **Mini-Boss:** Cave Leviathan
+   - Resources: Ores, gems, crystals
+   - **NEW SYSTEM:** Mining & Smelting!
+3. **Volcanic**
+   - Lava flows, ash storms
+   - **Mini-Boss:** Magma Golem
+   - Resources: Obsidian, fire crystals
+
+**MAGICAL BIOME (1) - THE BIG ONE!:**
+4. **Dino Valley** 🦖✨
+   - **DINOSAURS!** (T-Rex, Raptors, Pterodactyls)
+   - Prehistoric jungle, tar pits
+   - **Mini-Boss:** Alpha T-Rex
+   - Resources: Dinosaur bones, amber, rare eggs
+   - **TAMEABLE DINOS!** (Faza 4 unlock!)
+   - Portal mystery deepens (more anomalies)
+
+**Why Dino Valley?**
+- HUGE hype factor (everyone loves dinosaurs!)
+- Taming system introduction
+- Clearly magical (impossible post-apocalypse only)
+- Sets up full magical biome expansion (Faza 5+)
+
+---
+
+#### **⛏️ MINING SYSTEM (NEW!):**
+**Deep Caves Biome introduces mining!**
+
+**Ores (10 types):**
+1. **Copper Ore** - Basic metal
+2. **Tin Ore** - Bronze crafting
+3. **Iron Ore** - Already exists, but more abundant
+4. **Silver Ore** - Jewelry, advanced tech
+5. **Gold Ore** - Valuable, high-tier crafting
+6. **Titanium Ore** - Strongest armor/tools
+7. **Crystal Ore** - Portal fuel
+8. **Gem Ore** - Diamonds, rubies, emeralds
+9. **Radioactive Ore** - Advanced tech (hint at Chernobyl later!)
+10. **Obsidian** - Volcanic mining
+
+**Mining Mechanics:**
+- **Pickaxe required** (Wood → Stone → Iron → Titanium)
+- Ore veins spawn in caves
+- Each hit = chance to get ore + XP
+- Mining skill levels up (faster mining)
+- **Mineshaft building:** Can build your own mine on farm!
+
+**Smelting:**
+- Build **Smelter** (blueprint from Cave boss)
+- Smelt ore → Refined metal bars
+- Bars used for advanced crafting
+
+**Special Cave Features:**
+- **Underground Railway** - Discover old mine carts
+- **Gem veins** - Rare, glowing walls
+- **Cave crystals** - Light sources
+- **Mineshaft ruins** - Lore about pre-apocalypse miners
+
+---
+
+#### **🚂 RAILWAY SYSTEM (FULLY UNLOCKED!):**
+**Train Stations (4 new + 1 from Faza 3 = 5 total):**
+- Each biome has 1 station (ruined)
+- **Quest:** Restore all 5 stations
+- **Reward:** Railway fast travel network!
+
+**Railway Mechanics:**
+- Build tracks between stations
+- Requires: Steel, wood, blueprints
+- **Train appears** when network complete
+- Fast travel via train (alternative to portals)
+- Train = Mobile storage chest (bring items!)
+
+**Railway vs Portals:**
+- **Portals:** Instant, but scattered
+- **Railway:** Takes time, but scenic + storage
+
+---
+
+#### **💭 MEMORY SYSTEM (+10 More):**
+**Memories 11-20 (Total: 20/50)**
+
+**Emotional progression:**
+11. Arctic memory - Ana's snow globe
+12. Jungle memory - Ana's plant journal
+13. **Cave memory** - Ana's mining helmet (she explored caves!)
+14. Volcanic memory - Ana's heat-resistant gloves
+15. Arctic boss drop - Ana's ice pick
+16. Jungle hidden - Photo of family at waterfall
+17. **Cave ruins** - Ana's geologist notebook
+18. Volcanic shrine - Ana's fire-proof coat
+19. Railway station - Ana's train ticket (childhood trip)
+20. **BIG ONE:** Ana's voice recording - "Kai... if you find this..."
+
+**Memory #20 Effect:**
+- **FIRST TIME Ana's voice is heard!**
+- Emotional cutscene
+- "Wait... that voice... I know that voice!"
+- Twin Bond jumps to 40% strength
+- Can now **sense Ana's general direction** (East → Chernobyl!)
+
+---
+
+#### **🦌 MORE WILD ANIMALS (+10):**
+**Exotic creatures:**
+- Arctic: Polar bear, Penguin, Seal, Arctic fox, Snowy owl
+- Jungle: Monkey, Parrot, Jaguar, Anaconda, Toucan
+- **Caves:** Bats, Cave spiders, Moles, Blind salamanders, Glow worms
+- Volcanic: Salamander, Fire lizard
+
+**Taming unlocked!**
+- Can now tame certain animals
+- Companions (like Susi)
+- Max: 3 animal companions
+
+---
+
+#### **🌱 MORE PLANTS (+20):**
+**Exotic biome plants:**
+- Arctic: Ice flowers, frozen berries (5)
+- Jungle: Tropical fruits, medicinal vines (5)
+- **Caves:** Glowing mushrooms, underground moss, crystal flowers (5)
+- Volcanic: Fire flowers, ash herbs (5)
+
+**New recipes:**
+- Advanced potions
+- Rare dyes
+- Special foods
+
+---
+
+#### **👕 MORE CLOTHING (+15):**
+**Biome-appropriate gear:**
+
+**Arctic Gear:**
+- Fur Coat
+- Snow Goggles
+- Insulated Boots
+
+**Jungle Gear:**
+- Machete Belt
+- Jungle Hat
+- Liana Rope
+
+**Miner Gear:** ⛏️
+- Mining Helmet (with lamp!)
+- Leather work gloves
+- Reinforced boots
+
+**Volcanic Gear:**
+- Heat-resistant Armor
+- Ash Mask
+- Lava Walker Boots
+
+**Ana's Outfits (unlocked via memories!):**
+- Ana's Lab Coat
+- Ana's Scientist Glasses
+- Ana's Backpack (bigger inventory)
+
+---
+
+#### **📜 MORE BLUEPRINTS (+12):**
+21. Railway Track
+22. Train Station
+23. Animal Taming Post
+24. Advanced Smelter
+25. Potion Brewery
+26. Dye Workshop
+27. Clothing Workshop
+28. Storage Warehouse
+29. Teleporter Hub (multi-portal)
+30. Longboard Upgrade (stunts!)
+31. **Mining Shaft** (build own mine!)
+32. **Ore Refinery** (auto-smelting!)
+
+---
+
+#### **🧟 ZOMBI SKAVT EVOLUTION:**
+**Zombie Scouts → Zombi Skavt (5 Levels):**
+
+**Evolution system:**
+- Scout gains XP from missions
+- Levels up (1-5)
+- Each level = new appearance + abilities
+
+**Zombi Skavt Levels (From Game Bible):**
+1. **Lv1 Ragged:** Basic scout, torn clothes
+2. **Lv2 Wanderer:** Backpack, better clothes
+3. **Lv3 Seeker:** Lantern, bandana
+4. **Lv4 Explorer:** Full gear, friendly look
+5. **Lv5 Master Scout:** Red eyes (friendly!), elite gear
+
+**Lv5 Abilities:**
+- Automatic resource gathering
+- Finds rare loot
+- Warns of danger zones
+- Can escort NPCs between towns
+
+---
+
+### 🎯 FAZA 4 GOALS:
+
+**Exploration:**
+- ✅ Discover 4 exotic biomes
+- ✅ Defeat 4 more mini-bosses (8 total)
+- ✅ Restore 5 railway stations
+- ✅ Find 10 more memories (20/50 total)
+
+**Systems:**
+- ✅ Railway network operational
+- ✅ Animal taming unlocked
+- ✅ Zombi Skavt Lv5 achievable
+- ✅ Ana's voice discovered!
+- ✅ Twin Bond at 40%
+
+**Preparation for Faza 5:**
+- ⏳ First hint at magical biomes (portal anomalies)
+- ⏳ Ana's location known (direction)
+- ⏳ Player ready for harder challenges
+
+---
+
+## 📊 FAZA 3+4 COMBINED STATS:
+
+| Feature | Count |
+|---------|-------|
+| **Biomes** | 8 total (6 Normal + 2 Magical) |
+| **Mini-Bosses** | 8 total |
+| **Portals** | 8 (fast travel points) |
+| **Railway Stations** | 5 (Faza 4) |
+| **Memories** | 20/50 |
+| **Wild Animals** | 20 species |
+| **Dinosaurs** | 5 species (Faza 4!) |
+| **Plants** | 40 new |
+| **Clothing Items** | 30 |
+| **Blueprints** | 32 |
+| **Zombi Skavt Levels** | 5 stages |
+| **Zombie Dealer Levels** | 5 stages |
+| **Playtime** | ~20 hours (10h each) |
+
+---
+
+## 🎮 GAMEPLAY FLOW:
+
+**Faza 3 Experience:**
+1. Portal discovered → Explore biome
+2. Fight mini-boss → Get blueprint
+3. Repair portal → Unlock fast travel
+4. Find memory → Flashback cutscene
+5. Send zombie scout → Get resources
+6. Find longboard → Emotional quest
+7. Repeat for all 4 biomes
+
+**Faza 4 Experience:**
+1. Exotic biome discovered
+2. Railway station found
+3. Restore station + build tracks
+4. Fight mini-boss → Rare loot
+5. Find Ana's voice recording → EMOTIONAL!
+6. Tame first animal companion
+7. Zombi Skavt reaches Lv5
+8. Twin Bond now points toward Chernobyl
+
+---
+
+## ✅ WHY THIS WORKS:
+
+**For You (Dev):**
+- ✅ Clear systems to implement
+- ✅ Reusable mechanics (portals, railway)
+- ✅ Asset reuse (biomes, creatures)
+- ✅ Emotional story beats (longboard, Ana's voice)
+
+**For Players:**
+- ✅ Exploration feels rewarding
+- ✅ Multiple systems to engage with
+- ✅ Story progression (memories)
+- ✅ Customization (clothing)
+- ✅ Preparation for endgame (railway, scouts)
+
+---
+
+**Status:** ✅ PLAN READY  
+**Next:** Implement Faza 3, then Faza 4!  
+**Philosophy:** Each Faza adds layers, not just "more content"