# 🎯 ULTIMATE MASTER IMPLEMENTATION PLAN
## Complete Roadmap: DEMO + Faza 1 + Faza 2 (Audio + Mechanics + Features)

**Created:** January 9, 2026, 14:41 CET  
**Purpose:** Complete implementation plan for playable game  
**Includes:** Audio, Mechanics, Parent Memories, Assets  
**Timeline:** 2-4 weeks to full Alpha v2.5

---

## 📊 EXECUTIVE SUMMARY

### **What Needs to Be Done:**

| Category | Items | Est. Time | Priority |
|----------|-------|-----------|----------|
| **Audio** | 129 files | 3-4 hours | 🔥 HIGH |
| **Core Mechanics** | 8 systems | 40-50 hours | 🔥 HIGH |
| **Parent Memories** | Story system | 8-10 hours | 🟡 MED |
| **Missing Assets** | ~150 sprites | 10-15 hours | 🟡 MED |
| **Polish & Testing** | QA + bugs | 15-20 hours | 🟢 LOW |
| **TOTAL** | - | **76-99 hours** | (~2-3 weeks) |

---

# 🎵 PART 1: AUDIO IMPLEMENTATION

## Phase 1: DEMO Audio (45 files) - 3-4 hours

### **Step 1: Acquire Audio (2-3 hours)**
✅ Download guide ready: `AUDIO_DOWNLOAD_QUICK_GUIDE.md`

**Tasks:**
- [ ] Convert 8 .wav music tracks to .ogg (15 min)
- [ ] Download Kenney packs (30 min)
  - RPG Audio, Impact Sounds, Interface, Digital Audio
- [ ] Download Freesound.org specific sounds (1 hour)
  - Farming, combat, zombies, animals
- [ ] Download OpenGameArt ambient loops (15 min)
- [ ] Organize into `/assets/audio/` structure (30 min)

### **Step 2: Integration (1 hour)**

**Tasks:**
- [ ] Test all 45 files load in Phaser
- [ ] Configure AudioManager.js
- [ ] Set up music transitions
- [ ] Test SFX triggers
- [ ] Volume balancing

**Result:** DEMO audio 100% functional ✅

---

## Phase 2: Faza 1 Audio (+60 files) - 2-3 hours

**When:** After implementing Faza 1 biomes/combat

**Tasks:**
- [ ] Download biome music (desert, swamp, cave, boss)
- [ ] Get animal sounds (10 farm animals)
- [ ] Get advanced combat SFX (15 files)
- [ ] Get crafting sounds (5 files)
- [ ] Get environment sounds (5 files)
- [ ] Integrate into AudioManager

---

## Phase 3: Faza 2 Audio (+24 files) - 1-2 hours

**When:** After implementing town restoration

**Tasks:**
- [ ] Download town music (busy, church, tavern)
- [ ] Get town SFX (bells, market, NPCs)
- [ ] Get building completion stingers
- [ ] Integrate into town systems

---

# 🎮 PART 2: CORE MECHANICS IMPLEMENTATION

## 🌲 MECHANIC 1: Resource Logistics & Automation (8-10 hours)

### **System Overview:**
Implement full resource gathering → storage → crafting pipeline

### **Components:**

#### **A. Kai Auto-Pickup System (2 hours)**

**Features:**
- [ ] Radius-based auto-collection (5-tile radius)
- [ ] Resources fly to inventory with animation
- [ ] Satisfying "pop" SFX on pickup
- [ ] UI counter updates

**Implementation:**
```javascript
// src/systems/ResourceAutoPickup.js
class ResourceAutoPickup {
  constructor(player, radius = 5) {
    this.player = player;
    this.radius = radius * 32; // tiles to pixels
    this.pickupDelay = 200; // ms between pickups
  }
  
  update() {
    // Check for resources in radius
    // Auto-collect with animation
    // Update inventory
    // Play SFX
  }
}
```

**Assets Needed:**
- ✅ Have: Kai sprite, inventory UI
- ❌ Need: Pickup particle effect (1 sprite)

---

#### **B. Zombie Worker AI (4 hours)**

**Zombie Types:**

**1. Zombie Lumberjack (Gozdar)**
- [ ] Path to nearest tree
- [ ] Chop animation (use axe swing)
- [ ] Drop wood on ground
- [ ] Find next tree

**2. Zombie Carrier (Nosilec)**
- [ ] Detect items on ground
- [ ] Pick up item (carry animation)
- [ ] Path to storage
- [ ] Deposit item
- [ ] Return to patrol

