diff --git a/BIOME_UNLOCKABLES_NPC_VILLAGES.md b/BIOME_UNLOCKABLES_NPC_VILLAGES.md new file mode 100644 index 000000000..962886c41 --- /dev/null +++ b/BIOME_UNLOCKABLES_NPC_VILLAGES.md @@ -0,0 +1,511 @@ +# πŸ—ΊοΈπŸ˜οΈ **BIOME UNLOCKABLES + NPC VILLAGES - Complete System** + +## πŸ”“ **BIOME-SPECIFIC UNLOCK SYSTEM:** + +### **THE RULE:** +``` +βœ… Each biome has UNIQUE content! +βœ… Plants, Seeds, Weapons, Armor, Food, Buildings! +βœ… ONLY available in that biome! +βœ… Must explore to unlock! βœ… +``` + +--- + +## 🌍 **20 BIOMES - UNIQUE UNLOCKABLES:** + +### **1. DINO VALLEY** πŸ¦– + +**UNIQUE PLANTS/SEEDS:** +``` +- Prehistoric Ferns (decorative!) +- Giant Mushrooms (food source!) +- Cycad Palms (wood alternative!) +- Dino Eggs (hatch β†’ baby dino!) +``` + +**UNIQUE WEAPONS:** +``` +- Bone Axe (primitive, high damage!) +- Stone Spear (throwable!) +- Dino Tooth Knife (bleeding effect!) +- Obsidian Blade (sharp!) +``` + +**UNIQUE ARMOR:** +``` +- Dino Hide Armor (high defense!) +- Bone Helmet (headbutt attack!) +- Scale Boots (+speed in grass!) +- Tooth Necklace (+intimidation!) +``` + +**UNIQUE FOOD:** +``` +- T-Rex Steak (+100 HP! best meat!) +- Dino Eggs (+50 HP, protein!) +- Dino Jerky (preserves forever!) +- Bone Broth (+30 HP + stamina!) +``` + +**UNIQUE BUILDINGS:** +``` +- Primitive Hut (starter shelter!) +- Bone Fence (decoration + defense!) +- Stone Altar (ritual site!) +- Tar Pit Trap (catches dinos!) +``` + +--- + +### **2. CHERNOBYL** ☒️ + +**UNIQUE PLANTS:** +``` +- Mutated Grass (glowing green!) +- Radioactive Flowers (alchemy!) +- Toxic Mushrooms (poison craft!) +- Dead Trees (dark aesthetic!) +``` + +**UNIQUE WEAPONS:** +``` +- Lead Pipe (blunt, simple!) +- Contaminated Axe (+radiation damage!) +- **SHOTGUN!** (ONLY in Chernobyl!) +- Makeshift Weapons (scrap metal!) +``` + +**UNIQUE ARMOR:** +``` +- **HAZMAT SUIT** (radiation immune!) +- Gas Mask (breathing protection!) +- Lead Vest (radiation shield!) +- Protective Boots (walk on toxic ground!) +``` + +**UNIQUE FOOD:** +``` +- Canned Food (pre-war, rare!) +- Military Rations (MRE, sealed!) +- Radiation Pills (medicine!) +- Purified Water (rare, essential!) +``` + +**UNIQUE BUILDINGS:** +``` +- Reactor Building (ruin exploration!) +- Underground Bunker (safe haven!) +- Military Checkpoint (loot spot!) +- Decontamination Station (cleanse items!) +``` + +--- + +### **3. MYTHICAL HIGHLANDS** πŸ”οΈβœ¨ + +**UNIQUE PLANTS:** +``` +- **Cloud Flowers** (float in air!) +- Dragon Fruit Trees (magic fruit!) +- Mythril Ore Veins (legendary metal!) +- Crystal Mushrooms (glowing!) +``` + +**UNIQUE WEAPONS:** +``` +- **Mythril Sword** (legendary!) +- Dragon Bone Spear (fire enchant!) +- Unicorn Horn Lance (holy damage!) +- Griffin Feather Bow (accuracy+!) +``` + +**UNIQUE ARMOR:** +``` +- **Dragon Scale Armor** (best defense!) +- Pegasus Wing Cape (glide ability!) +- Unicorn Hide Boots (+healing!) +- Mythril Crown (prestige!) +``` + +**UNIQUE FOOD:** +``` +- Dragon Steak (legendary! +100 HP!) +- Phoenix Egg Omelet (revive buff!) +- Ambrosia (god food, max HP!) +- Cloud Bread (fluffy, +fly buff!) +``` + +**UNIQUE BUILDINGS:** +``` +- Sky Temple (worship site!) +- Dragon's Nest (taming spot!) +- Crystal Tower (wizard home!) +- Cloud Platform (floating base!) +``` + +--- + +### **4. ATLANTIS** 🌊 + +**UNIQUE PLANTS:** +``` +- **Kelp Forest** (farm underwater!) +- Coral (decorative, valuable!) +- Sea Anemones (defense plant!) +- Underwater Lotus (rare flower!) +``` + +**UNIQUE WEAPONS:** +``` +- Trident (Poseidon's weapon!) +- Coral Sword (sharp edges!) +- Harpoon Gun (underwater!) +- Pearl Staff (magic!) +``` + +**UNIQUE ARMOR:** +``` +- **Diving Suit** (underwater breathing!) +- Shell Armor (high defense!) +- Pearl Necklace (+30 sec breath!) +- Diving Flippers (+swim speed!) +``` + +**UNIQUE FOOD:** +``` +- Kelp Noodles (sushi!) +- Pearl Oysters (luxury food!) +- Deep Sea Fish (rare!) +- Atlantean Bread (waterproof!) +``` + +**UNIQUE BUILDINGS:** +``` +- Underwater Dome (air bubble!) +- Coral House (natural shelter!) +- Atlantean Temple (ruins!) +- Submarine Dock (vehicle!) +``` + +--- + +### **5. WITCH FOREST** πŸŒ‘πŸ§™ + +**UNIQUE PLANTS:** +``` +- **Shadow Berries** (dark alchemy!) +- Cursed Mushrooms (poison!) +- Witch Herbs (potion ingredients!) +- Haunted Flowers (spooky!) +``` + +**UNIQUE WEAPONS:** +``` +- Witch Staff (magic attacks!) +- Cursed Dagger (hex effect!) +- Broom (melee + ride!) +- Shadow Bow (invisible arrows!) +``` + +**UNIQUE ARMOR:** +``` +- Witch Robe (magic resist!) +- Pointy Hat (traditional!) +- Shadow Cloak (stealth!) +- Cursed Boots (+dark magic!) +``` + +**UNIQUE FOOD:** +``` +- Witch's Brew (potion!) +- Cursed Apples (risky!) +- Shadow Soup (dark energy!) +- Magic Tea (mana restore!) +``` + +**UNIQUE BUILDINGS:** +``` +- Witch Hut (home!) +- Cauldron Station (brewing!) +- Dark Altar (rituals!) +- Enchanted Garden (plants!) +``` + +--- + +## 🏘️ **NPC VILLAGE BUILDING SYSTEM:** + +### **HOW IT WORKS:** + +``` +PLAYER CAN BUILD VILLAGE FOR NPCs! + +REQUIREMENTS: +- Cleared farmland (24Γ—24 min!) +- 10,000 gold starting budget +- Materials (wood, stone, etc.) +- NPC invitation quests + +RESULT: NPCs move in, create village! βœ… +``` + +--- + +### **VILLAGE COMPONENTS:** + +**1. HOUSING (Required!):** +``` +[Build NPC Houses] + +SMALL HOUSE: +- Materials: 200 wood, 100 stone +- Cost: 1,000g +- Capacity: 1 NPC +- Build time: 2 days (zombies: 1 day) + +MEDIUM HOUSE: +- Materials: 400 wood, 200 stone +- Cost: 2,500g +- Capacity: 2-3 NPCs (family!) +- Build time: 5 days + +LARGE HOUSE: +- Materials: 800 wood, 400 stone, 100 glass +- Cost: 5,000g +- Capacity: 5+ NPCs (mansion!) +- Build time: 10 days + +BUILD 5-10 HOUSES = VILLAGE HOUSING! βœ… +``` + +--- + +**2. SHOPS (Services!):** +``` +[Build Shop Buildings] + +GENERAL STORE: +- Materials: 300 wood, 150 stone, 50 glass +- Cost: 2,000g +- NPC: Shopkeeper (sells basics!) +- Services: Buy/sell items + +BLACKSMITH: +- Materials: 500 iron, 200 stone, 100 coal +- Cost: 3,000g +- NPC: Blacksmith (repairs, craft!) +- Services: Weapon/armor repair, crafting + +TAILOR SHOP: +- Materials: 200 wood, 100 cloth, 50 thread +- Cost: 1,500g +- NPC: Tailor (clothing!) +- Services: Clothes, dyes, blueprints + +TAVERN/INN: +- Materials: 400 wood, 200 stone, 100 glass +- Cost: 3,500g +- NPCs: Bartender, Cook +- Services: Food, drink, sleep (5 rooms!) + +CHURCH: +- Materials: 600 stone, 200 wood, 150 glass +- Cost: 5,000g +- NPC: Priest +- Services: Heal, marriage, blessings +``` + +--- + +**3. INFRASTRUCTURE:** + +``` +ROADS: +- Place stone paths between buildings! +- Materials: Stone (cheap!) +- Makes village look organized! + +STREET LAMPS: +- Light up village at night! +- Materials: 10 iron, 5 glass each +- Place every 10m! + +FOUNTAIN (Center piece!): +``` +- Materials: 300 stone, 100 water +- Cost: 1,000g +- Decoration + water source! + +TOWN SQUARE: +- Open area 16Γ—16 +- Place benches, statues! +- NPCs gather here! +``` + +--- + +**4. DEFENSES:** + +``` +VILLAGE WALL: +- Materials: 1,000 stone, 500 wood +- Cost: 5,000g +- Protects from zombie raids! + +GUARD TOWER: +- Materials: 300 stone, 200 wood +- Cost: 2,000g +- NPC: Guard (defense!) +- Shoots zombies automatically! + +GATE: +- Materials: 200 iron, 100 wood +- Cost: 1,500g +- Opens for player/NPCs, blocks zombies! +``` + +--- + +### **VILLAGE PROGRESSION:** + +**TIER 1: HAMLET (5 NPCs)** +``` +Buildings: +- 3Γ— Small Houses +- 1Γ— General Store +- 1Γ— Well + +Population: 5 NPCs +Services: Basic shop +Cost: ~10,000g +``` + +**TIER 2: VILLAGE (15 NPCs)** +``` +Buildings: +- 7Γ— Houses (mix) +- General Store +- Blacksmith +- Tavern +- Roads + Lamps + +Population: 15 NPCs +Services: Shop, repair, food, sleep! +Cost: ~30,000g +``` + +**TIER 3: TOWN (50 NPCs)** +``` +Buildings: +- 20Γ— Houses +- All shops (5+) +- Church +- Town Square +- Wall + Guard Towers + +Population: 50 NPCs +Services: Everything! +Cost: ~100,000g +``` + +**TIER 4: CITY (100+ NPCs!)** +``` +Buildings: +- 50+ Houses +- Multiple shops (10+) +- Cathedral +- Market District +- Full fortification + +Population: 100+ NPCs +Services: MASSIVE economy! +Cost: ~500,000g!!! +``` + +--- + +### **NPC INVITATION SYSTEM:** + +``` +[Build house] +[House is empty] + +[Complete NPC quest] +QUEST: "Help the Wandering Merchant" + +[Quest Complete!] +NPC: "Thank you! May I live in your village?" + +OPTIONS: +A) "Yes! My village welcomes you!" βœ… + β†’ NPC moves into empty house! + β†’ Opens shop if assigned! + +B) "Not yet, maybe later" + β†’ NPC waits, can invite later + +[NPC MOVES IN!] +[Village population: +1] +[New services available!] +``` + +--- + +## πŸ“Š **BIOME UNLOCK PROGRESSION:** + +### **EXPLORATION REWARDS:** + +``` +DISCOVER BIOME: +βœ… Map reveals area +βœ… Can teleport (if station repaired) + +EXPLORE 25% OF BIOME: +βœ… Unlock basic recipes (food, tools) +βœ… 1 NPC invitation quest appears + +EXPLORE 50% OF BIOME: +βœ… Unlock advanced recipes (weapons, armor) +βœ… 2 more NPC quests +βœ… Special blueprint drops + +EXPLORE 75% OF BIOME: +βœ… Unlock unique buildings +βœ… Boss location revealed +βœ… Rare crafts unlocked + +100% COMPLETE BIOME: +βœ… ALL recipes unlocked! +βœ… Master NPC quest (village leader!) +βœ… Biome-themed outfit (cosmetic!) +βœ… Achievement! πŸ† +βœ… Permanent +5% stats in that biome! +``` + +--- + +## βœ… **SUMMARY:** + +**BIOME UNLOCKS:** +- Each of 20 biomes = unique content! +- Plants, weapons, armor, food, buildings! +- Explore to unlock! (25% β†’ 100%) + +**NPC VILLAGES:** +- Build houses for NPCs! +- 4 tiers: Hamlet β†’ City! +- Services: Shops, blacksmith, tavern, church! +- Defenses: Walls, towers, gates! + +**PROGRESSION:** +- Hamlet: 5 NPCs, 10,000g +- Village: 15 NPCs, 30,000g +- Town: 50 NPCs, 100,000g +- **CITY: 100+ NPCs, 500,000g!!!** + +--- + +**βœ… BIOME VARIETY + VILLAGE BUILDING COMPLETE!** πŸ—ΊοΈπŸ˜οΈ + +**Next: Consolidate ALL today's systems into FINAL_GAME_CONTENT_IN_OUT.md!**