novafarma/docs/MASTER_CONSOLIDATION_JAN_03_2026.md

# 🎮 **MASTER GAME UPDATE - January 03, 2026**
## **Complete System Integration + Final Documentation**

---

## 📊 **TODAY'S ADDITIONS (16 Major Systems!):**

### **✅ SYSTEMS ADDED:**
1. **MEMORY_LOSS_EXPANSION** - 50 Ana artifacts, heartbeat mechanic
2. **DUAL_PROTAGONIST_SYSTEM** - Play as Kai OR Ana
3. **RAILWAY_SYSTEM** - 27 stations, fast travel
4. **GRONK_RECRUITMENT_QUEST** - Find Gronk, unlock vape
5. **FARMING_MEMORIES_BREEDING_CRAFTING** - Farm therapy, 3 breeding systems, 20 crafting stations
6. **RANGED_WEAPONS_OVERHAUL** - 21 arrow types, shotgun exception
7. **MUTANT_ANIMALS_COMPLETE** - 10 Chernobyl creatures + drops
8. **BIOME_PLACEMENT_TRAVEL_SYSTEM** - Scattered map, travel restrictions
9. **CARAVAN_TELEPORTERS_CAMPS_TAMING** - 6 llamas, 21 teleporters, camps, baby taming
10. **CAMP_LIMITS_ZOMBIE_HELPERS** - 10 camp max, zombie helpers at camps
11. **FARM_EXPANSION_SYSTEM** - 8×8 → 64×64, fog of war
12. **SLEEP_CARGO_SIGNS_MONSTERS** - 30min night, llamas/alpacas, dragons, cyclops
13. **WOOD_TYPES_GLASS_CRAFTING** - 15 wood types + colors, glass from sand
14. **TRADING_CLOTHING_WEATHER_SYSTEM** - Universal trading, designer clothes, 7 weather events
15. **WARDROBE_AUTOCHANGE_WEATHER_HUD** - Wardrobe storage, auto-equip, weather HUD
16. **BIOME_UNLOCKABLES_NPC_VILLAGES** - Biome-specific content, village building

---

## 🌍 **20 BIOMES - COMPLETE CONTENT LIST:**

### **1. DOLINA SMRTI (Grassland - Starting Zone)** 🌾
```
LOCATION: Central Slovenia
DISCOVERY: Auto-unlocked (starting zone!)
DIFFICULTY: ⭐ Easy

UNIQUE CONTENT:
- Plants: Wheat, Corn, Potatoes, Carrots, Tomatoes
- Trees: Oak, Birch, Apple
- Animals: Chickens, Cows, Pigs, Horses
- Enemies: Basic Zombies (10-20 HP)
- NPCs: Farmers, Merchants, Blacksmith
- Buildings: Farmhouse, Barn, Silo, Windmill
- Special: BASE FARM (player's home!)
```

### **2. LJUBLJANA (Town Square)** 🏛️
```
LOCATION: 10km from Dolina Smrti
DISCOVERY: Auto-unlocked (first quest!)
DIFFICULTY: ⭐ Easy (safe zone!)

UNIQUE CONTENT:
- Services: All shops, bank, hospital, train station
- NPCs: 180 NPCs (shopkeepers, guards, citizens)
- Buildings: Town Hall, Market, Cathedral, Apartments
- Special: CENTRAL HUB for trading!
- Train Station: Fast travel to other towns!
```

### **3. ENDLESS FOREST** 🌲
```
LOCATION: 50km NE from base
DISCOVERY: Must travel (no fast travel first time!)
DIFFICULTY: ⭐⭐⭐ Medium-Hard

UNIQUE CONTENT:
- Plants: Wild Berries, Mushrooms, Herbs, Ferns
- Trees: Pine, Spruce, Oak (dense forest!)
- Animals: Deer, Wolves, Bears, **BIGFOOT** (rare!)
- Enemies: Werewolves (60 HP,night), Wendigos (80 HP)
- NPCs: Hermit, Hunter, Druid
- Buildings: Log Cabin, Hunter's Lodge, Druid Circle
- Weapons: Wooden Staff, Vine Whip, Bark Shield
- Armor: Leaf Armor, Bark Shield, Druid Robe
- Food: Wild Boar, Venison, Berries, Mushrooms
- Special: **BIGFOOT encounter!** (legendary!)
```