**Implementation:**
```javascript
// src/entities/ZombieWorker.js
class ZombieWorker extends Phaser.GameObjects.Sprite {
  constructor(scene, x, y, type) {
    this.type = type; // 'lumberjack' or 'carrier'
    this.state = 'idle'; // idle, working, carrying, depositing
    this.assignedTask = null;
    this.carryingItem = null;
  }
  
  update() {
    switch(this.state) {
      case 'idle': this.findWork(); break;
      case 'working': this.doWork(); break;
      case 'carrying': this.deliverItem(); break;
    }
  }
}
```

**Assets Needed:**
- ✅ Have: Zombie sprites (50 frames)
- ❌ Need: Carrying animation variant (8 frames)
- ❌ Need: Axe tool sprite for zombie (1 sprite)

---

#### **C. Storage Building (1 hour)**

**Features:**
- [ ] Small shed sprite (3x3 tiles)
- [ ] Capacity: 500 items (upgradable)
- [ ] Visual fill indicator
- [ ] Deposit/withdraw UI

**Implementation:**
```javascript
// src/buildings/Storage.js
class Storage extends Building {
  constructor(scene, x, y) {
    this.capacity = 500;
    this.contents = new Map(); // resource -> count
    this.fullness = 0; // 0-1 for visual
  }
  
  deposit(resource, amount) {
    // Add to storage
    // Update UI
    // Play SFX
  }
}
```

**Assets Needed:**
- ✅ Have: Building sprites from Faza 1 infrastructure
- ❌ Need: Small storage shed sprite (1 sprite)

---

#### **D. Working Table / Crafting (1 hour)**

**Features:**
- [ ] First buildable structure
- [ ] Opens crafting UI
- [ ] Recipes for basic tools

**Crafting Recipes:**
- Wooden Hoe: 10 wood
- Wooden Axe: 5 wood
- Wooden Pickaxe: 10 wood + 5 stone
- Watering Can: 10 wood + 5 iron

**Implementation:**
```javascript
// src/ui/CraftingUI.js
class CraftingUI {
  constructor(scene) {
    this.recipes = CRAFTING_RECIPES;
    this.selectedRecipe = null;
  }
  
  canCraft(recipe) {
    // Check if player has resources
    return recipe.materials.every(mat => 
      this.player.inventory.has(mat.id, mat.amount)
    );
  }
  
  craft(recipe) {
    // Deduct materials
    // Create item
    // Play animation + SFX
  }
}
```

**Assets Needed:**
- ✅ Have: Tool sprites (8 tools)
- ❌ Need: Crafting table sprite (1 sprite)
- ❌ Need: Crafting UI panel (1 sprite)

---

## 🏙️ MECHANIC 2: HIPODEVIL666CITY Management (6-8 hours)

### **System Overview:**
Dynamic city with population tracking, electricity, and NPC workers

### **Components:**

#### **A. Neon Population Board (2 hours)**

**Features:**
- [ ] Neon noir aesthetic sign
- [ ] Real-time population counter
- [ ] Categories: Total, Functional, Non-functional
- [ ] Flicker effect for broken bulbs

**Display:**
```
╔═══════════════════════════════╗
║  HIPODEVIL666CITY POPULATION  ║
║                               ║
║  TOTAL:  [###]  citizens      ║
║  F:      [###]  functional    ║
║  NF:     [###]  non-functional║
╚═══════════════════════════════╝
```

**Implementation:**
```javascript
// src/entities/PopulationBoard.js
class PopulationBoard extends Phaser.GameObjects.Container {
  constructor(scene, x, y) {
    this.totalText = scene.add.text(x, y, '0', neonStyle);
    this.functionalText = scene.add.text(x, y+20, '0', neonStyle);
    this.nonFunctionalText = scene.add.text(x, y+40, '0', neonStyle);
    this.needsUpdate = false;
  }
  
  update(cityData) {
    if (!cityData.statisticianPaid) {
      this.needsUpdate = true;
      return; // No updates without payment!
    }
    this.refresh(cityData);
  }
}
```

**Assets Needed:**
- ❌ Need: Neon board background (1 sprite)
- ❌ Need: Neon number sprites (0-9, 10 sprites)
- ✅ Have: Neon glow shader (can create)

---

#### **B. Zombie Statistician NPC (2 hours)**

**Features:**
- [ ] Office worker zombie
- [ ] Updates board daily
- [ ] Requires 1 Coin/day payment
- [ ] Grumbles if not paid
- [ ] Board freezes without updates

