Phase 1b: Slide + Klettern, TimeSystem, Greybox-Hub mit Zonen-Wechsel

- player.gd: Zustandsmaschine NORMAL/SLIDING/CLIMBING; Slide ueber
  slide-Action mit geschwindigkeitsabhaengigem Impuls und reduzierter
  Kapselhoehe (Shape wird dupliziert, geteilte NPC-Shapes bleiben
  unberuehrt), kein Slide im Stand; Sprung ueber jump-Action; automatisches
  Hochziehen an Kanten bis 2,2 m per Raycast-Kantenerkennung mit
  Kopffreiheits-Check
- TimeSystem: Slots Vormittag/Nachmittag/Abend, advance_slot() mit Signal,
  end_day() (Schlafsaal) erhoeht Tageszaehler, In-Memory ohne Save-Anbindung
- Greybox-Hub: rider_quadrant (Start, Imogen zieht hierher um), dormitory
  (Schlaf-Trigger beendet Tag), classroom; ZoneTrigger mit
  Spawn-Punkt-Handling, Uebergaenge zwischen allen drei Raeumen
- Player und Debug-Overlay als eigene Szenen extrahiert; test_ground bleibt
  reine Bewegungs-Testszene ohne Imogen
- Hauptmenue laedt rider_quadrant, Neues Spiel resettet auch TimeSystem
- Debug-Overlay: Tages-Slot, Tageszaehler und Bewegungszustand
- Headless verifiziert: Klettern, Slide (Hoehe/Ende), Slide-Verbot im
  Stand, Spawn-Platzierung, Trigger-Erkennung, Szenen-Boots

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-04 16:55:06 +02:00
parent ec8e1fa665
commit 806d938ada
17 changed files with 1226 additions and 141 deletions

View file

@ -0,0 +1,30 @@
extends Node3D
## Gemeinsame Ablauf-Steuerung der Greybox-Hub-Räume (Phase 1b).
##
## Platziert den Spieler nach einem Zonen-Wechsel am vom ZoneTrigger
## angeforderten Spawn-Punkt (Kind des SpawnPoints-Nodes, benannt nach dem
## Herkunfts-Raum), damit niemand im Boden oder in einem Trigger spawnt.
## Interims-Lösung wie in der Testszene, bis eine echte Menü-Führung
## existiert: Die menu-Action speichert und kehrt ins Hauptmenü zurück.
const MAIN_MENU_SCENE := "res://scenes/ui/main_menu.tscn"
## Setzt den Spieler auf den vom Zonen-Wechsel angeforderten Spawn-Punkt.
func _ready() -> void:
var spawn_name := ZoneTrigger.consume_pending_spawn()
if spawn_name.is_empty():
return
var spawn := get_node_or_null("SpawnPoints/%s" % spawn_name) as Node3D
var player := get_tree().get_first_node_in_group("player") as Node3D
if spawn == null or player == null:
push_warning("Spawn-Punkt '%s' oder Spieler nicht gefunden." % spawn_name)
return
player.global_position = spawn.global_position
## Speichert bei menu und wechselt zurück ins Hauptmenü.
func _unhandled_input(event: InputEvent) -> void:
if event.is_action_pressed("menu"):
SaveSystem.save_game()
get_tree().change_scene_to_file(MAIN_MENU_SCENE)

View file

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

View file