### **4. DINO VALLEY** 🦖
```
LOCATION: 60km S from base
DISCOVERY: Must travel
DIFFICULTY: ⭐⭐⭐⭐ Hard

UNIQUE CONTENT:
- Creatures: 12 Dinosaur types (T-Rex, Raptor, Triceratops, etc.)
- Plants: Prehistoric Ferns, Giant Mushrooms, Cycad Palms
- Trees: Ancient trees, fossilized stumps
- Enemies: Dino Zombies, Alpha T-Rex BOSS
- NPCs: Paleontologist, Dino Tamer
- Buildings: Primitive Hut, Dino Pen, Bone Fence
- Weapons: Bone Axe, Stone Spear, Obsidian Blade
- Armor: Dino Hide Armor, Bone Helmet, Scale Boots
- Food: **T-Rex Steak (+100 HP!)**, Dino Eggs, Dino Jerky
- Materials: Amber, Dino Bones, Tar Pit Tar
- Special: BREED DINOSAURS! Baby Raptor mount!
```

### **5. CHERNOBYL (Radioactive Zone)** ☢️
```
LOCATION: 150km E from base (border)
DISCOVERY: Must travel (FAR!)
DIFFICULTY: ⭐⭐⭐⭐⭐ EXTREME!

UNIQUE CONTENT:
- Mutants: 10 types (Wolf, Two-Headed Dog, Giant Rat, Bear, etc.)
- Plants: Mutated Grass, Radioactive Flowers, Toxic Mushrooms
- Trees: Dead trees, mutated wood
- Enemies: Radiation Zombies, Mutant Bear BOSS
- NPCs: Stalker, Scientist, Military Survivor
- Buildings: Reactor Ruins, Bunker, Military Checkpoint, Decontamination Station
- Weapons: **SHOTGUN (ONLY HERE!)**, Lead Pipe, Contaminated Axe
- Armor: **HAZMAT SUIT (REQUIRED!)**, Gas Mask, Lead Vest
- Food: Canned Food (pre-war!), MREs, Radiation Pills
- Materials: Uranium, Lead, Steel, Radioactive Waste
- Special: RADIATION DAMAGE without Hazmat! Mining uranium worth 350,000g!
```

### **6. MYTHICAL HIGHLANDS** 🏔️✨
```
LOCATION: Mountain peaks (various locations)
DISCOVERY: Must travel
DIFFICULTY: ⭐⭐⭐⭐ Hard + Cold!

UNIQUE CONTENT:
- Creatures: **Dragons (3 types!)**, Griffins, Unicorns, Pegasus, Phoenix, Chimera
- Plants: **Cloud Flowers (float!)**, Dragon Fruit, Crystal Mushrooms
- Trees: **Crystal Wood (TRANSPARENT!)**, Enchanted Wood
- Enemies: Dragon Zombies, **Thunder Dragon BOSS**
- NPCs: **Cyclops (3 types!)**, Mountain Hermit, Sky Mage
- Buildings: Sky Temple, Dragon's Nest, Crystal Tower, Cloud Platform
- Weapons: **Mythril Sword**, Dragon Bone Spear, Griffin Bow, Unicorn Lance
- Armor: **Dragon Scale Armor (BEST!)**, Pegasus Cape (glide!), Mythril Crown
- Food: **Dragon Steak**, Phoenix Omelet, **Ambrosia (god food!)**, Cloud Bread
- Materials: **Mythril Ore**, Dragon Scales, Phoenix Ash, Cloud Essence
- Special: TAME BABY DRAGONS! Flying mount (80 km/h!)
```

