ok

2026-01-20 01:05:17 +01:00
parent e4d01bc480
commit cbb2b64f92
5846 changed files with 1687 additions and 4494 deletions
--- a/docs/NEW_vs_EXISTING_NPCs.md
+++ b/docs/NEW_vs_EXISTING_NPCs.md
@@ -0,0 +1,260 @@
+# 🆕 NEW vs EXISTING NPCs - Complete Analysis
+**Last Updated:** 06.01.2026 at 15:24  
+**Purpose:** Identify which NPCs already exist vs. which are brand new
+
+---
+
+## 📊 SUMMARY
+
+| Category | Count |
+|----------|-------|
+| **Existing/Verified NPCs** | ~25 |
+| **NEW NPCs to Generate** | **~354** |
+| **TOTAL NPCs** | 379 |
+
+---
+
+# ✅ EXISTING NPCs (Already Defined/Generated)
+
+## Main Characters (4)
+1. ✅ **Kai Marković** (14, protagonist, alpha hybrid)
+2. ✅ **Ana Marković** (14, twin sister, scientist)
+3. ✅ **Gronk** (3m tall green troll, vapes, pink dreads)
+4. ✅ **Grok** (Gronk's cousin, dark magic, owns Susi)
+
+## Family (2)
+5. ✅ **Marko Marković** (father, dies Day 3)
+6. ✅ **Elena Marković** (mother, dies Day 3)
+
+## Villains/Bosses (2)
+7. ✅ **Dr. Krnić** (mad scientist villain, released virus)
+8. ✅ **Giant Troll King** (FINAL BOSS, Chernobyl)
+
+## Council of 11 Town NPCs (11) - Already Locked/Defined
+9. ✅ **Mayor Janez** (Ljubljana, elder statesman)
+10. ✅ **Ivan Kovač** (Blacksmith, master craftsman)
+11. ✅ **Mateja Novak** (General Store, merchant)
+12. ✅ **Petra Krajnc** (Innkeeper, warm host)
+13. ✅ **Andrej Kos** (Farmer, agriculture expert)
+14. ✅ **Luka Horvat** (Guard/Police Chief, protector)
+15. ✅ **Dr. Ana Chen** (Doctor/Healer, medical expert)
+16. ✅ **Father Marko** (Priest, spiritual leader)
+17. ✅ **Merchant Tomas** (Trader, exotic goods)
+18. ✅ **Old Jože** (Village Elder, wise counsel)
+19. ✅ **Young Nina** (Apprentice, eager learner)
+
+## Companions/Pets (2)
+20. ✅ **Susi** (Grok's terrier dog, hyperactive ADHD)
+21. ✅ **Zmaj Volk** (dragon-wolf, Ana's protector in Chernobyl)
+
+## Special NPCs (Maybe Existing - Need Verification)
+22. **Ghost Girl** (graveyard, marriage quest) - Status: Unknown
+23. **Glavni Smetar** (special character) - Status: Mentioned in KI
+24. **Zombie Scout** (companion, 5 evolutions) - Status: Defined
+
+**TOTAL EXISTING: ~25 NPCs** (4 main + 2 family + 2 villains + 11 council + 3 companions + 3 special)
+
+---
+
+# 🆕 NEW NPCs TO GENERATE (354 NPCs)
+
+## Breakdown by Category
+
+### 1. BIOME NPCs - **164 NEW**
+
+**Already have some (Council of 11 may overlap):**
+- Council of 11 are mostly in Ljubljana/Town Square
+- Some may appear in Grassland biome
+
+**Total Biome NPCs needed:** 189  
+**Minus existing that overlap:** ~25 (council + some specials)  
+**NEW BIOME NPCs:** **~164**
+
+### Biome-by-Biome New NPCs:
+
+| Biome | Total NPCs | Existing | NEW |
+|-------|------------|----------|-----|
+| Grassland 🌾 | 10 | ~3 (overlap with Ljubljana) | **7** |
+| Forest 🌲 | 6 | 0 | **6** |
+| Swamp 🐊 | 4 | 0 | **4** |
+| Desert 🏜️ | 8 | 0 | **8** |
+| Mountain ⛰️ | 6 | 0 | **6** |
+| Snow/Arctic ❄️ | 5 | 0 | **5** |
+| Wasteland ☢️ | 4 | 0 | **4** |
+| Tropical 🌴 | 10 | 0 | **10** |
+| Radioactive ☢️ | 3 | 0 | **3** |
+| Dino Valley 🦖 | 8 | 0 | **8** |
+| Mythical Highlands ✨ | 12 | 0 | **12** |
+| Endless Forest 👣 | 5 | 0 | **5** |
+| Loch Ness 🏴󠁧󠁢󠁳󠁣󠁴󠁿 | 15 | 0 | **15** |
+| Catacombs ⚰️ | 6 | 0 | **6** |
+| Egyptian Desert 🏺 | 12 | 0 | **12** |
+| Amazon Rainforest 🐍 | 12 | 0 | **12** |
+| Atlantis 🌊 | 17 | 0 | **17** |
+| Chernobyl ☢️ | 10 | 2 (Dr. Krnić, Troll King) | **8** |
+| Mexican Cenotes 🇲🇽 | 10 | 0 | **10** |
+| Witch Forest 🧙 | 8 | 0 | **8** |
+| **TOTAL** | **189** | **~25** | **~164** |
+
+---
+
+### 2. TOWN NPCs - **190 NEW**
+
+**Total town NPCs needed:** 190 (27 towns × 7 core NPCs avg)
+
+**Council of 11 are in Ljubljana only**, so:
+- Ljubljana: 11 existing (Council) + maybe 5-10 more = ~15-20 total
+- Other 26 towns: ~7 NPCs each = 182 NPCs
+
+**NEW TOWN NPCs needed:**
+- Ljubljana additions: ~5-10 new
+- Other 26 towns: ~180 new
+- **TOTAL NEW: ~190**
+
+### Town NPC Templates to Create:
+
+Each template needs 27 variants (one per town):
+
+1. **Mayor** - 27 variants (minus 1 existing = **26 new**)
+2. **Blacksmith** - 27 variants (minus 1 existing = **26 new**)
+3. **General Store Owner** - 27 variants (minus 1 existing = **26 new**)
+4. **Innkeeper** - 27 variants (minus 1 existing = **26 new**)
+5. **Farmer** - 27 variants (minus 1 existing = **26 new**)
+6. **Guard** - 27 variants (minus 1 existing = **26 new**)
+7. **Doctor** - 27 variants (minus 1 existing = **26 new**)
+
+**Plus additional:**
+8. **Priest** - ~15 towns = **15 new**
+9. **Merchant** - ~20 towns = **20 new**
+10. **Generic Villagers** - ~2-3 per town × 27 = **~60 new**
+
+**TOTAL NEW TOWN NPCs: ~190**
+
+---
+
+# 📈 COMPLETE NEW NPC LIST
+
+## Phase 1: Core Biome NPCs - **57 NEW**
+- Grassland (7 new)
+- Forest (6 new)
+- Mountain (6 new)
+- Desert (8 new)
+- Snow/Arctic (5 new)
+- Swamp (4 new)
+- Wasteland (4 new)
+- Tropical (10 new)
+- Radioactive (3 new)
+- Dino Valley (8 new)
+
+---
+
+## Phase 2: Magical Biome NPCs - **67 NEW**
+- Mythical Highlands (12 new)
+- Endless Forest (5 new)
+- Loch Ness (15 new)
+- Catacombs (6 new)
+- Egyptian Desert (12 new)
+- Amazon Rainforest (12 new)
+- Mexican Cenotes (10 new)
+- Witch Forest (8 new)
+
+---
+
+## Phase 3: Endgame Biome NPCs - **25 NEW**
+- Atlantis (17 new)
+- Chernobyl (8 new) - Dr. Krnić & Troll King already exist
+
+---
+
+## Phase 4: Town NPCs - **190 NEW**
+- Mayor variants (26 new)
+- Blacksmith variants (26 new)
+- Store Owner variants (26 new)
+- Innkeeper variants (26 new)
+- Farmer variants (26 new)
+- Guard variants (26 new)
+- Doctor variants (26 new)
+- Priest (15 new)
+- Merchant (20 new)
+- Villagers (~60 new)
+
+---
+
+# 🎨 SPRITE REQUIREMENTS FOR NEW NPCs
+
+## New NPCs: **354**
+
+**If Basic (20 sprites/NPC):**
+354 × 20 = **7,080 sprites**
+
+**If Minimum (4 sprites/NPC):**
+354 × 4 = **1,416 sprites**
+
+**If Full (28 sprites/NPC):**
+354 × 28 = **9,912 sprites**
+
+---
+
+# ✅ PRODUCTION CHECKLIST
+
+## Existing NPCs (No generation needed):
+- [x] Kai Marković ✅
+- [x] Ana Marković ✅
+- [x] Gronk ✅
+- [x] Grok ✅
+- [x] Marko Marković ✅
+- [x] Elena Marković ✅
+- [x] Dr. Krnić ✅
+- [x] Giant Troll King ✅
+- [x] Council of 11 (Ljubljana) ✅
+- [x] Susi (dog) ✅
+- [x] Zmaj Volk ✅
+
+**Total Existing: ~25**
+
+---
+
+## NEW NPCs to Generate:
+
+### Biome NPCs:
+- [ ] Phase 1: Core Biomes - **57 new NPCs**
+- [ ] Phase 2: Magical Biomes - **67 new NPCs**
+- [ ] Phase 3: Endgame Biomes - **25 new NPCs**
+
+### Town NPCs:
+- [ ] Phase 4: Town Templates - **190 new NPCs**
+
+**Total NEW to Generate: ~354 NPCs**
+
+---
+
+# 📊 FINAL SUMMARY
+
+| Category | Count | Status |
+|----------|-------|--------|
+| **Existing NPCs** | 25 | ✅ Already defined/generated |
+| **NEW NPCs** | **354** | ⬜ Need to generate |
+| **TOTAL NPCs** | 379 | - |
+| | | |
+| **Sprites for NEW NPCs** | **7,080** | (if 20 sprites/NPC) |
+| **OR Minimum sprites** | 1,416 | (if 4 sprites/NPC) |
+| **OR Full animation** | 9,912 | (if 28 sprites/NPC) |
+
+---
+
+## Recommended Approach:
+
+**Start with 4 sprites/NPC (minimum):**
+- 354 NPCs × 4 sprites = **1,416 sprites**
+- Faster production
+- Can upgrade to full animation later
+
+**Then upgrade to 20 sprites/NPC:**
+- Add walk cycles
+- Add idle animations
+- Total: 7,080 sprites eventually
+
+---
+
+**Status:** Ready for NPC generation!  
+**Priority:** Start with Phase 1 (Core Biome NPCs - 57 new)