Phase 3: Charakter-Anlage + Viadukt-Set-Piece mit Wren-Moment

- Charakter-Anlage (character_creation.tscn): Namenseingabe mit Default
  Tyrveil, Enter/confirm bestaetigt, cancel zurueck; Controller nutzt den
  Tastatur-Fallback mit bestaetigbarem Default (virtuelle Tastatur bewusst
  ausgelassen, nur Mobile/Web nativ); Name in GameState.player_name,
  erscheint in der Dialog-Box
- Neues Spiel: Hauptmenue -> Charakter-Anlage -> Viadukt -> (Platzhalter-
  Uebergang) Reiterquadrant; Fortsetzen unveraendert
- Viadukt (scenes/viaduct): vier kurze Segmente - schmaler Steg mit
  Sprung-Luecke und Gelaender-Stuecken, Kletter-Engstelle (Mechanik aus
  Phase 1b), Wren-Moment, Endplattform mit Uebergang; cineastischer
  Kamera-Schwenk beim Betreten (player.play_camera_pan, SPEC 2)
- Wren-Moment: nicht abbrechbarer Entscheidungspunkt ueber das bestehende
  Dialog-System (can_abort:false sperrt cancel UND dialogue_abort);
  beide Optionen retten Wren (fixer Ausgang laut STORY.md), Klinge/Herz
  -10/+10, Beziehung +1/+3, Wahl als Story-Flag viaduct_wren_rescue
  (neues gespeichertes story_flags-Muster im GameState)
- Permadeath: KillZone unter dem Steg - AN: Game Over ins Hauptmenue,
  AUS: Respawn am zuletzt erreichten Segment-Checkpoint
- DialogueSystem: story_flag-Options-Tag, is_abort_allowed,
  Spielername aus GameState in der Box
- .idea/ in .gitignore aufgenommen
- Headless verifiziert (23 Checks): Namensfluss, Pan-Sperre, Respawn,
  Abbruch-Sperre im Wren-Moment, beide Pfade inkl. Flags, Endübergang,
  Game Over bei Permadeath AN

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-05 12:15:32 +02:00
parent f0cd59c1e3
commit 3cdf5f6ac5
13 changed files with 630 additions and 10 deletions

View file

@ -16,7 +16,12 @@ extends Node
## Dialog ab; Tyrveil sagt dem Gegenüber dabei eine zufällig gewählte
## Zeile aus dem abort_lines-Array der Dialog-Datei an (Fallback:
## abort_line bzw. Standard) — so klingt der Abschied pro Charakter
## unterschiedlich. Abgebrochene Dialoge gelten nur dann als geführt, wenn in diesem
## unterschiedlich. Dialoge mit "can_abort": false (z. B. der
## Wren-Moment am Viadukt) sind nicht abbrechbar: Der Spieler muss eine
## Option wählen, bevor die Szene fortschreitet. Options-Tag story_flag
## (Flag-Name -> Wert) schreibt Story-Flags in den GameState (z. B. WIE
## Wren gerettet wurde). Der Anzeigename des Spielers in der Box kommt
## aus GameState.player_name (Charakter-Anlage). Abgebrochene Dialoge gelten nur dann als geführt, wenn in diesem
## Durchlauf bereits Options-Effekte angewendet wurden — so bleibt der
## Erst-Durchlauf-Effekt erhalten, ohne dass Abbrechen zum Werte-Farming
## taugt. dialogue_started/dialogue_finished erlauben es, Spielerbewegung
@ -31,6 +36,7 @@ const FALLBACK_LINE_SECONDS := 2.5
const DEFAULT_ABORT_LINE := "Nicht jetzt. Wir reden später weiter."
var is_dialogue_active := false
var is_abort_allowed := true
var _speakers: Dictionary = {}
var _speaker_names: Dictionary = {}
@ -60,6 +66,7 @@ func start_dialogue(dialogue_path: String, speakers: Dictionary) -> void:
_abort_lines = data.get("abort_lines", [])
if _abort_lines.is_empty():
_abort_lines = [str(data.get("abort_line", DEFAULT_ABORT_LINE))]
is_abort_allowed = bool(data.get("can_abort", true))
is_dialogue_active = true
dialogue_started.emit(dialogue_id)
_run_dialogue(data)
@ -68,7 +75,7 @@ func start_dialogue(dialogue_path: String, speakers: Dictionary) -> void:
## Merkt einen Abbruch-Wunsch (cancel) während laufender Dialog-Zeilen
## vor; offene Antwortauswahlen behandelt die Dialog-Box selbst.
func _unhandled_input(event: InputEvent) -> void:
if not is_dialogue_active:
if not is_dialogue_active or not is_abort_allowed:
return
if _box != null and _box.has_open_options():
return
@ -188,6 +195,10 @@ func _apply_option_effects(option: Dictionary) -> void:
for npc_id in relationship_shifts:
RelationshipSystem.adjust_relationship(str(npc_id), int(relationship_shifts[npc_id]))
_has_applied_effects = true
var flag_changes: Dictionary = option.get("story_flag", {})
for flag_name in flag_changes:
GameState.set_story_flag(str(flag_name), flag_changes[flag_name])
_has_applied_effects = true
## Spielt eine zufällig gewählte Abbruch-Zeile Tyrveils, damit der
@ -229,9 +240,12 @@ func _bubble_for(speaker_id: String) -> Node:
return bubble
## Liefert den Anzeigenamen eines Sprechers aus der speakers-Map der
## Dialog-Datei, sonst die großgeschriebene Sprecher-ID.
## Liefert den Anzeigenamen eines Sprechers: für den Spieler den in der
## Charakter-Anlage gewählten Namen, sonst den Eintrag aus der
## speakers-Map der Dialog-Datei bzw. die großgeschriebene Sprecher-ID.
func _display_name(speaker_id: String) -> String:
if speaker_id == PLAYER_SPEAKER_ID:
return GameState.player_name
return str(_speaker_names.get(speaker_id, speaker_id.capitalize()))

