Klima: 3D V2 fertig + PHP-Wrapper + Sprachregel + Lehrplan-Notiz

- App/sims/klima/game-3d.html neu (~4800 Z.): Three.js-Szene via KlimaEngine.
  Phasen A-D durch (Gerüst, Terrain + Vulkan + Ozean + OrbitControls,
  12 Mesh-Factories, Raycaster + Placement-Ghost + Zonen-Overlay).
  Ambient: Flughafen 2x mit Heli-Landezyklus auf H-Pad, drei Boote + Yacht,
  Start-Dorf mit Rauchfäden, Vulkan-Schutzwall, Mangroven-Sterben grau,
  Radwege am Küstenband, Ketten-Bau, Experten-Modus mit 17 Info-Cards.
  Sprachregel 4a angewandt (Arbeitsstand statt Spielstand etc.).
- App/pages/klima-3d.php neu: PHP-Wrapper analog zu klima-2d.php, teilt
  sich module_info und game_levels, separate Save-Slots (ggs-save-klima-3d).
- _inbox/klima/_status.md überschrieben.
- _inbox/zentrale/2026-04-19-1700-klima-3d-v2-fertig-modul-toggle.md:
  Bitte an Lehrplan um 2D/3D-Launcher auf modul-klima.php.

V1 (App/game-3d.html) bleibt unberührt.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

App/pages/klima-3d.php

@@ -0,0 +1,120 @@
+<?php
+/**
+ * Klimawächter 3D (V2) — PHP-Wrapper
+ * Lädt sims/klima/game-3d.html, injiziert Session-Kontext und Level-Config.
+ * Teilt sich mit klima-2d die gleiche `module_info` und `game_levels`-
+ * Quelle, damit Admin-Einstellungen für beide Varianten identisch gelten.
+ *
+ * URL: /geograsim/App/klima-3d (via index.php Front-Controller)
+ *      ?level=1|2|3  Schwierigkeit (Default: 1)
+ */
+
+require_once __DIR__ . '/../php/config/app.php';
+require_once __DIR__ . '/../php/lib/Database.php';
+require_once __DIR__ . '/../php/lib/Session.php';
+
+if (session_status() === PHP_SESSION_NONE) Session::start();
+
+$level      = max(1, min(3, (int)($_GET['level'] ?? 1)));
+$sessionId  = Session::studentId() ?? '';
+$studentName = 'Gast';
+$classId    = null;
+// Modul-Metadaten werden vom Admin in `module_info` gepflegt; 3D bekommt
+// denselben Titel wie 2D, aber mit "3D"-Suffix, damit der Header-Badge
+// klar macht welche Variante läuft.
+$simName = 'Klimawächter 3D';
+$simIcon = '🌍';
+
+try {
+    $db = Database::get();
+    if ($sessionId) {
+        $row = $db->fetchOne(
+            'SELECT class_id, display_name FROM student_sessions WHERE id = ?',
+            [$sessionId]
+        );
+        if ($row) {
+            $studentName = $row['display_name'] ?: 'Schüler*in';
+            $classId     = (int)$row['class_id'];
+        }
+    }
+    // Modul-Info aus DB (Atlas-verwaltet). Defaults greifen, wenn Tabelle
+    // fehlt oder kein Eintrag für "klima" existiert.
+    $mi = $db->fetchOne(
+        'SELECT title, icon FROM module_info WHERE module_id = ?',
+        ['klima']
+    );
+    if ($mi) {
+        if (!empty($mi['title'])) $simName = $mi['title'] . ' 3D';
+        if (!empty($mi['icon']))  $simIcon = $mi['icon'];
+    }
+} catch (Throwable $e) {
+    // DB nicht erreichbar → Defaults
+}
+
+// Level-Konfiguration — gleiche Werte wie klima-2d. 2D und 3D teilen sich
+// die Admin-Einstellungen; wenn Thomas Budget oder Runden-Limit anpasst,
+// gilt das für beide Varianten.
+$levelConfigs = [
+    1 => [
+        'difficulty'     => 'easy',
+        'label'          => 'Lernen',
+        'startBudget'    => 600,
+        'startPopulation'=> 6000,
+        'incomePer10k'   => 220,
+        'blackoutGrace'  => 5,
+        'timeLimit'      => 75,
+        'eventFrequency' => 0.3,
+    ],
+    2 => [
+        'difficulty'     => 'medium',
+        'label'          => 'Üben',
+        'startBudget'    => 480,
+        'startPopulation'=> 6000,
+        'incomePer10k'   => 155,
+        'blackoutGrace'  => 0,
+        'timeLimit'      => 75,
+        'eventFrequency' => 0.5,
+    ],
+    3 => [
+        'difficulty'     => 'hard',
+        'label'          => 'Profi',
+        'startBudget'    => 220,
+        'startPopulation'=> 7000,
+        'incomePer10k'   => 110,
+        'blackoutGrace'  => 0,
+        'timeLimit'      => 75,
+        'eventFrequency' => 0.7,
+    ],
+];
+
+$ctx = [
+    'sessionId'   => $sessionId,
+    'studentName' => $studentName,
+    'classId'     => $classId,
+    'simId'       => 'klima',
+    'simName'     => $simName,
+    'simIcon'     => $simIcon,
+    'level'       => $level,
+    'levelConfig' => $levelConfigs[$level],
+    'baseUrl'     => BASE_URL,
+    'basePath'    => BASE_PATH,
+    'apiUrl'      => BASE_URL . '/php/api',
+];
+
+$html = file_get_contents(__DIR__ . '/../sims/klima/game-3d.html');
+if ($html === false) {
+    http_response_code(500);
+    echo 'game-3d.html nicht gefunden';
+    exit;
+}
+
+$bp = BASE_PATH;
+$baseTag = '<base href="' . htmlspecialchars($bp . '/sims/klima/', ENT_QUOTES) . '">';
+$ctxJs   = '<script>window.__GGS__ = ' . json_encode($ctx, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES) . ';</script>';
+
+// <base>-Tag direkt nach <head> einfügen, damit relative Pfade aus /sims/klima/ heraus auflösen
+$html = preg_replace('/<head>/i', '<head>' . "\n" . $baseTag, $html, 1);
+// Session-Kontext vor </body>
+$html = str_replace('</body>', $ctxJs . "\n</body>", $html);
+
+echo $html;

