SYSTEM 3/9: ZombieScoutLevelingSystem complete. Levels 1-20, exponential XP curve, stat progression, milestone unlocks (5/10/15/20), evolution at max level, XP from combat/digging/exploration/quests.

docs/REMAINING_SYSTEMS_PLAN.md

@@ -0,0 +1,121 @@
+# 🎮 REMAINING SYSTEMS IMPLEMENTATION PLAN
+**Date:** 2026-01-05 18:44 CET
+**Status:** 2/9 systems complete, 7 remaining
+
+---
+
+## ✅ COMPLETED SYSTEMS (2/9)
+1. ✅ **TownRestorationLogic.js** - Full 14-building restoration system
+2. ✅ **MuseumEvolutionSystem.js** - 3-stage museum + artifact collection
+
+---
+
+## 🔴 REMAINING SYSTEMS (7/9)
+
+### **PRIORITY 1: Combat & Survival**
+
+#### **3. Zombie Scout Leveling System (1-20)**
+**File:** `src/systems/ZombieScoutLevelingSystem.js`
+**Features:**
+- XP gain from combat, exploration, digging
+- Level 1-20 progression
+- Stat increases per level
+- Visual level-up effects
+- Skill point unlocks
+
+#### **4. Zombie Scout Skills**
+**File:** `src/systems/ZombieScoutSkills.js`
+**Features:**
+- Skill tree (digging, combat, utility)
+- Active skills (special attacks)
+- Passive bonuses
+- Skill point allocation
+- Visual skill effects
+
+#### **5. Nomad Raider AI**
+**File:** `src/systems/NomadRaiderAI.js`
+**Features:**
+- Raider spawn logic
+- Pathfinding to farm
+- Combat AI
+- Loot stealing behavior
+- Difficulty scaling
+
+#### **6. Farm Raid System**
+**File:** `src/systems/FarmRaidSystem.js`
+**Features:**
+- Raid triggers (fame, resources)
+- Wave spawning
+- Defense response
+- Damage to buildings/crops
+- Raid rewards (defending)
+
+---
+
+### **PRIORITY 2: Town Evolution**
+
+#### **7. School Buff System**
+**File:** `src/systems/SchoolBuffSystem.js`
+**Features:**
+- Teacher NPC unlocks system
+- Skill learning (farming, combat)
+- Temporary buffs
+- Knowledge tree
+- Student progression
+
+#### **8. NPC Settlement System (Magic Helpers)**
+**File:** `src/systems/NPCSettlementSystem.js`
+**Features:**
+- NPC auto-assistance
+- Task delegation
+- Worker efficiency
+- Happiness/loyalty
+- NPC housing
+
+#### **9. City Gratitude Gift System**
+**File:** `src/systems/CityGratitudeSystem.js`
+**Features:**
+- Population milestones
+- Gift unlocks
+- Unique rewards
+- City reputation
+- Special equipment
+
+---
+
+## 📋 IMPLEMENTATION ORDER
+
+**Batch 1 (Combat Priority):**
+1. ZombieScoutLevelingSystem.js
+2. ZombieScoutSkills.js  
+3. NomadRaiderAI.js
+4. FarmRaidSystem.js
+
+**Batch 2 (Town Evolution):**
+5. SchoolBuffSystem.js
+6. NPCSettlementSystem.js
+7. CityGratitudeSystem.js
+
+---
+
+## 🎯 ESTIMATED COMPLETION
+
+**Per System:** ~20-30 minutes
+**Total Time:** ~2.5-3.5 hours
+**Current Time:** 18:44 CET
+**Est. Completion:** 21:30 CET (tonight)
+
+---
+
+## 📦 DELIVERABLES
+
+Each system includes:
+- Full JavaScript implementation
+- Integration with existing systems
+- Visual feedback
+- Quest hooks
+- Save/load support
+
+---
+
+**STARTING IMPLEMENTATION NOW...**