View file

@ -23,7 +23,9 @@ const HUMANITY_MAX := 100
const DEFAULT_STRENGTH := 35
const DEFAULT_AGILITY := 35
const DEFAULT_INTELLECT := 15
const DEFAULT_PLAYER_NAME := "Tyrveil"
var player_name := DEFAULT_PLAYER_NAME
var strength := DEFAULT_STRENGTH
var agility := DEFAULT_AGILITY
var intellect := DEFAULT_INTELLECT
@ -31,11 +33,13 @@ var blade_heart_tone := 0
var humanity := 0
var relationships: Dictionary = {}
var completed_dialogues: Dictionary = {}
var story_flags: Dictionary = {}
var is_permadeath_enabled := true
## Setzt alle Werte auf die Startwerte eines neuen Spiels zurück.
func reset() -> void:
player_name = DEFAULT_PLAYER_NAME
strength = DEFAULT_STRENGTH
agility = DEFAULT_AGILITY
intellect = DEFAULT_INTELLECT
@ -43,6 +47,7 @@ func reset() -> void:
humanity = 0
relationships.clear()
completed_dialogues.clear()
story_flags.clear()
is_permadeath_enabled = true
blade_heart_tone_changed.emit(blade_heart_tone)
@ -110,9 +115,22 @@ func has_completed_dialogue(dialogue_id: String) -> bool:
return completed_dialogues.get(dialogue_id, false)
## Setzt ein Story-Flag (z. B. wie Wren am Viadukt gerettet wurde) —
## gleiches gespeichertes Muster wie completed_dialogues, damit spätere
## Phasen darauf reagieren können.
func set_story_flag(flag_name: String, value: Variant) -> void:
story_flags[flag_name] = value
## Liest ein Story-Flag, default wenn es nicht gesetzt ist.
func get_story_flag(flag_name: String, default: Variant = null) -> Variant:
return story_flags.get(flag_name, default)
## Serialisiert den kompletten Zustand als Dictionary für das SaveSystem.
func to_save_dict() -> Dictionary:
return {
"player_name": player_name,
"strength": strength,
"agility": agility,
"intellect": intellect,
@ -120,6 +138,7 @@ func to_save_dict() -> Dictionary:
"humanity": humanity,
"relationships": relationships.duplicate(),
"completed_dialogues": completed_dialogues.duplicate(),
"story_flags": story_flags.duplicate(),
"is_permadeath_enabled": is_permadeath_enabled,
}
@ -129,6 +148,9 @@ func to_save_dict() -> Dictionary:
## normalisiert und alle Werte geklemmt; Änderungs-Signale werden nach dem
## Laden ausgelöst.
func apply_save_dict(data: Dictionary) -> void:
player_name = str(data.get("player_name", DEFAULT_PLAYER_NAME))
if player_name.strip_edges().is_empty():
player_name = DEFAULT_PLAYER_NAME
strength = clampi(int(data.get("strength", DEFAULT_STRENGTH)), STAT_MIN, STAT_MAX)
agility = clampi(int(data.get("agility", DEFAULT_AGILITY)), STAT_MIN, STAT_MAX)
intellect = clampi(int(data.get("intellect", DEFAULT_INTELLECT)), STAT_MIN, STAT_MAX)
@ -143,6 +165,10 @@ func apply_save_dict(data: Dictionary) -> void:
var saved_dialogues: Dictionary = data.get("completed_dialogues", {})
for dialogue_id in saved_dialogues:
completed_dialogues[String(dialogue_id)] = bool(saved_dialogues[dialogue_id])
story_flags.clear()
var saved_flags: Dictionary = data.get("story_flags", {})
for flag_name in saved_flags:
story_flags[String(flag_name)] = saved_flags[flag_name]
blade_heart_tone_changed.emit(blade_heart_tone)
for npc_id in relationships:
relationship_changed.emit(npc_id, relationships[npc_id])