**Dialogue:**
- Paid: "Numbers are current, boss!"
- Unpaid: "No pay, no work. Board stays old."
- Hire: "I'll keep your stats updated. 1 coin per day."

**Implementation:**
```javascript
// src/npcs/ZombieStatistician.js
class ZombieStatistician extends NPC {
  constructor(scene, x, y) {
    this.salaryPerDay = 1; // coins
    this.lastPaidDay = 0;
    this.isPaid = false;
  }
  
  dailyUpdate(currentDay) {
    if (this.lastPaidDay < currentDay) {
      this.isPaid = false;
      this.showUnhappy();
    }
  }
  
  payWage() {
    if (player.coins >= this.salaryPerDay) {
      player.coins -= this.salaryPerDay;
      this.isPaid = true;
      this.updateBoard();
    }
  }
}
```

**Assets Needed:**
- ❌ Need: Office zombie sprite (11 sprites: idle, walk, action, portrait)
- ✅ Have: Zombie base (can recolor/add suit)

---

#### **C. City Generator (Electric System) (2-3 hours)**

**Features:**
- [ ] Central power building
- [ ] Powers street lamps
- [ ] Powers basement UV lights
- [ ] Requires fuel (coal/oil)
- [ ] Visual: Lights on/off based on power

**Power Grid:**
```
Generator (Fuel) → Power Lines → Consumers
                                  ├─ Street Lamps
                                  ├─ UV Lights (basement)
                                  └─ Future: Other buildings
```

**Implementation:**
```javascript
// src/systems/ElectricitySystem.js
class ElectricitySystem {
  constructor(scene) {
    this.generator = null;
    this.powerGrid = [];
    this.isPowered = false;
  }
  
  update() {
    if (!this.generator.hasFuel()) {
      this.isPowered = false;
      this.turnOffAll();
      return;
    }
    
    this.generator.consumeFuel();
    this.isPowered = true;
    this.powerAllDevices();
  }
  
  powerAllDevices() {
    this.powerGrid.forEach(device => {
      device.turnOn();
      device.playHumSound();
    });
  }
}
```

**Assets Needed:**
- ❌ Need: Generator building sprite (1 sprite)
- ❌ Need: Power line poles (2 variations)
- ✅ Have: Street lamp sprites (from Faza 2)
- ❌ Need: UV light strip for basement (1 sprite)

---

## 🏠 MECHANIC 3: Building Upgrades & Basement Economy (5-6 hours)

### **System Overview:**
House progression unlocks hidden basement farming

### **Components:**

#### **A. House Upgrade System (2 hours)**

**Progression:**
1. Tent (starter)
2. Wooden Shack (10 wood, 5 stone)
3. Small House (50 wood, 20 stone, 10 iron)
4. House with Basement (100 wood, 50 stone, 25 iron, 10 glass)

**Features:**
- [ ] Visual upgrade on map
- [ ] Interior changes
- [ ] Basement unlocks at level 4
- [ ] Ladder/stairs to basement

**Implementation:**
```javascript
// src/buildings/PlayerHouse.js
class PlayerHouse extends Building {
  constructor(scene, x, y) {
    this.level = 1; // Tent
    this.hasBasement = false;
  }
  
  upgrade() {
    if (!this.canAffordUpgrade()) return false;
    
    this.level++;
    this.updateSprite();
    
    if (this.level >= 4) {
      this.unlockBasement();
    }
    return true;
  }
  
  unlockBasement() {
    this.hasBasement = true;
    this.createBasementEntrance();
    // Show tutorial about basement farming
  }
}
```

**Assets Needed:**
- ❌ Need: Tent sprite (1 sprite)
- ❌ Need: Wooden shack sprite (1 sprite)
- ✅ Have: House sprites (from Kai house references)
- ❌ Need: Basement entrance/ladder (1 sprite)

---

#### **B. Basement Farming System (3-4 hours)**

**Features:**
- [ ] Hidden underground room
- [ ] Grow illegal crops (Cannabis, Magic Mushrooms)
- [ ] UV lights speed up growth (if powered)
- [ ] Secret income source
- [ ] Risk: Raids can discover it

**Crop Growth:**
- Without UV: 7 days
- With UV (powered): 3 days
- Cannabis: High value (50 coins/harvest)
- Magic Mushrooms: Very high value (100 coins/harvest)