### **7. ARCTIC ZONE** ❄️
```
LOCATION: Far north
DISCOVERY: Must travel
DIFFICULTY: ⭐⭐⭐⭐ Hard (FREEZING!)

UNIQUE CONTENT:
- Animals: Polar Bears, Arctic Wolves, Penguins, Seals, Walrus, Mammoths
- Plants:Ice flowers, Tundra shrubs
- Trees: Frozen trees, icebound wood
- Enemies: Frozen Zombies, Frost Wraiths, **Ice Dragon**
- NPCs: Inuit Hunter, Arctic Explorer
- Buildings: Igloo, Ice Fortress, Research Station
- Weapons: Ice Spear, Frost Hammer
- Armor: **Fur Coat (REQUIRED!)**, Thermal Pants, Ice Boots
- Food: Seal Meat, Arctic Fish, Blubber
- Materials: Ice Crystals, Frozen Wood
- Weather: **PERMANENT BLIZZARD!** -30°C!
- Special: Tame Mammoth! Ice fishing!
```

### **8. WITCH FOREST** 🌑🧙
```
LOCATION: 45km W from base
DISCOVERY: Must travel
DIFFICULTY: ⭐⭐⭐ Medium (spooky!)

UNIQUE CONTENT:
- Creatures: Witches, Black Cats, Cursed Ravens, Shadow Beasts
- Plants: **Shadow Berries**, Cursed Mushrooms, Witch Herbs, Haunted Flowers
- Trees: **Shadow Wood (PURE BLACK!)**, Dark Oak
- Enemies: Witch Zombies, **Shadow Witch BOSS**
- NPCs: Hedge Witch, Potion Seller, Cursed Villager
- Buildings: Witch Hut, Cauldron Station, Dark Altar, Enchanted Garden
- Weapons: Witch Staff, Cursed Dagger, **Broom (ride + melee!)**, Shadow Bow
- Armor: Witch Robe, Pointy Hat, Shadow Cloak (stealth!), Cursed Boots
- Food: Witch's Brew, Cursed Apples, Shadow Soup, Magic Tea
- Materials: Shadow Essence, Cursed Gems, Witch Hair
- Special: LEARN DARK MAGIC! Brew potions!
```

### **9. ATLANTIC OCEAN / ATLANTIS** 🌊
```
LOCATION: Coastal / Underwater (offshore!)
DISCOVERY: Must discover coast → dive deep!
DIFFICULTY: ⭐⭐⭐⭐ Hard (underwater!)

UNIQUE CONTENT:
- Creatures: Mermaids, Sea Serpents, Giant Squid, Sharks, Dolphins
- Plants: **Kelp Forest (farm!)**, Coral, Sea Anemones, Underwater Lotus
- Enemies: Deep Sea Zombies, **Kraken BOSS**
- NPCs: Mer-King, Atlantean Citizen, Marine Biologist
- Buildings: **Underwater Dome (air bubble!)**, Coral House, Atlantean Temple, Submarine Dock
- Weapons: **Trident**, Coral Sword, Harpoon Gun, Pearl Staff
- Armor: **Diving Suit (REQUIRED!)**, Shell Armor, Pearl Necklace (+breath!), Flippers
- Food: Kelp Noodles, Pearl Oysters, Deep Sea Fish, Atlantean Bread
- Materials: Pearls, Coral, Shells, Sea Glass
- Special: UNLIMITED underwater exploration with gear! Mermaid breeding!
```

