# 👥 NPC GENERATION LIST - For Review & Production
**Last Updated:** 06.01.2026 at 15:21  
**Purpose:** Complete list of ALL NPCs that need to be generated

---

## 📊 TOTAL NPC COUNT

| Category | Count |
|----------|-------|
| **Biome NPCs** | **189 NPCs** |
| **Town NPCs** | **190 NPCs** (27 towns × 5-10 avg) |
| **GRAND TOTAL** | **~380 NPCs** |

---

# 🌍 BIOME NPCs (189 Total)

## 1. GRASSLAND 🌾 - **10 NPCs**
1. Farmer #1
2. Farmer #2
3. Merchant (general goods)
4. Merchant (seeds)
5. Townsfolk #1 (from Ljubljana)
6. Townsfolk #2 (from Ljubljana)
7. Townsfolk #3 (from Ljubljana)
8. Field Worker
9. Shepard
10. Livestock Trader

---

## 2. FOREST 🌲 - **6 NPCs**
1. Logger
2. Hermit (old man)
3. Hunter
4. Ranger (forest guardian)
5. Mushroom Picker (old woman)
6. Herbalist

---

## 3. SWAMP 🐊 - **4 NPCs**
1. Swamp Witch
2. Potion Seller
3. Exiled Hermit
4. Fisherman (swamp)

---

## 4. DESERT 🏜️ - **8 NPCs**
1. Nomad Trader #1
2. Nomad Trader #2
3. Nomad Trader #3
4. Nomad Trader #4
5. Oasis Keeper
6. Archaeologist
7. Treasure Hunter
8. Desert Guide

---

## 5. MOUNTAIN ⛰️ - **6 NPCs**
1. Mountain Guide
2. Miner
3. Shrine Keeper
4. Mountain Hermit
5. Yeti Hunter
6. Climbing Instructor

---

## 6. SNOW/ARCTIC ❄️ - **5 NPCs**
1. Inuit Elder
2. Ice Fisherman
3. Trader (furs)
4. Explorer (lost)
5. Scientist (research station)

---

## 7. WASTELAND ☢️ - **4 NPCs**
1. Scavenger
2. Mad Survivor
3. Raider (hostile)
4. Trader (rare, hidden)

---

## 8. TROPICAL 🌴 - **10 NPCs**
1. Tribal Chief
2. Warrior #1
3. Warrior #2
4. Warrior #3
5. Warrior #4
6. Shaman
7. Trader #1 (exotic goods)
8. Trader #2 (fruits)
9. Beach Vendor
10. Fisherman (tropical)

---

## 9. RADIOACTIVE ☢️ - **3 NPCs**
1. Mad Scientist
2. Hazmat Trader
3. Mutant Hunter

---

## 10. DINO VALLEY 🦖 - **8 NPCs**
1. Dino Keeper
2. Paleontologist
3. Researcher #1
4. Researcher #2
5. Researcher #3
6. Ranger (dino patrol)
7. Fossil Hunter
8. Egg Trader

---

## 11. MYTHICAL HIGHLANDS 🏔️✨ - **12 NPCs**
1. Elven Elder
2. Unicorn Keeper
3. Griffin Rider
4. Mage #1 (fire)
5. Mage #2 (ice)
6. Mage #3 (nature)
7. Fairy Queen
8. Enchanter #1
9. Enchanter #2
10. Dragon Tamer
11. Merchant #1 (magical items)
12. Merchant #2 (potions)

---

## 12. ENDLESS FOREST 🌲👣 - **5 NPCs**
1. Lost Logger
2. Cryptid Hunter
3. Forest Hermit
4. Neutral Witch
5. Tracker

---