App/sims/_inbox/klima/_status.md

@@ -1,65 +1,91 @@
 ---
 instanz: klima
-zuletzt_aktualisiert: 2026-04-19 00:10
+zuletzt_aktualisiert: 2026-04-19 17:00
-session_id: engine-refactor-schritte-1-2
+session_id: 3d-v2-ausbau
 ---
 
 # Aktueller Stand
 
 ## Wo ich stehe
 
-Engine-Refactor aus Atlas-Auftrag `2026-04-18-2145-auftrag-engine-und-3d-v2.md`:
+Engine-Refactor-Auftrag komplett — alle fünf Schritte durch:
 
-- **Schritt 1 — Engine extrahieren:** DONE (`App/sims/klima/engine.js`)
+- **Schritt 1 — Engine extrahieren:** DONE (ältere Session)
-- **Schritt 2 — 2D auf Engine umstellen:** DONE, von Thomas im Browser getestet
+- **Schritt 2 — 2D auf Engine umstellen:** DONE (ältere Session)
-- **Schritt 3 — 3D V2 bauen:** OFFEN (4-6h Block, neue Session)
+- **Schritt 3 — 3D V2 bauen:** DONE (`App/sims/klima/game-3d.html`)
-- **Schritt 4 — `pages/klima-3d.php`:** OFFEN
+- **Schritt 4 — `pages/klima-3d.php`:** DONE
-- **Schritt 5 — `module_info` 2D/3D-Toggle (via Lehrplan):** OFFEN
+- **Schritt 5 — `module_info` 2D/3D-Toggle:** Nachricht an Atlas/Lehrplan
+  raus (`_inbox/zentrale/2026-04-19-1700-klima-3d-v2-fertig-modul-toggle.md`)
 