@ -1,17 +1,25 @@
extends CharacterBody3D
## Greybox-Spielersteuerung für Phase 0.
## Greybox-Spielersteuerung (Phase 0 + Movement-Upgrade Phase 1b).
##
## Bewegt die Spieler-Kapsel relativ zur Kamera (WASD + linker Stick),
## unterstützt Sprint und steuert die weit rausgezoomte Third-Person-Kamera
## im WoW-Stil: Orbit über Maus und rechten Stick, Zoom über Mausrad und
## Schultertasten, Kollision über SpringArm3D. Die Actions look_x/look_y
## sind in der Input-Map registriert; Mausbewegung ist in Godot nicht auf
## Actions mappbar und wird deshalb direkt als InputEventMouseMotion
## gelesen, der rechte Stick direkt über die Joypad-Achsen (Deadzone 0.2).
## Bewegt die Spieler-Kapsel relativ zur Kamera (WASD + linker Stick) mit
## Sprint und Sprung, dazu die weit rausgezoomte Third-Person-Kamera im
## WoW-Stil über SpringArm3D (Orbit: Maus + rechter Stick, Zoom: Mausrad +
## Schultertasten). Phase 1b ergänzt eine Zustandsmaschine: Slide (kurzer,
## geschwindigkeitsabhängiger Rutsch-Impuls mit reduzierter Kapselhöhe über
## die slide-Action) und automatisches Hochziehen an Kanten unterhalb einer
## Maximalhöhe, wenn der Spieler im Sprung gegen eine Wand stößt (einfache
## Kantenerkennung per Raycast). Die Kapsel-Shape wird beim Start
## dupliziert, damit Größenänderungen keine NPC-Kapseln mit geteilter
## Ressource betreffen. Mausbewegung ist in Godot nicht auf Actions mappbar
## und wird direkt als InputEventMouseMotion gelesen, der rechte Stick
## direkt über die Joypad-Achsen (Deadzone 0.2).
enum MovementState { NORMAL, SLIDING, CLIMBING }
const WALK_SPEED := 4.0
const SPRINT_SPEED := 7.5
const STOP_SPEED := 16.0
const JUMP_SPEED := 4.5
const MESH_TURN_SPEED := 10.0
const MOUSE_SENSITIVITY := 0.003
const STICK_LOOK_SPEED := 2.5
@ -23,20 +31,46 @@ const ZOOM_MAX := 14.0
const ZOOM_STEP := 0.8
const ZOOM_BUTTON_SPEED := 8.0
const ZOOM_SMOOTHING := 10.0
const SLIDE_MIN_ENTRY_SPEED := 2.0
const SLIDE_MIN_SPEED := 6.0
const SLIDE_SPEED_BOOST := 1.35
const SLIDE_DURATION := 0.7
const SLIDE_CAPSULE_HEIGHT := 1.0
const SLIDE_MESH_SQUASH := 0.55
const STAND_CAPSULE_HEIGHT := 1.8
const CLIMB_MIN_LEDGE_HEIGHT := 0.4
const CLIMB_MAX_LEDGE_HEIGHT := 2.2
const CLIMB_PROBE_MARGIN := 0.3
const CLIMB_FORWARD_PROBE := 0.5
const CLIMB_LANDING_INSET := 0.35
const CLIMB_HEADROOM := 1.7
const CLIMB_DURATION := 0.4
const CLIMB_VERTICAL_PHASE := 0.6
var _state := MovementState.NORMAL
var _target_zoom := 9.0
var _gravity: float = ProjectSettings.get_setting("physics/3d/default_gravity")
var _slide_direction := Vector3.ZERO
var _slide_start_speed := 0.0
var _slide_time := 0.0
var _climb_start := Vector3.ZERO
var _climb_corner := Vector3.ZERO
var _climb_target := Vector3.ZERO
var _climb_time := 0.0
@onready var _camera_pivot: Node3D = $CameraPivot
@onready var _spring_arm: SpringArm3D = $CameraPivot/SpringArm3D
@onready var _mesh: MeshInstance3D = $MeshInstance3D
@onready var _collision_shape: CollisionShape3D = $CollisionShape3D
@onready var _capsule: CapsuleShape3D = _collision_shape.shape.duplicate()
## Fängt den Mauszeiger ein und übernimmt die im Editor gesetzte
## SpringArm-Länge als Zoom-Ziel.
## Fängt den Mauszeiger ein, übernimmt die SpringArm-Länge als Zoom-Ziel
## und gibt dem Spieler eine eigene Kapsel-Shape-Instanz.
func _ready() -> void:
Input.set_mouse_mode(Input.MOUSE_MODE_CAPTURED)
_target_zoom = _spring_arm.spring_length
_collision_shape.shape = _capsule
## Verarbeitet Maus-Look, Mausrad-Zoom sowie das Freigeben des Cursors über
@ -55,13 +89,18 @@ func _unhandled_input(event: InputEvent) -> void:
Input.set_mouse_mode(Input.MOUSE_MODE_VISIBLE)
## Treibt pro Physik-Tick Stick-Look, Schultertasten-Zoom, Zoom-Glättung und
## Bewegung an.
## Treibt Kamera und den aktiven Bewegungszustand pro Physik-Tick an.
func _physics_process(delta: float) -> void:
_apply_stick_look(delta)
_apply_button_zoom(delta)
_apply_zoom_smoothing(delta)
_apply_movement(delta)
match _state:
MovementState.NORMAL:
_process_normal(delta)
MovementState.SLIDING:
_process_slide(delta)
MovementState.CLIMBING:
_process_climb(delta)
## Liefert die aktuelle Kamera-Distanz in Metern für das Debug-Overlay.
@ -69,6 +108,130 @@ func get_camera_zoom() -> float:
return _spring_arm.spring_length
## Liefert den Namen des aktiven Bewegungszustands für Debug-Zwecke.
func get_movement_state_name() -> String:
return MovementState.keys()[_state]
## Normale Bewegung: Schwerkraft, kamerarelatives Laufen mit Sprint und
## Sprung, danach Slide-Einstieg und Kletter-Kantenerkennung prüfen.
func _process_normal(delta: float) -> void:
if not is_on_floor():
velocity.y -= _gravity * delta
elif Input.is_action_just_pressed("jump"):
velocity.y = JUMP_SPEED
var input_dir := Input.get_vector("move_left", "move_right", "move_forward", "move_back")
var direction := _camera_pivot.global_transform.basis * Vector3(input_dir.x, 0.0, input_dir.y)
direction.y = 0.0
var speed := SPRINT_SPEED if Input.is_action_pressed("sprint") else WALK_SPEED
if direction.length_squared() > 0.0:
velocity.x = direction.x * speed
velocity.z = direction.z * speed
var target_yaw := atan2(-direction.x, -direction.z)
_mesh.rotation.y = lerp_angle(_mesh.rotation.y, target_yaw, minf(MESH_TURN_SPEED * delta, 1.0))
else:
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()
if is_on_floor() and Input.is_action_just_pressed("slide"):
_try_start_slide()
elif not is_on_floor() and is_on_wall() and direction.length_squared() > 0.0:
_try_start_climb(direction.normalized())
## Startet den Slide, wenn genug horizontale Geschwindigkeit vorhanden ist:
## Impuls in Bewegungsrichtung proportional zur aktuellen Geschwindigkeit,
## Kapsel- und Mesh-Höhe reduziert. Kein Slide im Stand.
func _try_start_slide() -> void:
var horizontal := Vector3(velocity.x, 0.0, velocity.z)
if horizontal.length() < SLIDE_MIN_ENTRY_SPEED:
return
_slide_direction = horizontal.normalized()
_slide_start_speed = maxf(horizontal.length() * SLIDE_SPEED_BOOST, SLIDE_MIN_SPEED)
_slide_time = 0.0
_apply_body_height(SLIDE_CAPSULE_HEIGHT, SLIDE_MESH_SQUASH)
_state = MovementState.SLIDING
## Slide-Verlauf: Geschwindigkeit fällt über SLIDE_DURATION auf Gehtempo,
## dann Rückkehr in den normalen Zustand. Wände beenden den Slide sofort.
func _process_slide(delta: float) -> void:
_slide_time += delta
var progress := clampf(_slide_time / SLIDE_DURATION, 0.0, 1.0)
var speed := lerpf(_slide_start_speed, WALK_SPEED, progress)
velocity.x = _slide_direction.x * speed
velocity.z = _slide_direction.z * speed
if not is_on_floor():
velocity.y -= _gravity * delta
move_and_slide()
if progress >= 1.0 or is_on_wall():
_end_slide()
## Beendet den Slide und stellt Kapsel- und Mesh-Höhe wieder her.
func _end_slide() -> void:
_apply_body_height(STAND_CAPSULE_HEIGHT, 1.0)
_state = MovementState.NORMAL
## Setzt Kapselhöhe und Mesh-Stauchung gemeinsam und hält dabei beide
## Unterkanten auf Bodenniveau, indem die Mittelpunkte mitwandern.
func _apply_body_height(capsule_height: float, mesh_scale: float) -> void:
_capsule.height = capsule_height
_collision_shape.position.y = capsule_height / 2.0
_mesh.scale.y = mesh_scale
_mesh.position.y = STAND_CAPSULE_HEIGHT / 2.0 * mesh_scale
## Prüft im Sprung per Raycast, ob vor dem Spieler eine Kante unterhalb der
## Maximalhöhe mit freiem Platz darüber liegt, und startet das Hochziehen.
## move_direction ist die horizontale Bewegungsrichtung des Spielers.
func _try_start_climb(move_direction: Vector3) -> void:
var wall_normal := get_wall_normal()
wall_normal.y = 0.0
if wall_normal.length_squared() < 0.5:
return
wall_normal = wall_normal.normalized()
if move_direction.dot(-wall_normal) < 0.3:
return
var into_wall := -wall_normal
var space := get_world_3d().direct_space_state
var probe_top := global_position + Vector3.UP * (CLIMB_MAX_LEDGE_HEIGHT + CLIMB_PROBE_MARGIN) + into_wall * CLIMB_FORWARD_PROBE
var ledge_query := PhysicsRayQueryParameters3D.create(probe_top, probe_top + Vector3.DOWN * CLIMB_MAX_LEDGE_HEIGHT, collision_mask, [get_rid()])
var ledge_hit := space.intersect_ray(ledge_query)
if ledge_hit.is_empty():
return
var ledge_height: float = ledge_hit["position"].y - global_position.y
if ledge_height < CLIMB_MIN_LEDGE_HEIGHT or ledge_height > CLIMB_MAX_LEDGE_HEIGHT:
return
var landing: Vector3 = ledge_hit["position"] + into_wall * CLIMB_LANDING_INSET
landing.y = ledge_hit["position"].y + 0.05
var headroom_query := PhysicsRayQueryParameters3D.create(landing + Vector3.UP * 0.1, landing + Vector3.UP * CLIMB_HEADROOM, collision_mask, [get_rid()])
if not space.intersect_ray(headroom_query).is_empty():
return
_climb_start = global_position
_climb_corner = Vector3(global_position.x, landing.y, global_position.z)
_climb_target = landing
_climb_time = 0.0
velocity = Vector3.ZERO
_state = MovementState.CLIMBING
## Kletter-Verlauf in zwei Phasen: erst senkrecht auf Kantenhöhe, dann
## horizontal auf die Kante, anschließend zurück in normale Bewegung.
func _process_climb(delta: float) -> void:
_climb_time += delta
var progress := clampf(_climb_time / CLIMB_DURATION, 0.0, 1.0)
if progress < CLIMB_VERTICAL_PHASE:
global_position = _climb_start.lerp(_climb_corner, progress / CLIMB_VERTICAL_PHASE)
else:
var lateral := (progress - CLIMB_VERTICAL_PHASE) / (1.0 - CLIMB_VERTICAL_PHASE)
global_position = _climb_corner.lerp(_climb_target, lateral)
if progress >= 1.0:
velocity = Vector3.ZERO
_state = MovementState.NORMAL
## Dreht die Kamera um yaw_delta (horizontal, am Pivot) und pitch_delta
## (vertikal, am SpringArm, begrenzt auf PITCH_MIN..PITCH_MAX). Beide Werte
## in Radiant.
@ -100,26 +263,6 @@ func _apply_zoom_smoothing(delta: float) -> void:
_spring_arm.spring_length = lerpf(_spring_arm.spring_length, _target_zoom, minf(ZOOM_SMOOTHING * delta, 1.0))
## Wendet Schwerkraft an, bewegt den Spieler kamerarelativ mit Geh- oder
## Sprint-Tempo und dreht das Kapsel-Mesh weich in Laufrichtung.
func _apply_movement(delta: float) -> void:
if not is_on_floor():
velocity.y -= _gravity * delta
var input_dir := Input.get_vector("move_left", "move_right", "move_forward", "move_back")
var direction := _camera_pivot.global_transform.basis * Vector3(input_dir.x, 0.0, input_dir.y)
direction.y = 0.0
var speed := SPRINT_SPEED if Input.is_action_pressed("sprint") else WALK_SPEED
if direction.length_squared() > 0.0:
velocity.x = direction.x * speed
velocity.z = direction.z * speed
var target_yaw := atan2(-direction.x, -direction.z)
_mesh.rotation.y = lerp_angle(_mesh.rotation.y, target_yaw, minf(MESH_TURN_SPEED * delta, 1.0))
else:
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()
## Liest eine Joypad-Achse über alle verbundenen Controller und liefert den
## ersten Wert außerhalb der Deadzone, sonst 0.
func _read_joy_axis(axis: JoyAxis) -> float:

