# Traumwandler

Ein 3D-Spiel in Godot 4.7 (GDScript). Alle Objekte bestehen aus Godot-Primitiven
(Box, Zylinder, Kugel, Kapsel) — kein externes Asset.

Du bist ein Wesen aus der Traumwelt. Menschen tragen Träume mit sich herum, die
sie allein nicht bewegt bekommen. Du wirst auf die Erde geschickt, um zu helfen.

## Starten

    godot --path .

Steuerung: **WASD** bewegen · **Maus** umsehen · **E** interagieren ·
**Tab** Kodex · **Esc** Maus freigeben.
Auf der Erde zusätzlich **Leertaste** steigen und **Umschalt** sinken.

## Spielschleife

**Traumwelt** (Insel mit drei betretbaren Gebäuden)

* **Bibliothek der Techniken** — zwölf echte Lösungswege. Jede Technik nennt
  *Was* sie tut, *Wann* sie passt und *Warum* sie hilft. Lernen kostet 1 Einsicht.
* **Missionshalle** — vier Menschen mit ihrem Traum und dem, was im Weg steht.
  Eine Mission annehmen.
* **Meditationskammer** — eine gelernte Technik für 1 Einsicht vertiefen (+3 EP).
* **Tor zur Erde** — öffnet sich nur mit angenommener Mission.

**Erde** (Kleinstadt, ein Tag dauert 6 Minuten)

* Du bist ein unsichtbarer Geist, schwebst und gehst durch Wände.
* Vier Menschen leben ihren Tagesablauf: schlafen, arbeiten, grübeln, essen,
  spazieren. Jeder Ort und jede Tätigkeit steht fest.
* Nah herangehen, **E** drücken, Technik wählen. Das Panel zeigt für jede
  Technik die Erfolgschance in genau dieser Situation.
* Die Säule im Park bringt dich zurück in die Traumwelt.

## Erfolgschance

    8 % + 11 % je Fertigkeitsstufe
      + 25 %  wenn die Technik das Thema des Menschen trifft
      + 22 %  wenn der Moment passt (z. B. Box-Atmung, während jemand angespannt ist)
      − 30 %  wenn der Mensch gerade abblockt
    begrenzt auf 5 … 95 %

Schlafende sind nicht erreichbar. Erfolg bringt Fortschritt und 2 EP, ein
Fehlversuch 1 EP und eine kurze Sperre. Dieselbe Technik wirkt bei Wiederholung
schwächer — es lohnt sich, mehrere zu lernen. 100 % erfüllen den Traum und
bringen 3 Einsicht zurück.

## Aufbau

    project.godot          Projekt, Autoload `Game`
    scenes/main.tscn       Einstieg
    scripts/game.gd        Zustand, Regeln, Uhr (Autoload)
    scripts/technique_db.gd  die zwölf Techniken mit ihren Hinweisen
    scripts/human_db.gd    Orte, Menschen, Tagesabläufe, Wegfindung
    scripts/main.gd        Weltenwechsel, Fokus, Interaktion
    scripts/player.gd      Läufer in der Traumwelt, Geist auf der Erde
    scripts/human.gd       Mensch mit Tagesablauf und Reaktionen
    scripts/dream_world.gd Traumwelt inklusive Innenräume
    scripts/earth_world.gd Stadt mit Tag-Nacht-Wechsel
    scripts/ui.gd          HUD und alle Panels
    scripts/prims.gd       Bausteine aus Primitiven

## Prüfen

    godot --headless --path . tests/verify.tscn   # 81 Prüfungen der Spiellogik
    godot --path . tests/shots.tscn               # 16 Screenshots nach user://shots/

`verify` fährt das echte Spiel: Gebäude betreten, Technik lernen, Mission
annehmen, zur Erde reisen, Tagesabläufe über einen ganzen Tag, Erfolgschancen,
Mission abschließen, Tastensteuerung. Beendet sich mit Code 1, wenn etwas fehlt.