**Implementation:**
```javascript
// src/systems/BasementFarm.js
class BasementFarm {
  constructor(scene) {
    this.plots = []; // max 10 plots
    this.uvLights = [];
    this.isPowered = false;
  }
  
  update(delta) {
    if (!this.isPowered) {
      // Normal growth rate
      this.growCrops(delta, 1.0);
    } else {
      // 2.3x faster with UV
      this.growCrops(delta, 2.3);
      this.playUVHumSound();
    }
  }
  
  checkForRaid() {
    if (this.hasVisibleCrops() && Math.random() < 0.01) {
      // Guards might discover!
      triggerRaidEvent();
    }
  }
}
```

**Assets Needed:**
- ✅ Have: Cannabis growth sprites (6 stages)
- ❌ Need: Magic Mushroom growth sprites (6 stages)
- ❌ Need: Basement room tile set (floor, walls)
- ❌ Need: UV light fixture sprite (1 sprite)
- ✅ Have: Crop plot tiles

---

## ⛏️ MECHANIC 4: Procedural Mine & Land Expansion (6-8 hours)

### **System Overview:**
Infinite procedural mine + zombie-powered land clearing

### **Components:**

#### **A. Procedural Mine Generation (4 hours)**

**Features:**
- [ ] New layout each visit
- [ ] Multiple floors (deeper = better ores)
- [ ] Resources: Iron, Coal, Blood Ore
- [ ] Enemies increase with depth
- [ ] Ladder to go deeper

**Generation Algorithm:**
```javascript
// src/procedural/MineGenerator.js
class MineGenerator {
  generate(floor, seed) {
    const rng = new SeededRandom(seed + floor);
    
    // Generate cave layout
    const layout = this.generateCaveLayout(rng);
    
    // Place resources based on floor
    const oreSpawns = {
      iron: floor >= 1 ? rng.int(10, 20) : 0,
      coal: floor >= 2 ? rng.int(5, 15) : 0,
      bloodOre: floor >= 5 ? rng.int(1, 5) : 0
    };
    
    this.placeOres(layout, oreSpawns, rng);
    
    // Place enemies (more on deeper floors)
    const enemyCount = 5 + (floor * 2);
    this.placeEnemies(layout, enemyCount, rng);
    
    return layout;
  }
}
```

**Assets Needed:**
- ❌ Need: Cave wall tiles (4 variations)
- ❌ Need: Cave floor tiles (3 variations)
- ❌ Need: Iron ore sprite (1 sprite)
- ❌ Need: Coal ore sprite (1 sprite)
- ❌ Need: Blood ore sprite (1 sprite, glowing red)
- ❌ Need: Ladder sprite (1 sprite)
- ✅ Have: Mining animation (player swing pickaxe)

---

#### **B. Land Expansion System (2-3 hours)**

**Features:**
- [ ] Zombies clear ruins/trees on command
- [ ] Expands usable farm area
- [ ] Costs resources to assign zombies
- [ ] Visual progress (debris → clear land)

**Command System:**
```javascript
// src/systems/LandExpansion.js
class LandExpansion {
  constructor(scene) {
    this.clearableObjects = []; // trees, ruins, rocks
    this.activeWorkers = [];
  }
  
  assignClearingCrew(area) {
    // Cost: 3 zombies + 10 coins
    if (!player.hasZombies(3)) return false;
    if (!player.hasCoins(10)) return false;
    
    const crew = player.assignZombies(3);
    crew.forEach(zombie => {
      zombie.startClearing(area);
    });
    
    this.trackProgress(area);
  }
  
  onClearComplete(area) {
    // Convert to usable farmland
    this.expandFarmBoundary(area);
    returnZombies();
  }
}
```

**Implementation Steps:**
1. Player clicks "Expand" button
2. Draws area to clear
3. Assigns zombie crew
4. Zombies path to debris
5. Debris removal animation
6. Farmland tile appears
7. Boundary expands

**Assets Needed:**
- ✅ Have: Zombie worker sprites
- ✅ Have: Ruin/debris sprites (from Faza 2 buildings)
- ❌ Need: Clearing progress overlay (1 sprite)

---

## 🎨 MECHANIC 5: Visual Effects & Shaders (4-5 hours)

### **System Overview:**
Professional visual polish

### **Components:**

#### **A. 20px Blur Intro (1 hour)**

**Features:**
- [ ] Game starts with 20px blur
- [ ] Gradually clears over 5 seconds
- [ ] Kai waking up dialogue
- [ ] First-time player experience