View file

@ -46,9 +46,15 @@ const CLIMB_LANDING_INSET := 0.35
const CLIMB_HEADROOM := 1.7
const CLIMB_DURATION := 0.4
const CLIMB_VERTICAL_PHASE := 0.6
const PAN_START_YAW := 2.4
const PAN_START_PITCH := -0.55
const PAN_START_ZOOM := 14.0
const PAN_END_PITCH := -0.35
const PAN_DURATION := 3.0
var _state := MovementState.NORMAL
var _is_dialogue_locked := false
var _is_panning := false
var _target_zoom := 9.0
var _gravity: float = ProjectSettings.get_setting("physics/3d/default_gravity")
var _slide_direction := Vector3.ZERO
@ -115,13 +121,36 @@ func _physics_process(delta: float) -> void:
## Hält den Spieler während eines Dialogs an: Schwerkraft und Auslaufen
## bleiben aktiv, Eingaben für Bewegung, Sprung, Slide und Look nicht.
## Während eines Kamera-Schwenks steuert der Tween die SpringArm-Länge,
## nicht die Zoom-Glättung.
func _process_dialogue_lock(delta: float) -> void:
if not is_on_floor():
velocity.y -= _gravity * delta
velocity.x = move_toward(velocity.x, 0.0, STOP_SPEED * delta)
velocity.z = move_toward(velocity.z, 0.0, STOP_SPEED * delta)
move_and_slide()
_apply_zoom_smoothing(delta)
if not _is_panning:
_apply_zoom_smoothing(delta)
## Spielt einen kurzen cineastischen Kamera-Schwenk für Set-Pieces
## (SPEC Abschnitt 2): Die Kamera startet weit draußen und seitlich und
## fährt weich in die Standard-Third-Person-Ansicht zurück; die Steuerung
## ist für die Dauer gesperrt.
func play_camera_pan(duration := PAN_DURATION) -> void:
_is_dialogue_locked = true
_is_panning = true
_camera_pivot.rotation.y = PAN_START_YAW
_spring_arm.rotation.x = PAN_START_PITCH
_spring_arm.spring_length = PAN_START_ZOOM
_target_zoom = 9.0
var tween := create_tween().set_parallel(true).set_trans(Tween.TRANS_SINE).set_ease(Tween.EASE_IN_OUT)
tween.tween_property(_camera_pivot, "rotation:y", 0.0, duration)
tween.tween_property(_spring_arm, "rotation:x", PAN_END_PITCH, duration)
tween.tween_property(_spring_arm, "spring_length", _target_zoom, duration)
await tween.finished
_is_panning = false
_is_dialogue_locked = false
## Sperrt Bewegung und Look bei Dialogbeginn; ein laufender Slide endet

View file