### **10. VOLCANIC HELLSCAPE** 🌋
```
LOCATION: Geothermal area
DISCOVERY: Must travel
DIFFICULTY: ⭐⭐⭐⭐⭐ EXTREME (HOT!)

UNIQUE CONTENT:
- Creatures: **Fire Dragons**, Lava Golems, Phoenixes, Hell Hounds
- Plants: Lava Flowers, Fire Ferns (rare!)
- Trees: Charred Wood, Obsidian Trees
- Enemies: Fire Zombies, **Phoenix BOSS**, Lava Elementals
- NPCs: Fire Mage, Volcano Researcher
- Buildings: Lava Forge (best smithing!), Obsidian Tower, Fire Temple
- Weapons: Flame Sword, Lava Hammer, Phoenix Staff
- Armor: **Fire-Resistant Suit (REQUIRED!)**, Obsidian Armor, Phoenix Feather Cape
- Food: Fire Fruit, Lava-Cooked Meat (instant BBQ!)
- Materials: Obsidian, Lava Rock, Phoenix Feathers, Magma Crystals
- Weather: **VOLCANIC ERUPTIONS!** (3% chance!)
- Special: PHOENIX revive (if tamed, brings you back to life once/day!)
```

### **11. EGYPTIAN DESERT** 🏜️
```
LOCATION: 80km SE (anomaly portal!)
DISCOVERY: Must travel
DIFFICULTY: ⭐⭐⭐ Medium (HOT!)

UNIQUE CONTENT:
- Creatures: Mummies, Giant Scarabs, Giant Scorpions, Cobras, Sphinxes, Jackals, Camels
- Plants: Cacti, Desert Flowers, Palm Trees
- Trees: Date Palms, Dead Wood
- Enemies: Mummy Zombies, **Pharaoh BOSS**
- NPCs: Archaeologist, Bedouin Trader, Tomb Keeper
- Buildings: **Pyramid (explore!)**, Sphinx, Tomb, Oasis Settlement
- Weapons: Khopesh (curved sword!), Scarab Staff, Cobra Whip
- Armor: Pharaoh Robes, Mummy Wraps, Desert Turban, Sandstorm Mask
- Food: Dates, Figs, Desert Bread, Camel Milk
- Materials: Sand (glass!), Gold, Lapis Lazuli, Papyrus
- Weather: **SANDSTORMS!** (8% chance - 3m visibility!)
- Special: TREASURE in pyramids! Tame camels!
```

### **12. PIRATE COVE** 🏴‍☠️
```
LOCATION: Coastal
DISCOVERY: Must travel to shore
DIFFICULTY: ⭐⭐⭐ Medium

UNIQUE CONTENT:
- Creatures: Pirates, Parrots, Sea Turtles, Crabs
- Plants: Tropical Flowers, Palm Trees, Seaweed
- Trees: **Palm Wood**, Bamboo
- Enemies: Pirate Zombies, **Pirate Captain BOSS**
- NPCs: Pirate Crew, Merchant Sailor, Fisherman
- Buildings: **Pirate Ship (player can own!)**, Dock, Tavern, Treasure Cave
- Weapons: Cutlass, Flintlock Pistol (rare!), Harpoon, Anchor (melee!)
- Armor: Pirate Hat, Captain's Coat, Leather Boots, Eye Patch (cosmetic!)
- Food: Rum, Seafood, Hardtack, Tropical Fruit
- Materials: Rope, Sail Cloth, Ship Wood, Treasure Chests
- Special: SAIL A SHIP! Naval combat! Buried treasure maps!
```

### **13. MUSHROOM FOREST** 🍄
```
LOCATION: 25km from base (nearby!)
DISCOVERY: Easy to find
DIFFICULTY: ⭐⭐ Easy-Medium

UNIQUE CONTENT:
- Creatures: Giant Mushroom Creatures, Spore Sprites, Fungus Trolls, Mushroom Golems, Truffle Pigs
- Plants: **Giant Mushrooms (50+ types!)**, Spore Clouds, Mycelium
- Trees: Mushroom Trees (wood alternative!)
- Enemies: Spore Zombies, **Mushroom King BOSS**
- NPCs: Mycologist, Mushroom Farmer, Fungus Alchemist
- Buildings: Mushroom House (grow your own!), Spore Lab, Mycelium Farm
- Weapons: Spore Staff, Mushroom Shield
- Armor: Mushroom Cap Hat, Mycelium Armor (organic!)
- Food: **Hundreds of mushrooms!** (food + alchemy!), Spore Bread, Truffle Delicacy
- Materials: Spores, Mushroom Caps, Mycelium, Truffles (1,500g/day from pig!)
- Special: FARM GIANT MUSHROOMS! Truffle hunting with pigs!
```