## 13. LOCH NESS 🏴󠁧󠁢󠁳󠁣󠁴󠁿 - **15 NPCs**
1. Scottish Villager #1
2. Scottish Villager #2
3. Scottish Villager #3
4. Scottish Villager #4
5. Scottish Villager #5
6. Scottish Villager #6
7. Scottish Villager #7
8. Scottish Villager #8
9. Scottish Villager #9
10. Scottish Villager #10
11. Leprechaun (magical merchant)
12. Castle Lord
13. Fisherman #1
14. Fisherman #2
15. Bagpiper
16. Blacksmith
17. Innkeeper

**Note:** 17 total (15 avg used in calculations)

---

## 14. CATACOMBS ⚰️ - **6 NPCs**
1. Necromancer (hostile/neutral)
2. Grave Keeper
3. Archaeologist (tomb raider)
4. Tomb Raider (adventurer)
5. Priest (exorcist)
6. Friendly Ghost (NPC)

---

## 15. EGYPTIAN DESERT 🏺 - **12 NPCs**
1. Pharaoh (ghost)
2. Egyptian Guard #1
3. Egyptian Guard #2
4. Egyptian Guard #3
5. Egyptian Guard #4
6. Archaeologist #1
7. Archaeologist #2
8. Archaeologist #3
9. Trader #1 (artifacts)
10. Trader #2 (gold)
11. Priest #1
12. Priest #2
13. Sphinx Oracle
14. Treasure Hunter #1
15. Treasure Hunter #2

**Note:** 15 total (12 avg used)

---

## 16. AMAZON RAINFOREST 🐍 - **12 NPCs**
1. Tribal Chief
2. Warrior #1
3. Warrior #2
4. Warrior #3
5. Warrior #4
6. Warrior #5
7. Shaman #1 (medicine)
8. Shaman #2 (spirits)
9. Trader #1 (fruits)
10. Trader #2 (poison)
11. Lost Explorer
12. Scientist (research)
13. Healer (tribal medicine woman)

**Note:** 13 total (12 avg)

---

## 17. ATLANTIS 🌊 - **17 NPCs**
1. Atlantean King
2. Royal Guard #1
3. Royal Guard #2
4. Royal Guard #3
5. Royal Guard #4
6. Royal Guard #5
7. Merchant #1 (pearls)
8. Merchant #2 (coral)
9. Merchant #3 (crystals)
10. Mermaid #1
11. Mermaid #2
12. Mermaid #3
13. Mermaid #4
14. Mermaid #5
15. Scholar #1
16. Scholar #2
17. Scholar #3
18. Engineer #1
19. Engineer #2
20. Oracle (sea prophet)

**Note:** 20 total (17 avg)

---

## 18. CHERNOBYL ☢️🏭 - **10 NPCs**
1. Dr. Krnić (VILLAIN!)
2. Soviet Soldier (ghost) #1
3. Soviet Soldier (ghost) #2
4. Soviet Soldier (ghost) #3
5. Mad Scientist #1
6. Mad Scientist #2
7. Scavenger #1
8. Scavenger #2
9. Hazmat Trader
10. Stalker (survivor)
11. Radiation Cultist

**Note:** 11 total (10 avg)

---

## 19. MEXICAN CENOTES 🇲🇽 - **10 NPCs**
1. Mayan Priest
2. Villager #1
3. Villager #2
4. Villager #3
5. Villager #4
6. Villager #5
7. Archaeologist #1
8. Archaeologist #2
9. Diver (cenote explorer)
10. Cenote Guide
11. Shaman (Mayan)
12. Jade Merchant

**Note:** 12 total (10 avg)

---

## 20. WITCH FOREST 🧙 - **8 NPCs**
1. Baba Yaga (BOSS NPC!)
2. Witch #1 (hostile)
3. Witch #2 (neutral)
4. Witch #3 (hostile)
5. Black Cat (familiar NPC - talks!)
6. Cursed Knight
7. Lost Child (ghost)
8. Potion Seller
9. Herbalist (dark herbs)

**Note:** 9 total (8 avg)

---

# 🏙️ TOWN NPCs (190 Total across 27 Towns)

## Standard Town NPCs (per town × 27)