**Implementation:**
```javascript
// src/scenes/IntroScene.js
class IntroScene extends Phaser.Scene {
  create() {
    // Start with blur
    this.cameras.main.setPostPipeline('BlurPostFX');
    this.cameras.main.getPostPipeline('BlurPostFX').blurStrength = 20;
    
    // Tween to clear
    this.tweens.add({
      targets: this.cameras.main.getPostPipeline('BlurPostFX'),
      blurStrength: 0,
      duration: 5000,
      ease: 'Sine.easeOut',
      onComplete: () => {
        this.startDialogue("Where... where am I?");
      }
    });
  }
}
```

**Assets Needed:**
- ✅ Have: Kai sprite
- ✅ Have: Dialogue system
- ❌ No new assets needed

---

#### **B. Physics Shaders (2-3 hours)**

**Shaders:**

**1. Vertex Shader (Hair/Wheat Sway)**
- [ ] Kai's dreads sway with movement
- [ ] Wheat field waves in wind
- [ ] Gentle, natural movement

```glsl
// vertex_sway.glsl
uniform float time;
uniform float windStrength;

void main() {
  vec4 pos = gl_Position;
  
  // Sway based on vertex height + time
  float sway = sin(time + pos.y) * windStrength;
  pos.x += sway;
  
  gl_Position = pos;
}
```

**2. Displacement Shader (Water)**
- [ ] Water surface ripples
- [ ] Reflects sky
- [ ] Interactive splashes

```glsl
// water_displacement.glsl
uniform sampler2D uDisplacementMap;
uniform float time;

void main() {
  vec2 uv = gl_FragCoord.xy / resolution.xy;
  
  // Sample displacement
  float displacement = texture2D(uDisplacementMap, uv + time).r;
  
  // Apply to water surface
  vec2 distortedUV = uv + (displacement * 0.05);
  vec3 color = texture2D(uWaterTexture, distortedUV).rgb;
  
  gl_FragColor = vec4(color, 1.0);
}
```

**Implementation:**
```javascript
// src/shaders/ShaderManager.js
class ShaderManager {
  constructor(scene) {
    this.vertexShader = this.loadVertexShader();
    this.waterShader = this.loadWaterShader();
  }
  
  applyToSprite(sprite, shaderType) {
    const pipeline = scene.renderer.pipelines.add(shaderType, shader);
    sprite.setPipeline(pipeline);
  }
}
```

**Assets Needed:**
- ❌ Need: Displacement map texture (1 grayscale image)
- ✅ Have: Wheat/water sprites

---

## 🎮 MECHANIC 6: Xbox Controller Support (3-4 hours)

### **System Overview:**
Full analog controller support with rumble

### **Features:**

**Button Layout:**
- **Left Stick:** Move Kai
- **Right Stick:** Camera pan
- **A Button:** Interact / Confirm
- **B Button:** Cancel / Back
- **X Button:** Command zombies
- **Y Button:** Quick menu
- **LB/RB:** Cycle tools
- **LT/RT:** Sprint / Sneak
- **D-Pad:** Quick inventory
- **Start:** Pause menu
- **Back:** Map

**Rumble Events:**
- Light rumble: Harvest crop
- Medium rumble: Zombie attack
- Heavy rumble: Explosion/death

**Implementation:**
```javascript
// src/input/GamepadManager.js
class GamepadManager {
  constructor(scene) {
    this.gamepad = scene.input.gamepad.getPad(0);
    this.vibrationEnabled = true;
  }
  
  update() {
    if (!this.gamepad) return;
    
    // Movement
    const leftStick = {
      x: this.gamepad.leftStick.x,
      y: this.gamepad.leftStick.y
    };
    
    if (Math.abs(leftStick.x) > 0.1 || Math.abs(leftStick.y) > 0.1) {
      player.move(leftStick.x, leftStick.y);
    }
    
    // Buttons
    if (this.gamepad.A) this.handleInteract();
    if (this.gamepad.X) this.handleCommandZombies();
    if (this.gamepad.LB) this.cycleToolPrevious();
    if (this.gamepad.RB) this.cycleToolNext();
  }
  
  rumble(intensity, duration) {
    if (!this.vibrationEnabled) return;
    this.gamepad.vibration.playEffect('dual-rumble', {
      startDelay: 0,
      duration: duration,
      weakMagnitude: intensity * 0.5,
      strongMagnitude: intensity
    });
  }
}
```

**Assets Needed:**
- ❌ Need: Controller button prompt sprites (A, B, X, Y, etc.) (10 sprites)
- ❌ No new game assets needed

---

## 💬 MECHANIC 7: Parent Memories System (8-10 hours)

### **System Overview:**
Flashback sequences showing Kai and Ana's parents before apocalypse

### **Story Integration:**