### **14. MEDIEVAL CASTLE** 🏰
```
LOCATION: Mountain fortress
DISCOVERY: Must travel
DIFFICULTY: ⭐⭐⭐⭐ Hard (hostile!)

UNIQUE CONTENT:
- Creatures: Dragons (castle guardians!), Knights, Horses
- Plants: Castle Garden Flowers, Herb Garden
- Enemies: **Knight Zombies (armored!)**, Ghost Knights, **Dragon Knight BOSS**
- NPCs: King (if castle restored!), Knight, Blacksmith, Alchemist
- Buildings: **CASTLE (player can claim!)**, Throne Room, Armory, Dungeon, Tower
- Weapons: **Longsword**, Lance, Crossbow, War Hammer, Mace
- Armor: **Full Plate Armor**, Knight Helmet, Shield (various), Chainmail
- Food: Medieval Feast (roasted meats!), Mead, Bread, Cheese
- Materials: Stone, Iron, Steel, Banners
- Special: CLAIM CASTLE! Become royalty! Host medieval tournaments!
```

### **15. STEAMPUNK CITY** 🏭⚙️
```
LOCATION: Industrial ruins
DISCOVERY: Must travel
DIFFICULTY: ⭐⭐⭐ Medium

UNIQUE CONTENT:
- Creatures: Steam Robots, Clockwork Creatures, Automatons
- Plants: Industrial Plants (rare!)
- Trees: Metal Trees (decorative!)
- Enemies: Robot Zombies, **Steampunk Mech BOSS**
- NPCs: Engineer, Inventor, Steam Mechanic
- Buildings: **Factory (produces items!)**, Clocktower, Steam Workshop, Gear Foundry
- Weapons: **Steam Gun**, Gear Sword, Wrench (melee!), Clockwork Crossbow
- Armor: **Steampunk Suit**, Goggles, Gear Shield, Mechanical Arm
- Food: Industrial Rations, Canned Goods, Steam-Cooked Meals
- Materials: Gears, Steam Pipes, Brass, Copper, Oil
- Special: BUILD AUTOMATONS! Steam-powered vehicles!
```

### **16. WILD WEST** 🤠
```
LOCATION: 90km W (ghost town!)
DISCOVERY: Must travel
DIFFICULTY: ⭐⭐⭐ Medium

UNIQUE CONTENT:
- Creatures: Wild Horses, Bison, Coyotes, Rattlesnakes
- Plants: Tumbleweeds, Cacti, Desert Sage
- Trees: Dead Trees, Sagebrush
- Enemies: Cowboy Zombies, **Outlaw Sheriff BOSS**
- NPCs: Cowboy, Saloon Owner, Gunslinger
- Buildings: **Saloon**, Sheriff's Office, Bank, General Store (ruins!)
- Weapons: **Revolver** (rare!), Lasso, Tomahawk, Lever-Action Rifle (rare!)
- Armor: Cowboy Hat, Duster Coat, Spurs, Sheriff Badge
- Food: Beans, Beef Jerky, Whiskey, Cornbread
- Materials: Leather, Wood, Rope, Gold Nuggets
- Special: QUICK DRAW duels! Tame wild horses! Gold rush!
```

### **17. MEXICAN CENOTES** 🇲🇽
```
LOCATION: 70km (cave system!)
DISCOVERY: Must travel
DIFFICULTY: ⭐⭐⭐ Medium (underwater caves!)

UNIQUE CONTENT:
- Creatures: Bats (giant!), Cave Fish, Underground Lizards, **Cyclops (cave type!)**
- Plants: Cave Moss, Underground Flowers, Vines
- Enemies: Cave Zombies, **Cave Cyclops BOSS**
- NPCs: Cave Explorer, Mayan Descendant
- Buildings: **Cenote Pool (swim!)**, Cave Dwelling, Mayan Temple (ruins!)
- Weapons: Obsidian Blade, Cave Spear
- Armor: Cave Diver Suit, Mayan Ceremonial Garb
- Food: Cave Fish, Underground Mushrooms, Bat Soup
- Materials: Obsidian, Cave Crystals, Limestone
- Special: UNDERWATER CAVE DIVING! Discover Mayan treasures!
```