### Core NPCs (Every Town - 7 NPCs × 27 = 189)
1. **Mayor** - 27 variants (different names/appearances)
2. **Blacksmith** - 27 variants
3. **General Store Owner** - 27 variants
4. **Innkeeper** - 27 variants
5. **Farmer** - 27 variants
6. **Guard** - 27 variants
7. **Doctor/Healer** - 27 variants

### Additional NPCs (Some Towns)
8. **Priest** - 15 towns (religious towns)
9. **Merchant** - 20 towns (trading hubs)
10. **Villagers (generic)** - 2-5 per town (varies)

**Total Town NPCs:** ~190 (27 towns × 7 core avg)

---

# 📈 NPC SPRITE REQUIREMENTS

## Per NPC Sprite Count

**Minimum (Static):**
- 4 directions (N, S, E, W) = **4 sprites**

**Basic (Idle + Walk):**
- 4 directions × 1 idle = 4 sprites
- 4 directions × 4 walk frames = 16 sprites
- **Total: 20 sprites per NPC**

**Full Animation (Advanced):**
- Idle: 4 directions = 4 sprites
- Walk: 4 directions × 4 frames = 16 sprites
- Talk animation: 4 directions × 2 frames = 8 sprites
- **Total: 28 sprites per NPC**

---

## Total Sprite Calculation

| NPC Type | Count | Sprites Each | Total Sprites |
|----------|-------|--------------|---------------|
| **Biome NPCs (basic)** | 189 | 20 | **3,780** |
| **Town NPCs (basic)** | 190 | 20 | **3,800** |
| **GRAND TOTAL** | 379 | - | **7,580 sprites** |

**If using minimum (4 sprites):** 379 × 4 = **1,516 sprites**  
**If using full animation (28 sprites):** 379 × 28 = **10,612 sprites**

---

# 🎯 PRODUCTION PLAN

## Phase 1: Core Biome NPCs (Priority)
**Total: 62 NPCs**
- Grassland (10)
- Forest (6)
- Mountain (6)
- Desert (8)
- Snow/Arctic (5)
- Swamp (4)
- Wasteland (4)
- Tropical (10)
- Radioactive (3)
- Dino Valley (8)

**Sprites needed:** 62 × 20 = **1,240 sprites**

---

## Phase 2: Magical/Advanced Biomes
**Total: 67 NPCs**
- Mythical Highlands (12)
- Endless Forest (5)
- Loch Ness (15)
- Catacombs (6)
- Egyptian Desert (12)
- Amazon Rainforest (12)
- Mexican Cenotes (10)
- Witch Forest (8)

**Sprites needed:** 67 × 20 = **1,340 sprites**

---

## Phase 3: Endgame Biomes
**Total: 17 NPCs**
- Atlantis (17)
- Chernobyl (10)

**Sprites needed:** 27 × 20 = **540 sprites**

---

## Phase 4: Town NPCs (Generic Templates)
**Total: 190 NPCs**
- Create 7 base templates
- Recolor/modify for 27 towns
- Mayor variants: 27
- Blacksmith variants: 27
- Store Owner variants: 27
- Innkeeper variants: 27
- Farmer variants: 27
- Guard variants: 27
- Doctor variants: 27

**Sprites needed:** 190 × 20 = **3,800 sprites**

---

# ✅ FINAL CHECKLIST

## NPCs to Generate:

- [ ] **Phase 1: Core Biomes** - 62 NPCs (1,240 sprites)
- [ ] **Phase 2: Magical Biomes** - 67 NPCs (1,340 sprites)
- [ ] **Phase 3: Endgame** - 17 NPCs (540 sprites)
- [ ] **Phase 4: Town NPCs** - 190 NPCs (3,800 sprites)

## TOTAL:
- [ ] **379 NPCs**
- [ ] **7,580 sprites** (if 20 sprites/NPC)

---

**Status:** Ready for NPC generation!  
**Next Step:** Start Phase 1 (Core Biome NPCs)