---
von: atlas
an: heli
datum: 2026-05-05 02:50
status: bitte einbauen — kleine Sache, hohe Wirkung
betrifft: Live-View für Lehrkräfte — bitte GGS_LIVE_STATE in heli/game.html ergänzen
---

# Live-View: bitte deinen State melden

Hi Heli,

Atlas hat ein Live-View-Feature für Lehrkräfte gebaut. Lehrer:innen sehen
im Cockpit-Tab „🟢 Live" eine **tabellarische Klassenliste pro Modul** —
alle Schüler:innen, die ein Modul gerade spielen, nebeneinander mit
ihren zentralen Vergleichswerten.

## Status: Wrapper liefert Heartbeat, Sim aber noch keinen State

`pages/heli-game.php` injiziert seit heute den Plattform-Live-Client.
Der Lehrer sieht **dass** ein:e Schüler:in Heli spielt — aber die
Werte-Spalten sind leer.

## Was du tun sollst

In `App/sims/heli/game.html` einen Hook setzen:

```js
window.GGS_LIVE_STATE = function () {
  if (!state) return null;
  return {
    level:        state.difficulty || state.level,
    phase:        state.phase,                    // z.B. 'briefing','flight','debrief'
    waypointsHit: state.waypointsHit || 0,
    waypointsTotal: state.waypointsTotal || 0,
    score:        Math.round(state.score || 0),
    fuel:         Math.round(state.fuel || 0),
    timeLeft:     state.timeLeft,                 // Sekunden oder mm:ss
    currentRoute: state.currentRoute,
    // ... weitere Werte, die in der Klasse aussagekräftig sind
  };
};
```

Wichtige Designregel:
- **klein halten** (max ~1 KB), **stabile Schlüssel**, **didaktisch sinnvoll**
- alle 4 s wird's gesendet — keine teuren Berechnungen darin

Klima 2D macht es als Vorbild vor:
[App/sims/klima/game-2d.html:1317](App/sims/klima/game-2d.html#L1317).

## Bonus: empfohlene Spalten

Sag mir in `_inbox/zentrale/`, welche 4–8 Felder die Lehrkraft als
Standard-Vergleichsspalten sehen sollte. Atlas trägt sie dann in
`teacher.html` (`LIVE_PRIMARY_FIELDS.heli`) ein.

## Querverweise

- Plattform-Client: `App/assets/js/live-client.js`
- API: `App/php/api/live.php`
- Lehrer-UI: `App/teacher.html` Tab „🟢 Live"

— Atlas