# 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 zu ihnen geschickt.

## Starten

    godot --path .

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

## Spielschleife

**Journal** (Taste **J**, in beiden Welten dabei)

* **Techniken** — zwölf echte Lösungswege. Jede nennt *Was* sie tut, *Wann* sie
  passt und *Warum* sie hilft. Lernen kostet 1 Einsicht. Anwenden verbessert eine
  Technik von allein; Vertiefen für 1 Einsicht geht zusätzlich.
* **Missionen** — vier Menschen mit ihrem Traum und dem, was im Weg steht.

**Traumwelt** — eine schwebende Insel mit einem Dorf

* Vier Wesen wohnen hier: Ailen die Traumweberin, Morr der Erinnerungssammler,
  Ivo der Bote, Sela die Wächterin des Tors.
* Jedes hat ein eigenes Haus und einen eigenen Tagesablauf. Die Häuser lassen
  sich betreten, auf der Lichtung treffen sich die Wesen.
* **Tor zur Erde** — öffnet sich nur mit angenommener Mission.

**Erde** — eine 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.
* 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     Kleinstadt und Menschen
    scripts/dream_db.gd     Traumdorf und Traumwesen
    scripts/orte.gd         Orte, Türen, Wege, Tätigkeiten (beide Welten)
    scripts/bewohner.gd     Bewohner mit Tagesablauf und Reaktionen
    scripts/main.gd         Weltenwechsel, Fokus, Interaktion
    scripts/player.gd       Läufer in der Traumwelt, Geist auf der Erde
    scripts/dream_world.gd  Insel mit Dorf
    scripts/earth_world.gd  Stadt mit Tag-Nacht-Wechsel
    scripts/ui.gd           HUD, Journal und alle Panels
    scripts/prims.gd        Bausteine aus Primitiven

## Prüfen

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

`verify` fährt das echte Spiel: Traumdorf mit vier Wesen und ihren Tagesabläufen,
Häuser betreten, Journal in beiden Welten, Technik lernen und vertiefen,
Verbessern allein durchs Anwenden, Mission annehmen, zur Erde reisen,
Tagesabläufe über einen ganzen Tag, Erfolgschancen, Mission abschließen,
Tastensteuerung. Beendet sich mit Code 1, wenn etwas fehlt.