### **18. CYBERPUNK RUINS** 🌃
```
LOCATION: City outskirts
DISCOVERY: Must travel
DIFFICULTY: ⭐⭐⭐⭐ Hard (tech enemies!)

UNIQUE CONTENT:
- Creatures: Robots, Cyborgs, Drones, Holograms
- Plants: Neon Plants (glowing!), Bio-Tech Flowers
- Enemies: Cyborg Zombies, **AI BOSS**
- NPCs: Hacker, Cyberpunk Merchant, Rogue AI (friendly!)
- Buildings: **Neon Tower**, Data Center, Tech Lab, Holo-Bar
- Weapons: **Plasma Rifle** (future!), Laser Sword, EMP Grenade, Hack Tool
- Armor: **Cyber Suit**, Neon Jacket, Holo-Visor, Tech Gloves
- Food: Synth Food, Energy Drinks, Ramen, Cyberpunk Snacks
- Materials: Circuits, Nano-Tech, Holo-Screens, Cyber Implants
- Special: HACK systems! Get cyber upgrades!
```

### **19. LOCH NESS (Scottish Lake)** 🏴󠁧󠁢󠁳󠁣󠁴󠁿
```
LOCATION: 120km (lake region!)
DISCOVERY: Must travel (FAR!)
DIFFICULTY: ⭐⭐⭐⭐ Hard

UNIQUE CONTENT:
- Creatures: **NESSIE (Loch Ness Monster!)**, Giant Fish, Scottish Deer
- Plants: Highland Flowers, Heather, Lake Reeds
- Trees: Scottish Pine, Birch
- Enemies: Highland Zombies, **Nessie (can befriend OR fight!)**
- NPCs: Scottish Highlander, Fisherman, Bagpiper
- Buildings: **Highland Castle**, Stone Cottage, Fishing Dock
- Weapons: Claymore, Scottish Dirk, Bagpipes (weapon!)
- Armor: Kilt (yes!), Tartan Cloak, Highland Boots
- Food: Haggis, Scottish Salmon, Whisky, Shortbread
- Materials: Highland Stone, Wool, Lake Pearls
- Special: **TAME NESSIE!** Ride the monster! 🦕
```

### **20. ENCHANTED GARDEN** 🌺✨
```
LOCATION: Hidden portal (find in forest!)
DISCOVERY: Secret entrance (quest!)
DIFFICULTY: ⭐⭐ Easy (PEACEFUL!)

UNIQUE CONTENT:
- Creatures: Fairies, Unicorns, Talking Animals, Butterflies (giant!)
- Plants: **EVERY FLOWER!** Magical Plants, **Cherry Blossoms (PINK!)**, Rainbow Roses
- Trees: **Cherry Wood (PINK FURNITURE!)**, **Enchanted Wood (GLOWING!)**, Fruit Trees (all types!)
- Enemies: NONE! (peaceful zone!) – unless corrupted (rare event)
- NPCs: Fairy Queen, Garden Keeper, Unicorn
- Buildings: **Fairy Castle**, Enchanted Greenhouse, Rainbow Bridge, Flower Palace
- Weapons: Fairy Wand, Flower Staff (peace-only!)
- Armor: Fairy Wings (cosmetic + flight!), Flower Crown, Petal Dress
- Food: **Enchanted Fruit** (+magic!), Fairy Bread, Nectar, Ambrosia
- Materials: **Cherry Wood (PINK!)**, **Enchanted Wood (GLOWS!)**, Fairy Dust, Rainbow Petals
- Special: NO COMBAT! Perfect for farming! PINK WOOD for furniture! ✨🌸
```