View file

@ -0,0 +1,20 @@
extends Area3D
## Schlafsaal-Trigger (Phase 1b, SPEC.md Abschnitt 6).
##
## Beendet beim Betreten durch den Spieler den Tag über
## TimeSystem.end_day(): Tageszähler steigt, der Slot springt zurück auf
## den Vormittag. Rückmeldung vorerst über die Konsole und das
## Debug-Overlay; eine Schlaf-Sequenz mit UI folgt in einer späteren Phase.
## Verbindet das Betreten-Signal des Triggers.
func _ready() -> void:
body_entered.connect(_on_body_entered)
## Beendet den Tag, sobald der Spieler den Schlafbereich betritt.
func _on_body_entered(body: Node3D) -> void:
if not body.is_in_group("player"):
return
TimeSystem.end_day()
print("Geschlafen — Tag %d, %s." % [TimeSystem.day_count, TimeSystem.get_slot_name()])

View file

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

View file

@ -0,0 +1,35 @@
class_name ZoneTrigger
extends Area3D
## Zonen-Wechsel-Trigger zwischen den Greybox-Hub-Räumen (Phase 1b).
##
## Lädt beim Betreten durch den Spieler die Zielszene und merkt sich
## statisch den Namen des Spawn-Punkts, an dem der Ziel-Raum den Spieler
## platziert (hub_room.gd liest ihn über consume_pending_spawn()). Der
## Szenenwechsel läuft deferred, weil body_entered während des
## Physik-Schritts feuert.
static var _pending_spawn_name := ""
@export_file("*.tscn") var target_scene_path: String
@export var target_spawn_name: String
## Liefert den gemerkten Spawn-Punkt-Namen des letzten Zonen-Wechsels und
## leert ihn dabei; leerer String, wenn kein Wechsel ansteht.
static func consume_pending_spawn() -> String:
var spawn_name := _pending_spawn_name
_pending_spawn_name = ""
return spawn_name
## Verbindet das Betreten-Signal des Triggers.
func _ready() -> void:
body_entered.connect(_on_body_entered)
## Startet den Zonen-Wechsel, sobald der Spieler den Trigger betritt.
func _on_body_entered(body: Node3D) -> void:
if not body.is_in_group("player"):
return
_pending_spawn_name = target_spawn_name
get_tree().change_scene_to_file.call_deferred(target_scene_path)

View file

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