# 🎬 INTRO SEQUENCE - DESIGN DOCUMENT
## "From Colors to Darkness" - Kai's Amnesia Awakening

**Created:** January 10, 2026, 04:21 CET  
**Duration:** 30-45 seconds  
**Purpose:** Emotional setup for entire game narrative  
**Style:** Style 32 Dark-Chibi Noir with fast cuts (ADHD energy)

---

## 🎯 CORE CONCEPT: "SPOMIN vs. REALNOST"

**The Temelj (Foundation):**
- **Kai & Ana:** Twin siblings, separated in chaos
- **DNA Link:** Pink/green dreadlocks (genetic connection)
- **Virus "X-Noir":** Spreads through tech and blood → creates "Ombiji" (Zombies)
- **Amnesia:** Kai survived basement attack but forgot everything except ONE image: Ana

**Emotional Arc:**
> "We had colors" → "Then came darkness" → "I'm alone with hole in head" → "Must find her... even if takes whole life"

---

## 📋 TIMELINE OPTIONS

**Two versions available:**
1. **Version A (60 seconds):** 6-phase focused timeline with aging emphasis
2. **Version B (30-45 seconds):** 3-phase fast-cut ADHD energy version

Choose based on production time and narrative goals.

---

## ⏱️ VERSION A: 60-SECOND TIMELINE (6 Phases)

**Total Duration:** 1:00 (60 seconds)  
**Focus:** Aging system showcase, gradual emotional build  
**Style:** Cinematic, measured pacing

### **PHASE 1: HAPPY FAMILY (0:00 - 0:10)**

**Visual Content:**
- Kai and father on longboard (ocean pier, sunny)
- Ana at barbershop getting dreads styled
- RD birthday cake celebration
- Images warm but slightly blurred (nostalgic)

**Text (Typewriter):**
```
"Nekoč so bile barve resnične..."
(Once colors were real...)
```

**Audio:**
- Calm lo-fi melody
- Children's laughter in background
- Light, nostalgic vibe
- Volume: 0.4

**Effects:**
- Slight blur (nostalgic memory)
- Warm color grading
- VHS grain texture
- Soft crossfades

---

### **PHASE 2: THE BOND (0:10 - 0:20)**

**Visual Content:**
- Kai and Ana as children holding hands
- Focus on MATCHING pink/green dreadlocks (DNA proof)
- Twin connection clearly visible
- Clearest shot in intro (most important memory)

**Text (Typewriter):**
```
"Imel sem njo. Imela sva vse."
(I had her. We had everything.)
```

**Audio:**
- Gentle heartbeat appears in background
- Lo-fi melody continues
- Emotional, warm
- Volume: 0.5

**Effects:**
- Less blur (clearer memory)
- Focus on matching features
- Soft glow around twins
- VHS texture maintained

---

### **PHASE 3: THE COLLAPSE (0:20 - 0:35)**

**Visual Content:**
- Images become RED/NEON GREEN (toxic)
- Zombie silhouettes appearing
- Virus under microscope (X-Noir visualization)
- Chaos in streets (panic, running)
- Heavy glitch effects

**Text (Typewriter):**
```
"Potem je prišel X-Noir. In svet se je zlomil."
(Then came X-Noir. And the world broke.)
```

**Audio:**
- Fast punk-rock music kicks in
- Sirens and screams layered
- Chaos soundscape
- Volume: 0.7 → 1.0

**Effects:**
- VHS glitch intensifies
- RGB color separation
- Scanline corruption
- Red/green saturation +80%

---

### **PHASE 4: THE LOSS (0:35 - 0:45)**

**Visual Content:**
- Parents becoming transparent (foreshadowing ghosts)
- Father and mother fading into shadows
- Kai alone in basement (survival)
- Ana being taken away (military/scientists)

**Text (Typewriter):**
```
"Starša sta postala senci... Ana je izginila v temi."
(Parents became shadows... Ana disappeared into darkness.)
```