-Nebenbei diese Session erledigt:
+## Was in dieser Session gebaut wurde
-- Toasts voll-Canvas-breit mit 10px-Rand
+
-- Musik-Default 22 %, Auto-Start bei erster User-Geste
+### Phase A – D (Pflicht laut Auftrag)
-- Pro-Haus-Schornstein-Logik (je mehr Erneuerbare, desto mehr Häuser ohne Schornstein)
+
-- Flughafen-Helikopter fliegt (Zyklus Flug / Anflug / Pad)
+- **A — Gerüst:** game-2d.html kopiert, 2D-Canvas raus, Three.js-CDN
-- Alle Animationen via `state.animMs` bei Pause eingefroren, Speed skaliert
+  0.155.0 rein, `<div id="scene-container">` mit grid-column 1/-1.
-- Drama-Track `rising-pressure.mp3` integriert, Auto-Switch bei
+- **B — Szene:** Terrain als Höhenfeld (90×120-Plane, Vertex-Farben
-  `budget < 0 OR currentTemp > 17 OR floodedPct > 30` und bei `endLevel(false)`;
+  Strand/Wiese/Wald/Fels), Vulkan als Lathe-Dome + Schnee-Kappe mit
-  manuelle User-Auswahl blockt den Auto-Switch
+  Clipping-Plane für Schmelze, Ozean-Plane steigt mit state.seaLevelCm,
-- Bürger-Event-Bug gefixt (Phase-Restore + Pending-Event überlebt Refresh)
+  Himmel-Halbkugel, Ambient + DirectionalLight. Kamera per Kugel-
+  koordinaten + Eigenbau-Orbit (Drag, Scroll, Pfeiltasten, Auto-Drohne
+  mit 4 s Idle-Resume).
+- **C — 12 Mesh-Factories:** Wald, Solar, Wind, Gründach, Deich,
+  Seawall, Kohle, Flughafen (2x Scale, Heli-Pad schwarz mit H),
+  Wolken-Impfung, Radwege, Mangrove, Sand-Aufschüttung (breite Strand-
+  Plattform). Windräder animiert (rotorRef.rotation.z = tNow * 1.4).
+- **D — Placement-Ghost + Raycaster:** Zone-Overlay grün
+  (ShaderMaterial mit RGBA-Vertex-Farben), Küsten-Ausrichtung für
+  Deich/Seawall/Mangrove/Sand/Bikes, Ketten-Bau (Placement bleibt
+  nach Confirm offen), ESC / Rechtsklick / „Bau beenden"-Card verlassen.
+
+### Bonus-Polish / Thomas-Wünsche
+
+- Flughafen 2x Skala, Heli kreist → landet auf schwarzem H-Pad → steht
+  8 s → steigt wieder auf (36 s-Zyklus).
+- Drei Boote + Yacht: Fischerboot patrouilliert vorne, Tanker + kleines
+  Segelboot queren hinten, größere Yacht vorne — alle mit korrekten
+  Bug-Richtungen.
+- Start-Dorf: 10 Haus-Positionen, sichtbar ~ ceil(population/800),
+  Rauchfäden proportional zu (1 − renewablePower/demand).
+- Vulkan-Schutzwall (citizen-mountain-Event): Halbring aus 9 Fels-
+  Blöcken am Vulkanfuß, erscheint via `state.hasMountainShield`.
+- Mangroven sterben grau ab 30 cm Meeresspiegel (Material-Tint).
+- Radwege verlaufen am Küstenband (Terrain-Höhe 0.32–0.62, parallel).
+- Toast-Cap bei 6: älteste fliegt raus wenn 7. kommt.
+- End-Screen-Buttons: "Weiter arbeiten / Neue Simulation / Zurück zum
+  Cockpit". `startFreshSimulation()` räumt Save + startet ohne Reload.
+- Experten-Modus: 👨‍🔬-Button im Header, Cursor → help, Klick auf Objekt
+  öffnet INFO_TOPICS-Karte. 17 neue Info-Einträge (alle Maßnahmen +
+  Umgebung: Insel, Ozean, Vulkan, Tanker, Segelboot, Fischerboot, Heli,
+  Dorf, Schutzwall).
+- Sprachregel 4a durchgeführt: „Spielstand" → „Arbeitsstand",
+  "spielen" → "laufen lassen", "pleite" → "Budget aufgebraucht",
+  "Mission gescheitert" → "Ziel nicht erreicht", "Nochmal spielen"
+  → "Neue Simulation", "Startseite" → "Cockpit".
 
 ## Zuletzt geänderte Dateien
 
