Upload 5 files

Pr2.md

@@ -0,0 +1,250 @@
+### **NS\_Prompt\_02.txt**
+
+' STAR DUST VOYAGER: GALAXY WANDERER \- INITIAL AND MAIN MENU SCREEN DESIGN  
+' CREATED BY GROK 3 (XAI) \- 01:35 PM CEST, MONDAY, JULY 21, 2025  
+' DEFINES DETAILED DESIGN AND IMPLEMENTATION OF INITIALLOADINGSCREEN AND MAINMENUSCREEN  
+' TARGETED FOR TRAE AI AGENT (LOVABLE.DEV)  
+' PURPOSE: DEVELOP THE VISUAL AND FUNCTIONAL FOUNDATION FOR THE GAME'S ENTRY SCREENS USING PIXIJS, INTEGRATING THEMATIC PIXELART, 3D DEPTH, AND CZECH LOCALIZATION, BUILDING ON NS\_PROMPT\_01
+
+' GOALS  
+' \- Design and implement the InitialLoadingScreen to display asset loading progress, thematic visuals, and tips, using PixiJS for rendering with 3D depth illusion and pixelart style.  
+' \- Create the MainMenuScreen as a navigational hub with thematic UI elements (buttons, panels), parallax layers, and animated background, optimized with PixiJS for performance and immersion.  
+' \- Ensure both screens align with the game’s retro-futuristic aesthetic, featuring detailed textures, neon accents, and lore-inspired details (e.g., serial numbers, faded logos).  
+' \- Integrate Czech localization using i18next, with text rendered via PixiJS Text objects, and prepare for smooth transitions managed by SceneManager.  
+' \- Generate high-quality placeholder assets (backgrounds, UI elements, animations) compatible with PixiJS, adhering to the project’s asset management system from NS\_Prompt\_01.  
+' \- Lay the groundwork for subsequent prompts (e.g., NS\_Prompt\_03 for UI refinement) by establishing PixiJS rendering patterns, animation frameworks, and screen-specific logic.
+
+' PROJECT CONTEXT  
+' \- BUILDS ON: NS\_Prompt\_01, assuming the project structure (star-dust-voyager), tech stack (React, PixiJS, Zustand), and initial assets are set up.  
+' \- ASSUMPTIONS: PixiApplication, AssetManager, and SceneManager are functional, with placeholder assets (e.g., loading\_background.png) available.  
+' \- DEPENDENCIES: client/src/game/rendering/PixiApplication.ts, client/src/game/core/AssetManager.ts, client/src/game/core/SceneManager.ts, client/public/locales/cs.json.
+
+' SCREEN DESIGN SPECIFICATIONS  
+' \- INITIALLOADINGSCREEN  
+'   \- PURPOSE: Display loading progress (0-100%), a thematic background, and randomized tips to engage players during asset loading.  
+'   \- VISUAL STYLE:  
+'     \- BACKGROUND: Space dock scene (1280x720px), dark \#050510 base, with a 16x16px pixelart ship silhouette, faint \#3388ff neon lights, and a 5px offset star layer for parallax (3 layers total).  
+'     \- PROGRESS BAR: Horizontal bar (800x40px), metallic \#3388ff frame, \#050510 fill with a \#FFD700 gradient progress indicator, positioned at 640px, 500px.  
+'     \- TEXT: Loading progress (e.g., "Načítání: 75%") in FontStyle\_PixelArt\_Thematic\_16pt (white \#FFFFFF, \#3388ff outline), and a tip (e.g., "Tip: Kontrolujte zásoby paliva před warpem\!") in FontStyle\_PixelArt\_Thematic\_12pt (gray \#CCCCCC).  
+'     \- ANIMATION: Subtle star twinkling (8 frames, 15 FPS) and progress bar fill animation (16 frames, 20 FPS).  
+'   \- FUNCTIONALITY:  
+'     \- Load all assets from asset\_manifest.json using AssetManager.  
+'     \- Update progress text and bar in real-time via PixiJS ticker.  
+'     \- Display a random tip from cs.json on each load.  
+'     \- Transition to MainMenuScreen when loading completes (progress \= 1), using SceneManager.transitionTo("MainMenuScreen").  
+' \- MAINMENUSCREEN  
+'   \- PURPOSE: Serve as the main navigation hub with options (New Game, Load Game, Settings, Exit), featuring a dynamic galactic background and thematic UI.  
+'   \- VISUAL STYLE:  
+'     \- BACKGROUND: Galactic nebula (1280x720px), dark \#050510 base, with 3 parallax layers: distant stars (zIndex \-2), nebula clouds (zIndex \-1, 64 frames, 15 FPS), and orbiting station silhouette (zIndex 0, 16 frames, 10 FPS).  
+'     \- BUTTONS: Four buttons (200x40px each), metallic \#3388ff frames, \#050510 textured fills, neon \#FFD700 glow on hover, labels from cs.json (e.g., "Nová Hra"), arranged vertically at 640px, 200px (spacing 60px).  
+'     \- PANEL: Optional info panel (400x200px), dark \#050510 with \#333333 border, displaying a welcome message (e.g., "Vítejte ve hvězdné galaxii\!") and serial number (e.g., "SN-4721-XK"), positioned at 640px, 400px.  
+'     \- ANIMATION: Nebula cloud drift, station orbit, and button hover pulse (16 frames, 15 FPS).  
+'   \- FUNCTIONALITY:  
+'     \- Render background layers and animate via PixiJS ticker.  
+'     \- Handle button clicks to trigger SceneManager transitions (e.g., "NewGameScreen" for New Game).  
+'     \- Display localized text and dynamic elements (e.g., station animation) with PixiJS.
+
+' ASSET REQUIREMENTS  
+' \- NEW PLACEHOLDER ASSETS:  
+'   \- client/public/assets/images/screens/loading\_background.png  
+'     \- DIMENSIONS: 1280x720px  
+'     \- DESIGN: Space dock with 16x16px ship silhouette, \#050510 background, \#3388ff neon lights, 5px offset star layer, 32x32px tile precision, PixiJS Texture-compatible.  
+'     \- TOOL: Aseprite, with parallax layer separation.  
+'   \- client/public/assets/images/screens/mainmenu\_background.png  
+'     \- DIMENSIONS: 1280x720px  
+'     \- DESIGN: Galactic nebula with 3 layers (stars, clouds, station), \#050510 base, \#3388ff/\#FF3300 nebula colors, 16x16px station sprite, 64-frame cloud animation, PixiJS Texture-compatible.  
+'     \- TOOL: Aseprite, with spritesheet export for animation.  
+'   \- client/public/assets/images/ui/buttons/menu\_button\_base.png  
+'     \- DIMENSIONS: 200x40px  
+'     \- DESIGN: Metallic \#3388ff frame (2px), \#050510 textured fill (4x4px grid), white \#FFFFFF "Placeholder" text, transparent background, PixiJS Sprite-compatible.  
+'     \- TOOL: Aseprite, with 2-frame hover animation (menu\_button\_hover.png).  
+'   \- client/public/assets/images/ui/panels/info\_panel\_base.png (optional)  
+'     \- DIMENSIONS: 400x200px  
+'     \- DESIGN: Dark \#050510 fill, \#333333 2px border, subtle grid texture, PixiJS Sprite-compatible.  
+'     \- TOOL: Aseprite.  
+' \- UPDATE ASSET MANIFEST:  
+'   \- Add new entries to client/public/assets/data/asset\_manifest.json:  
+\`\`\`json  
+{  
+  "ui/button\_base": "images/ui/buttons/button\_base.png",  
+  "screens/loading\_background": "images/screens/loading\_background.png",  
+  "audio/loading\_theme": "audio/music/loading\_theme.ogg",  
+  "fonts/default": "fonts/pixelart\_default.ttf",  
+  "screens/mainmenu\_background": "images/screens/mainmenu\_background.png",  
+  "ui/buttons/menu\_button\_base": "images/ui/buttons/menu\_button\_base.png",  
+  "ui/buttons/menu\_button\_hover": "images/ui/buttons/menu\_button\_hover.png",  
+  "ui/panels/info\_panel\_base": "images/ui/panels/info\_panel\_base.png"  
+}
+
+’ PIXIJS CONFIGURATION (SCREEN-SPECIFIC) ’ \- INITIALLOADINGSCREEN: ’ \- USE: PixiApplication from NS\_Prompt\_01, with a new Container for loading elements. ’ \- SETUP: ’ \- Create a progressBar Container with a Graphics object for the bar and Text for progress. ’ \- Add a tipText Text object with random selection from cs.json. ’ \- Use ParticleContainer for star twinkling (50 particles, random alpha 0.1-0.5). ’ \- ANIMATION: Update progressBar width and tipText via ticker, with a 0.5s fade-out transition to MainMenuScreen. ’ \- MAINMENUSCREEN: ’ \- USE: PixiApplication with three Containers (stars, nebula, UI). ’ \- SETUP: ’ \- starsContainer: 100 static sprites (4x4px, \#FFFFFF), zIndex \-2. ’ \- nebulaContainer: AnimatedSprite with 64-frame spritesheet, zIndex \-1, speed 0.1. ’ \- uiContainer: Buttons as Sprites, panel as Sprite, Text for labels, zIndex 1\. ’ \- ANIMATION: Parallax scroll (stars at 0.5x speed, nebula at 0.2x), button hover with Filter (BlurFilter, 2px radius). ’ \- OPTIMIZATION: Use PixiJS batching for stars, texture atlas for button states, and limit nebula frames to 30 FPS on mobile.
+
+’ CODE IMPLEMENTATION ’ \- InitialLoadingScreen.tsx
+
+// client/src/components/InitialLoadingScreen.tsx  
+import { useEffect } from 'react';  
+import { pixiApp, PixiApplication } from '../game/rendering/PixiApplication';  
+import { assetManager } from '../game/core/AssetManager';  
+import { SceneManager } from '../game/core/SceneManager';  
+import { Text, Graphics, Container, ParticleContainer } from 'pixi.js';  
+import i18n from '../i18n';
+
+const InitialLoadingScreen \= () \=\> {  
+  useEffect(() \=\> {  
+    const assets \= \[  
+      "screens/loading\_background",  
+      "ui/buttons/menu\_button\_base",  
+      "audio/loading\_theme"  
+    \];  
+    const loadingContainer \= new Container();  
+    pixiApp.addToStage(loadingContainer);
+
+    // Background  
+    const bg \= new PIXI.Sprite(assetManager.getAsset("screens/loading\_background")\!);  
+    loadingContainer.addChild(bg);
+
+    // Progress Bar  
+    const progressBarBg \= new Graphics()  
+      .beginFill(0x333333)  
+      .drawRect(240, 460, 800, 40\)  
+      .endFill();  
+    const progressBar \= new Graphics()  
+      .beginFill(0xFFD700)  
+      .drawRect(240, 460, 0, 40);  
+    loadingContainer.addChild(progressBarBg, progressBar);
+
+    // Text  
+    const progressText \= new Text("Načítání: 0%", {  
+      fontFamily: 'pixelart\_default',  
+      fontSize: 16,  
+      fill: 0xFFFFFF,  
+      stroke: 0x3388ff,  
+      strokeThickness: 1  
+    });  
+    progressText.anchor.set(0.5);  
+    progressText.x \= 640;  
+    progressText.y \= 520;  
+    const tipText \= new Text(i18n.t('loading.tip\_1\_cz'), {  
+      fontFamily: 'pixelart\_default',  
+      fontSize: 12,  
+      fill: 0xCCCCCC  
+    });  
+    tipText.anchor.set(0.5);  
+    tipText.x \= 640;  
+    tipText.y \= 560;  
+    loadingContainer.addChild(progressText, tipText);
+
+    // Stars  
+    const stars \= new ParticleContainer(50, {  
+      position: true,  
+      alpha: true  
+    });  
+    for (let i \= 0; i \< 50; i++) {  
+      const star \= new PIXI.Sprite(PIXI.Texture.WHITE);  
+      star.width \= star.height \= 4;  
+      star.x \= Math.random() \* 1280;  
+      star.y \= Math.random() \* 720;  
+      star.alpha \= 0.1 \+ Math.random() \* 0.4;  
+      stars.addChild(star);  
+    }  
+    loadingContainer.addChild(stars);
+
+    // Loading Logic  
+    assetManager.loadAssets(assets).then(() \=\> {  
+      pixiApp.getApp().ticker.add(() \=\> {  
+        const progress \= assetManager.getProgress();  
+        progressBar.width \= 800 \* progress;  
+        progressText.text \= \`Načítání: ${Math.round(progress \* 100)}%\`;  
+        if (progress \=== 1\) {  
+          pixiApp.getApp().ticker.removeAllListeners();  
+          SceneManager.transitionTo("MainMenuScreen");  
+        }  
+      });  
+    });
+
+    return () \=\> {  
+      loadingContainer.destroy({ children: true });  
+    };  
+  }, \[\]);
+
+  return ;  
+};
+
+export default InitialLoadingScreen;
+
+’ \- MainMenuScreen.tsx
+
+// client/src/components/MainMenuScreen.tsx  
+import { useEffect } from 'react';  
+import { pixiApp } from '../game/rendering/PixiApplication';  
+import { assetManager } from '../game/core/AssetManager';  
+import { SceneManager } from '../game/core/SceneManager';  
+import { Container, Sprite, Text, AnimatedSprite, BlurFilter } from 'pixi.js';  
+import i18n from '../i18n';
+
+const MainMenuScreen \= () \=\> {  
+  useEffect(() \=\> {  
+    const menuContainer \= new Container();  
+    pixiApp.addToStage(menuContainer);
+
+    // Background Layers  
+    const starsContainer \= new Container();  
+    for (let i \= 0; i \< 100; i++) {  
+      const star \= new Sprite(PIXI.Texture.WHITE);  
+      star.width \= star.height \= 4;  
+      star.x \= Math.random() \* 1280;  
+      star.y \= Math.random() \* 720;  
+      starsContainer.addChild(star);  
+    }  
+    starsContainer.zIndex \= \-2;  
+    const nebulaContainer \= new AnimatedSprite(\[  
+      assetManager.getAsset("screens/mainmenu\_background")\!.clone(),  
+      // Assume 64-frame spritesheet  
+    \]);  
+    nebulaContainer.animationSpeed \= 0.1;  
+    nebulaContainer.play();  
+    nebulaContainer.zIndex \= \-1;  
+    menuContainer.addChild(starsContainer, nebulaContainer);
+
+    // UI Elements  
+    const buttons \= \[  
+      "newGame\_cz", "loadGame\_cz", "settings\_cz", "exit\_cz"  
+    \].map((key, index) \=\> {  
+      const button \= new Sprite(assetManager.getAsset("ui/buttons/menu\_button\_base")\!);  
+      button.x \= 640 \- 100;  
+      button.y \= 200 \+ index \* 60;  
+      const text \= new Text(i18n.t(\`mainMenu.${key}\`), {  
+        fontFamily: 'pixelart\_default',  
+        fontSize: 16,  
+        fill: 0xFFFFFF,  
+        stroke: 0x3388ff,  
+        strokeThickness: 1  
+      });  
+      text.anchor.set(0.5);  
+      text.x \= 100;  
+      button.addChild(text);  
+      button.interactive \= true;  
+      button.on('mouseover', () \=\> button.filters \= \[new BlurFilter(2)\]);  
+      button.on('mouseout', () \=\> button.filters \= \[\]);  
+      return button;  
+    });  
+    menuContainer.addChild(...buttons);
+
+    // Parallax and Animation  
+    pixiApp.getApp().ticker.add((delta) \=\> {  
+      starsContainer.x \-= 0.5 \* delta;  
+      nebulaContainer.x \-= 0.2 \* delta;  
+      if (starsContainer.x \< \-1280) starsContainer.x \= 0;  
+      if (nebulaContainer.x \< \-1280) nebulaContainer.x \= 0;  
+    });
+
+    return () \=\> {  
+      menuContainer.destroy({ children: true });  
+    };  
+  }, \[\]);
+
+  return ;  
+};
+
+export default MainMenuScreen;
+
+’ AI DIRECTIVES FOR TRAE ’ 1\. UPDATE PROJECT STRUCTURE: ’ \- Add client/src/components/InitialLoadingScreen.tsx and client/src/components/MainMenuScreen.tsx to the existing structure from NS\_Prompt\_01. ’ \- INSTRUCTION: Ensure TypeScript compiles and integrates with PixiCanvas.tsx. ’ 2\. GENERATE NEW ASSETS: ’ \- loading\_background.png: Follow design specs, export as PixiJS Texture. ’ \- mainmenu\_background.png: Create 64-frame spritesheet, optimize for PixiJS AnimatedSprite. ’ \- menu\_button\_base.png and menu\_button\_hover.png: Design 2-frame animation, PixiJS-compatible. ’ \- info\_panel\_base.png: Optional, follow design specs. ’ \- INSTRUCTION: Use Aseprite, verify with PixiJS Loader, and update asset\_manifest.json. ’ 3\. IMPLEMENT SCREENS: ’ \- Create InitialLoadingScreen.tsx with the provided code, testing progress and transition. ’ \- Create MainMenuScreen.tsx with the provided code, testing parallax and button interactivity. ’ \- INSTRUCTION: Run with Vite (npm run dev), confirm PixiJS rendering, and log transitions. ’ 4\. INTEGRATE LOCALIZATION: ’ \- Use i18next in both screens, rendering Text with cs.json keys. ’ \- INSTRUCTION: Test with i18n.t() calls, ensure proper font rendering. ’ 5\. OUTPUT REQUIREMENTS: ’ \- PROVIDE: List of new files and updated asset\_manifest.json. ’ \- PROVIDE: Screenshots of InitialLoadingScreen (at 50% and 100%) and MainMenuScreen (with hover effect). ’ \- PROVIDE: Confirm successful PixiJS rendering and transition from loading to menu. ’ \- PROVIDE: Full code of InitialLoadingScreen.tsx and MainMenuScreen.tsx with comments. ’ \- INSTRUCTION: Include logs and performance metrics (e.g., FPS) from PixiJS ticker.

Pr3.md

@@ -0,0 +1,274 @@
+### **NS\_Prompt\_03.txt**
+
+' STAR DUST VOYAGER: GALAXY WANDERER \- TRANSITION LOADING SCREEN AND NEW GAME SETUP MODULE  
+' CREATED BY GROK 3 (XAI) \- 02:15 PM CEST, MONDAY, JULY 21, 2025  
+' SPECIFIES DESIGN, VISUALS, LAYOUT, FUNCTIONALITY, ANIMATIONS, AND ASSETS FOR TRANSITIONLOADINGSCREEN AND NEWGAMESETUPSCREEN  
+' TARGETED FOR TRAE AI AGENT (LOVABLE.DEV)  
+' PURPOSE: DEVELOP TRANSITION LOADING SCREENS AND A MULTI-STEP NEW GAME SETUP WITH PILOT CREATION, SHIP SELECTION, CREW CHOICE, AND DIFFICULTY SETTINGS IN COMPLEX PIXELART STYLE, WITH CZECH LOCALIZATION
+
+' GOALS  
+' \- Design and implement the TransitionLoadingScreen for smooth scene transitions, featuring animated warp lines and a pulsating nexus symbol, rendered with PixiJS.  
+' \- Create a multi-step NewGameSetupScreen with detailed UI for difficulty selection, pilot creation (with procedural portraits), ship selection, optional crew and scenario choices, and a summary step, all in retro-futuristic pixelart style.  
+' \- Ensure all player-facing text is in Czech using i18next, with dynamic updates and tooltips for enhanced UX.  
+' \- Generate high-quality pixelart assets (backgrounds, sprites, icons) and sound effects, optimized for PixiJS rendering and the game’s aesthetic from NS\_Prompt\_01 and Prompt 35\.  
+' \- Integrate with SceneManager for seamless transitions and gameSessionStore for saving player choices.  
+' \- Prepare for subsequent prompts (e.g., NS\_Prompt\_04 for InSystemScene) by establishing reusable UI patterns and procedural generation logic.
+
+' PROJECT CONTEXT  
+' \- BUILDS ON: NS\_Prompt\_01 (project structure, tech stack), NS\_Prompt\_02 (InitialLoadingScreen, MainMenuScreen), and references Prompt 35 (global visual style) and Prompt 27/40 (alien races, portrait generation).  
+' \- ASSUMPTIONS: PixiApplication, AssetManager, and SceneManager are functional; placeholder assets and localization (cs.json) are available.  
+' \- DEPENDENCIES: client/src/game/rendering/PixiApplication.ts, client/src/game/core/AssetManager.ts, client/src/game/core/SceneManager.ts, client/public/locales/cs.json.
+
+' 0\. ASSUMPTIONS AND GLOBAL STYLES  
+' \- PIXEL ART STYLE: Strict adherence to "Complex Detailed Pixel Art Style with Retro Touch" (Prompt 1, 35), 16x16px base tile, with 3D depth via parallax and lighting effects.  
+' \- ASSET DIRECTORY: Follows NS\_Prompt\_01 structure (e.g., client/public/assets/).  
+' \- UI COMPONENTS: Uses global styles (ButtonStyle\_Standard\_PixelArt, FontStyle\_PixelArt\_DefaultText) from NS\_Prompt\_01.  
+' \- LOCALIZATION: All text uses i18next keys with Czech defaults.
+
+' 1\. TRANSITIONLOADINGSCREEN  
+' \- PURPOSE: Short loading screen between main scenes (e.g., MainMenu to NewGameSetup), displaying contextual text and animations.  
+' \- SPECIFICATION (TransitionLoadingScreenConfig):  
+\`\`\`json  
+{  
+    "id": "TransitionLoadingScreen",  
+    "screenName\_cz": "Načítání...",  
+    "background": {  
+        "type": "Subtle\_Animated\_PixelArt",  
+        "assetPath": "client/public/assets/images/ui/loading\_screens/transition\_warp\_lines\_subtle\_pixel\_anim\_sheet.png",  
+        "animationParams": { "frameCount": 32, "speed": 5, "loop": true },  
+        "overlayColor": "\#000000B0"  
+    },  
+    "loadingIndicator": {  
+        "type": "Pulsating\_Nexus\_Symbol\_Small\_PixelArt",  
+        "assetPath": "client/public/assets/images/ui/icons/nexus\_symbol\_loading\_pulsate\_pixelart\_anim.png",  
+        "animationParams": { "frameCount": 16, "speed": 2, "loop": true },  
+        "position": { "x\_percent": 50, "y\_percent": 45, "anchor\_x": 0.5, "anchor\_y": 0.5 },  
+        "sizePx": { "x": 48, "y": 48 }  
+    },  
+    "loadingText": {  
+        "display": true,  
+        "dynamicKey\_cz": "loading.text.contextual\_cz",  
+        "defaultText\_cz": "PROSÍM ČEKEJTE...",  
+        "fontStyleKey": "FontStyle\_PixelArt\_Loading\_Transition",  
+        "position": { "x\_percent": 50, "y\_percent": 55, "anchor\_x": 0.5, "anchor\_y": 0.5 }  
+    },  
+    "displayDuration\_IfNoRealTask\_ms": 300,  
+    "fadeInOut\_Animation": { "type": "FadeToFromBlack", "durationMs": 200 }  
+}
+
+’ \- DESCRIPTION: ’ \- Displays animated warp lines and a pulsating nexus symbol during scene transitions or data loading. ’ \- Text updates dynamically (e.g., “Generování Postavy…”) via SceneManager. ’ \- PIXIJS IMPLEMENTATION: ’ \- Use PixiApplication with a Container for background (AnimatedSprite) and indicator (AnimatedSprite). ’ \- Apply overlay with Graphics and Text for loading message. ’ \- Animate via ticker with fade-in/out using PixiJS AlphaFilter. ’ \- REQUIRED ASSETS: ’ \- client/public/assets/images/ui/loading\_screens/transition\_warp\_lines\_subtle\_pixel\_anim\_sheet.png: 1280x720px, 32-frame spritesheet, warp effect with \#3388ff lines on \#050510. ’ \- client/public/assets/images/ui/icons/nexus\_symbol\_loading\_pulsate\_pixelart\_anim.png: 48x48px, 16-frame spritesheet, pulsating \#FFD700 symbol on \#050510. ’ \- FontStyle\_PixelArt\_Loading\_Transition: 16px, white \#FFFFFF with \#00AACC outline.
+
+’ 2\. NEWGAMESETUPSCREEN ’ \- PURPOSE: Multi-step screen for configuring a new game, including difficulty, pilot creation, ship selection, crew choice, scenario, and summary. ’ \- SPECIFICATION (NewGameSetupScreenConfig):
+
+{  
+    "id": "NewGameSetupScreen",  
+    "screenName\_cz": "Nová Hra \- Nastavení",  
+    "panelStyle": {  
+        "backgroundImageAsset\_Subtle\_Path": "client/public/assets/images/ui/backgrounds/new\_game\_setup\_bg\_blueprint\_grid\_animated.png",  
+        "backgroundColor": "\#080A18F8",  
+        "borderColor": "\#00AACC",  
+        "borderWidthPx": 2,  
+        "widthPercentOfScreen": 90,  
+        "heightPercentOfScreen": 90,  
+        "paddingPx": 30  
+    },  
+    "steps": \[  
+        { "stepId": "difficulty\_selection", "titleKey\_cz": "newgame.step1.title\_cz", "defaultTitle\_cz": "Nastavení Obtížnosti a Módů Hry", "ui\_Component\_Key": "NewGameStep\_Difficulty" },  
+        { "stepId": "pilot\_creation", "titleKey\_cz": "newgame.step2.title\_cz", "defaultTitle\_cz": "Vytvoření Pilota", "ui\_Component\_Key": "NewGameStep\_PilotCreation" },  
+        { "stepId": "ship\_selection", "titleKey\_cz": "newgame.step3.title\_cz", "defaultTitle\_cz": "Výběr Počáteční Lodi", "ui\_Component\_Key": "NewGameStep\_ShipSelection" },  
+        { "stepId": "crew\_selection", "titleKey\_cz": "newgame.step4.title\_cz", "defaultTitle\_cz": "Sestavení Počáteční Posádky (Volitelné)", "ui\_Component\_Key": "NewGameStep\_CrewSelection" },  
+        { "stepId": "scenario\_selection", "titleKey\_cz": "newgame.step5.title\_cz", "defaultTitle\_cz": "Zvolte Počáteční Scénář (Volitelné)", "ui\_Component\_Key": "NewGameStep\_ScenarioSelection" },  
+        { "stepId": "summary", "titleKey\_cz": "newgame.step6.title\_cz", "defaultTitle\_cz": "Souhrn Vašich Voleb", "ui\_Component\_Key": "NewGameStep\_Summary" }  
+    \],  
+    "navigationButtons": {  
+        "nextButton\_TextKey\_cz": "newgame.next\_cz", "defaultNextButton\_Text\_cz": "Další \>",  
+        "previousButton\_TextKey\_cz": "newgame.previous\_cz", "defaultPreviousButton\_Text\_cz": "\< Zpět",  
+        "startGameButton\_TextKey\_cz": "newgame.start\_cz", "defaultStartGameButton\_Text\_cz": "Zahájit Dobrodružství\!",  
+        "buttonStyleKey": "ButtonStyle\_Large\_Confirm\_PixelArt",  
+        "layout\_Position": "Bottom\_Center\_Spread"  
+    },  
+    "stepIndicator\_UI": {  
+        "displayType": "DotSequence\_Highlighted",  
+        "dotStyle\_Active\_Asset": "assets/images/ui/dot\_active\_gold\_pixelart.png",  
+        "dotStyle\_Inactive\_Asset": "assets/images/ui/dot\_inactive\_gray\_pixelart.png",  
+        "position": "TopCenter"  
+    },  
+    "music\_NewGameSetup\_AssetPath": "client/public/assets/audio/music/themes/new\_game\_setup\_theme\_contemplative\_tech\_loop.ogg",  
+    "transitionTo\_OnStartGame\_ScreenId": "TransitionLoadingScreen\_To\_InGame"  
+}
+
+’ 2.1 STEP 1: DIFFICULTY AND GAME MODE SELECTION ’ \- SPECIFICATION (NewGame\_Step\_DifficultyConfig):
+
+{  
+    "ui\_Component\_Key": "NewGameStep\_Difficulty",  
+    "titleKey\_cz": "newgame.step1.title\_cz", "defaultTitle\_cz": "Nastavení Obtížnosti a Módů Hry",  
+    "layout\_Columns": 2,  
+    "difficultySelection\_UI": {  
+        "labelKey\_cz": "newgame.difficulty.label\_cz", "defaultLabel\_cz": "Zvolte Obtížnost:",  
+        "options": \[  
+            { "value": "Easy", "labelKey\_cz": "difficulty.easy\_cz", "defaultLabel\_cz": "Lehká (Tulák Začátečník)", "description\_cz": "Mírnější nepřátelé, více zdrojů, menší postihy.", "iconAsset": "assets/images/icons/ui/difficulty\_easy\_shield.png" },  
+            { "value": "Normal", "labelKey\_cz": "difficulty.normal\_cz", "defaultLabel\_cz": "Normální (Ostřílený Poutník)", "description\_cz": "Vyvážený zážitek.", "iconAsset": "assets/images/icons/ui/difficulty\_normal\_sword\_shield.png" },  
+            { "value": "Hard", "labelKey\_cz": "difficulty.hard\_cz", "defaultLabel\_cz": "Těžká (Vesmírný Vlk Samotář)", "description\_cz": "Silnější nepřátelé, méně zdrojů.", "iconAsset": "assets/images/icons/ui/difficulty\_hard\_skull.png" },  
+            { "value": "Roguelike", "labelKey\_cz": "difficulty.roguelike\_cz", "defaultLabel\_cz": "Nemilosrdná (Legenda Prázdnoty)", "description\_cz": "Trvalá smrt, extrémní výzva.", "iconAsset": "assets/images/icons/ui/difficulty\_roguelike\_broken\_skull.png" }  
+        \],  
+        "displayType": "LargeButtons\_With\_IconAndDescription",  
+        "selectedOption\_HighlightStyleKey": "SelectionHighlight\_GoldBorder\_Animated",  
+        "defaultSelection": "Normal"  
+    },  
+    "gameModes\_UI": {  
+        "labelKey\_cz": "newgame.gamemodes.label\_cz", "defaultLabel\_cz": "Speciální Herní Módy:",  
+        "options": \[  
+            { "id": "permadeath\_mode", "labelKey\_cz": "gamemode.permadeath\_cz", "defaultLabel\_cz": "Trvalá Smrt", "tooltip\_cz": "Hra končí při explozi lodi (pouze pro 'Nemilosrdná').", "checkboxStyleKey": "Checkbox\_RetroTech\_Large", "isEnabled\_Condition": "difficulty \=== 'Roguelike'" },  
+            { "id": "ironman\_mode", "labelKey\_cz": "gamemode.ironman\_cz", "defaultLabel\_cz": "Režim Ironman", "tooltip\_cz": "Zakázané manuální ukládání.", "checkboxStyleKey": "Checkbox\_RetroTech\_Large" }  
+        \]  
+    },  
+    "galaxySeed\_UI": {  
+        "labelKey\_cz": "newgame.galaxyseed.label\_cz", "defaultLabel\_cz": "Seed Galaxie (volitelné):",  
+        "inputField\_StyleKey": "TextInput\_PixelArt\_Retro\_Medium",  
+        "randomizeButton\_Text\_cz": "Náhodný", "randomizeButton\_IconAsset": "assets/images/icons/ui/dice\_random\_icon.png", "randomizeButton\_StyleKey": "Button\_Small\_IconOnly\_PixelArt"  
+    }  
+}
+
+’ \- PIXIJS: Render buttons as Sprites with AnimatedSprite highlights, text via Text objects.
+
+’ 2.2 STEP 2: PILOT CREATION ’ \- SPECIFICATION (NewGame\_Step\_PilotCreationConfig):
+
+{  
+    "ui\_Component\_Key": "NewGameStep\_PilotCreation",  
+    "titleKey\_cz": "newgame.step2.title\_cz", "defaultTitle\_cz": "Vytvoření Pilota",  
+    "layout\_Columns": 2,  
+    "pilotName\_Input\_UI": {  
+        "labelKey\_cz": "newgame.pilot.name\_cz", "defaultLabel\_cz": "Jméno Pilota:",  
+        "inputField\_StyleKey": "TextInput\_PixelArt\_Retro\_Large",  
+        "maxLength": 24  
+    },  
+    "pilotRace\_Selection\_UI": {  
+        "labelKey\_cz": "newgame.pilot.race\_cz", "defaultLabel\_cz": "Rasa:",  
+        "displayType": "Dropdown\_With\_RaceIcons\_And\_InfoTooltip",  
+        "options\_Source\_AlienRaceDefinitions\_Playable": true,  
+        "onRaceChange\_Action": "UpdatePortraitGenerator\_WithRaceParts\_And\_ResetAppearance"  
+    },  
+    "pilotPortrait\_Customization\_UI": {  
+        "previewArea\_SizePx": { "x": 256, "y": 256 },  
+        "previewBackground\_AssetPath": "assets/images/ui/new\_game\_setup/portrait\_preview\_bg\_tech.png",  
+        "componentCategories\_cz": \[  
+            { "categoryId": "HeadShape", "label\_cz": "Tvar Hlavy", "partType\_Reference": "HeadShape" },  
+            { "categoryId": "HairStyle", "label\_cz": "Účes/Hlavové Útvary", "partType\_Reference": "HairOrHeadFeature" },  
+            { "categoryId": "Eyes", "label\_cz": "Oči", "partType\_Reference": "Eyes" },  
+            { "categoryId": "Mouth", "label\_cz": "Ústa", "partType\_Reference": "Mouth" },  
+            { "categoryId": "SkinPatterns", "label\_cz": "Vzory Kůže", "partType\_Reference": "SkinPattern" },  
+            { "categoryId": "Clothing", "label\_cz": "Oblečení \- Trup", "partType\_Reference": "Clothing" },  
+            { "categoryId": "Accessories", "label\_cz": "Doplňky", "partType\_Reference": "Accessory" }  
+        \],  
+        "partSelection\_UI\_Type": "Horizontal\_IconStrip\_With\_Arrows",  
+        "colorSelection\_UI\_Type\_ForColorableParts": "PaletteGrid\_SmallSwatches",  
+        "randomizeAppearance\_Button\_cz": {  
+            "text\_cz": "Náhodný Vzhled", "iconAsset": "assets/images/icons/ui/dice\_random\_icon\_large.png",  
+            "styleKey": "Button\_Standard\_PixelArt\_WithIcon",  
+            "action": "Call\_ProceduralPortraitGenerator\_RandomizeForCurrentRace"  
+        },  
+        "genderOrEquivalent\_Selection\_IfRaceHasMultiple\_cz": true  
+    },  
+    "pilotOrigin\_Selection\_UI\_Optional": {  
+        "labelKey\_cz": "newgame.pilot.origin\_cz", "defaultLabel\_cz": "Původ:",  
+        "options\_Path": "assets/data/player\_setup/pilot\_origins\_cz.json",  
+        "displayType": "Dropdown\_With\_DescriptionTooltip"  
+    }  
+}
+
+’ \- PIXIJS: Render preview as Sprite, use AnimatedSprite for part changes, Text for labels.
+
+’ 2.3 STEP 3: SHIP SELECTION ’ \- SPECIFICATION (NewGame\_Step\_ShipSelectionConfig):
+
+{  
+    "ui\_Component\_Key": "NewGameStep\_ShipSelection",  
+    "titleKey\_cz": "newgame.step3.title\_cz", "defaultTitle\_cz": "Výběr Počáteční Lodi",  
+    "layout\_Type": "Horizontal\_ShipCarousel\_With\_StatsDisplay",  
+    "availableStartingShips\_Ids": \["explorer\_scout\_nomad\_player\_start", "fighter\_light\_arrow\_starter", "transport\_small\_hauler\_starter", "corvette\_stealth\_shadow\_starter"\],  
+    "shipDisplay\_InUI": {  
+        "sprite\_AssetPath\_From\_ShipClassDefinition": true,  
+        "sprite\_ScaleFactor": 1.0,  
+        "animation\_Idle\_SubtleRotation\_Or\_EngineFlicker": { "frameCount": 8, "speed": 3, "loop": true },  
+        "background\_ForShipSprite\_AssetPath": "assets/images/ui/new\_game\_setup/ship\_display\_hangar\_bay\_bg.png"  
+    },  
+    "shipStats\_Display\_KeyElements\_cz": \["Název Třídy", "Role", "Max. Trup", "Max. Štíty", "Rychlost", "Obratnost", "Nákladový Prostor", "Počet Zbraňových Slotů", "Stručný Popis Výhod/Nevýhod"\],  
+    "shipStats\_Comparison\_UI\_Optional": true,  
+    "shipName\_Input\_UI": {  
+        "labelKey\_cz": "newgame.ship.name\_cz", "defaultLabel\_cz": "Pojmenujte Svou Loď:",  
+        "inputField\_StyleKey": "TextInput\_PixelArt\_Retro\_Medium"  
+    },  
+    "shipColor\_Selection\_UI\_Basic": {  
+        "labelKey\_cz": "newgame.ship.color\_cz", "defaultLabel\_cz": "Primární Barva Lodi:",  
+        "colorPalette\_Options\_Path": "assets/data/player\_setup/ship\_starting\_colors.json",  
+        "displayType": "ColorSwatch\_Buttons\_Selectable"  
+    }  
+}
+
+’ \- PIXIJS: Use Carousel with AnimatedSprite for ships, Text for stats.
+
+’ 2.4 STEP 4: CREW SELECTION (OPTIONAL) ’ \- SPECIFICATION (NewGame\_Step\_CrewSelectionConfig):
+
+{  
+    "ui\_Component\_Key": "NewGameStep\_CrewSelection",  
+    "titleKey\_cz": "newgame.step4.title\_cz", "defaultTitle\_cz": "Sestavení Počáteční Posádky (Volitelné)",  
+    "allowSkip\_Button\_Text\_cz": "Začít Sám",  
+    "maxSelectableCrew\_Initial": 2,  
+    "candidatePool\_Generation\_Logic\_cz": "4-6 random candidates with procedural portraits and traits.",  
+    "candidateDisplay\_UI\_ListItem": {  
+        "layout\_cz": "Portrét vlevo, Jméno/Rasa/Hlavní Dovednost/Rys vpravo.",  
+        "portraitSizePx": { "x": 48, "y": 48 },  
+        "fontStyle\_NameKey": "StandardText\_Bold",  
+        "fontStyle\_InfoKey": "SmallText\_Default",  
+        "selectionCheckbox\_StyleKey": "Checkbox\_RetroTech\_Small"  
+    },  
+    "selectedCrew\_Summary\_Panel\_cz": "Small panel with portraits and names."  
+}
+
+’ \- PIXIJS: Render candidates as Sprites, use Text for details.
+
+’ 2.5 STEP 5: SCENARIO SELECTION (OPTIONAL) ’ \- SPECIFICATION (NewGame\_Step\_ScenarioSelectionConfig):
+
+{  
+    "ui\_Component\_Key": "NewGameStep\_ScenarioSelection",  
+    "titleKey\_cz": "newgame.step5.title\_cz", "defaultTitle\_cz": "Zvolte Počáteční Scénář (Volitelné)",  
+    "allowSkip\_Button\_Text\_cz": "Standardní Začátek",  
+    "scenarioOptions\_Path": "assets/data/player\_setup/starting\_scenarios\_cz.json",  
+    "displayType": "SelectableCards\_With\_ImageAndDescription",  
+    "cardStyle\_AssetPath\_Template": "assets/images/ui/new\_game\_setup/scenario\_card\_{scenarioId}.png"  
+}
+
+’ \- PIXIJS: Render cards as Sprites with Text overlays.
+
+’ 2.6 STEP 6: SUMMARY ’ \- SPECIFICATION (NewGame\_Step\_SummaryConfig):
+
+{  
+    "ui\_Component\_Key": "NewGameStep\_Summary",  
+    "titleKey\_cz": "newgame.step6.title\_cz", "defaultTitle\_cz": "Souhrn Vašich Voleb",  
+    "layout\_Display\_ReadAllChoices\_cz": "Display all choices: Difficulty, Pilot Name/Race/Portrait, Origin, Ship, Crew, Scenario.",  
+    "confirmationText\_cz": "Jste připraveni zahájit své vesmírné dobrodružství?",  
+    "startGame\_Button\_Reference": "NewGameSetupScreenConfig.navigationButtons.startGameButton"  
+}
+
+’ \- PIXIJS: Use Container for summary layout, Text for details.
+
+’ 3\. REQUIRED GRAPHIC ASSETS ’ \- BACKGROUND: client/public/assets/images/ui/backgrounds/new\_game\_setup\_bg\_blueprint\_grid\_animated.png: 1280x720px, animated grid, \#00AACC lines. ’ \- DIFFICULTY ICONS: assets/images/icons/ui/difficulty\_easy\_shield.png, difficulty\_normal\_sword\_shield.png, difficulty\_hard\_skull.png, difficulty\_roguelike\_broken\_skull.png: 32x32px each. ’ \- GAME MODE ICONS: assets/images/icons/ui/gamemode\_permadeath\_icon.png, gamemode\_ironman\_icon.png: 24x24px. ’ \- RANDOMIZE BUTTONS: assets/images/icons/ui/dice\_random\_icon.png (24x24px), dice\_random\_icon\_large.png (48x48px). ’ \- PORTRAIT PARTS: client/public/assets/images/portraits/procedural/{raceId}/{partType}/: 64x64px PNGs for 3-4 races \+ Humans (e.g., human/HeadShape\_01.png). ’ \- PORTRAIT PREVIEW: assets/images/ui/new\_game\_setup/portrait\_preview\_bg\_tech.png: 256x256px, tech frame. ’ \- SHIP SPRITES: assets/images/ships/player\_starters/explorer\_nomad\_detailed\_preview.png, etc.: 128x256px, animated. ’ \- SHIP DISPLAY: assets/images/ui/new\_game\_setup/ship\_display\_hangar\_bay\_bg.png: 300x200px. ’ \- SCENARIO CARDS: assets/images/ui/new\_game\_setup/scenario\_card\_{scenarioId}.png: 200x150px each.
+
+’ 4\. REQUIRED SOUND ASSETS ’ \- MUSIC: client/public/assets/audio/music/themes/new\_game\_setup\_theme\_contemplative\_tech\_loop.ogg: 3-min loop, 44.1kHz. ’ \- UI SOUNDS: sfx/ui/new\_game\_step\_next\_confirm.wav, previous\_click.wav, start\_adventure\_confirm\_epic.wav, dropdown\_select\_option\_click.wav, checkbox\_toggle\_tech\_click.wav, text\_input\_keypress\_pixel.wav, portrait\_part\_change\_click.wav, ship\_select\_confirm\_chime.wav, crew\_candidate\_select\_click.wav, randomize\_button\_dice\_roll.wav: 0.5-2s each.
+
+’ 5\. AI DIRECTIVES FOR TRAE ’ \- IMPLEMENT TRANSITIONLOADINGSCREEN: ’ \- Create TransitionLoadingScreen.tsx with PixiJS logic (AnimatedSprite for background/indicator, Text for loading). ’ \- Ensure display during SceneManager transitions, update text dynamically. ’ \- Generate assets (warp lines, nexus symbol, font). ’ \- IMPLEMENT NEWGAMESETUPSCREEN: ’ \- Create NewGameSetupScreen.tsx to manage steps and navigation. ’ \- Implement each step (NewGameStep\_\*.tsx) with PixiJS rendering: ’ \- Step 1: Difficulty selection with buttons and checkboxes. ’ \- Step 2: Pilot creation with input, dropdown, and portrait customization (procedural generation). ’ \- Step 3: Ship selection with carousel and stats. ’ \- Step 4: Crew selection with random candidates. ’ \- Step 5: Scenario selection with cards. ’ \- Step 6: Summary with all choices. ’ \- Store choices in gameSessionStore.newGameConfig. ’ \- Generate all specified assets (pixelart sprites, sounds). ’ \- ENSURE: ’ \- Pixelart style with retro touch, Czech localization, smooth transitions. ’ \- Test with Vite, log FPS and transitions. ’ \- OUTPUT: ’ \- List of new files and assets. ’ \- Screenshots of each step and transition screen. ’ \- Full code of TransitionLoadingScreen.tsx and NewGameSetupScreen.tsx with subcomponents.
+
+’ DIAGRAM UPDATE ’ graph TD A\[Spuštění Aplikace\] –\> B(NS\_Prompt\_02: Úvodní Načítací Obrazovka); B –\> C{NS\_Prompt\_02: Hlavní Menu Hry}; C –\> |“NOVÁ HRA”| D(NS\_Prompt\_03: Přechodová Načítací Obrazovka); D –\> E\[NS\_Prompt\_03: Tvorba Nové Hry (Vícekroková)\]; E –\> |Zahájit Hru| D2(NS\_Prompt\_03: Přechodová Načítací Obrazovka  
+ “Generuji Galaxii…”); D2 –\> F\_GAME\[NS\_Prompt\_42: Hlavní Herní Scéna\]; C –\> |“NAČÍST HRU”| G(NS\_Prompt\_03: Přechodová Načítací Obrazovka); G –\> H\[Obrazovka Načtení Uložené Hry\]; H –\> |Načíst| G2(NS\_Prompt\_03: Přechodová Načítací Obrazovka  
+ “Načítám Hru…”); G2 –\> F\_GAME; C –\> |“NASTAVENÍ”| I\[NS\_Prompt\_13: Nastavení Hry\]; C –\> |“KNIHOVNA”| J\[NS\_Prompt\_19 & 47: Knihovna Znalostí\]; C –\> |“TVŮRCI”| K\[Obrazovka Tvůrců\]; C –\> |“UKONČIT HRU”| L\[Potvrzovací Dialog Ukončení\]; style D fill:\#ff9900,stroke:\#fff,stroke-width:2px style E fill:\#ff9900,stroke:\#fff,stroke-width:2px style D2 fill:\#ff9900,stroke:\#fff,stroke-width:2px style G fill:\#ff9900,stroke:\#fff,stroke-width:2px style G2 fill:\#ff9900,stroke:\#fff,stroke-width:2px
+
+\#\#\# Podrobnosti pro Trae  
+1\. \*\*TransitionLoadingScreen\*\*:  
+   \- Animated background and indicator with PixiJS, short duration for fluidity.  
+2\. \*\*NewGameSetupScreen\*\*:  
+   \- Multi-step UI with detailed customization (portraits, ships, crew), all rendered with PixiJS.  
+   \- Procedural generation for portraits and crew, integrated with race data.  
+3\. \*\*Assets\*\*:  
+   \- Extensive pixelart library for portraits, ships, and UI, generated with Aseprite.  
+4\. \*\*Code\*\*:  
+   \- React components with PixiJS for each step, managed by a parent component.
+

Pr4.md

@@ -0,0 +1,225 @@
+### **NS\_Prompt\_04.txt**
+
+' STAR DUST VOYAGER: GALAXY WANDERER \- SETTINGS, CREDITS, EXIT DIALOG, AND LOAD GAME MODULE  
+' CREATED BY GROK 3 (XAI) \- 02:45 PM CEST, MONDAY, JULY 21, 2025  
+' SPECIFIES DESIGN, VISUALS, LAYOUT, FUNCTIONALITY, ANIMATIONS, AND ASSETS FOR SETTINGS, CREDITS, EXIT DIALOG, AND LOAD GAME SCREENS  
+' TARGETED FOR TRAE AI AGENT (LOVABLE.DEV)  
+' PURPOSE: IMPLEMENT SYSTEM SCREENS WITH PIXELART STYLE, CZECH LOCALIZATION, AND INTEGRATION WITH SCENEMANAGER AND STATE MANAGER
+
+' GOALS  
+' \- Design and implement SettingsScreen as a modal UI for graphics, sound, and controls, with save/apply logic.  
+' \- Create CreditsScreen with scrolling text and animated starfield background.  
+' \- Develop ExitGameDialog for game termination with unsaved changes handling.  
+' \- Build LoadGameScreen for loading and deleting saved games with version compatibility checks.  
+' \- Generate all required pixelart assets and sound effects, optimized for PixiJS.  
+' \- Ensure responsive UI and integration with SceneManager and StateManager.
+
+' PROJECT CONTEXT  
+' \- BUILDS ON: NS\_Prompt\_01 (project structure), NS\_Prompt\_02 (MainMenu), NS\_Prompt\_03 (TransitionLoadingScreen), and references Prompt 35 (visual style).  
+' \- ASSUMPTIONS: PixiApplication, AssetManager, SceneManager, and StateManager are functional.  
+' \- DEPENDENCIES: client/src/game/core/SceneManager.ts, client/src/game/core/StateManager.ts, client/public/locales/cs.json.
+
+' 0\. ASSUMPTIONS AND GLOBAL STYLES  
+' \- PIXEL ART STYLE: Strict adherence to "Complex Detailed Pixel Art Style with Retro Touch" (Prompt 1, 35), 16x16px base tile, with depth effects.  
+' \- ASSET DIRECTORY: Follows NS\_Prompt\_01 (e.g., client/public/assets/).  
+' \- UI COMPONENTS: Uses global styles (ButtonStyle\_Standard\_PixelArt\_Retro, FontStyle\_PixelArt\_DefaultText) or generated by AI.  
+' \- LOCALIZATION: All text uses i18next keys with Czech defaults.  
+' \- SCENE/STATE MANAGEMENT: SceneManager and StateManager handle transitions and data persistence.
+
+' 1\. SETTINGSSCREEN  
+' \- PURPOSE: Configurable modal screen for graphics, sound, and controls, accessible from MainMenu or In-Game Menu.  
+' \- SPECIFICATION (SettingsScreenConfig):  
+\`\`\`json  
+{  
+    "id": "SettingsScreen",  
+    "screenName\_cz": "Nastavení Hry",  
+    "isModal": true,  
+    "panelStyle": {  
+        "backgroundImageAsset\_Subtle\_Path": "client/public/assets/images/ui/backgrounds/settings\_panel\_bg\_tech\_circuitry\_anim\_sheet.png",  
+        "backgroundColor": "\#0A0F18F5",  
+        "borderColor": "\#2070A0", "borderWidthPx": 2,  
+        "widthPercentOfScreen\_IfModal": 80, "heightPercentOfScreen\_IfModal": 85, "paddingPx": 25,  
+        "titleBar\_HeightPx": 40, "titleBar\_TextStyleKey": "FontStyle\_PixelArt\_Header\_Large\_PanelTitle\_Teal"  
+    },  
+    "tabDefinitions": \[  
+        {  
+            "id": "graphicsSettingsTab", "tabLabelKey\_cz": "settings.tab.graphics\_cz", "defaultTabLabel\_cz": "GRAFIKA",  
+            "iconAsset": "client/public/assets/images/icons/tabs/icon\_tab\_graphics\_pixelart.png",  
+            "layoutColumns": 2,  
+            "items": \[  
+                { "itemType": "Label", "id": "gfx\_display\_header", "labelKey\_cz": "settings.graphics.display\_header\_cz", "defaultLabel\_cz": "NASTAVENÍ ZOBRAZENÍ", "labelStyleKey": "FontStyle\_PixelArt\_SectionHeader\_Orange" },  
+                { "itemType": "Dropdown", "id": "gfx\_resolution", "labelKey\_cz": "settings.graphics.resolution\_cz", "defaultLabel\_cz": "Rozlišení Obrazovky:", "options": \[{"value": "native", "label\_cz": "Nativní"}, {"value": "800x600", "label\_cz": "800x600"}, {"value": "1280x720", "label\_cz": "1280x720"}\], "defaultValue": "native", "currentValue\_StoreKey": "settings.graphics.resolution", "styleKey": "Dropdown\_RetroTech\_PixelArt", "requiresRestart": true, "tooltipTextKey\_cz": "settings.graphics.resolution.tooltip\_cz", "defaultTooltipText\_cz": "Nastaví rozlišení hry. Změna může vyžadovat restart." },  
+                { "itemType": "Checkbox", "id": "gfx\_colorblind\_protanopia", "labelKey\_cz": "settings.graphics.colorblind\_protanopia\_cz", "defaultLabel\_cz": "Režim Protanopie", "defaultValue": false, "currentValue\_StoreKey": "settings.accessibility.colorblindMode\_Protanopia", "styleKey": "Checkbox\_RetroTech\_PixelArt\_Toggle" }  
+            \]  
+        },  
+        {  
+            "id": "soundSettingsTab", "tabLabelKey\_cz": "settings.tab.sound\_cz", "defaultTabLabel\_cz": "ZVUK",  
+            "iconAsset": "client/public/assets/images/icons/tabs/icon\_tab\_sound\_pixelart.png",  
+            "layoutColumns": 2,  
+            "items": \[  
+                { "itemType": "Label", "id": "snd\_volume\_header", "labelKey\_cz": "settings.sound.volume\_header\_cz", "defaultLabel\_cz": "HLOUBKA ZVUKU", "labelStyleKey": "FontStyle\_PixelArt\_SectionHeader\_Orange" },  
+                { "itemType": "Slider", "id": "snd\_master\_volume", "labelKey\_cz": "settings.sound.master\_volume\_cz", "defaultLabel\_cz": "Hlavní Hlasitost:", "min": 0, "max": 100, "defaultValue": 75, "currentValue\_StoreKey": "settings.sound.masterVolume", "styleKey": "Slider\_RetroTech\_PixelArt" }  
+            \]  
+        },  
+        {  
+            "id": "controlSettingsTab", "tabLabelKey\_cz": "settings.tab.controls\_cz", "defaultTabLabel\_cz": "OVLÁDÁNÍ",  
+            "iconAsset": "client/public/assets/images/icons/tabs/icon\_tab\_controls\_pixelart.png",  
+            "layoutColumns": 2,  
+            "items": \[  
+                { "itemType": "Label", "id": "ctrl\_input\_header", "labelKey\_cz": "settings.controls.input\_header\_cz", "defaultLabel\_cz": "NASTAVENÍ OVLÁDÁNÍ", "labelStyleKey": "FontStyle\_PixelArt\_SectionHeader\_Orange" },  
+                { "itemType": "KeybindList", "id": "ctrl\_move\_up", "labelKey\_cz": "settings.controls.move\_up\_cz", "defaultLabel\_cz": "Posun Vzhůru:", "defaultValue": "W", "currentValue\_StoreKey": "settings.controls.moveUp", "styleKey": "KeybindListItem\_PixelArt" }  
+            \]  
+        }  
+    \],  
+    "actionButtons": {  
+        "applyButton": { "id": "settings\_apply", "textLabelKey\_cz": "settings.button.apply\_cz", "defaultText\_cz": "POUŽÍT ZMĚNY", "action": { "type": "APPLY\_SETTINGS" }, "styleKey": "ButtonStyle\_Primary\_PixelArt\_Large" },  
+        "defaultsButton": { "id": "settings\_defaults", "textLabelKey\_cz": "settings.button.defaults\_cz", "defaultText\_cz": "VÝCHOZÍ", "action": { "type": "RESET\_TO\_DEFAULTS", "scope": "CurrentTab" }, "styleKey": "ButtonStyle\_Secondary\_PixelArt\_Medium" },  
+        "backOrCloseButton": { "id": "settings\_back", "textLabelKey\_cz": "settings.button.back\_cz", "defaultText\_cz": "ZPĚT", "action": { "type": "SAVE\_AND\_NAVIGATE\_BACK", "target": "PreviousScreen" }, "styleKey": "ButtonStyle\_Secondary\_PixelArt\_Medium",  
+            "confirmDialog\_IfChangesUnapplied\_OnBack": {  
+                "titleKey\_cz": "dialog.unsaved\_settings.title\_cz", "defaultTitle\_cz": "Neuložené Změny",  
+                "messageKey\_cz": "dialog.unsaved\_settings.message\_cz", "defaultMessage\_cz": "Máte neuložené změny v nastavení. Chcete je použít před odchodem, nebo je zahodit?",  
+                "button\_ApplyAndBack\_Text\_cz": "Použít a Zpět",  
+                "button\_DiscardAndBack\_Text\_cz": "Zahodit a Zpět",  
+                "button\_StayOnSettings\_Text\_cz": "Zůstat v Nastavení"  
+            }  
+        },  
+        "layout": "Horizontal\_RightAligned\_Footer", "spacingPx": 15  
+    },  
+    "sharedTooltipStyleKey": "TooltipStyle\_Standard\_PixelArt\_Dark",  
+    "onSettingsChanged\_NeedsRestart\_Indicator\_cz": { "text\_cz": "(vyžaduje restart hry)", "iconAsset": "client/public/assets/images/icons/ui/restart\_required\_pixelart\_icon.png", "color": "\#FFA500" },  
+    "settingsStorage\_Mechanism": "LocalStorage\_Via\_SettingsStore",  
+    "soundEffects": {  
+        "openScreen": "sfx/ui/settings\_screen\_open\_interface.wav",  
+        "closeScreen": "sfx/ui/settings\_screen\_close\_confirm.wav",  
+        "tab\_Change": "sfx/ui/settings\_tab\_switch\_click.wav",  
+        "setting\_ValueChange\_Generic": "sfx/ui/settings\_value\_change\_tick.wav",  
+        "button\_Apply\_Click": "sfx/ui/settings\_apply\_changes\_confirm.wav",  
+        "button\_Defaults\_Click": "sfx/ui/settings\_reset\_defaults\_action.wav"  
+    }  
+}
+
+’ \- PIXIJS: Render as Container with AnimatedSprite background, Text for labels, and interactive UI elements.
+
+’ 2\. CREDITSSCREEN ’ \- PURPOSE: Displays credits and thanks with scrolling text and animated background. ’ \- SPECIFICATION (CreditsScreenConfig):
+
+{  
+    "id": "CreditsScreen",  
+    "screenName\_cz": "Tvůrci Hry",  
+    "isModal": true,  
+    "background": {  
+        "type": "Animated\_Starfield\_DeepSpace\_PixelArt",  
+        "assetPath\_Template": "client/public/assets/images/ui/backgrounds/credits\_bg\_starfield\_parallax\_layer\_{1,2,3}.png",  
+        "layerCount": 3,  
+        "animationParams\_StarScroll": { "frameCount": 1, "speed": \-0.5, "loop": true }  
+    },  
+    "scrollingText\_Content\_Path\_cz": "client/public/assets/data/ui\_config/credits\_text\_cz.json",  
+    "scrollingText\_Style": {  
+        "fontFamily\_Title": "FontStyle\_PixelArt\_Header\_Large\_Gold",  
+        "fontFamily\_Entry": "FontStyle\_PixelArt\_Credits\_White",  
+        "lineSpacingPx": 8,  
+        "scrollSpeed\_PixelsPerSecond": 30,  
+        "alignment": "center"  
+    },  
+    "music\_CreditsTheme\_AssetPath": "client/public/assets/audio/music/themes/credits\_theme\_reflective\_epic\_loop.ogg",  
+    "interactionButtons": {  
+        "skipButton\_Text\_cz": "Přeskočit", "skipButton\_Key": "Escape", "skipButton\_StyleKey": "ButtonStyle\_Transparent\_Small\_TopRight",  
+        "speedUpButton\_Text\_cz": "Zrychlit (Držet)", "speedUpButton\_Key": "ArrowDown",  
+        "backButton\_Text\_cz": "Zpět do Menu", "backButton\_StyleKey": "ButtonStyle\_Standard\_PixelArt\_BottomCenter"  
+    },  
+    "autoReturnTo\_PreviousScreen\_AfterScrollEnd": true  
+}
+
+’ \- PIXIJS: Use ParallaxContainer with AnimatedSprite layers, Text for scrolling content.
+
+’ 3\. EXITGAMEDIALOG ’ \- PURPOSE: Confirmation dialog for game exit with unsaved changes handling. ’ \- SPECIFICATION (ExitGameDialogConfig):
+
+{  
+    "id": "ExitGameConfirmationDialog",  
+    "dialogStyleKey": "DialogStyle\_PixelArt\_Warning\_Retro",  
+    "titleKey\_cz": "dialog.exit.title\_cz", "defaultTitle\_cz": "Ukončit Hru?",  
+    "messageText\_cz\_Template": "Opravdu si přejete ukončit {GameTitle}?{UnsavedChangesWarning\_IfPresent}",  
+    "buttons": {  
+        "confirmExit\_Button": { "textKey\_cz": "dialog.exit.button\_confirm\_cz", "defaultText\_cz": "Ano, Ukončit", "styleKey": "ButtonStyle\_Danger\_PixelArt", "action": "APPLICATION\_QUIT" },  
+        "cancelExit\_Button": { "textKey\_cz": "dialog.exit.button\_cancel\_cz", "defaultText\_cz": "Ne, Zpět do Hry", "styleKey": "ButtonStyle\_Secondary\_PixelArt", "action": "CLOSE\_DIALOG" },  
+        "saveAndExit\_Button\_IfUnsavedChanges": { "textKey\_cz": "dialog.exit.button\_save\_and\_exit\_cz", "defaultText\_cz": "Uložit a Ukončit", "styleKey": "ButtonStyle\_Primary\_PixelArt", "action": "SAVE\_GAME\_THEN\_APPLICATION\_QUIT" }  
+    },  
+    "iconAsset\_Warning\_Path": "client/public/assets/images/icons/ui/warning\_icon\_pixelart\_large.png",  
+    "soundEffect\_OpenDialog": "sfx/ui/dialog\_open\_warning\_chime.wav"  
+}
+
+’ \- PIXIJS: Render as Container with Sprite background and Text/buttons.
+
+’ 4\. LOADGAMESCREEN ’ \- PURPOSE: Screen for loading and deleting saved game slots. ’ \- SPECIFICATION (LoadGameScreenConfig):
+
+{  
+    "id": "LoadGameScreen",  
+    "screenName\_cz": "Načíst Uloženou Hru",  
+    "isModal": true,  
+    "panelStyle": {  
+        "backgroundImageAsset\_Path": "client/public/assets/images/ui/backgrounds/load\_game\_bg\_data\_archives\_pixelart.png"  
+    },  
+    "layout": {  
+        "saveSlotList\_Position": { "x\_percent": 30, "y\_percent": 20, "width\_percent": 40, "height\_percent": 60 },  
+        "selectedSavePreviewPanel\_Position": { "x\_percent": 70, "y\_percent": 20, "width\_percent": 25, "height\_percent": 60 },  
+        "actionButtons\_Panel\_Position": "Bottom\_Row\_Spread"  
+    },  
+    "saveSlotList\_MaxVisible\_BeforeScroll": 5,  
+    "saveSlotItem\_Style": {  
+        "heightPx": 100,  
+        "backgroundColor\_Default": "\#0A0F18",  
+        "backgroundColor\_Hover": "\#1A1F28",  
+        "backgroundColor\_Selected": "\#2A2F38",  
+        "borderColor\_Selected": "\#2070A0",  
+        "thumbnail\_SizePx": { "x": 160, "y": 90 },  
+        "thumbnail\_Placeholder\_AssetPath": "client/public/assets/images/ui/save\_load/save\_slot\_thumbnail\_placeholder.png",  
+        "fontStyle\_SlotName": { "styleKey": "FontStyle\_PixelArt\_DefaultText\_Bold" },  
+        "fontStyle\_PlayerName": { "styleKey": "FontStyle\_PixelArt\_DefaultText" },  
+        "fontStyle\_GameTime": { "styleKey": "FontStyle\_PixelArt\_SmallText" },  
+        "fontStyle\_RealDateTime": { "styleKey": "FontStyle\_PixelArt\_SmallText" },  
+        "fontStyle\_GameVersion\_MismatchWarning": { "color": "\#FFA500" },  
+        "deleteButton\_IconAsset": "client/public/assets/images/icons/ui/delete\_icon\_pixelart\_small.png",  
+        "deleteButton\_StyleKey": "ButtonStyle\_IconOnly\_Danger\_Small"  
+    },  
+    "selectedSavePreviewPanel\_Content\_cz": {  
+        "largerThumbnail": true,  
+        "currentLocation\_Text\_cz": "Poslední Lokace: {SystemName} / {PlanetName}",  
+        "mainQuest\_Progress\_Text\_cz": "Hlavní Úkol: {QuestName} ({PercentComplete}%)",  
+        "shipName\_And\_Class\_Text\_cz": "Loď: {ShipName} (Třída {ShipClass})"  
+    },  
+    "actionButtons": {  
+        "loadButton": { "id": "load\_game", "textLabelKey\_cz": "load.button.load\_cz", "defaultText\_cz": "NAČÍST HRU", "action": { "type": "LOAD\_SELECTED\_GAME" }, "styleKey": "ButtonStyle\_Primary\_PixelArt\_Large" },  
+        "deleteButton": { "id": "delete\_save", "textLabelKey\_cz": "load.button.delete\_cz", "defaultText\_cz": "SMAZAT", "action": { "type": "DELETE\_SELECTED\_SAVE" }, "confirmDialog\_MessageKey\_cz": "load.dialog.delete\_confirm\_cz", "defaultConfirmDialog\_Message\_cz": "Opravdu smazat {SaveName}?", "styleKey": "ButtonStyle\_Danger\_PixelArt\_Medium" },  
+        "backButton": { "id": "load\_back", "textLabelKey\_cz": "load.button.back\_cz", "defaultText\_cz": "ZPĚT", "action": { "type": "NAVIGATE\_BACK", "target": "PreviousScreen\_Or\_MainMenu" }, "styleKey": "ButtonStyle\_Secondary\_PixelArt\_Medium" }  
+    },  
+    "emptySaveList\_MessageKey\_cz": "load.message.no\_saves\_cz", "defaultEmptySaveList\_Message\_cz": "Žádné uložené hry nebyly nalezeny.",  
+    "saveFileVersion\_CompatibilityCheck\_Logic\_cz": "Varovat hráče, pokud se snaží načíst uložení z nekompatibilní verze. Možnost 'Načíst na vlastní riziko'.",  
+    "soundEffects": {  
+        "openScreen": "sfx/ui/load\_game\_screen\_open\_data\_access.wav",  
+        "slot\_Select": "sfx/ui/load\_game\_slot\_hover.wav",  
+        "button\_Load\_Confirm": "sfx/ui/load\_game\_confirm\_systems\_online.wav",  
+        "button\_Delete\_Confirm": "sfx/ui/load\_game\_delete\_confirm.wav",  
+        "delete\_Success\_Sound": "sfx/ui/load\_game\_delete\_success.wav",  
+        "delete\_Fail\_Sound": "sfx/ui/load\_game\_delete\_fail.wav"  
+    }  
+}
+
+’ \- PIXIJS: Use ScrollContainer for slots, Sprite for thumbnails, Text for details.
+
+’ 5\. AI DIRECTIVES FOR TRAE ’ \- IMPLEMENT SETTINGSSCREEN: ’ \- Create SettingsScreen.tsx with tabs (Graphics, Sound, Controls) and UI elements. ’ \- Integrate with settingsStore for persistence. ’ \- Handle apply, defaults, and back logic with confirmation dialog. ’ \- IMPLEMENT CREDITSSCREEN: ’ \- Create CreditsScreen.tsx with scrolling Text and Parallax background. ’ \- Add skip, speed-up, and back controls. ’ \- IMPLEMENT EXITGAMEDIALOG: ’ \- Create ExitGameDialog.tsx with conditional buttons for unsaved changes. ’ \- Link to application quit logic. ’ \- IMPLEMENT LOADGAMESCREEN: ’ \- Create LoadGameScreen.tsx with slot list and preview panel. ’ \- Integrate with SaveLoadManager for metadata and deletion. ’ \- Add version compatibility check. ’ \- GENERATE ASSETS: ’ \- Settings: settings\_panel\_bg\_tech\_circuitry\_anim\_sheet.png, tab icons, UI styles. ’ \- Credits: starfield\_parallax\_layer\_{1,2,3}.png, fonts, music. ’ \- Exit: dialog\_warning\_bg\_pixelart.png, warning\_icon\_pixelart\_large.png. ’ \- Load: load\_game\_bg\_data\_archives\_pixelart.png, save\_slot\_thumbnail\_placeholder.png, delete\_icon\_pixelart\_small.png. ’ \- ENSURE: ’ \- Pixelart style with retro touch, Czech localization, responsive UI. ’ \- Test with SceneManager and StateManager. ’ \- OUTPUT: ’ \- List of new files and assets. ’ \- Screenshots of each screen/dialog.
+
+’ DIAGRAM UPDATE ’ graph TD A\[Spuštění Aplikace\] –\> B(NS\_Prompt\_02: Úvodní Načítací Obrazovka); B –\> C{NS\_Prompt\_02: Hlavní Menu Hry}; C –\> |“NOVÁ HRA”| D(NS\_Prompt\_03: Přechodová Načítací Obrazovka); D –\> E\[NS\_Prompt\_03: Tvorba Nové Hry (Vícekroková)\]; E –\> |Zahájit Hru| D2(NS\_Prompt\_03: Přechodová Načítací Obrazovka  
+ “Generuji Galaxii…”); D2 –\> F\_GAME\[NS\_Prompt\_42: Hlavní Herní Scéna\]; C –\> |“NAČÍST HRU”| G(NS\_Prompt\_03: Přechodová Načítací Obrazovka); G –\> H\[NS\_Prompt\_04: Obrazovka Načtení Uložené Hry\]; H –\> |Načíst| G2(NS\_Prompt\_03: Přechodová Načítací Obrazovka  
+ “Načítám Hru…”); G2 –\> F\_GAME; C –\> |“NASTAVENÍ”| I\[NS\_Prompt\_04: Nastavení Hry (Modální)\]; I – Zpět –\> C; C –\> |“KNIHOVNA”| J\[NS\_Prompt\_19 & 47: Knihovna Znalostí (Modální)\]; J – Zpět –\> C; C –\> |“TVŮRCI”| K\[NS\_Prompt\_04: Obrazovka Tvůrců (Modální)\]; K – Zpět –\> C; C –\> |“UKONČIT HRU”| L\[NS\_Prompt\_04: Potvrzovací Dialog Ukončení\]; L – Ano –\> M\[Ukončení Aplikace\]; L – Ne –\> C; subgraph InGameInteractions \[Interakce ve Hře\] F\_GAME –\> N\[NS\_Prompt\_XX: Menu ve Hře (In-Game Menu \- Modální)\]; N –\> I\_GM\[NS\_Prompt\_04: Nastavení Hry (Modální)\]; I\_GM – Zpět –\> N; N –\> L\_GM\[NS\_Prompt\_04: Potvrzovací Dialog Ukončení\]; L\_GM – Ano –\> M; L\_GM – Ne –\> N; N –\> H\_GM\[NS\_Prompt\_04: Obrazovka Načtení Uložené Hry (Modální)\]; H\_GM – Zpět –\> N; N – Uložit Hru –\> O\[Obrazovka Uložení Hry (Modální)\]; O – Zpět –\> N; end style H fill:\#ff9900,stroke:\#fff,stroke-width:2px style I fill:\#ff9900,stroke:\#fff,stroke-width:2px style K fill:\#ff9900,stroke:\#fff,stroke-width:2px style L fill:\#ff9900,stroke:\#fff,stroke-width:2px style I\_GM fill:\#ff9900,stroke:\#fff,stroke-width:2px style L\_GM fill:\#ff9900,stroke:\#fff,stroke-width:2px style H\_GM fill:\#ff9900,stroke:\#fff,stroke-width:2px style O fill:\#ff9900,stroke:\#fff,stroke-width:2px
+
+\#\#\# Podrobnosti pro Trae  
+1\. \*\*SettingsScreen\*\*:  
+   \- Modal UI with tabs, integrated with settingsStore, and restart indicators.  
+2\. \*\*CreditsScreen\*\*:  
+   \- Scrolling text with parallax starfield, interactive controls.  
+3\. \*\*ExitGameDialog\*\*:  
+   \- Confirmation with unsaved changes logic.  
+4\. \*\*LoadGameScreen\*\*:  
+   \- Slot list with preview, deletion, and version checks.  
+5\. \*\*Assets\*\*:  
+   \- Detailed pixelart for backgrounds, icons, and UI styles.
+

Prompt_1.md

@@ -0,0 +1,389 @@
+## **Specifikační Dokument Modulu: Založení Projektu, Struktura Adresářů a Technologie**
+
+Série Nových Promptů \- Číslo: 01  
+Datum Vytvoření: 2025-05-27  
+Cíl Dokumentu: Tento dokument slouží jako direktiva pro AI agenta (např. Lovable.dev) pro založení základní struktury projektu hry "Star Dust Voyager: Galaxy Wanderer". Definuje hlavní cíle projektu, použitý technologický stack, detailní adresářovou strukturu, konvence pojmenování a seznam základních knihoven a nástrojů k instalaci. V této fázi se nebude implementovat žádná herní logika do souborů, pouze se vytvoří jejich struktura a základní konfigurace.
+
+### **1\. Celková Filozofie a Cíle Projektu**
+
+Hra "Star Dust Voyager: Galaxy Wanderer" je koncipována jako 2D top-down vesmírná explorační roguelike hra\[cite: 5, 41\]. Klade důraz na:
+
+* Vizuální Styl: Extrémně detailní fotorealistický pixel art s retro nádechem\[cite: 5, 11, 49\]. Každý vizuální prvek, od nebeských těles po UI, musí být propracovaný a plný detailů, s využitím pokročilých pixel artových technik.  
+* Herní Svět: Procedurálně generovaná galaxie obsahující 100-200 hvězdných systémů\[cite: 5, 41, 57\]. Každý systém s realisticky škálovanými a rozmístěnými nebeskými tělesy (hvězdy 500-1500px, planety 200-800px, měsíce 50-300px, s minimální mezerou 2000px mezi tělesy)\[cite: 6, 49, 50, 56\].  
+* Hratelnost: Hluboké herní mechaniky zahrnující průzkum, dynamický boj v reálném čase, správu zdrojů (palivo, energie, integrita trupu, náklad, kredity, teplota, kyslík)\[cite: 44\], rozsáhlou customizaci lodí\[cite: 5, 47\], diplomacii s frakcemi\[cite: 5, 52\], správu posádky\[cite: 5, 52\], dynamické události a příběh ovlivněný hráčovými volbami\[cite: 5, 42, 52\].  
+* Cílové Platformy: PC (Windows, Linux, macOS), mobilní zařízení (iOS, Android) a gamepad podpora, s volitelnou budoucí podporou pro AR/VR\[cite: 5, 51\].  
+* Modding: Podpora pro komunitní modifikace\[cite: 5, 52\].
+
+AI musí adresovat a opravit specifické problémy zmíněné v Sd.txt, jako je pohyb lodí a zajištění správného škálování a rozmístění nebeských těles\[cite: 6, 7\].
+
+### **2\. Základní Technologický Stack**
+
+Pro vývoj hry bude použit následující technologický stack, vycházející z poskytnutých dokumentů\[cite: 336, 387, 392, 411, 412, 413, 414, 420\]:
+
+* Frontend (Klient):  
+  * Jazyk: TypeScript (se zapnutým strict módem)\[cite: 38, 420\].  
+  * UI Framework: React (pro HUD, menu, herní obrazovky a všechny UI komponenty)\[cite: 16, 22, 410\].  
+  * Vykreslovací Engine: PixiJS (pro hlavní herní scénu, vykreslování spritů, částicové efekty, shadery)\[cite: 16, 32, 410\].  
+  * Správa Stavu: Zustand (pro globální správu stavu hry, hráče, UI atd.)\[cite: 28, 405\].  
+  * Stylování UI: Emotion (nebo jiná CSS-in-JS knihovna) pro pixel-perfect retro estetiku (např. pozadí \#050510, akcenty \#3388ff)\[cite: 22\].  
+  * Routing (pro UI obrazovky): react-router-dom (nebo ekvivalent).  
+  * Lokalizace: i18next s react-i18next pro podporu více jazyků (primárně čeština).  
+* Backend (Server):  
+  * Jazyk: Node.js s TypeScriptem\[cite: 33, 411\].  
+  * Framework: Express.js (nebo výkonnější alternativa jako Fastify)\[cite: 412\].  
+  * Databáze: MongoDB (pro perzistentní ukládání hráčského postupu, stavu galaxie, uživatelských účtů)\[cite: 33, 411\].  
+  * ODM (Object Data Modeling): Mongoose pro MongoDB.  
+  * Real-time Komunikace: WebSockets (např. pomocí knihovny Socket.IO) pro případné multiplayerové funkce nebo synchronizaci\[cite: 33, 412\].  
+  * Autentifikace: JWT (jsonwebtoken) pro zabezpečení API.  
+* Vývojové Nástroje a Prostředí:  
+  * Verzování: Git, repozitář na GitHub (dle Sd.txt\[cite: 4\], StarDustVoyager.txt\[cite: 382\], Hvězdička.txt \[cite: 770\]).  
+  * Linting a Formátování: ESLint a Prettier pro udržení kvality a konzistence kódu.  
+  * Build Nástroje: Vite (nebo Create React App s Craco pro úpravy Webpacku) pro frontend, tsc pro backend.  
+  * CI/CD: GitHub Actions pro automatické buildy, linting a testování při pushi\[cite: 39\].  
+* Deployment:  
+  * Frontend a Serverless Backend: Vercel (nebo ekvivalent jako Netlify, AWS Amplify).  
+  * Databáze: MongoDB Atlas (nebo jiný cloudový poskytovatel).
+
+### **3\. Detailní Adresářová Struktura Projektu**
+
+Následující struktura adresářů (vycházející z Sd.txt, StarDustVoyager.txt, Hvězdička.txt) by měla být vytvořena. AI zatím nebude vytvářet obsah souborů, pouze adresáře a prázdné soubory s definovanými názvy a příponami tam, kde je to uvedeno.  
+/star-dust-voyager-galaxy-wanderer  \# Kořenový adresář projektu  
+|  
+|-- client/                       \# Frontend aplikace (React, PixiJS, TypeScript)  
+|   |-- public/                   \# Statické soubory přímo servírované web serverem  
+|   |   |-- index.html            \# Hlavní HTML vstupní bod  
+|   |   |-- favicon.ico  
+|   |   |-- manifest.json  
+|   |   |-- assets/               \# Herní grafické, zvukové a datové assety  
+|   |   |   |-- images/           \# Obrázky a spritesheety  
+|   |   |   |   |-- backgrounds/  \# Pozadí pro menu, hru, galaktickou mapu, panoramata  
+|   |   |   |   |-- celestial\_bodies/ \# Sprity planet, hvězd, měsíců, asteroidů, komet  
+|   |   |   |   |-- ships/        \# Sprity lodí (hráč, NPC, frakce, mimozemšťané)  
+|   |   |   |   |   |-- player/  
+|   |   |   |   |   |-- factions/ \# Podsložky pro jednotlivé frakce  
+|   |   |   |   |   |-- aliens/   \# Podsložky pro mimozemské rasy  
+|   |   |   |   |-- ship\_modules/ \# Vizuální reprezentace modulů lodí  
+|   |   |   |   |-- projectiles/  \# Sprity/animace projektilů, paprsků  
+|   |   |   |   |-- fx/           \# Spritesheety pro explózie, štíty, motory, warp, anomálie  
+|   |   |   |   |-- ui/           \# Ikony, rámečky, tlačítka, prvky HUD, načítací obrazovky  
+|   |   |   |   |   |-- icons/    \# Obecné UI ikony, ikony pro itemy, skilly, úspěchy, frakce atd.  
+|   |   |   |   |   |-- buttons/  
+|   |   |   |   |   |-- panels/  
+|   |   |   |   |-- items/        \# Ikony pro předměty, suroviny, komponenty, plány  
+|   |   |   |   |-- portraits/    \# Portréty postav, posádky, mimozemšťanů  
+|   |   |   |   |   |-- procedural\_parts/ \# Části pro generování portrétů  
+|   |   |   |   |-- codex/        \# Ilustrace pro Knižnici Znalostí  
+|   |   |   |   |-- decals/       \# Nálepky a symboly pro lodě  
+|   |   |   |-- audio/            \# Zvukové soubory  
+|   |   |   |   |-- music/        \# Hudební stopy (ogg, mp3) \< 5MB \[cite: 20, 40\]  
+|   |   |   |   |-- sfx/          \# Zvukové efekty (wav, ogg) \< 5MB \[cite: 20, 40\]  
+|   |   |   |   |-- voices/       \# Krátké hlasové projevy (pokud budou)  
+|   |   |   |-- fonts/            \# Pixel art fonty (ttf, woff2)  
+|   |   |   |-- data/             \# JSON konfiguračné soubory pro hru (všechny s příponou \_cz.json pro české texty)  
+|   |   |   |   |-- game\_setup/   \# Např. difficulty\_settings\_cz.json  
+|   |   |   |   |-- ships/        \# např. ship\_classes\_cz.json, ship\_modules\_visuals\_cz.json  
+|   |   |   |   |-- items/        \# např. resources\_cz.json, trade\_goods\_cz.json, consumables\_cz.json  
+|   |   |   |   |-- celestial\_bodies/ \# např. planet\_types\_cz.json, star\_types\_cz.json, anomalies\_cz.json  
+|   |   |   |   |-- research/     \# např. research\_tree\_main\_cz.json, tech\_definitions\_cz.json  
+|   |   |   |   |-- factions/     \# např. faction\_definitions\_cz.json, alien\_races\_cz.json  
+|   |   |   |   |-- quests/       \# např. main\_story\_nexus\_cz.json, side\_missions\_templates\_cz.json  
+|   |   |   |   |-- codex/        \# např. codex\_entries\_planets\_cz.json, procedural\_lore\_templates\_cz.json  
+|   |   |   |   |-- blueprints/   \# např. crafting\_blueprints\_all\_cz.json  
+|   |   |   |   |-- player\_progression/ \# např. player\_skills\_cz.json, achievements\_cz.json  
+|   |   |   |   |-- events/       \# např. dynamic\_events\_cz.json, galactic\_events\_cz.json  
+|   |   |   |   |-- ui\_config/    \# např. hud\_layout\_cz.json, main\_menu\_config\_cz.json  
+|   |   |   |   |-- name\_generation/ \# např. name\_syllables\_human\_cz.json, name\_patterns\_planets\_cz.json  
+|   |   |   |   |-- game\_constants.json  
+|   |   |-- shaders/              \# GLSL shadery (fragment .frag a vertex .vert) \- dle Sd.txt \[cite: 21, 40\]  
+|   |       |-- effects/          \# např. distortion.frag, bloom.frag, heat\_haze.frag, pixelart\_gravitational\_lens.frag  
+|   |       |-- celestial\_bodies/ \# např. planet\_surface\_lighting.frag, star\_corona.frag  
+|   |       |-- postprocessing/   \# např. retro\_crt\_filter.frag  
+|   |-- src/                      \# Zdrojový kód klienta  
+|   |   |-- App.tsx               \# Hlavní React komponenta, routing, globální kontext  
+|   |   |-- index.tsx             \# Vstupní bod React aplikace, renderování App  
+|   |   |-- config/               \# Konfigurace klienta  
+|   |   |   |-- clientConfig.ts  
+|   |   |   |-- gameConstants.ts  // Fyzikální konstanty, UI rozměry, herní balanc  
+|   |   |-- components/           \# Znovupoužitelné React UI komponenty \[cite: 22, 395\]  
+|   |   |   |-- common/           \# Základní UI prvky (Button.tsx, Panel.tsx, Modal.tsx, Icon.tsx, ProgressBar.tsx, Slider.tsx) \[cite: 23\]  
+|   |   |   |-- screens/          \# Komponenty pro hlavní herní obrazovky (MainMenuScreen.tsx, SettingsScreen.tsx, atd.)  
+|   |   |   |-- hud/              \# Komponenty pro Heads-Up Display (HUD.tsx, TargetInfoPanel.tsx, MiniMap.tsx) \[cite: 22\]  
+|   |   |   |-- game\_specific\_ui/ \# Specifické UI pro herní mechaniky (např. CraftingInterface.tsx, ResearchNode.tsx)  
+|   |   |-- game/                 \# Hlavní herní logika (PixiJS, ECS) \[cite: 24, 396\]  
+|   |   |   |-- core/             \# Základní herní systémy a manažery  
+|   |   |   |   |-- GameController.ts \# Hlavní třída řídící hru, herní smyčka, správa scén  
+|   |   |   |   |-- AssetManager.ts   \# Správa načítání a přístupu k assetům (obrázky, zvuky, JSON)  
+|   |   |   |   |-- InputManager.ts   \# Zpracování vstupů (klávesnice, myš, gamepad, dotyk)  
+|   |   |   |   |-- AudioManager.ts   \# Správa zvuku a hudby (dle Sd.txt\[cite: 19\], StarDustVoyager.txt \[cite: 391\])  
+|   |   |   |   |-- SceneManager.ts   \# Správa přechodů mezi herními scénami  
+|   |   |   |   |-- EventBus.ts       \# Globální event emitter  
+|   |   |   |   |-- SaveLoadManager.ts \# Logika pro ukládání a načítání hry  
+|   |   |   |   |-- TimeManager.ts    \# Správa herního času (G.S.R., domovský čas)  
+|   |   |   |   |-- TutorialManager.ts  
+|   |   |   |-- ecs/              \# Implementace Entity-Component-System  
+|   |   |   |   |-- Entity.ts  
+|   |   |   |   |-- Component.ts  
+|   |   |   |   |-- System.ts  
+|   |   |   |   |-- World.ts  
+|   |   |   |-- components/       \# Herní komponenty (ECS) \- čistě datové \[cite: 25, 399\]  
+|   |   |   |   |-- Transform.component.ts // Position, Rotation, Scale  
+|   |   |   |   |-- PhysicsBody.component.ts // Velocity, Mass, Forces  
+|   |   |   |   |-- Renderable.component.ts // SpriteKey, Tint, Alpha, ZIndex  
+|   |   |   |   |-- Health.component.ts  
+|   |   |   |   |-- Shield.component.ts  
+|   |   |   |   |-- WeaponSystem.component.ts  
+|   |   |   |   |-- AIController.component.ts  
+|   |   |   |   |-- PlayerAgent.component.ts // Označuje entitu hráče  
+|   |   |   |   |-- Faction.component.ts  
+|   |   |   |   |-- CargoHold.component.ts  
+|   |   |   |   |-- MiningTool.component.ts  
+|   |   |   |   |-- WarpDrive.component.ts  
+|   |   |   |   |-- CrewQuarters.component.ts  
+|   |   |   |   |-- PlanetaryBaseAnchor.component.ts  
+|   |   |   |   |-- QuestTarget.component.ts  
+|   |   |   |   |-- DiscoveredByPlayer.component.ts  
+|   |   |   |-- systems/          \# Herní systémy (ECS) \- logika \[cite: 28, 403\]  
+|   |   |   |   |-- Movement.system.ts // Pohyb, rotace, warp  
+|   |   |   |   |-- Physics.system.ts // Kolize, gravitace, setrvačnost  
+|   |   |   |   |-- Rendering.system.ts // Vykreslování spritů, efektů, UI (PixiJS)  
+|   |   |   |   |-- Combat.system.ts // Střelba, poškození, obrana  
+|   |   |   |   |-- PlayerInput.system.ts  
+|   |   |   |   |-- NPC\_AI.system.ts // Chování NPC lodí, frakcí  
+|   |   |   |   |-- Mining.system.ts  
+|   |   |   |   |-- Crafting.system.ts  
+|   |   |   |   |-- Research.system.ts  
+|   |   |   |   |-- Diplomacy.system.ts  
+|   |   |   |   |-- Mission.system.ts  
+|   |   |   |   |-- DynamicEvent.system.ts  
+|   |   |   |   |-- Codex.system.ts  
+|   |   |   |   |-- CrewManagement.system.ts  
+|   |   |   |   |-- PlanetaryInteraction.system.ts  
+|   |   |   |   |-- Animation.system.ts // Správa spritesheet animací  
+|   |   |   |   |-- ParticleEffect.system.ts  
+|   |   |   |   |-- SoundPlayback.system.ts  
+|   |   |   |   |-- Persistence.system.ts // Pro in-session persistence  
+|   |   |   |-- entities/         \# Funkce pro vytváření ("továrny") entit s předdefinovanými komponentami  
+|   |   |   |   |-- createPlayerShip.ts  
+|   |   |   |   |-- createAsteroid.ts  
+|   |   |   |   |-- createPirateScout.ts  
+|   |   |   |   |-- createPlanetVolcanic.ts  
+|   |   |   |-- world\_generation/ \# Logika pro procedurální generování \[cite: 24, 397\]  
+|   |   |   |   |-- GalaxyGenerator.ts  
+|   |   |   |   |-- StarSystemGenerator.ts  
+|   |   |   |   |-- CelestialBodyGenerator.ts // Planety, měsíce, hvězdy, asteroidy  
+|   |   |   |   |-- NameGenerator.ts // Pro názvy systémů, planet, postav  
+|   |   |   |   |-- PortraitGenerator.ts // Pro portréty posádky/NPC  
+|   |   |   |-- utils/            \# Pomocné funkce a třídy (matematika, RNG, string utils) \[cite: 31, 408\]  
+|   |   |   |-- types/            \# Globální TypeScript typy a rozhraní pro herní logiku  
+|   |   |   |-- scenes/           \# Definice herních scén (každá může mít vlastní ECS World nebo sdílet)  
+|   |   |       |-- InitialLoadingScene.ts  
+|   |   |       |-- MainMenuScene.ts  
+|   |   |       |-- NewGameSetupScene.ts  
+|   |   |       |-- InSystemScene.ts  
+|   |   |       |-- GalaxyMapScene.ts  
+|   |   |       |-- OrbitViewScene.ts  
+|   |   |-- services/             \# Služby pro komunikaci se serverem (API, WebSockets)  
+|   |   |   |-- apiService.ts  
+|   |   |   |-- webSocketService.ts  
+|   |   |-- stores/               \# Správa globálního stavu aplikace (Zustand) \[cite: 28, 405\]  
+|   |   |   |-- playerStore.ts  
+|   |   |   |-- gameSessionStore.ts // Ukládá i in-session perzistentní data  
+|   |   |   |-- uiStore.ts  
+|   |   |   |-- settingsStore.ts  
+|   |   |   |-- researchStore.ts  
+|   |   |   |-- codexStore.ts  
+|   |   |   |-- missionStore.ts  
+|   |   |   |-- achievementStore.ts  
+|   |   |-- styles/               \# Globální CSS/SCSS styly, témata (Emotion se používá pro komponenty)  
+|   |   |-- hooks/                \# Vlastní React hooks  
+|   |   |-- translations/         \# Soubory pro lokalizaci (i18n)  
+|   |       |-- cs.json           \# České texty  
+|   |       |-- en.json           \# Anglické texty (volitelně)  
+|   |-- tsconfig.json             \# Konfigurace TypeScriptu pro klienta  
+|   |-- package.json              \# Závislosti a skripty pro klienta  
+|   |-- .env.local                \# Lokální proměnné prostředí (API URL)  
+|  
+|-- server/                       \# Backend (Node.js \+ TypeScript \+ MongoDB) \[cite: 33, 411\]  
+|   |-- src/  
+|   |   |-- config/  
+|   |   |   |-- serverConfig.ts   \# Port, DB connection string, JWT secret, cesty k datům  
+|   |   |   |-- corsOptions.ts  
+|   |   |-- api/                  \# REST API routes (Express.js/Fastify)  
+|   |   |   |-- index.ts          \# Hlavní router  
+|   |   |   |-- auth.routes.ts    \# Autentifikace (registrácia, login)  
+|   |   |   |-- player.routes.ts  \# Ukladanie/načítanie postupu hráča  
+|   |   |   |-- game\_data.routes.ts \# Prípadné endpointy pre herné dáta (leaderboardy, mody)  
+|   |   |-- ws/                   \# WebSocket handlery (Socket.IO)  
+|   |   |   |-- index.ts          \# Hlavný WebSocket server  
+|   |   |   |-- game\_sync.handler.ts \# Pre multiplayerové interakcie (ak budú)  
+|   |   |   |-- chat.handler.ts  
+|   |   |-- db/                   \# Interakcia s databázou (Mongoose)  
+|   |   |   |-- models/           \# MongoDB schémy/modely  
+|   |   |   |   |-- Player.model.ts  
+|   |   |   |   |-- GameSave.model.ts  
+|   |   |   |   |-- FactionState.model.ts // Ak je stav frakcií perzistentný na serveri  
+|   |   |   |-- connection.ts     \# Pripojenie k MongoDB  
+|   |   |-- services/             \# Serverové služby (logika pre autentifikáciu, validáciu, atď.)  
+|   |   |   |-- auth.service.ts  
+|   |   |   |-- player.service.ts  
+|   |   |   |-- mod\_validation.service.ts \[cite: 34\]  
+|   |   |-- middleware/           \# Express.js/Fastify middleware (napr. pre autentifikáciu JWT, rate limiting \[cite: 35\])  
+|   |   |-- index.ts              \# Vstupný bod serverovej aplikácie (spustenie servera)  
+|   |   |-- types/                \# TypeScript typy špecifické pre server  
+|   |-- tsconfig.json             \# Konfigurácia TypeScriptu pre server  
+|   |-- package.json              \# Závislosti a skripty pre server  
+|   |-- .env                      \# Premenné prostredia pre server  
+|  
+|-- shared/                       \# Kód (hlavne typy) zdieľaný medzi klientom a serverom  
+|   |-- types/                    \# Spoločné TypeScript typy a rozhrania  
+|   |   |-- IPlayer.ts  
+|   |   |-- IGameSave.ts  
+|   |   |-- IAPIResponse.ts  
+|   |   |-- ICelestialBodyData.ts // Základné typy pre planéty, hviezdy atď.  
+|   |   |-- IShipModuleData.ts  
+|   |   |-- IFactionData.ts  
+|   |   |-- IQuestData.ts  
+|   |-- utils/                    \# Spoločné pomocné funkcie (napr. validátory, formátovače)  
+|   |-- constants/                \# Spoločné konštanty (napr. názvy eventov, herné limity)  
+|  
+|-- docs/                         \# Dokumentácia hry \[cite: 37, 418\]  
+|   |-- GDD/                      \# Game Design Dokumenty (tieto prompty)  
+|   |-- API\_Docs/                 \# Dokumentácia API (napr. generovaná Swaggerom/OpenAPI)  
+|   |-- Modding\_Guide\_cz.md/      \# Návod pre modderov v češtině \[cite: 37, 419\]  
+|   |-- Architecture\_Overview.md  \# Přehled architektury \[cite: 37, 418\]  
+|  
+|-- tools/                        \# Vývojové nástroje \[cite: 36, 415\]  
+|   |-- sprite\_editor/            \# (Konceptuálně) Jednoduchý editor spritů nebo integrace s externím  
+|   |-- galaxy\_visualizer/        \# Nástroj pro vizualizaci generované galaxie  
+|   |-- mod\_builder\_cli/          \# CLI nástroj pro vytváření a balení modů  
+|  
+|-- tests/                        \# Testy \[cite: 37, 417\]  
+|   |-- unit/                     \# Jednotkové testy (Jest)  
+|   |   |-- ecs/                  \# např. movementSystem.test.ts  
+|   |   |-- world\_generation/     \# např. galaxyGenerator.test.ts  
+|   |-- integration/              \# Integrační testy  
+|   |   |-- combatFlow.test.ts  
+|   |   |-- tradeMission.test.ts  
+|   |-- e2e/                      \# End-to-end testy (Cypress)  
+|       |-- newGameToFirstWarp.spec.ts  
+|  
+|-- .gitignore                    \# Ignorované soubory a složky (node\_modules/, dist/, .env\*)  
+|-- .eslintrc.js                  \# Konfigurace ESLint  
+|-- .prettierrc.js                \# Konfigurace Prettier  
+|-- README\_cz.md                  \# Hlavní README projektu v češtině  
+|-- LICENSE                       \# Licence projektu
+
+Popis Účelu Klíčových Složek:
+
+* client/: Obsahuje veškerý kód a assety pro herního klienta, který běží v prohlížeči nebo jako zabalená aplikace.  
+  * public/assets/: Místo pro všechny statické herní zdroje (obrázky, zvuky, data). Je důležité zde udržovat jasnou a intuitivní strukturu podsložek.  
+  * src/components/: React komponenty tvořící uživatelské rozhraní.  
+  * src/game/: Jádro herní logiky, implementované pomocí ECS architektury a PixiJS pro vykreslování.  
+  * src/stores/: Globální správa stavu pomocí Zustand.  
+* server/: Backendová část aplikace pro perzistenci dat, případné multiplayer funkce a validaci modů.  
+* shared/: Kód (především TypeScript typy a rozhraní), který je sdílen mezi klientem a serverem pro zajištění konzistence.  
+* docs/: Veškerá projektová a herní dokumentace.  
+* tools/: Pomocné nástroje pro vývoj (např. editor spritů, vizualizér galaxie).  
+* tests/: Automatizované testy pro zajištění kvality kódu.
+
+### **4\. Konvence Pojmenování Souborů a Proměnných**
+
+Pro udržení přehlednosti a konzistence v kódu budou dodržovány následující konvence:
+
+* Soubory a Složky:  
+  * Složky: kebab-case (např. celestial-bodies, ui-components).  
+  * TypeScript/JavaScript soubory: camelCase.ts nebo PascalCase.ts (např. assetManager.ts, PlayerShip.ts).  
+  * React komponenty: PascalCase.tsx (např. MainMenuScreen.tsx, Button.tsx).  
+  * Konfigurační JSON soubory s českými texty: nazev\_konfigurace\_cz.json (např. planety\_typy\_cz.json).  
+  * CSS/SCSS moduly (pokud by se používaly mimo Emotion): ComponentName.module.scss.  
+* Proměnné a Funkce:  
+  * camelCase (např. playerHealth, calculateDamage).  
+* Třídy, Rozhraní, Typy, Enumy:  
+  * PascalCase (např. ShipModuleData, PlayerState, enum GameScreen).  
+* Konstanty:  
+  * UPPER\_SNAKE\_CASE (např. MAX\_SPEED, DEFAULT\_PLANET\_SIZE).  
+* Grafické Assety (Soubory):  
+  * Formát: kategorie\_typ\_specifikace\_{varianta}\_{velikostPokudRelevantni}\_{animPokudRelevantni}.png (nebo jiná přípona).  
+  * Příklady: ship\_fighter\_krall\_talon\_v1\_128px.png, planet\_terrestrial\_earthlike\_orbit\_800px.png, icon\_item\_medkit\_basic\_48px.png, fx\_explosion\_medium\_ship\_anim\_sheet.png, ui\_button\_confirm\_blue\_hover.png.  
+  * Vše malými písmeny, odděleno podtržítky pro maximální kompatibilitu a čitelnost.  
+* Zvukové Assety (Soubory):  
+  * Formát: kategorie\_specifickyPopis\_{varianta}.wav (pro krátké efekty) / .ogg (pro hudbu a delší ambientní zvuky).  
+  * Příklady: sfx\_weapon\_laser\_fire\_heavy\_01.wav, music\_theme\_main\_menu\_loop.ogg, ambience\_station\_tradehub\_busy\_loop.ogg.
+
+### **5\. Požadované Základní Knihovny a Nástroje k Instalaci**
+
+AI by měla zajistit, že package.json soubory pro klienta a server budou obsahovat následující klíčové závislosti (konkrétní verze "latest" nebo dle potřeby kompatibility):
+
+* Klient (client/package.json):  
+  * Hlavní: react, react-dom, pixi.js, zustand, typescript.  
+  * Typy: @types/react, @types/react-dom, @types/node, @types/pixi.js.  
+  * Stylování: @emotion/react, @emotion/styled.  
+  * Routing: react-router-dom.  
+  * Lokalizace: i18next, react-i18next.  
+  * Utility: uuid, lodash (nebo ramda), howler.js (pro audio, pokud vestavěné nestačí).  
+  * Vývojové: eslint, prettier, vite (nebo react-scripts s craco), @typescript-eslint/parser, @typescript-eslint/eslint-plugin, eslint-plugin-react.  
+* Server (server/package.json):  
+  * Hlavní: express (nebo fastify), mongoose, socket.io, jsonwebtoken, bcryptjs, typescript, cors.  
+  * Typy: @types/express, @types/mongoose, @types/socket.io, @types/jsonwebtoken, @types/bcryptjs, @types/cors.  
+  * Vývojové: ts-node, nodemon, eslint, prettier.  
+* Globální (pro projekt):  
+  * husky, lint-staged (pro pre-commit hooky).  
+  * jest (pro jednotkové a integrační testy), ts-jest.  
+  * cypress (pro E2E testy).
+
+### **6\. Základní Konfigurační Soubory (Přehled)**
+
+AI by měla vytvořit základní verze těchto konfiguračních souborů s doporučeným nastavením:
+
+* client/tsconfig.json a server/tsconfig.json: Konfigurace pro TypeScript kompilátor, včetně strict: true\[cite: 38\], esModuleInterop: true, nastavení paths pro aliasy importů, jsx: "react-jsx".  
+* .eslintrc.js (v kořeni projektu): Konfigurace pro ESLint s doporučenými pravidly pro TypeScript a React.  
+* .prettierrc.js (v kořeni projektu): Konfigurace pro Prettier pro jednotné formátování kódu.  
+* .gitignore (v kořeni projektu): Seznam ignorovaných souborů a složek (např. node\_modules/, dist/, build/, .env\*, .DS\_Store).  
+* client/.env.local a server/.env: Soubory pro lokální proměnné prostředí (např. REACT\_APP\_API\_URL pro klienta, DATABASE\_URL, JWT\_SECRET, PORT pro server). Tyto soubory nebudou commitovány do Gitu. Vytvořit také .env.example soubory se šablonami.  
+* client/package.json a server/package.json: AI vygeneruje základní package.json s názvem projektu, verzí a skripty jako start, dev (pro spuštění s nodemon/vite HMR), build, test, lint, format. AI také přidá výše uvedené knihovny do dependencies a devDependencies.
+
+### **7\. Direktiva pro AI (Lovable.dev) \- Založení Projektu**
+
+1. Vytvořit Adresářovou Strukturu: AI vygeneruje kompletní adresářovou strukturu definovanou v Sekci 3, včetně všech uvedených podsložek. Vytvoří prázdné soubory s uvedenými názvy tam, kde je to specifikováno (např. GameController.ts, clientConfig.ts).  
+2. Inicializovat package.json: Pro client/ a server/ AI inicializuje package.json a přidá všechny knihovny uvedené v Sekci 5 do příslušných dependencies a devDependencies. Použít npm install nebo yarn add (konceptuálně).  
+3. Vytvořit Základní Konfigurační Soubory: AI vytvoří soubory uvedené v Sekci 6 s doporučeným základním obsahem (např. tsconfig.json s strict: true, základní .gitignore).  
+4. NepImplementovat Herní Logiku: V této fázi AI nebude psát žádný kód do herních logických souborů (např. do systémů ECS, React komponent pro obrazovky, atd.). Cílem tohoto promptu je pouze příprava kostry projektu. Obsah těchto souborů bude definován v následujících promptech.  
+5. Nastavit Linting a Formátování: Konfigurovat ESLint a Prettier pro projekt.  
+6. Inicializovat Git Repozitář: (Konceptuálně) Vytvořit .git adresář a provést první commit se základní strukturou projektu.
+
+### **8\. Diagram Herního Toku a Propojení Komponent**
+
+(Zde by AI vložila vylepšený diagram hry. Protože já jako textový model nemohu přímo pracovat s obrázky, AI (Lovable.dev) by měla tento diagram buď vygenerovat jako SVG/PNG na základě mého textového popisu v následujících promptech, nebo by zde byl placeholder pro manuální vložení. Prozatím popíšu, co by měl základní diagram obsahovat a jak bude rozšiřován.)  
+Základní Koncept Diagramu (bude rozšiřován v každém promptu):  
+Diagram bude vizualizovat hlavní komponenty a tok mezi nimi. Pro tento Prompt 01 (Založení Projektu), diagram by měl velmi zjednodušeně ukazovat:  
+graph TD  
+    A\[Start Aplikace\] \--\> B(InitialLoadingScreen);  
+    B \--\> C{Hlavní Menu (MainMenuScreen)};  
+    C \--\> |Nová Hra| D(TransitionLoadingScreen);  
+    D \--\> E\[Nastavení Nové Hry (NewGameSetupScreen)\];  
+    C \--\> |Načíst Hru| F(TransitionLoadingScreen);  
+    F \--\> G\[Načtení Uložené Hry (LoadGameScreen)\];  
+    C \--\> |Nastavení| H\[Nastavení (SettingsScreen) \- Modální\];  
+    C \--\> |Knihovna| I\[Knihovna Znalostí (KnowledgeLibraryScreen) \- Modální\];  
+    C \--\> |Tvůrci| J\[Tvůrci (CreditsScreen) \- Modální\];  
+    C \--\> |Ukončit| K\[Potvrzovací Dialog Ukončení\];
+
+    subgraph Projektová Struktura \[Definováno v NS\_Prompt\_01\]  
+        direction LR  
+        S01\[client/\]  
+        S02\[server/\]  
+        S03\[shared/\]  
+        S04\[docs/\]  
+        S05\[tools/\]  
+        S06\[tests/\]  
+    end
+
+    %% Zvýraznění aktuální části diagramu pro NS\_Prompt\_01  
+    style Projektová Struktura fill:\#333,stroke:\#fff,stroke-width:2px,color:\#fff  
+    style A fill:\#333,stroke:\#fff,stroke-width:2px,color:\#fff
+
+Popis Zvýrazněné Části Diagramu pro NS\_Prompt\_01:  
+Tento prompt se zaměřuje na vytvoření základní Projektové Struktury (client/, server/, shared/, atd.) a definuje počáteční bod aplikace (Start Aplikace), který vede k první viditelné obrazovce (InitialLoadingScreen) a následně k Hlavnímu Menu. Ostatní propojení z Hlavního Menu jsou zde naznačena, ale jejich detailní implementace bude následovat v dalších promptech.  
+(Tento diagram bude AI agent vkládat na konec každého promptu a vždy zvýrazní tu část, kterou daný prompt detailně popisuje, a přidá nová relevantní propojení.)  
+Tento první prompt nové série by měl AI (Lovable.dev) poskytnout všechny potřebné informace k založení robustní a dobře organizované kostry projektu pro hru "Star Dust Voyager: Galaxy Wanderer".  
+Jakmile budeš mít připravený náčrt diagramu, nebo pokud chceš, abychom začali s diagramem, který jsem zde naznačil a budeme ho postupně rozvíjet, dej vědět. Poté se můžeme pustit do druhého promptu, který se zaměří na InitialLoadingScreen a MainMenuScreen s detailním popisem jejich UI, assetů a funkcí.

textures.md

@@ -0,0 +1,474 @@
+# **Stylová dokumentace a šablony Star Dust Voyager**
+
+## **Terminály a CRT obrazovky**
+
+* **Styl rozhraní**: CRT-heavy retro-futuristický design s analogovým vzhledem (opalovaný plast, kov).  
+* **Rozlišení**: Pevné násobky pixelů (např. 320times200, 640times480).  
+* **Pixelart rastr**: Viditelné pixely, ostré hrany bez antialiasingu.  
+* **Barvy**: Omezená paleta (monochromatická nebo několik základních barev \- např. zelená, jantarová, červená). Používají se barevné režimy zelený fosfor, jantarový žlutý, sytě červený.  
+* **Scanlines**: Vrstva jemných horizontálních pruhů mezi řádky pixelů. Intenzita 50-70% (simulace rasteru CRT).  
+* **Záře (Glow)**: Slabá záření u jasných prvků (text, LED). Implementována jako rozostřený poloprůhledný obrys (kuželoidní bloom).  
+* **Kovový rámeček**: Terminály mají robustní rám z INDUSTRIAL\_METAL s opotřebovaným lakem. Tlumené odstíny, s drobnými oděrkami a korozí v rozích.  
+* **Obsah obrazovky**: Terminály zobrazují blokový text, jednoduchou vektorovou grafiku nebo statické obrázky (schémata). Animace omezena na 15-20 FPS pro retro dojem.  
+* **Zvuk a animace**: Interakce způsobuje krátké zablikání obrazem (flicker) a pulzování kontrolek. Simulovat analogové chvění jasu.  
+* **Ghosting**: Při rychlém přepínání ponechat slabý „závoj" předchozího obrazu (simulace luminiscence).  
+* **Tearing efekt**: Náhodné horizontální posuny pixelů (drobný obrys, rušení) při přetížení.  
+* **Šum**: Přes obrazovku přidat jemný pixelový šum (grain) s nízkou neprůhledností.  
+* **Zakřivení**: Lehká barelová deformace (barrel distortion) simulující zakřivený tvar obrazovky CRT.
+
+**Příklad**
+
+TerminalPanel { \[cite: 21\]  
+resolution: (320, 200\) \[cite: 22\]  
+palette: "green\_phosphor" \[cite: 23\]  
+scanlineIntensity: 0.6 \[cite: 24\]  
+glowRadius: 1.0 \[cite: 25\]  
+frameMaterial: "INDUSTRIAL\_METAL" \[cite: 26\]  
+cornerRadius: 4 \[cite: 27\]  
+content: \[ \[cite: 28\]  
+TextBox(font="RetroConsole8", color="green\_phosphor", text="SYSTEM READY"), \[cite: 29, 30\]  
+IndicatorLight(color="amber", state="on") \[cite: 31\]  
+\]  
+}
+
+## **Přepínače a ovládací prvky**
+
+* **Vzhled**: Mechanické spínače a tlačítka s výraznými 3D detaily \- kovové knoflíky, opotřebovaný plast, nýtové spoje.  
+* **Stavy**: Každý prvek má stavy Normal, Hover, Active (pressed), Disabled, Alert. Pro každý stav definovat změnu jasu, barvy nebo stínu.  
+* **Hover**: Při najetí kurzorem zvýšit mírně jas a přidat jemný glow (zdůraznění aktivního prvku).  
+* **Active**: Při stisku se objekt posune o pár pixelů, jeho barva ztmavne, zvýrazní se vnitřní stín (efekt zatlačení).  
+* **Disabled/Alert**: Neaktivní stav šedý nebo ztlumený. Alarmový stav má blikavé červené světlo, případně invertované barvy.  
+* **Zvuk**: Mechanické cvaknutí při potvrzení, žádné digitální pípy. Použít originální kovové kliky.  
+* **Sprite Textury**: Používat spritesheety s vícestavovými obrázky (např. off/on), aby bylo snadné přepínat stav.  
+* **Mřížka**: Komponenty umisťovat do pixel-perfect mřížky (např. krok 16px).  
+* **Feedback**: Na kliknutí krátké bliknutí nebo puls animace (ripple) kolem tlačítka.
+
+**Příklad**
+
+ToggleSwitch { \[cite: 46\]  
+size: (48, 16\) \[cite: 47\]  
+offStateTexture: "switch\_off.png" \[cite: 48\]  
+onStateTexture: "switch\_on.png" \[cite: 49\]  
+onHover: enableGlow(intensity=0.2) \[cite: 50\]  
+onClick: playSound("click\_metal.wav") \[cite: 51\]  
+}
+
+## **HUD a mapy**
+
+* **HUD panely**: Průhledné nebo kovové rámečky, integrované analogové ukazatele a LED pruhy. Indikátory jako segmentové displeje a ručičky.  
+* **Fonty**: Monospace pixelové fonty (8times8 nebo 8times16). Barva kontrastní (typicky neonově zelená, žlutá nebo červená na tmavém pozadí).  
+* **Minimap / Galaktická mapa**: Pozadí tmavé (black), hvězdné pole animované s mírným pohybem (parallax). Body zájmu (planety, hvězdy) neonově zvýrazněné.  
+* **Ikonografie**: Jednoduché ikonky (8times8 nebo 16times16) pro objekty, barevné podle typu. Malé animace (blikání, pulsování) pro pozornost.  
+* **Grid pro HUD**: Používat hrubou mřížku 32px pro hlavní elementy a jemnou 8px pro umisťování textů/ikon.  
+* **Interaktivní prvky**: Kliknutí/hover na ikonky zobrazí tooltipy s efektem zeleného obrysu. Hranice kolmo na mřížku.  
+* **Navigace**: Horní nebo dolní ovládací prvky pro zoom a posun (LED tlačítka, kolečka).  
+* **Indikátory**: Digitální čítače (pixel-art) a analogové metry pro stavy. Např. tahomer, radarové lokátory.
+
+**Příklad**
+
+HUD\_GalaxyMap { \[cite: 64\]  
+size: (800, 600\) \[cite: 65\]  
+background: Texture("starfield\_static.png") \[cite: 66\]  
+waypoints: \[ \[cite: 68\]  
+{id: "Sol", pos: (150,120), icon:"icon\_star.png", tooltip: "Sol System"}, \[cite: 69, 70\]  
+{id: "Alpha", pos: (500,400), icon: "icon\_planet.png", tooltip: "Alpha Centauri"} \[cite: 71, 72\]  
+\]  
+font: "PixelFont8x8" \[cite: 73\]  
+colorMode: "neon\_green\_on\_black" \[cite: 74\]  
+}
+
+## **Hierarchie vrstev a grid systém**
+
+* **Vrstvy UI**: Rozdělit prvky do úrovní (background, UI, overlay, efekty). Vrstvy určeny podle z-indexu (pozadí \= 0, UI \= 1-2, efekty \= 4-5, varování \= 6).  
+* **Grid systém**: Hlavní mřížka 32px (moduly, panely), sekundární 8px (text, ikony). Vše pixel-perfect \- přesné násobky pixelů.  
+* **Rozlišení**: Navržené pro pevný poměr stran (např. 4:3 nebo 16:9). Při škálování vždy dělat celočíselnou změnu (beze ztráty ostrých hran).  
+* **Zarovnání textu**: Všechny texty na 8px baselinu. Řádky textu přesně 8px od sebe.  
+* **Focus a modální stavy**: Aktivní okno/komponenta je zvýrazněna. Ostatní prvky lze „zasvětlit" (snížit opacity) pro dohled.  
+* **Responsivita**: Přizpůsobení na nižší rozlišení: skrýt méně důležité panely, zmenšit písmo, zachovat velikost v krocích po pixelech.
+
+**Příklad**
+
+UILayout { \[cite: 86\]  
+gridMajor: 32 \[cite: 87\]  
+gridMinor: 8 \[cite: 88\]  
+layers: \[ \[cite: 89\]  
+{name: "background", zIndex: 0}, \[cite: 90\]  
+{name: "ui", zIndex: 1}, \[cite: 91\]  
+{name: "overlay", zIndex: 4}, \[cite: 92\]  
+{name: "alerts", zIndex: 6} \[cite: 93\]  
+\]  
+anchors: \["top-left", "center", "bottom-right"\] \[cite: 95\]  
+align: "pixel-perfect" \[cite: 96\]  
+}
+
+## **Barevné režimy a fonty**
+
+* **Paleta**: Omezené palety připomínající CRT. Obvykle 1-4 barvy na element. Typické barvy: neonově zelená, smaragdově modrá, oranžový jantar.  
+* **Kontrast**: Vysoký kontrast text/pozadí (text\~80-90% jasu, pozadí \~10-20%). Umožňuje čitelnost i při nízkém rozlišení/skenování.  
+* **Fonty**: Ručně malované pixelové fonty s artefakty (drobná nepravidelnost v liních). Žádné vyhlazování. Např. PixelFont8x8, RetroConsole.  
+* **Fallback znaky**: Pro neznámé znaky použít vyplněný blok (blacksquare) nebo prázdný modul. Zajistit čitelné symboly.  
+* **Inverze**: Pro varování/informace přepínat na inverzní zobrazení (bílé texty na černém pozadí nebo červené na černé).  
+* **Materiál textu**: Indikátory (LED, indikátory) využívají vlastní úroveň jasu a barvy (červená, oranžová, neon zelená) oddělené od main palety.
+
+**Příklad**
+
+StyleSheet { \[cite: 108\]  
+colorScheme: { \[cite: 109\]  
+primary: "\#00FF00", // neon green \[cite: 111\]  
+secondary: "\#002244", // deep blue \[cite: 112\]  
+alert: "\#FF4444" \[cite: 113\]  
+}  
+font: { \[cite: 114\]  
+name: "PixelFont8x8", \[cite: 117\]  
+size: 8, \[cite: 118\]  
+spacing: 2 \[cite: 119\]  
+}  
+terminalEffect: "scanline\_overlay" \[cite: 120\]  
+}
+
+## **Terminálové efekty (Scanlines, Glow, Glitch)**
+
+* **Scanlines**: Přidat horizontální 1px pruhy mezi řádky. Intenzita \~0.5 (50% opacity).  
+* **Bloom/Glow**: Jasné objekty (text, LED) rozmazat do okolí (malý radius). Např. jasný pixel nabobtná na \-2px rozostřenou záři.  
+* **Deformace CRT**: Mírná barelová deformace obrazu (zakřivení rohů) simulující realitu.  
+* **Glitch**: Občasné náhodné posuny (offset) některých řádků o pár pixelů. Barevné poruchy (RGB oddělení) pro dramatický efekt.  
+* **Šum**: Krátkodobý statický šum \- celý obraz lehce „zavibruje" bíločerným šumem.  
+* **Pořadí aplikace**: Shader efekty aplikovat v pořadí: základní obraz → scanlines → bloom → glitch.
+
+**Příklad**
+
+Effect ApplyCRTFilters { \[cite: 129\]  
+enableScanlines(opacity=0.6) \[cite: 130\]  
+enableBloom(threshold=0.7, radius=1.0) \[cite: 131\]  
+if (state \== ERROR) { \[cite: 132\]  
+applyGlitch(offsetX=3, duration=0.2) \[cite: 133\]  
+applyColorDrift(rShift=+5, gShift=-5) \[cite: 134\]  
+}  
+}
+
+## **Interaktivní stavy a responsivita**
+
+* **Stavy UI**: Definovat stavy Normal, Hover, Active, Disabled, Alert. Pro každý stav specifikovat vizuální změny (jas, barva, posun).  
+* **Animace**: Přechody \-0.1s (ease-in-out). Např. lehké vyjasnění při hover.  
+* **Zpětná vazba**: Akce (click, select) generuje krátký pulz (zvýšení jasu/změna barvy) nebo zvukový efekt.  
+* **Klávesové zkratky**: Podtrhnout odpovídající písmeno (např. Enter) a detekovat Alt+\[Key\].  
+* **Responzivní layout**: Při změně rozlišení měnit velikost prvků po celých pixelech. Na menších rozlišeních skrýt pomocné prvky.  
+* **Zdůraznění**: Vybraný prvek orámovat neonovou barvou (např. zelenou). Zvýraznění může pulsovat.
+
+**Příklad**
+
+Button { \[cite: 146\]  
+normal: {bg: "\#333333", text: "\#00FF00"} \[cite: 147\]  
+hover: {bg:"\#444444", glow:0.2} \[cite: 148, 149\]  
+active: {offsetY: 2px, shadow: 0.5px, text:"\#99FF99"} \[cite: 150, 151\]  
+onHover: animate(duration=0.1s) \[cite: 152\]  
+onClick: playSound("button\_press.wav") \[cite: 153\]  
+}
+
+## **Příklady layoutů**
+
+### **Výzkumná konzole**
+
+* **Rozvržení**: Levý panel \- textové logy, střední panel \- 3D holografická mapa, pravý panel \- datové statistiky. Vše zarovnáno do 32px mřížky.  
+* **Komponenty**: Terminálové obrazovky s textem, analogové ručičkové měřiče a LED indikátory. Barvy \- zelené a modré akcenty.  
+* **Interakce**: Levý panel scrolluje logy, na mapě lze přemisťovat kameru (otáčet), pravý panel filtruje data.
+
+Layout ResearchConsole { \[cite: 161\]  
+panels: \[ \[cite: 163\]  
+{name: "log\_panel", size: (200x400), position: (0,0)}, \[cite: 165\]  
+{name:"3d\_display", size: (400x400), position: (200,0)}, \[cite: 166\]  
+{name:"stats\_panel", size: (200x400), position: (600,0)} \[cite: 167\]  
+\]  
+grid: 32 \[cite: 168\]  
+font: "PixelFont8x8" \[cite: 169\]  
+colorMode: "monochrome\_green" \[cite: 170\]  
+}
+
+### **Mapa galaxie**
+
+* **Rozvržení**: Celá obrazovka pokryta hvězdným polem. Ikony planet a hvězd jsou barevné a blikají.  
+* **Navigace**: Šipky nebo kolečko pro zoom vlevo/pravý. Ikony pro posun vlevo/vpravo/horní/dolní.  
+* **Grafika**: Spojnice mezi hvězdami neonově zelené, hvězdy pulsují. Pozadí statické se slabým pohybem (parallax).
+
+Layout GalaxyMap { \[cite: 175\]  
+background: StarField(texture="stars\_noise.png", parallax=0.6) \[cite: 176\]  
+waypoints: \["Sol", "Alpha", "Vega"\] \[cite: 179\]  
+icons: {star: "star\_icon.png", planet: "planet\_icon.png"} \[cite: 180\]  
+zoomControls: {position:"bottom-right", size: 48} \[cite: 180\]  
+textFont: "PixelFont8x8" \[cite: 180\]  
+highlightColor: "neon\_green" \[cite: 181\]  
+}
+
+### **Inventář**
+
+* **Rozvržení**: Mřížka 5x4 slotů na předměty na tmavém kovovém pozadí, dolní panel s detailem položky.  
+* **Sloty**: Každý slot hranatý, rámeček kovový. Vybraný slot má zářivě zelený rámeček a lehce pulzuje.  
+* **Ikony**: Pixelové ikony položek se stínem. Konstantní velikost (např. 48x48 px).  
+* **Text**: Vedle vybraného slotu se zobrazí název a popis pixelfontem.
+
+Layout Inventory { \[cite: 187\]  
+grid: {columns: 5, rows: 4, cellSize:64, gap:8} \[cite: 189\]  
+slotFrame: Texture("inv\_slot\_frame.png") \[cite: 189\]  
+selectedBorder: {color:"neon\_green", thickness:2} \[cite: 190\]  
+itemIconSize: (48, 48\) \[cite: 191\]  
+infoPanel: {size: (400x100), position: "bottom"} \[cite: 192\]  
+font: "PixelFont8x8" \[cite: 192\]  
+}
+
+## **Šablony assetů**
+
+* **Lodě**: Modulární design \- trup, křídla, kokpit, motory. Povrch z INDUSTIAL\_METAL s nátěrem, viditelné šrouby a panely. Barevné akcenty (červené/žluté).  
+* **Stanice**: Rozsáhlé kubické bloky, robustní vazby. Textury RUSTED\_STEEL pro exteriér, panely s WORN\_PLASTIC v interiéru.  
+* **Vnitřní moduly**: Chodby a kabíny. Stěny z INDUSTRIAL\_METAL s opotřebovaným nátěrem, ozdobné OSD panely z WORN\_PLASTIC.  
+* **Panely (control panels)**: Vnější rámečky z INDUSTRIAL\_METAL, tlačítka z WORN\_PLASTIC. Povrch 2D textury s dekály (štítky, šrouby).  
+* **Trupy**: Zakřivené kovové části z INDUSTRIAL\_METAL. Opotřebení hlavně na hranách a styčných místech.  
+* **Generátory**: Robustní válce a žebra. Použít RUSTED\_STEEL pro části vystavené žáru (skvrny spáleného kovu), kablíky z CABLING\_BUNDLE.
+
+**Příklad**
+
+AssetTemplate Ship\_X { \[cite: 203\]  
+modules: \["cockpit", "engine", "wing\_left", "wing\_right", "hull"\] \[cite: 204\]  
+style: "retro\_futuristic" \[cite: 205\]  
+defaultMaterials: \["INDUSTRIAL\_METAL", "RUSTED\_STEEL"\] \[cite: 206\]  
+textureLayers: \[ \[cite: 207\]  
+{material: "INDUSTRIAL\_METAL", normalMap: "metal\_norm.png"}, \[cite: 211\]  
+{material: "WORN\_PLASTIC", decal: "panel\_scratch.png"} \[cite: 212\]  
+\]  
+}
+
+### **INDUSTRIAL\_METAL**
+
+* **Barva**: Tmavě ocelová se studeným odstínem. Lehce zelenkavá nebo šedá patina.  
+* **Textura**: Jemné kovové zrno, škrábance. Přidat šmouhy oleje/maziva.  
+* **Specular**: Nízký, povrch matný (roughness \~0.7). Lesklejší prvky na okrajích škrábanců.  
+* **Opotřebení**: Okraje a hřeby světlejší. Použít masku pro odřeniny a odlupování laku.  
+* **Normálová mapa**: Zvýraznění promáčklin a škrábanců pro realistické odlesky.  
+* **Použití**: Trupy, nosníky, exteriér lodí a stanic.
+
+**Příklad**
+
+Material INDUSTRIAL\_METAL { \[cite: 220\]  
+baseColor: \#5A5D61 \[cite: 221\]  
+roughness: 0.7 \[cite: 222\]  
+normalTexture: "industrial\_metal\_norm.png" \[cite: 223\]  
+scratchTexture: "metal\_scratches.png" \[cite: 224\]  
+}
+
+### **WORN\_PLASTIC**
+
+* **Barva**: Tmavě šedá nebo olivová, matný plast. Povrch původně lakovaný.  
+* **Opotřebení**: Oděry a škrábance odhalující světlejší plast v hloubce. Místy odštípnutý lak.  
+* **Struktura**: Jemná granulace (simulace výlisku). Škrábance jako drobné čáry.  
+* **Lesk**: Velmi nízký (průmyslový mat, roughness \~0.9).  
+* **Použití**: Kryty ovládacích panelů, madla, interiérové obklady.
+
+**Příklad**
+
+Material WORN\_PLASTIC { \[cite: 233\]  
+baseColor: \#4B4B4B \[cite: 234\]  
+roughness: 0.9 \[cite: 235\]  
+normalTexture: "worn\_plastic\_norm.png" \[cite: 236\]  
+decalTexture: "plastic\_dents.png" \[cite: 237\]  
+}
+
+### **RUSTED\_STEEL**
+
+* **Barva**: Rezavě hnědá/oranžová. Na podkladu tmavý kov (tmavě hnědý).  
+* **Koroze**: Hluboké mapy rzi na exponovaných místech. Nerovnoměrné flíčky rezu.  
+* **Povrch**: Matný (rust není lesklý). Odlupuje se s mírou (podklad obnažen).  
+* **Detaily**: Vypálené či zašpiněné oblasti (okolo šroubů, hran).  
+* **Použití**: Exteriér stanic, potrubí, generátorů, části kde je vlhkost/chemická zátěž.
+
+**Příklad**
+
+Material RUSTED\_STEEL { \[cite: 247\]  
+baseColor: \#664433 \[cite: 248\]  
+rustIntensity: 0.8 \[cite: 249\]  
+rustMask: "rust\_blots.png" \[cite: 250\]  
+normalTexture: "rusted\_steel\_norm.png" \[cite: 251\]  
+}
+
+### **CABLING\_BUNDLE**
+
+* **Barva**: Mix kabelů \- základem černá/gumová izolace. Varovné žluté/červené proužky.  
+* **Textura**: Zřetelné spojovací prvky (dráty, konektory). Praporkovité izolace navinuté okolo.  
+* **Opletení**: U většiny kabelů spirálový pruhový vzor (světlejší linky).  
+* **Detaily**: Namáčení na spojích, pájené spoje. Mírně lesklé koncové konektory.  
+* **Použití**: Elektrické trasy, moduly s elektronikou, spotřebiče.
+
+**Příklad**
+
+Material CABLING\_BUNDLE { \[cite: 260\]  
+baseColor: \#222222 \[cite: 261\]  
+wireCount: 6 \[cite: 262\]  
+insulationPattern: "spiral\_stripes.png" \[cite: 263\]  
+connectorTexture: "metal\_connector.png" \[cite: 264\]  
+}
+
+## **Vrstvení a efekty opotřebení**
+
+* **Základní vrstvy**: Používat sekvenci base \> dirt \> scratch \> edgeHighlight. Nejprve nanést čistý základní materiál, potom vrstvy nečistot, škrábanců a nakonec krajové opotřebení.  
+* **Parametrická patina**: Použití Perlinova šumu či Voronoi pro generování koroze a škrábanců s náhodným seedem.  
+* **Ovládací parametry**: hustota škrábanců, velikost flíčků, směr degradace.  
+* **Hrany**: Kraje dílů zvýraznit světlejší barvou (simulace obrusu). Maskovat podle vzdálenosti od okraje.  
+* **Kombinování efektů**: Smíchat celoplošné (základní patinování) s drobnými (bodové škrábance, kapky).  
+* **Maskování**: Použít grunge masky k umístění efektů (okraje, rohy). Zachovat pixelart ostrost (masky high-contrast).  
+* **Automatizace**: Procedurálně generovat drobné detaily (čárky, tečky) skripty (např. náhodné 1px linky).
+
+**Příklad**
+
+LayeredTexture WallModule { \[cite: 276\]  
+baseLayer: Material("INDUSTRIAL\_METAL") \[cite: 277\]  
+addLayer(type="DIRT", opacity=0.3, seed=42) \[cite: 278\]  
+addLayer(type="SCRATCHES", density=0.5, angle=45) \[cite: 279\]  
+applyEdgeMask(intensity=0.8) \[cite: 281\]  
+}
+
+## **Texturovací modely**
+
+* **Panely (Control Panels)**: Velikost obvykle malé (32times32 až 128times128 px). Rozděleny do sekcí (knoflíky, obrazovka). Použít uniformní rám a textury šroubů a štítků.  
+* **Zařízení (Devices)**: Kulatá nebo válcová tělesa (motory, baterie). Povrch rozdělen na segmenty s různými materiály (kov, plast, zářivka).  
+* **Přepážky (Partitions)**: Rovné plochy stěn. Použít opakující se modulární vzor (geometrická mřížka, ventily).  
+* **Pozadí**: Technologické pozadí s jemnými detaily (potrubí, cívky, perforace). Nízká kontrast, aby nepřehlušilo primární objekty.  
+* **Normal mapy**: Vypočíst z vysoko-kontrastních základních vzorů (šrouby, prolisy).  
+* **UV layout**: Šablony pro standardní tvary (1times1 panel, 2times1 krychle apod.) pro konzistentní texturování.
+
+**Příklad**
+
+TextureModel ControlPanel { \[cite: 292\]  
+size: (64, 64\) \[cite: 293\]  
+segments: 4x2 \[cite: 294\]  
+baseTexture: "panel\_base.png" \[cite: 295\]  
+detailOverlays: \["screws.png", "buttons.png"\] \[cite: 296\]  
+normalMap: "panel\_norm.png" \[cite: 297\]  
+}
+
+## **Příklady generování modulu**
+
+* **Tvar modulu**: Definovat základní geometrii (např. krychle, válec). Nastavit UV-mapping odpovídající rozměrům.  
+* **Hlavní materiál**: Aplikovat primární materiál (např. INDUSTRIAL\_METAL) na všechny plochy.  
+* **Doplňkové vrstvy**: Nad hlavní materiál přidat vrstvy opotřebení: WORN\_PLASTIC pro oděrky, RUSTED\_STEEL pro korozi na okrajích, CABLING\_BUNDLE pro elektrická vedení.  
+* **Detaily**: Generovat dekorativní části \- větrací otvory, šrouby, světla \- samostatně a integrovat jako transparentní mapy nebo 3D prvky.  
+* **Kombinace textur**: Vrstvy spojit do výsledné textury (displacement map). Při velkém rozlišení zachovat pixelovou ostrost (více mipmap, žádné bilineární rozmazání).
+
+**Příklad**
+
+ModuleTexture EngineBay { \[cite: 307\]  
+shape: "Cylinder" \[cite: 308\]  
+baseMaterial: "INDUSTRIAL\_METAL" \[cite: 309\]  
+addLayer(material="RUSTED\_STEEL", amount=0.4, region="edges") \[cite: 310\]  
+addLayer(material="WORN\_PLASTIC", amount=0.2, region="center") \[cite: 311\]  
+addDetail(type="CABLING\_BUNDLE", position=(32,64)) \[cite: 311\]  
+finalize() \[cite: 311\]  
+}
+
+## **Výbuchy a fléry**
+
+* **Frame-by-frame**: Sekvence 8-12 snímků. Začíná jasným explozním středem (white-hot), postupně se rozrůstá oblak (oranžovo-žlutý) a končí šedivým kouřem.  
+* **Expanze**: Každý další snímek mírně zvětší průměr exploze. Simulace rozptylu částic (jiskry) v pozadí.  
+* **Barvy**: Počáteční snímek bílý/yellow, následují oranžové a tmavnoucí červené tóny, nakonec šedý/černý kouř.  
+* **Částice**: Kromě hlavního plamene emulovat drobné jiskry a úlomky (2D pixel particle system).  
+* **Loop**: Jednorázová animace (loop \= false). Po dokončení spustit event (např. audio „boom").  
+* **Světelný flash**: První snímek může být o jeden stupeň jasnější (přesvětlený).
+
+**Příklad**
+
+Animation EngineExplosion { \[cite: 324\]  
+frames: 10 \[cite: 325\]  
+frameRate: 12 \[cite: 326\]  
+sprites: \["exp0.png", "exp1.png", ... ,"exp9.png"\] \[cite: 327\]  
+loop: false \[cite: 328\]  
+onComplete: emit("ExplosionDone") \[cite: 329\]  
+}
+
+## **Glitch efekty**
+
+* **Horizontální posuvy**: Náhodně posunovat některé řádky obrazu o několik pixelů (offset glitch). Častá frekvence krátkodobě (např. 5-10Hz).  
+* **Chromatická aberace**: Mírný posuv RGB kanálů (červený a modrý rozestup) pro digitální šum.  
+* **Šumové linie**: Vertikální a horizontální lineární šum (blikající bíločerné pruhy).  
+* **Frekvence**: Epizodicky, ne konstantně \- glitch se objevuje v intervalech (např. 2-5 sekund trvající burst).  
+* **Selektivní aplikace**: Aplikovat na specifický prvek (monitor, HUD) nebo celou vrstvu obrazovky.
+
+**Příklad**
+
+Effect ScreenGlitch { \[cite: 338\]  
+horizontalJitter(intensity=2px, frequency=10Hz) \[cite: 339\]  
+verticalNoise(strength=0.3) \[cite: 340\]  
+onAlert: colorShift(r=+10, g=-5, b=+10) \[cite: 341\]  
+}
+
+## **Parallax a ambientní efekty**
+
+* **Parallax**: Více vrstev pozadí s různou rychlostí posuvu. Např. vzdálené hvězdy pomalu, blízké rychleji.  
+* **Ambientní světla**: Statické kontrolky a světelné panely, které občas bliknou (blinking) nebo plynule mění jas (pulsování).  
+* **Šum**: Jemný celoplošný šum (grain) přidán na vrstvu, simulující statický signál.  
+* **Částice**: Drobná animovaná částice prachu nebo kouře v popředí pro hloubku (nízká transparentnost).  
+* **Kamera**: Při akcích (výbuchu, letu) aplikovat lehký pohyb kamery (shake, slewing) pro dynamiku.
+
+**Příklad**
+
+ParallaxScene {   
+layers: \[   
+{asset:"stars\_far.png", speed:0.2},   
+{asset:"stars\_near.png", speed:0.5},   
+{asset:"space\_dust.png", speed:0.8}   
+\]  
+ambientLights: \[   
+{color:"red", pattern:"blink", interval:1.0},   
+{color:"green", pattern:"pulse", interval:0.5}   
+\]  
+noiseOverlay: {strength:0.05}   
+}
+
+## **Simulace starého terminálu**
+
+* **Textový výstup**: Postupné „psaní“ znaků s pauzami (typewriter effect). Každý znak doprovázen krátkým pípnutím.  
+* **Varovné stavy**: Při chybě střídavě blikat celé slovo nebo řádek (červeně) – invertovat barvy textu nebo použít efektní blikající pozadí.  
+* **FIFO buffer**: Na obrazovce se text vykresluje po řádcích z fronty. Každý nový řádek se posouvá nahoru.  
+* **Kursor**: Blikající podtržítko nebo blok ukazující aktivní pozici textu (blinking cursor \~2Hz).  
+* **Tónové efekty**: Nahrát charakteristický šum pro každé odeslané písmeno a varovné syčení.
+
+**Příklad**
+
+TerminalAnimation {   
+textLines: \["Accessing system...", "Loading data...", "WARNING: OVERLOAD"\]   
+charDelay: 0.05s   
+onWarning: flashText(color="red", duration=0.5)   
+cursor: blink(rate=2Hz)   
+}
+
+## **Příklady efektů**
+
+### **Výbuch motoru**
+
+* Frame-by-frame animace motorového výbuchu: rychlý počáteční blesk, oblaka kouře do strany.
+
+Animation EngineExplosion {   
+frames: 12 \[cite: 357\]  
+frameRate: 15 \[cite: 357\]  
+sprites: \["eng\_exp0.png","eng\_exp1.png",...,"eng\_exp11.png"\] \[cite: 357\]  
+loop: false \[cite: 357\]  
+onComplete: spawnDebris() \[cite: 357\]  
+}
+
+### **Glitch monitoru**
+
+* Post-procesní glitch efekt na obrazovce: náhodné rovnoběžné posuvy a barevný šum.
+
+Effect MonitorGlitch {   
+horizontalShift(intensity=3px, frequency=8Hz)   
+noiseOverlay(strength=0.2)   
+colorDrift(r=+20, g=-10, b=+20)   
+}
+
+### **Přechod obrazovky**
+
+* Stylizovaný přechod mezi obrazovkami: z černé do neonové barvy s přídavným scanline efektem.
+
+Transition ScreenFade {   
+fromColor: "black"   
+toColor: "green"   
+duration: 0.8   
+overlayScanlines: true   
+soundEffect: "static\_burst.wav"   
+}