novafarma/docs/REMAINING_SYSTEMS_PLAN.md

🎮 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...