-- `App/sims/klima/engine.js` (neu)
+- `App/sims/klima/game-3d.html` (umfangreich erweitert, ~4800 Z.)
-- `App/sims/klima/game-2d.html`
+- `App/pages/klima-3d.php` (neu)
-- `App/sims/klima/assets/music/rising-pressure.mp3` (neu)
+- `App/sims/_inbox/zentrale/2026-04-19-1700-klima-3d-v2-fertig-modul-toggle.md`
-- `App/sims/_inbox/klima/2026-04-18-2240-handover-engine-steps3-5.md` (neu)
+  (neu, an Atlas + Lehrplan)
-- `App/sims/_inbox/zentrale/` — 4 Meldungen raus (Start, Fortschritt, Claim, Claim-final)
 
-## Als nächstes
+## Noch offen
 
-**Neue Klima-Session** für Schritt 3 (3D V2 bauen). Die neue Session MUSS
+- **Phase E Browser-Regression** — muss Thomas machen; meine Seite ist
-zuerst lesen:
+  statisch komplett, die 8 Tests aus Handover + 3D-Spezifisches
-
+  (Kamera-Orbit, alle 12 Meshes platzieren, Save/Load mit 3D-Positionen,
-1. `App/sims/_inbox/klima/_status.md` (diese Datei)
+  V1 unberührt) fehlen noch. Nach erstem Test-Durchgang kommen
-2. `App/sims/_inbox/klima/2026-04-18-2145-auftrag-engine-und-3d-v2.md` (Auftrag)
+  vermutlich Feinschliff-Iterationen — dann weiter in dieser Inbox.
-3. `App/sims/_inbox/klima/2026-04-18-2240-handover-engine-steps3-5.md` (Übergabe-Details)
+- **Lehrplan:** wartet auf Antwort, sobald `modul-klima.php` den
-4. `App/docs/music-registry.md` (für Musik-Slot-Koordination)
+  2D/3D-Toggle zeigt.
-
-Kern-Aufgabe: `App/sims/klima/game-3d.html` bauen, identisch zu V1-3D
-(`App/game-3d.html` + `App/src/sims/sim-05-treibhaus-3d/*.ts` als Vorlage),
-aber mit `KlimaEngine` als Logik-Schicht und Plattform-Drumherum
-(Design-System, Audio, Musik, Glossar, Autosave, Achievements).
 
 ## Offene Entscheidungen
 
-- Three.js per CDN (`https://unpkg.com/three@0.155.0/build/three.min.js`) —
+Keine. Alle drei Entscheidungen aus Phase-A-Plan sind durch:
-  Atlas hat das vorgegeben, kein Build-Schritt.
+OrbitControls-Eigenbau, Alt-Save-Fallback via pickBuildPosition,
-- 3D-Platzierungs-Koordinaten: `resolveMeta` liefert
+Session-Split nach C (nicht nötig — in einer Session geschafft).
-  `{ pos: {x,y,z}, rotation }` — Engine spreizt das wie in 2D in das
-  Instance-Objekt.
-- Save-Key für 3D: `ggs-save-klima-3d-L{n}` (parallel zu 2D, separate Slots)
 
 ## Blocker
 