---

## 🏗️ **BUILDING SYSTEM (Materials, NOT Gold!):**

### **CLARIFICATION:**

```
❌ CANNOT just buy buildings with gold!
✅ MUST gather materials + build manually/with zombies!

EXAMPLE: NPC HOUSE (Small)
```

**WRONG:**
```
[Click "Build House"]
[Pay 1,000 gold]
[House appears!] ❌ TOO EASY!
```

**CORRECT:**
```
[Go to Build Menu]
[Select "Small House"]

MATERIALS REQUIRED:
- 200× Wood (chop trees!)
- 100× Stone (mine rocks!)
- 50× Nails (craft from iron!)
- 20× Glass (smelt sand!)
- 10× Rope (craft from fiber!)

[Gather all materials] (takes time or zombie workers!)

[Place foundation at chosen location]

BUILD OPTIONS:
A) BUILD MANUALLY (player hammers, 8 hours!)
B) ASSIGN ZOMBIE WORKERS (5 zombies, 1 day!)
C) HIRE NPC BUILDER (costs 500g + materials, 6 hours!)

[Construction begins!]
[House finished after time!] ✅

TOTAL COST:
- Materials (gathered OR bought)
- Time (8 hours player OR 1 day zombies)
- Optional: Builder fee (500g)
```

---

### **MATERIAL GATHERING:**

```
WOOD: Chop trees (axe)
STONE: Mine rocks (pickaxe)
IRON: Mine ore → Smelt in furnace → Iron bars
GLASS: Dig sand → Smelt in furnace → Glass
NAILS: Craft from iron bars at anvil
ROPE: Craft from fiber (from plants!)
CLOTH: Weave from wool/cotton at loom

FREE if gathered yourself! ✅
OR buy from NPCs (costs gold!)
```

---

## 👥 **NPC FRIENDSHIP + ZOMBIE LENDING SYSTEM:**

### **FRIENDSHIP LEVELS:**

```
EACH NPC HAS FRIENDSHIP: 0-100%

LEVEL 1 (0-20%): Stranger
- Basic shop transactions
- Won't help you
- Expensive prices (+20%)

LEVEL 2 (21-40%): Acquaintance
- Normal prices
- Small discounts (5%)
- Basic conversations

LEVEL 3 (41-60%): Friend
- Good discounts (10%)
- Gives small gifts!
- Shares gossip/tips

LEVEL 4 (61-80%): Good Friend
- Better discounts (15%)
- **UNLOCKS: Zombie Lending!** ✅
- Gives better gifts!
- Invites to events

LEVEL 5 (81-100%): Best Friend
- BEST discounts (25%!)
- **Can borrow multiple zombies!**
- Gives rare gifts!
- Marriage candidate (if applicable!)
- Will help in emergencies!
```

---

### **HOW TO INCREASE FRIENDSHIP:**

```
TALK TO NPC DAILY: +1%
GIVE GIFTS (liked items): +5-15%
COMPLETE QUESTS FOR NPC: +20%
HELP IN EMERGENCIES: +30%!
MARRY (if applicable!): +100% (instant best friend!)

DECREASE FRIENDSHIP:
Give hated items: -10%
Ignore for 7 days: -5%
Attack NPC: -100% (instant enemy!)
```

---

### **ZOMBIE LENDING SYSTEM:**

```
[Reach Friendship Level 4 with NPC]

[NPC approaches you next day]

NPC: "Hey [Kai/Ana]! We're good friends now, right?
I could really use some help on my farm...
Could I maybe... borrow one of your zombie workers?
Just for a few days! I'll make it worth your while!"

OPTIONS:
A) "Sure! Take one of my zombies!" ✅
   [Lend 1 zombie for 3 days]
   
B) "I need them right now, sorry!"
   [Decline, no penalty]

C) "How about TWO zombies?" (if Level 5!)
   [Lend 2 zombies for 3 days!]
```