**Trigger Points:**
1. **Kai's Dad Memory:** Find his old toolbox in ruins
2. **Kai's Mom Memory:** Discover family photo in debris
3. **Ana's Dad Memory:** Uncover his diary/research notes
4. **Ana's Mom Memory:** Find her pendant in cemetery

**Memory Types:**

#### **A. Static Memories (4 hours)**

**Sepia-toned photo flashbacks:**
- [ ] Family photo analysis
- [ ] Kai examining old photo
- [ ] Ana's voice-over narration
- [ ] Emotional music
- [ ] Returns to present

**Implementation:**
```javascript
// src/systems/MemorySystem.js
class MemorySystem {
  constructor(scene) {
    this.memories = [];
    this.activeMemory = null;
  }
  
  triggerMemory(memoryId) {
    const memory = MEMORIES[memoryId];
    
    // Fade to sepia
    this.scene.cameras.main.fade(1000, 139, 121, 94);
    
    // Show memory image
    this.showMemoryImage(memory.photo);
    
    // Play narration
    this.playNarration(memory.audioFile);
    
    // Wait for completion
    this.scene.time.delayedCall(memory.duration, () => {
      this.endMemory();
    });
  }
  
  endMemory() {
    // Fade back to present
    this.scene.cameras.main.fade(1000, 0, 0, 0, true);
    
    // Mark as viewed
    this.activeMemory.viewed = true;
    
    // Grant emotional reward (optional stat boost)
    player.addMoraleBoost(10);
  }
}
```

**Memory Data:**
```javascript
const MEMORIES = {
  kai_dad_toolbox: {
    id: 'kai_dad_toolbox',
    photo: 'kai_dad_workshop.png',
    audioFile: 'memory_kai_dad.mp3',
    duration: 15000, // 15 seconds
    narration: {
      en: "Dad always said... 'Take care of your tools, they'll take care of you.'",
      sl: "Oče je vedno govoril... 'Skrbi za svoja orodja, skrbela bodo zate.'"
    }
  },
  
  ana_mom_pendant: {
    id: 'ana_mom_pendant',
    photo: 'ana_mom_cemetery.png',
    audioFile: 'memory_ana_mom.mp3',
    duration: 20000,
    narration: {
      en: "Mom... she was the strongest person I knew. Until...",
      sl: "Mama... bila je najmočnejša oseba, ki sem jo poznal. Dokler..."
    }
  }
  
  // ... more memories
};
```

**Assets Needed:**
- ❌ Need: Parent character sprites (4 characters × 2 poses = 8 sprites)
  - Kai's Dad (workshop clothes)
  - Kai's Mom (casual clothes)
  - Ana's Dad (scientist coat)
  - Ana's Mom (elegant dress)
- ❌ Need: Sepia-toned photo frames (4 images)
- ❌ Need: Memory trigger items (4 sprites):
  - Old toolbox
  - Family photo frame
  - Research diary
  - Silver pendant

---

#### **B. Interactive Memories (4-6 hours)**

**Playable flashback sequences:**
- [ ] Control Kai as child
- [ ] Learn farming from dad
- [ ] Simple mini-game (plant seeds)
- [ ] Emotional payoff

**Example: "Dad's Lesson" Memory**

**Sequence:**
1. Flashback: 10 years before apocalypse
2. Young Kai (8 years old) with dad in garden
3. Dad teaches how to plant wheat
4. Mini-game: Plant 5 seeds correctly
5. Dad's praise: "Good job, son! You're a natural farmer."
6. Flash forward to present: Kai plants same crop, tears in eyes
7. Achievement unlocked: "Father's Legacy"

**Implementation:**
```javascript
// src/scenes/MemoryFlashbackScene.js
class MemoryFlashbackScene extends Phaser.Scene {
  create(data) {
    const memory = data.memoryConfig;
    
    // Set up flashback environment
    this.createFlashbackWorld(memory.setting);
    
    // Spawn young Kai sprite
    this.youngKai = new YoungKai(this, 400, 300);
    
    // Spawn parent NPC
    this.parent = new ParentNPC(this, 450, 300, memory.parentId);
    
    // Start dialogue
    this.startDialogue(memory.dialogue);
    
    // Setup mini-game
    this.setupMiniGame(memory.miniGame);
  }
  
  onMiniGameComplete() {
    // Parent praises
    this.parent.speak("Proud of you, kid!");
    
    // Grant reward
    player.unlockSkill(memory.rewardSkill);
    
    // Return to present
    this.scene.start('GameScene');
  }
}
```

**Mini-Game Examples:**