-Keine. Kontext-Knappheit ist der einzige Grund, warum Schritt 3 in neuer
+Keine.
-Session ansteht.

App/sims/_inbox/zentrale/2026-04-19-1700-klima-3d-v2-fertig-modul-toggle.md

@@ -0,0 +1,67 @@
+---
+von: klima (3D-Session)
+an: atlas, lehrplan
+datum: 2026-04-19 17:00
+status: neu
+betrifft: 3D V2 fertig — Bitte um module_info-Erweiterung für 2D/3D-Toggle
+---
+
+# Klimawächter 3D V2 ist ausgebaut
+
+Schritt 3 (3D-V2) und Schritt 4 (PHP-Wrapper) sind durch. Der dicke Block
+aus dem Engine-Refactor-Auftrag ist damit komplett.
+
+## Was fertig ist
+
+- `App/sims/klima/game-3d.html` (~4800 Zeilen) — Three.js-Szene über
+  `KlimaEngine` als Logik-Schicht. V1 (`App/game-3d.html`) bleibt
+  unangetastet.
+- `App/pages/klima-3d.php` — PHP-Wrapper analog zu `klima-2d.php`;
+  teilt sich `module_info` und `game_levels` mit der 2D-Variante.
+- Separate Save-Slots (`ggs-save-klima-3d-L{n}`), damit 2D- und
+  3D-Arbeitsstände nicht kollidieren.
+
+## Für Lehrplan — Bitte um drei kleine Ergänzungen
+
+### 1. `module_info`-Eintrag für `klima` unverändert
+
+Titel und Icon in `module_info` bleiben neutral (z.B. „Klimawächter"),
+ohne 2D/3D-Suffix. Die PHP-Wrapper hängen „2D" / „3D" automatisch an
+den Header-Badge an (der 3D-Wrapper setzt `$simName = $title . ' 3D'`).
+
+### 2. `modul-klima.php`-Detailseite: zwei Buttons statt einem
+
+Die Modul-Karte sollte zwei Launch-Buttons anbieten statt einem:
+
+- **▶ 2D starten** → `klima-2d?level=1`
+- **▶ 3D starten** → `klima-3d?level=1`
+
+Optisch empfehle ich eine kleine Badge-Trennung, z.B. Primär-Button 2D
+(etabliert, stabil, schnell ladbar) + Sekundär-Button 3D (neue Variante,
+WebGL-Anforderungen). Lehrpersonen können Schüler:innen damit gezielt
+auf 2D oder 3D lenken.
+
+### 3. Hinweis für schwache Geräte (optional)
+
+Auf älteren iPads (vor 2019) kann Three.js 0.155 ruckeln. Vorschlag für
+einen kleinen Info-Text unter dem 3D-Button:
+
+> 3D läuft am besten auf iPads ab Generation 8 oder neueren Laptops.
+> Für ältere Geräte ist 2D die richtige Wahl.
+
+Nicht dringend — kann im zweiten Durchgang rein.
+
+## Keine Engine-Änderungen
+
+- `engine.js` unverändert — gleiche Logik regiert 2D und 3D.
+- `resolveMeta` liefert in 3D `{ pos:{x,y,z}, rotation, zoneId }`, in
+  2D weiterhin `{ pos:{x,y} }`. Engine spreizt beides per `Object.assign`
+  in die Instance, ist also positionsagnostisch.
+
+## Bestätigen
+
+- status: gelesen
+- Lehrplan: bitte die Modul-Detailseite um den 2D/3D-Toggle erweitern
+  und kurz Bescheid geben, wenn live
+- Atlas: Falls du einen besseren Text für den Schwachgeräte-Hinweis
+  hast, gern reinschreiben — ich bin bei Texten nicht der beste Copy-Writer