@ -0,0 +1,67 @@
extends Node3D
## Ablauf-Steuerung des Viadukt-Set-Pieces (Phase 3, STORY.md Prolog).
##
## Spielt beim Betreten den cineastischen Kamera-Schwenk (SPEC Abschnitt
## 2), verwaltet die Checkpoints der Segmente und die KillZone unter dem
## Steg: Bei Permadeath AN führt ein Sturz zum Game Over (zurück ins
## Hauptmenü), bei Permadeath AUS zum Respawn am zuletzt erreichten
## Segment-Anfang. Der Wren-Moment (Segment 3) startet einmalig beim
## Betreten des Trigger-Bereichs als nicht abbrechbarer Dialog
## (viaduct_wren.json) — beide Optionen retten Wren, die Wahl landet als
## Story-Flag im GameState. Der Übergang am Ende ist ein Platzhalter
## Richtung Reiterquadrant; Ankunft und Squad-Logik folgen später.
const MAIN_MENU_SCENE := "res://scenes/ui/main_menu.tscn"
const WREN_DIALOGUE_PATH := "res://data/dialogue/viaduct_wren.json"
var _checkpoint_position := Vector3.ZERO
var _has_wren_triggered := false
@onready var _wren: Node3D = $Wren
## Merkt den Startpunkt als ersten Checkpoint, verbindet Checkpoints,
## KillZone und Wren-Trigger und spielt den Kamera-Schwenk.
func _ready() -> void:
var player := get_tree().get_first_node_in_group("player")
if player != null:
_checkpoint_position = player.global_position
player.play_camera_pan()
for checkpoint in $Checkpoints.get_children():
checkpoint.body_entered.connect(_on_checkpoint_entered.bind(checkpoint))
$KillZone.body_entered.connect(_on_kill_zone_entered)
$WrenTrigger.body_entered.connect(_on_wren_trigger_entered)
## Setzt den Respawn-Punkt auf den erreichten Segment-Anfang.
func _on_checkpoint_entered(body: Node3D, checkpoint: Area3D) -> void:
if not body.is_in_group("player"):
return
_checkpoint_position = Vector3(checkpoint.global_position.x, 0.1, checkpoint.global_position.z)
## Sturz in den Abgrund: Game Over bei Permadeath AN, sonst Respawn am
## letzten Checkpoint.
func _on_kill_zone_entered(body: Node3D) -> void:
if not body.is_in_group("player"):
return
if GameState.is_permadeath_enabled:
print("Game Over — das Viadukt fordert seinen Preis.")
Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE)
get_tree().change_scene_to_file.call_deferred(MAIN_MENU_SCENE)
return
body.velocity = Vector3.ZERO
body.global_position = _checkpoint_position
## Startet den Wren-Moment einmalig als nicht abbrechbaren Dialog.
func _on_wren_trigger_entered(body: Node3D) -> void:
if not body.is_in_group("player"):
return
if _has_wren_triggered or DialogueSystem.is_dialogue_active:
return
_has_wren_triggered = true
DialogueSystem.start_dialogue(WREN_DIALOGUE_PATH, {
"wren": _wren,
DialogueSystem.PLAYER_SPEAKER_ID: body,
})

View file

@ -0,0 +1 @@
uid://b5770kb2okfgx

View file

