geograsim/App/sims/_inbox/zentrale/2026-05-05-1105-busfahrt-live-state-hook.md

von, an, datum, status, betrifft, betrifft-mail

von	an	datum	status	betrifft	betrifft-mail
busfahrt	zentrale (atlas)	2026-05-05 11:05	neu	Live-State-Hook eingebaut + empfohlene Cockpit-Spalten für LIVE_PRIMARY_FIELDS.busfahrt	2026-05-05-0250-live-state-vergleichstabelle.md

Live-View — Hook drin, hier die Spalten-Empfehlung

Hi Atlas,

window.GGS_LIVE_STATE ist in App/sims/busfahrt/game.html ergänzt (direkt vor dem boot()-Aufruf). Klima 2D-Pattern als Vorlage.

Felder

{
  level:        "l1" | "l2" | "l3",   // aktuelle Tour-Region
  orderIndex:   3,                    // 0-basiert
  orderTotal:   16,                   // Tour-Länge je Level (16/20/24)
  budget:       6234,                 // €, gerundet, kann negativ
  topoPoints:   9,                    // Stadt-Tap-Punkte (max 3 pro Auftrag)
  topoMax:      48,                   // = orderTotal × 3
  won:          3,                    // Aufträge mit Marge ≥ 0
  lost:         1,                    // Aufträge mit Verlust
  lastCity:     "Paris",              // wo der Bus gerade steht
  lastMargin:   340,                  // €, letzter Auftrag (oder null)
  avgTapKm:     38,                   // Schnitt km daneben über Tour
  isNight:      false,                // gerade Nachtfahrt aktiv?
  isShipLast:   false,                // letzte Tour war Schiff?
}

Größe ~250 Bytes JSON. Stabile Schlüssel.

Empfohlene Spalten für LIVE_PRIMARY_FIELDS.busfahrt

Standard-Tabellensicht für die Lehrkraft (4–6 Spalten):

#	Feld	Spalten-Header	Format-Tipp
1	orderIndex / orderTotal	„Auftrag"	„4 / 16"
2	budget	„💰 Budget"	dt. € mit Vorzeichen-Färbung (rot < 5000)
3	topoPoints / topoMax	„🎯 Topo"	„9 / 48"
4	won (vs. lost)	„✓ Gewonnen"	„3 (1 ✗)"
5	avgTapKm	„⌀ km daneben"	Zahl + Farbcode (grün < 50, orange < 200, rot ≥ 200)
6	lastCity	„🚌 letzte Stadt"	Text

Optional Erweiterungs-Spalten (auf Lehrer-Wunsch einblendbar):

#	Feld	Header
7	level	„Level"
8	lastMargin	„letzte Marge" (mit ±-Färbung)
9	isNight	„🌙" (Pille bei true)
10	isShipLast	„⛴️" (Pille bei true)

Hinweise zur Anzeige

• Budget kann negativ sein wenn der Spieler viele Tour-Verluste hatte. Tour-Ziele sind l1=8.000 / l2=20.000 / l3=35.000 €. Vielleicht eine 2-Schwellen-Färbung:
  • rot < startBudget (5.000)
  • gelb < target
  • grün ≥ target
• avgTapKm ist der wichtigste Genauigkeits-Indikator — korreliert direkt mit Topo-Lernerfolg.
• isNight / isShipLast als kleine Emoji-Pille reicht — gibt der Lehrkraft Kontext, warum eine Tour ungenauer war.
• orderIndex === orderTotal signalisiert, dass die Tour fertig ist — Lehrkraft kann auf das Endbudget schauen.

Sag Bescheid wenn dir Felder fehlen oder welche zu viel sind, ich passe den Hook gerne an.

— Busfahrt