ok

2026-01-20 01:05:17 +01:00
parent e4d01bc480
commit cbb2b64f92
5846 changed files with 1687 additions and 4494 deletions
--- a/docs/BIOME_BUILDINGS_AND_NPCS_TOTALS.md
+++ b/docs/BIOME_BUILDINGS_AND_NPCS_TOTALS.md
@@ -0,0 +1,251 @@
+# 🏘️ BUILDINGS & NPCs - COMPLETE BIOME TOTALS
+**Last Updated:** 06.01.2026 at 15:03  
+**Scope:** All 20 Biomes (excluding 27 towns)
+
+---
+
+## 📊 QUICK SUMMARY
+
+| Category | Total Count |
+|----------|-------------|
+| **Total Buildings/Structures** | **192 unique buildings** |
+| **Total NPCs (Biome-specific)** | **163-215 NPCs** (avg ~189) |
+| **Total NPCs (Including 27 towns)** | **~350-400 NPCs** |
+
+---
+
+# 🏛️ BUILDINGS/STRUCTURES BY BIOME
+
+## Detailed Breakdown
+
+| # | Biome | Buildings Count | Building Types |
+|---|-------|-----------------|----------------|
+| 1 | Grassland 🌾 | **8** | Barn ruins (3), Wells (2), Fences, Watchtower, Farmhouse ruins |
+| 2 | Forest 🌲 | **6** | Hunting cabin, Watchtower, Log pile, Ranger station, Hidden treehouse |
+| 3 | Swamp 🐊 | **4** | Shack on stilts, Rotting dock, Sunken boat, Witch hut |
+| 4 | Desert 🏜️ | **7** | Sandstone ruins (3), Small pyramid, Oasis well, Nomad tent, Ancient temple |
+| 5 | Mountain ⛰️ | **5** | Stone bridge ruins, Mountain shrine, Cave entrance, Miner's hut, Watchtower |
+| 6 | Snow/Arctic ❄️ | **5** | Igloo (3), Ice cave, Research station, Frozen ruins |
+| 7 | Wasteland ☢️ | **8** | Ruined buildings (3), Collapsed bridge, Abandoned vehicle (2), Scavenger camp, Bunker entrance |
+| 8 | Tropical 🌴 | **8** | Tribal hut (5), Totem pole (2), Rope bridge, Beach cabana, Treehouse |
+| 9 | Radioactive ☢️ | **5** | Reactor ruins, Contamination tent, Hazmat storage, Research bunker, Observation tower |
+| 10 | Dino Valley 🦖 | **7** | Dino nest (3 sizes), Cave entrance (large), Skeleton display, Research station, Observation tower, Ranger hut |
+| 11 | Mythical Highlands 🏔️✨ | **12** | Elven ruins (6), Magical portal, Unicorn shrine, Dragon roost, Enchanter's tower, Fairy grove, Crystal palace |
+| 12 | Endless Forest 🌲👣 | **5** | Bigfoot cave, Logger cabin (abandoned), Mysterious stone circle, Witch hut, Ancient ruins |
+| 13 | Loch Ness 🏴󠁧󠁢󠁳󠁣󠁴󠁿 | **15** | Scottish castle ruins (10 pieces), Stone bridge, Celtic cairn, Village (5 houses), Pub, Blacksmith |
+| 14 | Catacombs ⚰️ | **12** | Stone pillars (3), Crypts (4), Altar (dark), Tomb entrance, Sarcophagi (20+), Necromancer's chamber |
+| 15 | Egyptian Desert 🏺 | **18** | Pyramid exterior (3), Pyramid interior (10 rooms), Sphinx statue, Obelisk (2), Temple ruins (5), Tomb entrance |
+| 16 | Amazon Rainforest 🐍 | **10** | Tribal village hut (5), Treehouse platform (3), Rope bridge (2), Ritual altar, Shaman's hut |
+| 17 | Atlantis 🌊 | **20** | Atlantean ruins (10), Underwater temple, Portal, Bubble dome, Palace (5 sections), Market, Library |
+| 18 | Chernobyl ☢️🏭 | **15** | Reactor building (7 levels!), Soviet apartment (5), Military checkpoint, Cooling tower, Research bunker, Hazmat storage, Control room, Pripyat ruins (10) |
+| 19 | Mexican Cenotes 🇲🇽 | **12** | Mayan pyramid, Temple ruins (6), Stone altar (2), Underground passage (3), Village (5 huts) |
+| 20 | Witch Forest 🧙 | **10** | Witch hut (5), Baba Yaga's Hut (walking!), Dark altar (2), Hanging cages, Cauldron area, Ritual circle |
+
+### **TOTAL BUILDINGS: 192 unique structures**
+
+---
+
+# 👥 NPCs BY BIOME
+
+## Detailed Breakdown
+
+| # | Biome | NPC Count | NPC Types |
+|---|-------|-----------|-----------|
+| 1 | Grassland 🌾 | **8-12** (avg 10) | Farmers, Merchants, Townsfolk from Ljubljana |
+| 2 | Forest 🌲 | **5-8** (avg 6) | Logger, Hermit, Hunter, Ranger, Mushroom Picker |
+| 3 | Swamp 🐊 | **3-5** (avg 4) | Swamp Witch, Potion Seller, Exiled Hermit, Fisherman |
+| 4 | Desert 🏜️ | **6-10** (avg 8) | Nomad Traders (4), Oasis Keeper, Archaeologist, Treasure Hunter |
+| 5 | Mountain ⛰️ | **5-7** (avg 6) | Mountain Guide, Miner, Shrine Keeper, Hermit, Yeti Hunter |
+| 6 | Snow/Arctic ❄️ | **4-6** (avg 5) | Inuit Elder, Ice Fisherman, Trader, Explorer, Scientist |
+| 7 | Wasteland ☢️ | **3-5** (avg 4) | Scavenger, Mad Survivor, Raider (hostile), Trader (rare) |
+| 8 | Tropical 🌴 | **8-12** (avg 10) | Tribal Chief, Warriors (4), Shaman, Traders (2), Beach Vendor, Fisherman |
+| 9 | Radioactive ☢️ | **2-4** (avg 3) | Scientist (mad), Hazmat Trader, Mutant Hunter, Radiation Cult Leader |
+| 10 | Dino Valley 🦖 | **6-10** (avg 8) | Dino Keeper, Paleontologist, Researcher (3), Ranger, Fossil Hunter, Egg Trader |
+| 11 | Mythical Highlands 🏔️✨ | **10-15** (avg 12) | Elven Elder, Unicorn Keeper, Griffin Rider, Mages (3), Fairy Queen, Enchanters (2), Dragon Tamer, Merchants (2) |
+| 12 | Endless Forest 🌲👣 | **4-6** (avg 5) | Logger (lost), Cryptid Hunter, Forest Hermit, Witch (neutral), Tracker |
+| 13 | Loch Ness 🏴󠁧󠁢󠁳󠁣󠁴󠁿 | **12-18** (avg 15) | Scottish Villagers (10), Leprechaun, Castle Lord, Fisherman (2), Bagpiper, Blacksmith, Innkeeper |
+| 14 | Catacombs ⚰️ | **5-8** (avg 6) | Necromancer, Grave Keeper, Archaeologist, Tomb Raider, Priest (exorcist), Ghost (friendly) |
+| 15 | Egyptian Desert 🏺 | **10-15** (avg 12) | Pharaoh (ghost), Egyptian Guards (4), Archaeologists (3), Traders (2), Priests (2), Sphinx Oracle, Treasure Hunters (2) |
+| 16 | Amazon Rainforest 🐍 | **10-15** (avg 12) | Tribal Chief, Warriors (5), Shaman (2), Traders (2), Explorer (lost), Scientist, Healer |
+| 17 | Atlantis 🌊 | **15-20** (avg 17) | Atlantean King, Guards (5), Merchants (3), Mermaids (5), Scholars (3), Engineers (2), Oracle |
+| 18 | Chernobyl ☢️🏭 | **8-12** (avg 10) | Dr. Krnić (villain!), Soviet Soldiers (3), Scientists (2), Scavengers (2), Hazmat Trader, Stalker, Radiation Cultist |
+| 19 | Mexican Cenotes 🇲🇽 | **8-12** (avg 10) | Mayan Priest, Villagers (5), Archaeologists (2), Diver, Cenote Guide, Shaman, Jade Merchant |
+| 20 | Witch Forest 🧙 | **6-10** (avg 8) | Baba Yaga (BOSS!), Witches (3 types), Black Cat (familiar), Cursed Knight, Lost Child (ghost), Potion Seller, Herbalist |
+
+### **BIOME NPCs TOTAL:**
+- **Low Estimate:** 163 NPCs
+- **High Estimate:** 215 NPCs
+- **Average:** ~189 NPCs
+
+---
+
+# 🏙️ ADDITIONAL NPCs (27 TOWNS)
+
+## Town NPC Distribution
+
+Each of the **27 towns** has:
+- **5-10 NPCs per town** (depending on town size)
+- Total town NPCs: **135-270 NPCs**
+
+### Town NPC Types (Standard):
+- Mayor
+- Blacksmith
+- General Store Owner
+- Innkeeper
+- Farmer
+- Guard
+- Doctor/Healer
+- Priest
+- Merchant
+- Villagers (2-5 per town)
+
+---
+
+# 📈 GRAND TOTAL
+
+## Complete NPC Count (Biomes + Towns)
+
+| Category | Count |
+|----------|-------|
+| **Biome-specific NPCs** | 163-215 |
+| **Town NPCs (27 towns)** | 135-270 |
+| **TOTAL NPCs** | **298-485** |
+| **Realistic Average** | **~380 NPCs** |
+
+## Complete Building Count
+
+| Category | Count |
+|----------|-------|
+| **Biome Buildings** | 192 |
+| **Town Buildings** | ~500 (27 towns × 15-20 buildings avg) |
+| **TOTAL Buildings** | **~692 structures** |
+
+---
+
+# 🎯 TOP 5 BIOMES - Most Buildings
+
+| Rank | Biome | Buildings | Why? |
+|------|-------|-----------|------|
+| 1 | **Atlantis 🌊** | 20 | Entire underwater city! Palace, temple, ruins |
+| 2 | **Egyptian Desert 🏺** | 18 | Pyramids (interior + exterior), temples, sphinx |
+| 3 | **Loch Ness 🏴󠁧󠁢󠁳󠁣󠁴󠁿** | 15 | Scottish castle ruins (10 pieces), village |
+| 4 | **Chernobyl ☢️** | 15 | Reactor (7 levels), Soviet apartments, Pripyat |
+| 5 | **Mythical Highlands ✨** | 12 | Elven ruins, magical structures, crystal palace |
+
+---
+
+# 🎯 TOP 5 BIOMES - Most NPCs
+
+| Rank | Biome | NPCs | Why? |
+|------|-------|------|------|
+| 1 | **Atlantis 🌊** | 15-20 | Full underwater civilization! |
+| 2 | **Loch Ness 🏴󠁧󠁢󠁳󠁣󠁴󠁿** | 12-18 | Scottish village + castle inhabitants |
+| 3 | **Egyptian Desert 🏺** | 10-15 | Pharaoh court, archaeologists, priests |
+| 4 | **Amazon Rainforest 🐍** | 10-15 | Tribal village with chief, warriors, shamans |
+| 5 | **Mythical Highlands ✨** | 10-15 | Elves, mages, enchanters, fairy queen |
+
+---
+
+# 🎯 SMALLEST BIOMES (Minimal Content)
+
+| Rank | Biome | Buildings | NPCs | Why Small? |
+|------|-------|-----------|------|------------|
+| 1 | **Radioactive ☢️** | 5 | 2-4 | Extreme danger zone, few survivors |
+| 2 | **Swamp 🐊** | 4 | 3-5 | Hostile environment, few inhabitants |
+| 3 | **Wasteland ☢️** | 8 | 3-5 | Post-apocalypse ruins, scarce population |
+| 4 | **Mountain ⛰️** | 5 | 5-7 | Remote, high altitude, harsh conditions |
+| 5 | **Endless Forest 🌲👣** | 5 | 4-6 | Creepy, dangerous, people avoid it |
+
+---
+
+# 📋 PRODUCTION CHECKLIST
+
+## Buildings Production Status
+
+- [ ] **192 biome buildings** (0/192 completed)
+- [ ] **~500 town buildings** (0/500 completed)
+- [ ] **Total: ~692 structures** (0/692 completed)
+
+**Estimated Time per Building:** 15-30 minutes  
+**Total Building Time:** ~173-346 hours (7-14 days full-time!)
+
+## NPCs Production Status
+
+- [ ] **189 biome NPCs** (0/189 completed)
+- [ ] **~190 town NPCs** (0/190 completed)
+- [ ] **Total: ~380 NPCs** (0/380 completed)
+
+**Assets per NPC:** 
+- 4 directions × 1 idle = 4 sprites minimum
+- 4 directions × 4 walk frames = 16 sprites (if animated)
+- **Average: 8-20 sprites per NPC**
+
+**Total NPC Sprites:** ~3,040-7,600 sprites!
+
+---
+
+# 🚀 RECOMMENDED PRODUCTION ORDER
+
+## Phase 1: Core Biomes (Simple)
+1. Grassland - 8 buildings, 10 NPCs
+2. Forest - 6 buildings, 6 NPCs
+3. Mountain - 5 buildings, 6 NPCs
+
+**Phase 1 Total:** 19 buildings, 22 NPCs
+
+## Phase 2: Medium Biomes
+4. Desert - 7 buildings, 8 NPCs
+5. Snow/Arctic - 5 buildings, 5 NPCs
+6. Swamp - 4 buildings, 4 NPCs
+7. Tropical - 8 buildings, 10 NPCs
+8. Wasteland - 8 buildings, 4 NPCs
+
+**Phase 2 Total:** 32 buildings, 31 NPCs
+
+## Phase 3: Complex Biomes
+9. Dino Valley - 7 buildings, 8 NPCs
+10. Radioactive - 5 buildings, 3 NPCs
+11. Endless Forest - 5 buildings, 5 NPCs
+12. Witch Forest - 10 buildings, 8 NPCs
+13. Catacombs - 12 buildings, 6 NPCs
+14. Mexican Cenotes - 12 buildings, 10 NPCs
+
+**Phase 3 Total:** 51 buildings, 40 NPCs
+
+## Phase 4: Massive Biomes
+15. Mythical Highlands - 12 buildings, 12 NPCs
+16. Loch Ness - 15 buildings, 15 NPCs
+17. Amazon Rainforest - 10 buildings, 12 NPCs
+18. Egyptian Desert - 18 buildings, 12 NPCs
+
+**Phase 4 Total:** 55 buildings, 51 NPCs
+
+## Phase 5: ENDGAME
+19. Atlantis - 20 buildings, 17 NPCs
+20. Chernobyl - 15 buildings, 10 NPCs
+
+**Phase 5 Total:** 35 buildings, 27 NPCs
+
+---
+
+# 📊 FINAL SUMMARY
+
+| Item | Count |
+|------|-------|
+| **Total Biome Buildings** | 192 |
+| **Total Town Buildings** | ~500 |
+| **TOTAL BUILDINGS** | **~692** |
+| | |
+| **Total Biome NPCs** | ~189 |
+| **Total Town NPCs** | ~190 |
+| **TOTAL NPCs** | **~380** |
+| | |
+| **NPC Sprites (avg 8-20 per NPC)** | **3,040-7,600** |
+| **Building Sprites (1-5 per building)** | **~1,400-3,500** |
+| **TOTAL SPRITES (Buildings + NPCs)** | **4,440-11,100** |
+
+---
+
+**Last Updated:** 06.01.2026 at 15:03  
+**Status:** Ready for production planning!  
+**Next Step:** Begin Phase 1 (Grassland, Forest, Mountain)