@ -0,0 +1,77 @@
extends Control
## Charakter-Anlage (Phase 3): Eingabe von Tyrveils Anzeigenamen, wird
## nach "Neues Spiel" vor dem Viadukt-Prolog aufgerufen.
##
## Tastatur: Name direkt eintippen, Enter bestätigt. Controller:
## Fokus-Navigation (D-Pad/Stick) plus confirm bestätigt den eingegebenen
## bzw. Default-Namen, cancel führt zurück ins Hauptmenü. Auf eine
## virtuelle Controller-Tastatur wird bewusst verzichtet: Godots
## eingebaute Bildschirmtastatur existiert nur auf Mobile/Web, eine
## eigene wäre für den Vertical Slice unverhältnismäßig — der
## Tastatur-Fallback mit bestätigbarem Default-Namen deckt beide
## Eingabewege ab. Der Name landet in GameState.player_name und erscheint
## u. a. in der Dialog-Box.
const VIADUCT_SCENE := "res://scenes/viaduct/viaduct.tscn"
const MAIN_MENU_SCENE := "res://scenes/ui/main_menu.tscn"
var _is_leaving := false
@onready var _name_edit: LineEdit = $CenterContainer/VBoxContainer/NameEdit
@onready var _confirm_button: Button = $CenterContainer/VBoxContainer/Buttons/ConfirmButton
@onready var _back_button: Button = $CenterContainer/VBoxContainer/Buttons/BackButton
## Gibt die Maus frei, füllt den Default-Namen ein und setzt den Fokus in
## das Eingabefeld.
func _ready() -> void:
Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE)
_name_edit.text = GameState.DEFAULT_PLAYER_NAME
_name_edit.caret_column = _name_edit.text.length()
_name_edit.text_submitted.connect(_on_name_submitted)
_confirm_button.pressed.connect(_on_confirm_pressed)
_back_button.pressed.connect(_on_back_pressed)
_name_edit.grab_focus.call_deferred()
## Controller-Bestätigung (Ⓐ/✕) übernimmt den Namen bzw. aktiviert den
## fokussierten Button; cancel führt zurück ins Hauptmenü. Enter läuft
## über LineEdit (text_submitted) bzw. ui_accept der Buttons.
func _unhandled_input(event: InputEvent) -> void:
if _is_leaving:
return
if event.is_action_pressed("cancel"):
_on_back_pressed()
return
if not event.is_action_pressed("confirm"):
return
if event.is_action("ui_accept"):
return
var focused := get_viewport().gui_get_focus_owner()
if focused == _back_button:
_on_back_pressed()
else:
_on_confirm_pressed()
## Enter im Eingabefeld bestätigt den Namen.
func _on_name_submitted(_text: String) -> void:
_on_confirm_pressed()
## Übernimmt den Namen (leer -> Default) und startet das Viadukt.
func _on_confirm_pressed() -> void:
if _is_leaving:
return
_is_leaving = true
var chosen := _name_edit.text.strip_edges()
GameState.player_name = chosen if not chosen.is_empty() else GameState.DEFAULT_PLAYER_NAME
get_tree().change_scene_to_file(VIADUCT_SCENE)
## Zurück ins Hauptmenü, ohne den GameState anzufassen.
func _on_back_pressed() -> void:
if _is_leaving:
return
_is_leaving = true
get_tree().change_scene_to_file(MAIN_MENU_SCENE)

View file

@ -0,0 +1 @@
uid://bxcrf1rspx0he

View file

@ -60,6 +60,8 @@ func _unhandled_input(event: InputEvent) -> void:
if not has_open_options():
return
if event.is_action_pressed("cancel") or event.is_action_pressed("dialogue_abort"):
if not DialogueSystem.is_abort_allowed:
return
_clear_options()
option_chosen.emit(ABORT_INDEX)
return

View file

@ -10,7 +10,8 @@ extends Control
## auf den Beenden-Button. Die Aktivierung läuft explizit über die
## Input-Map-Action confirm und hängt nicht an Godots internem ui_accept.
const GAME_SCENE := "res://scenes/hub/rider_quadrant.tscn"
const CREATION_SCENE := "res://scenes/ui/character_creation.tscn"
const CONTINUE_SCENE := "res://scenes/hub/rider_quadrant.tscn"
@onready var _start_button: Button = $CenterContainer/VBoxContainer/StartButton
@onready var _continue_button: Button = $CenterContainer/VBoxContainer/ContinueButton
@ -56,17 +57,17 @@ func _handle_confirm(event: InputEvent) -> void:
## Startet ein neues Spiel mit frisch zurückgesetztem GameState und
## Tageszyklus.
## Tageszyklus: erst Charakter-Anlage, von dort geht es aufs Viadukt.
func _on_start_pressed() -> void:
GameState.reset()
TimeSystem.reset()
get_tree().change_scene_to_file(GAME_SCENE)
get_tree().change_scene_to_file(CREATION_SCENE)
## Lädt den Spielstand und wechselt bei Erfolg in die Testszene.
## Lädt den Spielstand und wechselt bei Erfolg in den Reiterquadranten.
func _on_continue_pressed() -> void:
if SaveSystem.load_game():
get_tree().change_scene_to_file(GAME_SCENE)
get_tree().change_scene_to_file(CONTINUE_SCENE)
## Beendet das Spiel.