**Audio:**
- Distortion (corrupted sound)
- Sudden silence after chaos
- Single heartbeat (Kai's survival)
- Volume: 0.3 (quiet, intimate)

**Effects:**
- Parents fade to 30% opacity
- Heavy blur on Ana separation
- Screen darkens
- VHS corruption peaks

---

### **PHASE 5: PASSAGE OF TIME (0:45 - 0:55)**

**Visual Content:**
- **FAST MONTAGE: Kai aging through life stages**
- Reference: `/assets/references/aging_system/`
  - Young Kai (current)
  - Adult Kai (35, beard appears, dreads tied)
  - Elder Kai (50+, grey dreads, punk grandpa)
- Beard growing longer
- Dreadlocks getting longer, then grey
- Fast cuts (2-3 seconds per age)

**Text (Typewriter):**
```
"Leta so postala megla. Obraz se je spremenil... cilj nikoli."
(Years became fog. Face changed... goal never.)
```

**Audio:**
- Deep noir synth (dark bass)
- Time-passing sound effect
- Ticking clock (subtle)
- Volume: 0.6

**Effects:**
- Time-lapse blur
- Rapid crossfades
- Aging progression clear
- Grey color grading increases

**CRITICAL:** This phase showcases the Generational Aging System!

---

### **PHASE 6: AMNESIA WAKE-UP (0:55 - 1:00)**

**Visual Content:**
- Everything goes MAXIMUM BLUR (amnesia effect)
- Kai opens eyes in GameScene bedroom
- Bedroom slowly comes into focus
- Gronk's silhouette in doorway with vape smoke

**Text (Typewriter):**
```
"Kdo sem? ... Kje je Ana?"
(Who am I? ... Where is Ana?)
```

**Final Audio:**
- Vape sound effect (Gronk)
- Gronk voice: "No, končno si buden." (Well, finally awake.)
- [AI_VOICE:gronk:custom]

**Audio:**
- Silence, then breathing
- Heartbeat normalizing
- Vape hiss (Gronk)
- Volume: 0.3

**Effects:**
- Gaussian blur: 20 → 0 (over 3 seconds)
- Bedroom fades in
- VHS filter fades out
- Transition to gameplay

---

### **SKIP OPTION:**

**Trigger:** After 5 seconds
**Display:** Small corner text
```
[Hold X to face reality]
```
- Skips entire intro
- Direct to gameplay
- Saves intro completion flag

---

## 🎬 VERSION B: 30-45 SECOND TIMELINE (3 Phases)

**Total Duration:** 30-45 seconds  
**Focus:** Fast cuts, ADHD energy, immediate impact  
**Style:** Aggressive, punk aesthetic

### **PHASE 1: HAPPY FAMILY MEMORIES (15 seconds)

### **PHASE 1: HAPPY FAMILY MEMORIES (15 seconds)**

**Visual Style:**
- Fast cuts (ADHD energy - 3-5s per shot)
- Blur-to-sharp effect (memories clarifying)
- Bright neon colors (magenta/cyan rim lighting)
- VHS grain texture (nostalgic)
- Style 32 chibi characters

**Shots (5 total, ~3s each):**

**Shot 1 (0-3s): Longboard with Father**
- Reference: `/assets/references/aging_system/otac_punk_father.png`
- Scene: Ocean pier, sunny day
- Action: Father teaching Kai to skate
- Father's hand on Kai's shoulder: "Pojdi, sin!" (Go, son!)
- Blur clears when father smiles

**Shot 2 (3-6s): Dreadlocks at Barbershop**
- Scene: Barbershop mirror
- Action: Stylist adding PINK streak to green dreads
- Kai's excited smile in reflection
- Ana visible in background getting similar style
- Blur clears on mirror reflection

**Shot 3 (6-9s): Twin Moment with Ana**
- Reference: `/assets/references/aging_system/mlada_ana_twin_prisoner.png` (but happy, not prisoner)
- Scene: University lab (Ana's workspace)
- Action: Both laughing, Ana showing science project
- CLEAREST shot (most important memory)
- No blur - this is what Kai holds onto

**Shot 4 (9-12s): Birthday Celebration**
- Scene: Home garden/party
- Action: Cake with candles, family together
- Mother and Father present (alive, happy)
- Reference: Both parents from `/assets/references/aging_system/`
- Warm colors, joy

**Shot 5 (12-15s): Family Portrait**
- Scene: Professional photo setup or casual selfie
- Action: All four smiling (Father, Mother, Kai, Ana)
- Perfect family moment
- Freeze frame for 2 seconds
- This is "what was lost"

**Text Overlay (Typewriter Effect):**
```
"Nekoč smo imeli barve..."
(We once had colors...)
```

**Audio:**
- **Music:** Light, happy indie/lo-fi (slightly grainy)
- **SFX:** Children's laughter, ocean waves, city hum
- **Heartbeat:** Subtle, steady (background)
- **Volume:** 0.4

---

### **PHASE 2: THE COLLAPSE (15 seconds)**

**Visual Style:**
- Images start GLITCHING (digital corruption)
- Colors become INTENSE (saturated reds, toxic greens)
- VHS scanlines multiply
- Blur increases (memory breaking)
- Style 32 Noir kicks in (dark atmospheric)

**Shots (4 total, faster cuts ~4s each):**

**Shot 1 (15-19s): Virus Spread**
- Visual: Green fluorescent particles spreading
- Digital HUD showing infection progress
- "X-Noir Virus: Outbreak Detected"
- Neon green toxic glow
- Screen glitches heavily

**Shot 2 (19-23s): Ombiji Appear**
- Silhouettes of zombies (Style 32 shadows)
- Red eyes glowing in darkness
- Crowd of normal people transforms
- Panic, screaming (visual chaos)
- Fast strobe cuts

**Shot 3 (23-27s): Parents Fight/Flee**
- Reference: `/assets/references/aging_system/otac_punk_father.png` and `mati_punk_mother.png`
- Scene: Parents protecting twins
- Father with longboard as weapon
- Mother pulling kids to safety
- Blur effect HEAVY (Kai can't process)
- Red atmospheric lighting

**Shot 4 (27-30s): Separation**
- Ana being pulled away (military/scientists)
- Kai reaching for her (slow motion)
- Screen goes RED
- VHS glitch corrupts everything
- Final frame: Ana's face disappearing into static

**Text Overlay (Typewriter Effect):**
```
"Potem je prišla tema..."
(Then came the darkness...)
```

**Audio:**
- **Music:** Fast, aggressive punk rock (distorted)
- **SFX:** Sirens, screams, gunshots, chaos
- **Heartbeat:** Rapid, panicked (120 BPM)
- **Volume:** 0.7 → 1.0 (building tension)

---

### **PHASE 3: AMNESIA WAKE-UP (5-10 seconds)**

**Visual Style:**
- COMPLETE BLUR (nothing clear)
- Screen goes dark (fade to black)
- Slow fade up to Kai's bedroom
- Kai visible but confused, disoriented
- Camera shake (grogginess)

**Shots:**

**Shot 1 (30-33s): Pure Blur/Darkness**
- Black screen with faint VHS scanlines
- Heartbeat gets slower
- Breathing sounds (Kai waking)

**Shot 2 (33-37s): Kai's Bedroom (Current Day)**
- Reference: Young Kai base sprite
- Scene: Dark bedroom, morning light coming in
- Kai sitting up in bed, confused
- Hand on head (amnesia headache)
- Room details: posters, longboard, minimal

**Shot 3 (37-40s): Memory Fragment Flash**
- Quick flash of Ana's face (twin memory)
- Only thing Kai remembers clearly
- Purple skin version (memory distortion)
- Reference: `/assets/references/main_characters/ana/master_reference_nobg.png`

**Shot 4 (40-45s): Gronk's Voice**
- Audio only OR Gronk sprite appears in doorway
- Gronk's silhouette with vape smoke
- "Spet si zaspal, stari... upam, da si sanjal o mojem vapiu."
- (You overslept again, man... hope you dreamed about my vape.)

**Text Overlay (Typewriter Effect):**
```
"In ostal sem sam... z luknjo v glavi."
(And I remained alone... with a hole in my head.)
```

**Final Text (Typewriter Effect):**
```
"Moram jo najti. Tudi če mi vzame celo življenje."
(I must find her. Even if it takes my whole life.)
```

**Audio:**
- **Music:** Slow, dark ambient (ethereal)
- **SFX:** Heavy breathing, heartbeat slowing (80 BPM → 60 BPM)
- **Gronk's Voice:** [AI_VOICE:gronk:custom] with vape background sound
- **Volume:** 0.3 (quiet, intimate)

---

## 🎮 SPECIAL EDITION NOTIFICATION (5 seconds - Optional)

**Trigger:** If player is buyer #1-20 OR streamer mode detected

**Visual:**
```
┌─────────────────────────────────────────┐
│  ⭐ SPECIAL EDITION ACTIVATED! ⭐       │
│                                         │
│  Gronk Helper Mode: UNLOCKED            │
│  (Exclusive for Founder #XX)            │
│                                         │
│  Press [G] to summon Gronk companion!   │
└─────────────────────────────────────────┘
```

**Style:**
- Neon magenta/cyan border
- Pulsing glow animation
- 5-second display
- Skip on any key
- Gronk chibi sprite appears briefly

**Audio:**
- Special unlock chime (vape sound effect)
- Gronk: "Gronk help! Pink is best!"

---

## 📝 TYPEWRITER TEXT SCRIPT (Complete)

**Phase 1 (Happy Memories):**
```
"Nekoč smo imeli barve..."
```

**Phase 2 (The Collapse):**
```
"Potem je prišla tema..."
```

**Phase 3 (Amnesia Wake-Up):**
```
"In ostal sem sam... z luknjo v glavi."

"Moram jo najti. Tudi če mi vzame celo življenje."
```

**Typewriter Settings:**
- Speed: 50ms per character (ADHD-friendly - not too slow!)
- Sound: Subtle typewriter click (0.1 volume)
- Skip: Any key press
- Color: White with neon cyan shadow

---

## 🎨 VISUAL EFFECTS SPECIFICATIONS

### **Blur Effect:**
```javascript
// Phase 1: Blur-to-Clear (memories clarifying)
blurStrength: 10 → 0 (over 2 seconds per shot)
ease: 'Power2.easeOut'

// Phase 2: Clear-to-Blur (memories breaking)
blurStrength: 0 → 15 (over 3 seconds)
ease: 'Power2.easeIn'

// Phase 3: Maximum Blur (amnesia)
blurStrength: 20 (total darkness)
```

### **VHS Glitch Effect:**
```javascript
// Phase 1: Light grain
scanlineIntensity: 0.2
glitchFrequency: 0 (no glitches yet)

// Phase 2: Heavy corruption
scanlineIntensity: 0.7
glitchFrequency: 2.0 (glitch every 500ms)
colorShift: true (RGB separation)

// Phase 3: Minimal
scanlineIntensity: 0.1
```

### **Color Grading:**
```javascript
// Phase 1: Happy/Warm
saturation: 1.2
brightness: 1.1
temperature: 'warm' (orange tint)

// Phase 2: Intense/Toxic
saturation: 1.5
brightness: 1.0
reds: +50% (danger)
greens: +70% (virus)

// Phase 3: Desaturated/Cold
saturation: 0.6
brightness: 0.8
temperature: 'cold' (blue tint)
```

---

## 🔊 AUDIO TIMELINE

**0-15s (Happy Memories):**
- Track: Light indie/lo-fi music
- Tempo: 100 BPM
- Mood: Nostalgic, warm
- Volume: 0.4

**15-30s (The Collapse):**
- Track: Fast punk rock (distorted)
- Tempo: 180 BPM
- Mood: Chaos, panic
- Volume: 0.7 → 1.0 (crescendo)
- SFX: Layered chaos (sirens, screams, gunfire)

**30-45s (Amnesia Wake-Up):**
- Track: Dark ambient (drone)
- Tempo: N/A (atmospheric)
- Mood: Confused, lonely
- Volume: 0.3
- SFX: Heartbeat (60 BPM), breathing, Gronk's voice

**Transitions:**
- Crossfade duration: 1 second
- No silence gaps (seamless flow)

---

## 📂 REFERENCE ASSETS REQUIRED

**Images (Happy Memories):**
- Otac (alive): `otac_punk_father.png`
- Mati (alive): `mati_punk_mother.png`
- Mlada Ana (happy version): Generate from `mlada_ana_twin_prisoner.png` but smiling
- Young Kai: `/assets/references/main_characters/kai/master_reference_nobg.png`

**Images (The Collapse):**
- Zombie silhouettes: Generate Style 32 shadow zombies
- Virus particles: Generate neon green toxic effect
- Parents fighting: Action poses from alive references

**Images (Amnesia):**
- Kai bedroom: Generate dark bedroom scene
- Ana memory flash: `master_reference_nobg.png` (purple version - memory distortion)
- Gronk silhouette: `/assets/references/npcs/gronk/` (if exists)

**Audio:**
- Happy music: Find CC0 indie/lo-fi track
- Punk rock: High-energy distorted track
- Ambient: Dark drone atmosphere
- SFX: Kenney.nl packs, Freesound.org
- Gronk voice: Edge-TTS generated

---

## 💻 IMPLEMENTATION GUIDE FOR AGENT

### **IntroScene.js Structure (Version A - 60 seconds):**

```javascript
class IntroScene extends Phaser.Scene {
    constructor() {
        super({ key: 'IntroScene' });
        this.skipEnabled = false;
        this.currentPhase = 0;
    }
    
    create() {
        // Initialize systems
        this.typewriterSystem = new DynamicTypewriterSystem(this);
        this.audioSystem = new HIPOAudioSystem(this);
        
        // VHS overlay (entire intro)
        this.vhsFilter = this.cameras.main.setPostPipeline('VHSScanlineShader');
        
        // Enable skip after 5 seconds
        this.time.delayedCall(5000, () => {
            this.skipEnabled = true;
            this.showSkipPrompt();
        });
        
        // Input handlers
        this.setupSkipControls();
        
        // Start intro
        this.playPhase1HappyFamily();
    }
    
    playPhase1HappyFamily() {
        // 0:00 - 0:10 (10 seconds)
        this.currentPhase = 1;
        
        // Typewriter text
        this.typewriterSystem.displayText(
            "Nekoč so bile barve resnične...",
            0.5  // delay 0.5s
        );
        
        // Audio
        this.audioSystem.playMusic('intro_happy_lofi', {volume: 0.4, loop: false});
        this.audioSystem.playSFX('children_laughter', {volume: 0.2, loop: true});
        
        // Visual shots
        this.showShot('otac_longboard', 0, 3000, {
            blur: {start: 10, end: 5},
            colorGrade: 'warm'
        });
        
        this.showShot('ana_barbershop_dreads', 3000, 6000, {
            blur: {start: 8, end: 3},
            colorGrade: 'warm'
        });
        
        this.showShot('birthday_cake_rd', 6000, 10000, {
            blur: {start: 5, end: 2},
            colorGrade: 'warm',
            vhsIntensity: 0.2
        });
        
        // Transition to Phase 2
        this.time.delayedCall(10000, () => this.playPhase2TheBond());
    }
    
    playPhase2TheBond() {
        // 0:10 - 0:20 (10 seconds)
        this.currentPhase = 2;
        
        // Typewriter text
        this.typewriterSystem.displayText(
            "Imel sem njo. Imela sva vse.",
            0.5
        );
        
        // Heartbeat SFX
        this.audioSystem.playSFX('heartbeat_gentle', {volume: 0.3, loop: true, bpm: 80});
        
        // CLEAREST shot (most important)
        this.showShot('kai_ana_twins_holding_hands', 10000, 20000, {
            blur: {start: 0, end: 0},  // NO BLUR - crystal clear!
            glow: 'soft',  // Soft glow around twins
            focus: ['kai_dreads', 'ana_dreads'],  // Highlight matching DNA
            vhsIntensity: 0.15
        });
        
        // Transition to Phase 3
        this.time.delayedCall(20000, () => this.playPhase3TheCollapse());
    }
    
    playPhase3TheCollapse() {
        // 0:20 - 0:35 (15 seconds)
        this.currentPhase = 3;
        
        // Typewriter text
        this.typewriterSystem.displayText(
            "Potem je prišel X-Noir. In svet se je zlomil.",
            0.5
        );
        
        // Audio SHIFT
        this.audioSystem.stopSFX('children_laughter');
        this.audioSystem.stopSFX('heartbeat_gentle');
        this.audioSystem.fadeOutMusic(1000);
        
        this.time.delayedCall(1000, () => {
            this.audioSystem.playMusic('intro_punk_chaos', {volume: 0.7, fadeIn: 500});
            this.audioSystem.playSFX('sirens_chaos', {volume: 0.6, loop: true});
            this.audioSystem.playSFX('screams_distant', {volume: 0.4});
        });
        
        // Visual chaos
        this.showShot('virus_xnoir_spread', 20000, 23000, {
            colorOverride: {green: +70%, saturation: 1.5},
            glitch: 'heavy',
            vhsIntensity: 0.7
        });
        
        this.showShot('zombie_silhouettes_panic', 23000, 27000, {
            colorOverride: {red: +50%},
            glitch: 'extreme',
            strobe: true,
            rgbSeparation: true
        });
        
        this.showShot('chaos_streets', 27000, 32000, {
            blur: {start: 5, end: 15},
            colorOverride: {red: +80%},
            shake: true
        });
        
        this.showShot('ana_taken_away', 32000, 35000, {
            blur: {start: 15, end: 20},
            glitch: 'corruption',
            fade: 'red'
        });
        
        // Transition to Phase 4
        this.time.delayedCall(35000, () => this.playPhase4TheLoss());
    }
    
    playPhase4TheLoss() {
        // 0:35 - 0:45 (10 seconds)
        this.currentPhase = 4;
        
        // Typewriter text
        this.typewriterSystem.displayText(
            "Starša sta postala senci... Ana je izginila v temi.",
            0.5
        );
        
        // Audio SHIFT - sudden silence
        this.audioSystem.stopAll();
        this.time.delayedCall(1000, () => {
            this.audioSystem.playSFX('heartbeat_single', {volume: 0.4, bpm: 60});
            this.audioSystem.playMusic('intro_distortion', {volume: 0.3});
        });
        
        // Parents fading
        this.showShot('parents_becoming_ghosts', 35000, 40000, {
            opacity: {start: 100%, end: 30%},  // Foreshadowing!
            blur: {start: 10, end: 15},
            vhsIntensity: 0.9
        });
        
        this.showShot('kai_alone_basement', 40000, 45000, {
            darken: 80%,
            blur: {start: 15, end: 18},
            vhsIntensity: 1.0  // Maximum corruption
        });
        
        // Transition to Phase 5 (AGING!)
        this.time.delayedCall(45000, () => this.playPhase5PassageOfTime());
    }
    
    playPhase5PassageOfTime() {
        // 0:45 - 0:55 (10 seconds)
        // CRITICAL: Showcases Generational Aging System!
        this.currentPhase = 5;
        
        // Typewriter text
        this.typewriterSystem.displayText(
            "Leta so postala megla. Obraz se je spremenil... cilj nikoli.",
            0.5
        );
        
        // Audio
        this.audioSystem.stopAll();
        this.audioSystem.playMusic('intro_noir_synth', {volume: 0.6});
        this.audioSystem.playSFX('clock_ticking', {volume: 0.2, loop: true});
        this.audioSystem.playSFX('time_passing_whoosh', {volume: 0.3});
        
        // FAST MONTAGE - AGING STAGES
        // Young Kai (current)
        this.showShot('kai_young_current', 45000, 48000, {
            blur: {start: 5, end: 3},
            timelapse: true
        });
        
        // Adult Kai (35) - beard, tied dreads
        this.showShot('kai_adult_35_beard', 48000, 51000, {
            blur: {start: 5, end: 3},
            timelapse: true,
            reference: '/assets/references/aging_system/adult_kai_family_man.png'
        });
        
        // Elder Kai (50+) - grey dreads, punk grandpa
        this.showShot('kai_elder_punk_grandpa', 51000, 55000, {
            blur: {start: 5, end: 8},
            timelapse: true,
            colorGrade: 'grey',  // More grey as aging
            reference: '/assets/references/aging_system/elder_kai_punk_grandpa.png'
        });
        
        // Transition to Phase 6 (Wake up!)
        this.time.delayedCall(55000, () => this.playPhase6AmnesiaWakeUp());
    }
    
    playPhase6AmnesiaWakeUp() {
        // 0:55 - 1:00 (5 seconds)
        this.currentPhase = 6;
        
        // Typewriter text
        this.typewriterSystem.displayText(
            "Kdo sem? ... Kje je Ana?",
            0.5
        );
        
        // Audio
        this.audioSystem.stopAll();
        this.time.delayedCall(500, () => {
            this.audioSystem.playSFX('breathing_heavy', {volume: 0.3});
            this.audioSystem.playSFX('heartbeat_normalizing', {volume: 0.2, bpm: 60});
        });
        
        // MAXIMUM BLUR → Clear
        this.cameras.main.fadeOut(1000, 0, 0, 0);
        
        this.time.delayedCall(1500, () => {
            // Fade in bedroom
            this.cameras.main.fadeIn(2000);
            this.showShot('kai_bedroom_wakeup', 56500, 60000, {
                blur: {start: 20, end: 0},  // Amnesia clearing
                vhsFade: true  // VHS filter fades out
            });
            
            // Gronk voice
            this.time.delayedCall(58000, () => {
                this.audioSystem.playSFX('vape_hiss', {volume: 0.4});
                this.audioSystem.playDialogue(
                    "[AI_VOICE:gronk:custom] No, končno si buden.",
                    'gronk'
                );
            });
            
            // Transition to GameScene
            this.time.delayedCall(60000, () => {
                this.scene.start('GameScene');
            });
        });
    }
    
    setupSkipControls() {
        // Hold X to skip
        this.input.keyboard.on('keydown-X', () => {
            if (this.skipEnabled) {
                this.skipIntro();
            }
        });
        
        // ESC also skips
        this.input.keyboard.on('keydown-ESC', () => {
            if (this.skipEnabled) {
                this.skipIntro();
            }
        });
    }
    
    showSkipPrompt() {
        const skipText = this.add.text(
            20, 20,
            '[Hold X to face reality]',
            {
                fontFamily: 'Courier New',
                fontSize: '16px',
                color: '#ffffff',
                stroke: '#000000',
                strokeThickness: 2
            }
        );
        skipText.setAlpha(0);
        
        this.tweens.add({
            targets: skipText,
            alpha: 0.7,
            duration: 1000,
            yoyo: true,
            repeat: -1
        });
    }
    
    skipIntro() {
        console.log('⏩ Intro skipped!');
        this.audioSystem.stopAll();
        this.scene.start('GameScene');
    }
    
    showShot(imageKey, startTime, endTime, effects = {}) {
        this.time.delayedCall(startTime, () => {
            // Load and display image
            const shot = this.add.image(
                this.cameras.main.width / 2,
                this.cameras.main.height / 2,
                imageKey
            );
            
            // Apply effects
            if (effects.blur) {
                this.applyBlurTransition(shot, effects.blur, endTime - startTime);
            }
            if (effects.glitch) {
                this.applyGlitchEffect(shot, effects.glitch);
            }
            if (effects.colorOverride) {
                this.applyColorGrading(shot, effects.colorOverride);
            }
            if (effects.opacity) {
                this.applyOpacityTransition(shot, effects.opacity, endTime - startTime);
            }
            
            // Remove shot when done
            this.time.delayedCall(endTime, () => {
                shot.destroy();
            });
        });
    }
}
```

### **IntroScene.js Structure (Version B - 30-45 seconds):**

```javascript
class IntroScene extends Phaser.Scene {
    create() {
        // Initialize systems
        this.typewriterSystem = new DynamicTypewriterSystem(this);
        this.audioSystem = new HIPOAudioSystem(this);
        
        // Play sequence
        this.playPhase1HappyMemories();
    }
    
    playPhase1HappyMemories() {
        // Duration: 15 seconds
        // 5 shots, 3s each
        // Blur-to-clear effect
        // Typewriter text: "Nekoč smo imeli barve..."
        
        this.showShot('otac_longboard', 0, 3000, {blur: {start: 10, end: 0}});
        this.showShot('dreads_barbershop', 3000, 6000, {blur: {start: 10, end: 0}});
        this.showShot('ana_twin_moment', 6000, 9000, {blur: {start: 0, end: 0}}); // Clearest
        this.showShot('birthday_party', 9000, 12000, {blur: {start: 5, end: 0}});
        this.showShot('family_portrait', 12000, 15000, {blur: {start: 5, end: 0}, freeze: 2000});
        
        this.time.delayedCall(15000, () => this.playPhase2Collapse());
    }
    
    playPhase2Collapse() {
        // Duration: 15 seconds
        // 4 shots, faster cuts
        // Glitch effect intensifies
        // Typewriter text: "Potem je prišla tema..."
        
        this.showShot('virus_spread', 15000, 19000, {glitch: 'heavy', green: +70%});
        this.showShot('ombiji_appear', 19000, 23000, {glitch: 'extreme', strobe: true});
        this.showShot('parents_fight', 23000, 27000, {blur: 15, red: +50%});
        this.showShot('ana_separation', 27000, 30000, {glitch: 'corruption', red: 100%});
        
        this.time.delayedCall(30000, () => this.playPhase3Amnesia());
    }
    
    playPhase3Amnesia() {
        // Duration: 10 seconds
        // Blur → Kai's room → Memory flash → Gronk
        // Typewriter text: "In ostal sem sam..."
        
        this.cameras.main.fadeOut(2000, 0, 0, 0);
        this.time.delayedCall(3000, () => {
            this.cameras.main.fadeIn(2000);
            this.showShot('kai_bedroom', 33000, 37000, {blur: 5});
            this.showShot('ana_memory_flash', 37000, 38000, {flash: true});
            this.playGronkVoice(40000);
            
            this.time.delayedCall(45000, () => {
                if (this.checkSpecialEdition()) {
                    this.showSpecialEditionNotif();
                } else {
                    this.scene.start('GameScene');
                }
            });
        });
    }
    
    checkSpecialEdition() {
        // Check buyer ID or streamer mode
        return (buyerID <= 20 || streamerMode);
    }
}
```

---

## 🎯 KEY DESIGN PRINCIPLES

**1. ADHD Energy (Fast Cuts):**
- No shot longer than 5 seconds
- Rapid transitions keep attention
- Skip button ALWAYS available
- Visual variety prevents boredom

**2. Emotional Impact:**
- Happy → Sad = Maximum contrast
- Clear memory (Ana) = Quest motivation
- Parents sacrifice = Depth
- Amnesia = Player relatability

**3. Story Clarity:**
- 3 text overlays tell complete story
- Visual storytelling (no exposition dump)
- Mystery preserved (what happened to Ana?)
- Motivation clear (find her!)

**4. Style Consistency:**
- All Style 32 Dark-Chibi Noir
- Neon magenta/cyan throughout
- VHS aesthetic (memory theme)
- Thick outlines maintained

---

## 📊 TECHNICAL REQUIREMENTS

**Assets Needed:**
- 15+ reference images (some need generation)
- 3 music tracks (happy/punk/ambient)
- 20+ SFX (layered chaos)
- 1 AI voice (Gronk)
- Typewriter font (monospace)

**Phaser Effects:**
- Blur PostFX
- VHS Scanline shader (custom)
- Color grading pipeline
- Fade transitions
- Glitch effect (RGB separation)

**Performance:**
- All images preloaded
- Audio streaming (not preloaded)
- Effects optimized for 60 FPS
- Skip function instant (no delay)

---

## 🚀 NEXT STEPS FOR IMPLEMENTATION

1. **Generate Missing Assets:**
   - Happy Ana (smiling version)
   - Zombie silhouettes
   - Virus particle effect
   - Kai's bedroom

2. **Create IntroScene.js:**
   - Phase system
   - Timeline management
   - Effect controllers

3. **Test Sequence:**
   - Verify timing (30-45s total)
   - Check skip functionality
   - Audio sync
   - Special Edition trigger

4. **Polish:**
   - Blur curves smooth
   - Glitch timing Perfect
   - Music transitions seamless
   - Text readable

---

**Document Status:** ✅ Complete Design  
**Ready For:** Agent Implementation  
**Next Phase:** Asset Generation → IntroScene Coding  

*Created by: David "HIPO" Kotnik*  
*Hipodevil666 Studios™*  
*"From colors to darkness - Kai's journey begins"* 🎬🛹💜