**1. Planting Seeds (Dad's Lesson)**
- Plant 5 wheat seeds in correct spots
- Dad guides: "Not too close together!"
- Success: +5% farming speed bonus

**2. First Aid (Mom's Lesson)**
- Bandage injured animal
- Follow mom's instructions
- Success: +10 max health

**3. Lab Safety (Ana's Dad)**
- Identify dangerous chemicals
- Ana learns as child
- Success: Unlock alchemy recipes

**4. Cooking (Ana's Mom)**
- Follow recipe steps
- Make family meal
- Success: +20% food effectiveness

**Assets Needed:**
- ❌ Need: Young Kai sprite (chibi version, 11 sprites)
- ❌ Need: Young Ana sprite (chibi version, 11 sprites)
- ❌ Need: Parent NPC full sprites (4 parents × 11 sprites = 44 sprites)
- ❌ Need: Flashback environment tiles (garden, kitchen, lab, cemetery)
- ❌ Need: Mini-game UI elements (5-10 sprites)

---

## 📦 PART 3: MISSING ASSETS SUMMARY

### **Audio Assets:**
- ✅ Plan complete: `AUDIO_DOWNLOAD_QUICK_GUIDE.md`
- Total: 129 files (45 DEMO + 60 Faza 1 + 24 Faza 2)

### **Visual Assets Needed:**

#### **Mechanics Assets (35 sprites):**
- [ ] Pickup particle effect (1)
- [ ] Zombie carrying animation variant (8)
- [ ] Zombie with axe sprite (1)
- [ ] Small storage shed (1)
- [ ] Crafting table (1)
- [ ] Crafting UI panel (1)
- [ ] Neon population board (1)
- [ ] Neon number sprites 0-9 (10)
- [ ] Office zombie sprite set (11)

#### **Building Assets (15 sprites):**
- [ ] Generator building (1)
- [ ] Power line poles (2)
- [ ] UV light strip (1)
- [ ] Tent sprite (1)
- [ ] Wooden shack (1)
- [ ] Basement entrance/ladder (1)
- [ ] Magic Mushroom growth cycle (6)
- [ ] Basement room tileset (2)
- [ ] UV light fixture (1)

#### **Mine Assets (8 sprites):**
- [ ] Cave wall tiles (4)
- [ ] Cave floor tiles (3)
- [ ] Ladder sprite (1)
- [ ] Iron ore sprite (1)
- [ ] Coal ore sprite (1)
- [ ] Blood ore sprite (1)
- [ ] Clearing progress overlay (1)

#### **Parent Memory Assets (65 sprites):**
- [ ] Parent character designs (8)
- [ ] Sepia photo frames (4)
- [ ] Memory trigger items (4)
- [ ] Young Kai chibi sprites (11)
- [ ] Young Ana chibi sprites (11)
- [ ] Parent NPC full sets (44)
- [ ] Flashback environment tiles (varies)
- [ ] Mini-game UI elements (10)

#### **Controller Assets (10 sprites):**
- [ ] Xbox button prompts A, B, X, Y, LB, RB, LT, RT, Start, Back (10)

**TOTAL NEW ASSETS NEEDED: ~133 sprites**

---

## 📅 IMPLEMENTATION TIMELINE

### **Week 1: Audio + Core Mechanics**

**Days 1-2: Audio Setup (6-8 hours)**
- Acquire DEMO audio (45 files)
- Integrate into Phaser
- Test all SFX/music
- Volume balancing

**Days 3-4: Resource Logistics (10-12 hours)**
- Kai auto-pickup system
- Zombie worker AI (lumberjack + carrier)
- Storage building
- Working table crafting

**Days 5-7: City Management (12-15 hours)**
- Population board
- Zombie statistician NPC
- Electric generator system
- Power grid + lights

---

### **Week 2: Buildings + Visuals**

**Days 8-10: House & Basement (10-12 hours)**
- House upgrade progression
- Basement unlock
- Basement farming system
- UV light mechanics

**Days 11-12: Mine System (8-10 hours)**
- Procedural generation
- Ore placement
- Mining mechanics
- Land expansion zombies

**Days 13-14: Visual Polish (6-8 hours)**
- 20px blur intro
- Vertex shader (hair/wheat)
- Displacement shader (water)
- Controller support

---

### **Week 3: Parent Memories + Assets**

**Days 15-17: Generate Assets (12-15 hours)**
- Mechanics sprites (35)
- Building sprites (15)
- Mine sprites (8)
- Controller UI (10)

**Days 18-20: Memory System (12-15 hours)**
- Static memory implementation
- Parent sprites (65 total)
- Interactive flashbacks
- Mini-games

**Day 21: Integration Testing**
- Test all systems together
- Bug fixes
- Performance optimization

---

### **Week 4: Polish & Launch**

**Days 22-24: Final Polish (10-15 hours)**
- UI/UX improvements
- Tutorial sequences
- Balance testing
- Achievement system

**Days 25-26: QA Testing (8-10 hours)**
- Full gameplay test
- Bug hunt
- Performance profiling
- Controller testing

**Days 27-28: Launch Prep (6-8 hours)**
- Documentation
- Early Access setup (Gronk for first 20)
- Twitch tester keys
- Marketing materials

---

## 🎯 PRIORITY LEVELS

### **🔥 CRITICAL (Must have for playable demo):**
1. ✅ Audio system (45 DEMO files)
2. ✅ Resource auto-pickup
3. ✅ Zombie workers
4. ✅ Storage building
5. ✅ Crafting table
6. ✅ House upgrades
7. ✅ Basic controller support

### **🟡 IMPORTANT (Adds depth):**
1. ✅ Population board
2. ✅ Electric system
3. ✅ Basement farming
4. ✅ Procedural mine
5. ✅ Parent memories (static)
6. ✅ Visual shaders

### **🟢 NICE TO HAVE (Polish):**
1. ⚪ Interactive memories with mini-games
2. ⚪ Full Faza 1 audio (+60 files)
3. ⚪ Advanced rumble effects
4. ⚪ Land expansion visuals
5. ⚪ Achievement system

---

## ✅ COMPLETION CHECKLIST

### **DEMO Readiness:**
- [ ] Audio: 45 files integrated
- [ ] Kai auto-pickup works
- [ ] Zombie workers functional
- [ ] Storage + crafting implemented
- [ ] House can be upgraded
- [ ] Controller support basic
- [ ] 20px blur intro
- **= Playable demo ready!**

### **Faza 1 Readiness:**
- [ ] Population board live
- [ ] Electric system working
- [ ] Basement farming complete
- [ ] Procedural mine playable
- [ ] Parent static memories (4)
- [ ] Faza 1 audio (+60 files)
- **= Full Alpha v2.5!**

### **Faza 2 Readiness:**
- [ ] Town restoration mechanics
- [ ] NPC full integration
- [ ] Faza 2 audio (+24 files)
- [ ] Interactive parent memories
- [ ] Achievement system
- **= Complete experience!**

---

## 💡 QUICK WIN PATH (Minimal Viable Product)

**If time is limited, implement THIS FIRST (1 week):**

**Day 1-2: Audio (45 files)**
**Day 3: Kai auto-pickup + Zombie lumberjack**
**Day 4: Storage building**
**Day 5: Crafting table**
**Day 6: House upgrade to level 4**
**Day 7: Controller support + blur intro**

**= PLAYABLE DEMO in 1 week!** 🚀

Then add:
- Week 2: City management + basement
- Week 3: Mine + parent memories
- Week 4: Polish + launch

---

## 📊 RESOURCE REQUIREMENTS

### **Development Time:**
- **Minimum:** 76 hours (~2 weeks full-time)
- **Recommended:** 99 hours (~2.5 weeks with polish)
- **Maximum:** 120 hours (3 weeks with full features)

### **Asset Generation:**
- Audio: 129 files (3-4 hours to acquire)
- Visual: ~133 new sprites (10-15 hours to generate)
- Total asset time: ~15-20 hours

### **Team Size:**
- 1 developer: 3-4 weeks
- 2 developers: 2 weeks
- 3 developers: 1.5 weeks

---

## 🎉 FINAL DELIVERABLE

**Alpha v2.5 "HIPODEVIL666CITY" Features:**

✅ Complete DEMO audio (45 files)  
✅ Resource logistics automation  
✅ Zombie worker AI  
✅ City management systems  
✅ Dynamic population tracking  
✅ Electric power grid  
✅ House progression & basement  
✅ Underground illegal farming  
✅ Procedural infinite mine  
✅ Land expansion mechanics  
✅ Parent memory story system  
✅ 20px blur intro  
✅ Hair/wheat/water shaders  
✅ Xbox controller support with rumble  
✅ Early Access Gronk reward  

**= Complete, polished, playable game!** 🎮🎉

---

**Status:** ✅ **ULTIMATE MASTER PLAN COMPLETE!**  
**Next Step:** Choose starting point or begin audio acquisition!  
**Estimated Completion:** 2-4 weeks to full Alpha v2.5! 🚀