From b966bd37fee76a139f2da07eecaa0b5aaaa23d6a Mon Sep 17 00:00:00 2001
From: David Kotnik <hipodevil666@gmail.com>
Date: Thu, 8 Jan 2026 16:18:46 +0100
Subject: [PATCH] =?UTF-8?q?=F0=9F=8E=AC=20Jan=208=20Enable=20PrologueScene?=
 =?UTF-8?q?=20+=20Character=20Sprite=20Loading?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

✅ INTRO CUTSCENE + CHARACTER SPRITES ADDED:

**1. Enabled PrologueScene (Intro Cutscene):**
- Uncommented PrologueScene.js in index.html
- Added PrologueScene to game.js scene list
- Now shows intro story when clicking 'New Game'
- Explains: What happened, where Kai is, who Ana is

**2. Character Sprite Loading:**
- Added preloadCharacterSprites() to PreloadScene
- Loading Kai idle + walk sprites
- Loading Ana idle + walk sprites
- Loading Susi (dog) idle + run sprites
- Path: /assets/references/main_characters/[char]/animations/

**Character Images Now Available:**
✅ kai_idle, kai_walk (Kai - protagonist)
✅ ana_idle, ana_walk (Ana - twin sister)
✅ susi_idle, susi_run (Susi - dog companion)

**Test Flow:**
1. Launch game → Loading screen
2. Click 'New Game' → PrologueScene intro
3. After intro → GameScene with character sprites

**Next:** Test TestVisualAudioScene with loaded sprites!
---
 index.html                 |  2 +-
 src/game.js                |  2 +-
 src/scenes/PreloadScene.js | 33 +++++++++++++++++++++++++++++++++
 3 files changed, 35 insertions(+), 2 deletions(-)

diff --git a/index.html b/index.html
index c01e6a85c..dc92ce936 100644
--- a/index.html
+++ b/index.html
@@ -206,7 +206,7 @@
     <script src="src/scenes/DemoSceneEnhanced.js"></script> <!-- ✨ ENHANCED DEMO with Locket! -->
     <script src="src/scenes/TiledTestScene.js"></script> <!-- 🗺️ Tiled Map Test Scene -->
     <!-- ⚠️ TEMPORARILY DISABLED - Missing assets (prologue.json, NPC portraits) -->
-    <!-- <script src="src/scenes/PrologueScene.js"></script> --><!-- 🎬 Story Prologue -->
+    <script src="src/scenes/PrologueScene.js"></script><!-- 🎬 Story Prologue -->
     <script src="src/scenes/UIScene.js"></script>
     <script src="src/scenes/StoryScene.js"></script>
     <script src="src/scenes/TownSquareScene.js"></script>
diff --git a/src/game.js b/src/game.js
index 6a1ba3ce0..aa51d2319 100644
--- a/src/game.js
+++ b/src/game.js
@@ -68,7 +68,7 @@ const config = {
             debug: false
         }
     },
-    scene: [BootScene, PreloadScene, SystemsTestScene, TestVisualAudioScene, DemoScene, DemoSceneEnhanced, TiledTestScene, StoryScene, /* PrologueScene - DISABLED */, GameScene, UIScene, TownSquareScene],
+    scene: [BootScene, PreloadScene, PrologueScene, SystemsTestScene, TestVisualAudioScene, DemoScene, DemoSceneEnhanced, TiledTestScene, StoryScene, GameScene, UIScene, TownSquareScene],
     scale: {
         mode: Phaser.Scale.FIT,
         autoCenter: Phaser.Scale.CENTER_BOTH
diff --git a/src/scenes/PreloadScene.js b/src/scenes/PreloadScene.js
index 370f4375a..ac6a7e264 100644
--- a/src/scenes/PreloadScene.js
+++ b/src/scenes/PreloadScene.js
@@ -14,6 +14,11 @@ class PreloadScene extends Phaser.Scene {
         // ═══════════════════════════════════════════════════════════════
         this.preloadAudio();
 
+        // ═══════════════════════════════════════════════════════════════
+        // 🎨 CHARACTER SPRITES - Demo Characters
+        // ═══════════════════════════════════════════════════════════════
+        this.preloadCharacterSprites();
+
         // ═══════════════════════════════════════════════════════════════
         // 🎮 DEMO MODE - ALL OLD ASSETS DISABLED!
         // ═══════════════════════════════════════════════════════════════
@@ -23,6 +28,34 @@ class PreloadScene extends Phaser.Scene {
         console.log('✅ Minimal preload complete - DemoSceneEnhanced will load its own assets!');
     }
 
+    preloadCharacterSprites() {
+        console.log('🎨 Preloading character sprites...');
+
+        const basePath = 'assets/references/main_characters/';
+
+        // Kai sprites
+        this.loadImageSafe('kai_idle', basePath + 'kai/animations/idle/kai_idle_frame1.png');
+        this.loadImageSafe('kai_walk', basePath + 'kai/animations/walk/kai_walk_frame1.png');
+
+        // Ana sprites  
+        this.loadImageSafe('ana_idle', basePath + 'ana/animations/idle/ana_idle_frame1.png');
+        this.loadImageSafe('ana_walk', basePath + 'ana/animations/walk/ana_walk_frame1.png');
+
+        // Susi (companion)
+        this.loadImageSafe('susi_idle', 'assets/references/companions/susi/animations/idle/susi_idle_frame1.png');
+        this.loadImageSafe('susi_run', 'assets/references/companions/susi/animations/run/susi_run_frame1.png');
+
+        console.log('🎨 Character sprites queued');
+    }
+
+    loadImageSafe(key, path) {
+        try {
+            this.load.image(key, path);
+        } catch (error) {
+            console.warn(`⚠️  Image skipped: ${key}`);
+        }
+    }
+
     preloadAudio() {
         console.log('🎵 Preloading audio assets...');