---

### **LENDING PROCESS:**

```
[You agree to lend zombie]

YOUR ZOMBIES: 5 total
[Select which zombie to lend:]
- Zombie Worker #1 (Miner, Level 5)
- Zombie Worker #2 (Farmer, Level 3) ✅
- Zombie Worker #3 (Lumberjack, Level 4)
- etc.

[Select Zombie Worker #2]

[Zombie walks to NPC's farm!]
[Works for NPC for 3 days]

YOUR FARM:
- Zombies remaining: 4/5
- Can still function! (slightly slower)

NPC'S FARM:
- Gets help from your zombie!
- NPC is grateful! ❤️
```

---

### **REWARDS AFTER LENDING:**

```
[3 days later]

[Zombie returns to your farm!]

NPC: "Thank you SO MUCH! Your zombie was a huge help!
Here's a little something for your kindness!"

REWARDS (RANDOM):
- 1,000-5,000 gold! 💰
- Rare blueprint! (furniture, weapon, etc!)
- Stack of rare materials! (50× mythril, etc!)
- Unique item! (NPC's specialty!)
- Recipe unlock! (NPC teaches you!)
- +10% friendship boost! ❤️

SPECIAL REWARDS (Level 5 friends):
- **Permanent discount (30%!)**
- **Free service once/week!**
- **Secret shop unlocked!** (rare items!)
- **NPC will work for YOU sometimes!** (trades places!)
```

---

### **EXAMPLES:**

**EXAMPLE 1: Blacksmith NPC**
```
[Lend zombie to Ivan the Blacksmith]

[3 days later, zombie returns]

IVAN: "Your zombie helped me finish urgent orders!
Here, take this weapon I crafted for you!"

REWARD: **Legendary Steel Sword** (worth 5,000g!)
+ Recipe: "Master Swordsmithing" unlocked!
+ Ivan's Friendship: +10% (now 85%!)
```

**EXAMPLE 2: Farmer NPC**
```
[Lend zombie to Marija the Farmer]

[3 days later]

MARIJA: "We harvested SO MUCH with your zombie!
Take half the crops!"

REWARD: 200× Wheat, 100× Corn, 50× Potatoes
Value: ~2,000g!
+ Recipe: "Farm Efficiency" (crops grow 5% faster!)
+ Marija's Friendship: +10% (now 72%!)
```

**EXAMPLE 3: Merchant NPC**
```
[Lend 2 zombies to Gregor the Merchant - Level 5 friend!]

[3 days later]

GREGOR: "Your zombies helped me move inventory!
Here's your cut of the profits!"

REWARD: **10,000 GOLD!!!** 💰💰💰
+ **Permanent VIP Status** (30% discount forever!)
+ **Secret Luxury Shop** unlocked! (sells rare items!)
+ Gregor's Friendship: 100% (maxed!)
```

---

## ✅ **COMPLETE SYSTEMS SUMMARY:**

### **20 BIOMES:**
- Each with unique plants, trees, animals, enemies
- Each with unique weapons, armor, food, buildings
- Must explore to unlock! (25% → 100% rewards!)

### **BUILDING:**
- Materials required! (wood, stone, glass, etc!)
- Can't just buy with gold! ✅
- Manual build OR zombie workers OR hire NPC builder!

### **NPC FRIENDSHIP:**
- 5 levels (Stranger → Best Friend)
- Increase via gifts, quests, daily talk
- Level 4: Unlock zombie lending!
- Level 5: Best rewards!

### **ZOMBIE LENDING:**
- Lend zombies to friendly NPCs!
- They work for NPC 3 days
- Return with rewards! (gold, items, blueprints!)
- Better friendship = better rewards!

---

**📁 ALL SYSTEMS DOCUMENTED IN 16 NEW FILES!**
**🎮 READY FOR INTEGRATION INTO FINAL_GAME_CONTENT_IN_OUT.md!**