CR 8a: Kampf-Kern — leicht/schwer, Ausweichen, Dodge, Block/Parry

- CombatActor als gemeinsame Basis (HP, Ausdauer mit Regeneration,
  Haltung, Stagger); take_hit wertet i-Frames → Parry → Block → Treffer,
  schwere Angriffe umgehen Block und Parry
- PlayerCombat am Spieler: Grammatik über der unveränderten Bewegung —
  leichter Angriff, schwerer Angriff (langer Windup, bricht Blocks),
  Seitenschritt ohne i-Frames, Dodge-Rolle mit i-Fenster, Block mit
  Parry-Fenster; Windup → Active → Recovery, ein Treffer pro Schwung
- Stats: Kraft → Schaden, Schnelligkeit → Tempo und i-Frames,
  Verstand → Parry-Fenster (alle gedeckelt, Feinbalancing bleibt 8e)
- EncounterZone schaltet den Kampf nur in definierten Zonen scharf
  (Option B, keine roamenden Gegner); außerhalb bleibt Movement frei
- Trainings-Dummy mit telegrafiertem Schlag + Greybox-Testarena
  (scenes/combat/combat_testground.tscn)
- Neue Input-Actions heavy_attack (F / L2) und dodge (Leertaste / A✕);
  Tuning daten-getrieben in data/combat/combat_tuning.json
- Buchführung: 8a nach CHANGEREQUESTS_DONE, ROADMAP nachgezogen

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
danny 2026-07-20 19:07:40 +02:00
parent 942672c4ad
commit 32f75a732b
15 changed files with 828 additions and 7 deletions

View file

@ -0,0 +1,51 @@
{
"player": {
"max_health": 100,
"max_stamina": 100,
"stamina_regen_per_second": 18.0,
"stamina_regen_delay": 0.6
},
"light_attack": {
"base_damage": 8,
"stamina_cost": 12.0,
"windup_seconds": 0.12,
"active_seconds": 0.14,
"recovery_seconds": 0.24,
"poise_damage": 8
},
"heavy_attack": {
"base_damage": 20,
"stamina_cost": 28.0,
"windup_seconds": 0.42,
"active_seconds": 0.18,
"recovery_seconds": 0.5,
"poise_damage": 30,
"breaks_block": true
},
"sidestep": {
"stamina_cost": 10.0,
"duration_seconds": 0.22,
"speed": 9.0,
"has_iframes": false
},
"dodge_roll": {
"stamina_cost": 22.0,
"duration_seconds": 0.5,
"speed": 8.0,
"iframe_start": 0.06,
"iframe_end": 0.34
},
"block": {
"damage_multiplier": 0.2,
"stamina_cost_per_hit": 14.0,
"parry_window_seconds": 0.22,
"parry_stagger_seconds": 1.1
},
"stats": {
"strength_damage_per_point": 0.02,
"agility_speed_per_point": 0.006,
"agility_speed_max_bonus": 0.4,
"intellect_parry_per_point": 0.004,
"intellect_parry_max_bonus": 0.12
}
}

View file

@ -52,11 +52,7 @@
cast). Greybox-First, daten-getrieben. cast). Greybox-First, daten-getrieben.
### Sub-CRs (Reihenfolge = Bau-Track) ### Sub-CRs (Reihenfolge = Bau-Track)
- **8a — Kampf-Kern (frei, waffenlos/generisch):** Kampf-Movement, leichter + - **8a — Kampf-Kern** ✅ erledigt (2026-07-19, siehe CHANGEREQUESTS_DONE).
schwerer Angriff, Ausweichen, Dodgen (i-Frames), Block/Parry; Stats-Kopplung.
*Akzeptanz:* freie Bewegung im Encounter; Dummy mit leicht/schwer treffen; per
Seitenschritt ausweichen UND per Rolle mit i-Fenster durch einen Angriff dodgen;
blocken/parieren; Kraft/Schnelligkeit wirken messbar.
- **8b — Waffen-Framework (3 Klassen):** Dolch/Schwert/Axt, jederzeit wechselbar, - **8b — Waffen-Framework (3 Klassen):** Dolch/Schwert/Axt, jederzeit wechselbar,
**gleiche DPR** bei gleichem Skill, daten-getrieben. *Akzeptanz:* Wechsel im **gleiche DPR** bei gleichem Skill, daten-getrieben. *Akzeptanz:* Wechsel im
Kampf ohne Bruch; die drei Klassen fühlen sich verschieden an, messen aber Kampf ohne Bruch; die drei Klassen fühlen sich verschieden an, messen aber

View file

@ -85,6 +85,53 @@ Gewichts-Summe + `randi_range`), damit das Feld tatsächlich wirkt statt nur
dekorativ zu sein. Die zehn ursprünglichen erfundenen Siegelkräfte bleiben als dekorativ zu sein. Die zehn ursprünglichen erfundenen Siegelkräfte bleiben als
Baseline (weight 10) erhalten. Baseline (weight 10) erhalten.
## 2026-07-19 — CR 8a: Kampf-Kern (Welle 2, Sub-CR 1 von 5)
**Request:** Kampf-Movement, leichter + schwerer Angriff, Ausweichen,
Dodgen (i-Frames), Block/Parry, Stats-Kopplung. *Akzeptanz:* freie
Bewegung im Encounter; Dummy mit leicht/schwer treffen; per Seitenschritt
ausweichen UND per Rolle mit i-Fenster durch einen Angriff dodgen;
blocken/parieren; Kraft/Schnelligkeit wirken messbar.
**Umsetzung:**
- **`CombatActor`** (`scripts/gameplay/combat/combat_actor.gd`): gemeinsame
Basis mit Trefferpunkten, Ausdauer (Regeneration nach kurzer Pause),
Haltung und Stagger. `take_hit()` wertet in fester Reihenfolge:
i-Frames → Parry (Angreifer wird gestaggert) → Block (stark
reduzierter Schaden, kostet Ausdauer) → voller Schaden; schwere
Angriffe umgehen Block und Parry.
- **`PlayerCombat`** (Node in player.tscn): legt die Grammatik über die
**unveränderte** Bewegung von player.gd — leichter Angriff (schnell,
günstig), schwerer Angriff (langer Windup, bricht Blocks),
**Seitenschritt ohne i-Frames** (Positionierung, billig) vs.
**Dodge-Rolle mit i-Fenster** (teurer), Block mit **Parry-Fenster**.
Jede Aktion läuft Windup → Active → Recovery und trifft pro Schwung
genau einmal.
- **Stats-Kopplung:** Kraft hebt den Schaden (0,02/Punkt — bewusst
moderat, Feinbalancing bleibt 8e), Schnelligkeit verkürzt Windup und
Recovery und verlängert die i-Frames (gedeckelt bei +40 %), Verstand
weitet das Parry-Fenster (gedeckelt).
- **Encounter-Zonen (Option B):** `EncounterZone` schaltet den
Kampf-Modus beim Betreten scharf und beim Verlassen wieder ab —
außerhalb bleiben Sprung, Slide und Klettern unberührt, es gibt
**keine roamenden Gegner**.
- **Trainings-Dummy + Greybox-Testarena** (`scenes/combat/combat_testground.tscn`):
Gegner mit sichtbar telegrafiertem Schlag (Farbwechsel) und
Trefferpunkte-Label zum Üben von Ausweichen, Rollen, Blocken, Parieren.
- **Input (SPEC §9 erweitert):** neu `heavy_attack` (F / L2) und `dodge`
(Leertaste / Ⓐ✕) — kontextgebunden wie die bestehenden Mehrfach-
Belegungen des Projekts. `weapon_switch` folgt mit 8b.
- Alle Zahlen daten-getrieben in **`data/combat/combat_tuning.json`**.
**Verifikation:** Sonde 22/22 grün (Zone schaltet scharf/ab; leichter
und schwerer Treffer inkl. Schadensunterschied; Ausdauer-Sperre;
Seitenschritt ohne und Rolle mit i-Frames inkl. durchgehendem Treffer;
Parry ohne Schaden + Angreifer-Stagger; Block reduziert, schwerer
Angriff bricht durch; Kraft 8→21 Schaden, Schnelligkeit 28→26 Frames).
Boot-Checks Testarena, Hof, Sparringshalle, Viadukt, Gauntlet,
Materialraum fehlerfrei. **Sparring und Tag-9 laufen noch auf dem alten
System — der Umbau ist 8d.**
## 2026-07-19 — CR 14 + CR 15: Aula-Bau, Schlafsaal-Tür-Fix, Hub-Layout (Welle 1 abgeschlossen) ## 2026-07-19 — CR 14 + CR 15: Aula-Bau, Schlafsaal-Tür-Fix, Hub-Layout (Welle 1 abgeschlossen)
**Request (CR 14):** Verwaiste Klassenraum-Tür im Erstjahr-Schlafsaal **Request (CR 14):** Verwaiste Klassenraum-Tür im Erstjahr-Schlafsaal

View file

@ -87,7 +87,7 @@ Greifen erst nach Dreschen + erstem Flug; brauchen die CR-6-Basis.
| 5 | Staffel/Geschwader-Setup | 1 | erledigt (2026-07-19) | | 5 | Staffel/Geschwader-Setup | 1 | erledigt (2026-07-19) |
| 6 | Zweite Siegelkraft | 1 | erledigt (2026-07-19, latent; Ausspielung: Akt 3) | | 6 | Zweite Siegelkraft | 1 | erledigt (2026-07-19, latent; Ausspielung: Akt 3) |
| 7 | Stehendes Gauntlet-Rad | — | erledigt (2026-07-16) | | 7 | Stehendes Gauntlet-Rad | — | erledigt (2026-07-16) |
| 8 | Kampfsystem Action-RPG (8a–8e) | 2 | Scope ✅; **Bau offen** | | 8 | Kampfsystem Action-RPG (8a–8e) | 2 | **8a erledigt** (2026-07-19); 8b–8e offen |
| 8-magie | Magie-Kampf | 4 (Akt 2) | offen | | 8-magie | Magie-Kampf | 4 (Akt 2) | offen |
| 9 | Bindungs-Achse (Akt 2) | 4 | offen | | 9 | Bindungs-Achse (Akt 2) | 4 | offen |
| 10 | Drachenpflege (Akt 2) | 4 | offen | | 10 | Drachenpflege (Akt 2) | 4 | offen |

View file

@ -188,3 +188,15 @@ look_down={
"events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":3,"axis_value":1.0,"script":null) "events": [Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":3,"axis_value":1.0,"script":null)
] ]
} }
heavy_attack={
"deadzone": 0.2,
"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":70,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
, Object(InputEventJoypadMotion,"resource_local_to_scene":false,"resource_name":"","device":-1,"axis":4,"axis_value":1.0,"script":null)
]
}
dodge={
"deadzone": 0.2,
"events": [Object(InputEventKey,"resource_local_to_scene":false,"resource_name":"","device":-1,"window_id":0,"alt_pressed":false,"shift_pressed":false,"ctrl_pressed":false,"meta_pressed":false,"pressed":false,"keycode":0,"physical_keycode":32,"key_label":0,"unicode":0,"location":0,"echo":false,"script":null)
, Object(InputEventJoypadButton,"resource_local_to_scene":false,"resource_name":"","device":-1,"button_index":0,"pressure":0.0,"pressed":false,"script":null)
]
}

View file

@ -0,0 +1,109 @@
[gd_scene load_steps=16 format=3]
[ext_resource type="PackedScene" path="res://scenes/player.tscn" id="1_player"]
[ext_resource type="PackedScene" path="res://scenes/ui/debug_overlay.tscn" id="2_debug"]
[ext_resource type="Script" path="res://scripts/gameplay/combat/encounter_zone.gd" id="3_zone"]
[ext_resource type="Script" path="res://scripts/gameplay/combat/training_dummy.gd" id="4_dummy"]
[sub_resource type="ProceduralSkyMaterial" id="ProceduralSkyMaterial_sky"]
sky_horizon_color = Color(0.55, 0.55, 0.6, 1)
ground_horizon_color = Color(0.55, 0.55, 0.6, 1)
[sub_resource type="Sky" id="Sky_sky"]
sky_material = SubResource("ProceduralSkyMaterial_sky")
[sub_resource type="Environment" id="Environment_env"]
background_mode = 2
sky = SubResource("Sky_sky")
tonemap_mode = 2
[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_floor"]
albedo_color = Color(0.4, 0.38, 0.36, 1)
[sub_resource type="BoxShape3D" id="BoxShape3D_floor"]
size = Vector3(24, 1, 24)
[sub_resource type="BoxMesh" id="BoxMesh_floor"]
material = SubResource("StandardMaterial3D_floor")
size = Vector3(24, 1, 24)
[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_mat"]
albedo_color = Color(0.55, 0.3, 0.25, 1)
[sub_resource type="CylinderMesh" id="CylinderMesh_mat"]
material = SubResource("StandardMaterial3D_mat")
top_radius = 7.0
bottom_radius = 7.0
height = 0.08
[sub_resource type="CapsuleShape3D" id="CapsuleShape3D_dummy"]
radius = 0.45
height = 1.9
[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_dummy"]
albedo_color = Color(0.45, 0.45, 0.5, 1)
[sub_resource type="CapsuleMesh" id="CapsuleMesh_dummy"]
material = SubResource("StandardMaterial3D_dummy")
radius = 0.45
height = 1.9
[sub_resource type="CylinderShape3D" id="CylinderShape3D_zone"]
radius = 7.5
height = 4.0
[node name="CombatTestground" type="Node3D"]
[node name="WorldEnvironment" type="WorldEnvironment" parent="."]
environment = SubResource("Environment_env")
[node name="Sun" type="DirectionalLight3D" parent="."]
transform = Transform3D(0.866025, 0.383022, -0.321394, 0, 0.642788, 0.766044, 0.5, -0.663414, 0.55667, 0, 10, 0)
[node name="Floor" type="StaticBody3D" parent="."]
transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, -0.5, 0)
[node name="CollisionShape3D" type="CollisionShape3D" parent="Floor"]
shape = SubResource("BoxShape3D_floor")
[node name="MeshInstance3D" type="MeshInstance3D" parent="Floor"]
mesh = SubResource("BoxMesh_floor")
[node name="RingMat" type="MeshInstance3D" parent="."]
transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.04, 0)
mesh = SubResource("CylinderMesh_mat")
[node name="EncounterZone" type="Area3D" parent="."]
transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 2, 0)
collision_layer = 0
collision_mask = 2
script = ExtResource("3_zone")
[node name="CollisionShape3D" type="CollisionShape3D" parent="EncounterZone"]
shape = SubResource("CylinderShape3D_zone")
[node name="Dummy" type="StaticBody3D" parent="."]
transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, -3.5)
[node name="CollisionShape3D" type="CollisionShape3D" parent="Dummy"]
transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.95, 0)
shape = SubResource("CapsuleShape3D_dummy")
[node name="MeshInstance3D" type="MeshInstance3D" parent="Dummy"]
transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.95, 0)
mesh = SubResource("CapsuleMesh_dummy")
[node name="HealthLabel" type="Label3D" parent="Dummy"]
transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 2.3, 0)
billboard = 1
text = "Dummy"
font_size = 48
outline_size = 12
[node name="TrainingDummy" type="Node" parent="Dummy"]
script = ExtResource("4_dummy")
[node name="Player" parent="." instance=ExtResource("1_player")]
transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.1, 0)
[node name="DebugOverlay" parent="." instance=ExtResource("2_debug")]

View file

@ -1,9 +1,10 @@
[gd_scene load_steps=9 format=3] [gd_scene load_steps=10 format=3]
[ext_resource type="Script" path="res://scripts/gameplay/player.gd" id="1_player"] [ext_resource type="Script" path="res://scripts/gameplay/player.gd" id="1_player"]
[ext_resource type="PackedScene" path="res://scenes/ui/speech_bubble.tscn" id="2_bubble"] [ext_resource type="PackedScene" path="res://scenes/ui/speech_bubble.tscn" id="2_bubble"]
[ext_resource type="PackedScene" path="res://scenes/ui/lexicon.tscn" id="3_journal"] [ext_resource type="PackedScene" path="res://scenes/ui/lexicon.tscn" id="3_journal"]
[ext_resource type="PackedScene" path="res://scenes/ui/pause_menu.tscn" id="4_pause"] [ext_resource type="PackedScene" path="res://scenes/ui/pause_menu.tscn" id="4_pause"]
[ext_resource type="Script" path="res://scripts/gameplay/combat/player_combat.gd" id="5_combat"]
[ext_resource type="PackedScene" path="res://scenes/npcs/googly_eyes.tscn" id="90_eyes"] [ext_resource type="PackedScene" path="res://scenes/npcs/googly_eyes.tscn" id="90_eyes"]
[sub_resource type="StandardMaterial3D" id="StandardMaterial3D_player"] [sub_resource type="StandardMaterial3D" id="StandardMaterial3D_player"]
@ -49,5 +50,8 @@ transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 2.4, 0)
[node name="PauseMenu" parent="." instance=ExtResource("4_pause")] [node name="PauseMenu" parent="." instance=ExtResource("4_pause")]
[node name="PlayerCombat" type="Node" parent="."]
script = ExtResource("5_combat")
[node name="GooglyEyes" parent="MeshInstance3D" instance=ExtResource("90_eyes")] [node name="GooglyEyes" parent="MeshInstance3D" instance=ExtResource("90_eyes")]
transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.55, -0.3) transform = Transform3D(1, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0.55, -0.3)

View file

@ -0,0 +1,174 @@
class_name CombatActor
extends Node
## Gemeinsame Kampf-Basis für Spieler und Gegner (CR 8a).
##
## Hält Trefferpunkte, Ausdauer und Haltung (Poise) eines Kämpfers und
## nimmt Treffer entgegen. Ein Treffer prüft in dieser Reihenfolge:
## Unverwundbarkeit (i-Frames der Dodge-Rolle) → Parry-Fenster (der
## Angreifer wird gestaggert, kein Schaden) → Block (stark reduzierter
## Schaden, kostet Ausdauer; schwere Angriffe brechen den Block) →
## voller Schaden. Ausdauer regeneriert nach einer kurzen Pause. Die
## Zahlen kommen aus data/combat/combat_tuning.json; abgeleitete
## Klassen (player_combat, training_dummy) füllen Verhalten und
## Eingaben. Der Tod meldet nur das Signal — die Konsequenz (Respawn,
## Szenenende) gehört der jeweiligen Encounter-Szene.
signal health_changed(current: int, maximum: int)
signal stamina_changed(current: float, maximum: float)
signal hit_taken(damage: int, result: String)
signal parried(attacker: CombatActor)
signal staggered(seconds: float)
signal died
const TUNING_PATH := "res://data/combat/combat_tuning.json"
const RESULT_DODGED := "dodged"
const RESULT_PARRIED := "parried"
const RESULT_BLOCKED := "blocked"
const RESULT_HIT := "hit"
static var _tuning: Dictionary = {}
var max_health := 100
var max_stamina := 100.0
var health := 100
var stamina := 100.0
var poise := 30
var _stagger_remaining := 0.0
var _stamina_pause := 0.0
## Lädt die Tuning-Tabelle einmalig in den statischen Cache.
static func load_tuning() -> Dictionary:
if not _tuning.is_empty():
return _tuning
var file := FileAccess.open(TUNING_PATH, FileAccess.READ)
if file == null:
push_error("Kampf-Tuning nicht lesbar: %s" % TUNING_PATH)
return {}
var parsed: Variant = JSON.parse_string(file.get_as_text())
file.close()
if parsed is Dictionary:
_tuning = parsed
else:
push_error("Kampf-Tuning ist ungültig: %s" % TUNING_PATH)
return _tuning
## Liefert einen Tuning-Abschnitt (leer, wenn unbekannt).
static func tuning_section(section: String) -> Dictionary:
var data := load_tuning()
return data.get(section, {})
## Setzt Werte auf Maximum zurück (Encounter-Start).
func reset_combat_values() -> void:
health = max_health
stamina = max_stamina
_stagger_remaining = 0.0
_stamina_pause = 0.0
health_changed.emit(health, max_health)
stamina_changed.emit(stamina, max_stamina)
## Gibt zurück, ob der Kämpfer gerade unverwundbar ist (i-Frames).
## Abgeleitete Klassen überschreiben das.
func is_invulnerable() -> bool:
return false
## Gibt zurück, ob gerade geblockt wird. Abgeleitete Klassen überschreiben.
func is_blocking() -> bool:
return false
## Gibt zurück, ob der Block noch im Parry-Fenster liegt. Abgeleitete
## Klassen überschreiben.
func is_parrying() -> bool:
return false
## Gibt zurück, ob der Kämpfer gerade gestaggert ist (keine Aktionen).
func is_staggered() -> bool:
return _stagger_remaining > 0.0
## Gibt zurück, ob der Kämpfer noch lebt.
func is_alive() -> bool:
return health > 0
## Nimmt einen Treffer entgegen und liefert das Ergebnis als String
## (dodged/parried/blocked/hit). attacker darf null sein (Umwelt).
func take_hit(damage: int, is_heavy := false, attacker: CombatActor = null) -> String:
if not is_alive():
return RESULT_HIT
if is_invulnerable():
hit_taken.emit(0, RESULT_DODGED)
return RESULT_DODGED
if is_parrying() and not is_heavy:
var block_data := tuning_section("block")
var stagger := float(block_data.get("parry_stagger_seconds", 1.0))
if attacker != null:
attacker.apply_stagger(stagger)
parried.emit(attacker)
hit_taken.emit(0, RESULT_PARRIED)
return RESULT_PARRIED
if is_blocking() and not is_heavy:
var block_data := tuning_section("block")
var reduced := int(round(float(damage) * float(block_data.get("damage_multiplier", 0.25))))
spend_stamina(float(block_data.get("stamina_cost_per_hit", 12.0)))
_apply_damage(reduced)
hit_taken.emit(reduced, RESULT_BLOCKED)
return RESULT_BLOCKED
_apply_damage(damage)
hit_taken.emit(damage, RESULT_HIT)
return RESULT_HIT
## Legt den Kämpfer für seconds Sekunden lahm (Parry-Folge, schwerer
## Treffer gegen die Haltung).
func apply_stagger(seconds: float) -> void:
_stagger_remaining = maxf(_stagger_remaining, seconds)
staggered.emit(seconds)
## Zieht Ausdauer ab und pausiert die Regeneration kurz; liefert false,
## wenn nicht genug Ausdauer vorhanden war.
func spend_stamina(amount: float) -> bool:
if stamina < amount:
return false
stamina = maxf(stamina - amount, 0.0)
_stamina_pause = float(tuning_section("player").get("stamina_regen_delay", 0.6))
stamina_changed.emit(stamina, max_stamina)
return true
## Prüft, ob genug Ausdauer für eine Aktion da ist.
func has_stamina(amount: float) -> bool:
return stamina >= amount
## Treibt Stagger-Countdown und Ausdauer-Regeneration voran; abgeleitete
## Klassen rufen das in ihrem eigenen _physics_process auf.
func tick_combat(delta: float) -> void:
if _stagger_remaining > 0.0:
_stagger_remaining = maxf(_stagger_remaining - delta, 0.0)
if _stamina_pause > 0.0:
_stamina_pause = maxf(_stamina_pause - delta, 0.0)
return
if stamina < max_stamina:
var regen := float(tuning_section("player").get("stamina_regen_per_second", 15.0))
stamina = minf(stamina + regen * delta, max_stamina)
stamina_changed.emit(stamina, max_stamina)
## Zieht Schaden ab und meldet den Tod einmalig.
func _apply_damage(damage: int) -> void:
if damage <= 0:
return
health = maxi(health - damage, 0)
health_changed.emit(health, max_health)
if health == 0:
died.emit()

View file

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

View file

@ -0,0 +1,44 @@
extends Area3D
## Encounter-Zone (CR 8a, Reichweiten-Entscheidung Option B).
##
## Kampf gibt es nur in definierten Zonen — kein Welt-Sandbox, keine
## roamenden Gegner auf dem Hof. Betritt der Spieler die Zone, schaltet
## sie seinen PlayerCombat-Knoten scharf (Angriffe, Dodge, Block); beim
## Verlassen wieder ab, damit Sprung, Slide und Klettern außerhalb
## unberührt bleiben. Die Zone kennt ihre Gegner über die Gruppe
## combat_actor in ihrer Szene — Sieg/Niederlage werten die
## Encounter-Skripte darüber aus (8d).
signal encounter_started
signal encounter_ended
## Verbindet die Reichweiten-Signale.
func _ready() -> void:
body_entered.connect(_on_body_entered)
body_exited.connect(_on_body_exited)
## Schaltet den Kampf-Modus des Spielers scharf.
func _on_body_entered(body: Node3D) -> void:
var combat := _combat_of(body)
if combat == null:
return
combat.set_encounter_active(true)
encounter_started.emit()
## Schaltet den Kampf-Modus wieder ab.
func _on_body_exited(body: Node3D) -> void:
var combat := _combat_of(body)
if combat == null:
return
combat.set_encounter_active(false)
encounter_ended.emit()
## Liefert den PlayerCombat-Knoten eines Körpers (null, wenn keiner).
func _combat_of(body: Node3D) -> Node:
if not body.is_in_group("player"):
return null
return body.get_node_or_null("PlayerCombat")

View file

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

View file

@ -0,0 +1,278 @@
extends CombatActor
## Tyrveils Kampf-Kern (CR 8a) — Node am Spieler, ersetzt kein Movement.
##
## Die Bewegung bleibt frei: player.gd läuft weiter, dieses Skript legt
## nur die Kampf-Grammatik darüber (SPEC §1, CHANGEREQUESTS §8). Aktiv
## ist es ausschließlich in Encounter-Zonen (set_encounter_active) —
## außerhalb schluckt es keine Eingaben, damit Sprung, Slide und
## Klettern unberührt bleiben (Option B: kein Welt-Sandbox).
##
## Grammatik:
## - **Leichter Angriff** (attack): schnell, günstig.
## - **Schwerer Angriff** (heavy_attack): langer Windup, hoher Schaden,
## **bricht Blocks** und kann nicht pariert werden.
## - **Seitenschritt** (dodge + Bewegungsrichtung quer): kurzer Schritt
## OHNE Unverwundbarkeit — reine Positionierung, billig.
## - **Dodge-Rolle** (dodge ohne Richtung bzw. vorwärts): Rolle MIT
## Unverwundbarkeits-Fenster, teurer.
## - **Block/Parry** (block halten): stark reduzierter Schaden; in den
## ersten Sekundenbruchteilen ein **Parry**, das den Angreifer
## staggert.
##
## Stats-Kopplung (SPEC §6): Kraft hebt den Schaden, Schnelligkeit
## verkürzt Windup/Recovery und verlängert die i-Frames, Verstand weitet
## das Parry-Fenster. Alle Zahlen aus data/combat/combat_tuning.json.
signal attack_landed(result: String, damage: int)
signal attack_started(kind: String)
signal dodge_started(has_iframes: bool)
enum ActionState { READY, WINDUP, ACTIVE, RECOVERY, DODGING }
const HITBOX_RANGE := 1.9
const HITBOX_RADIUS := 1.1
var is_encounter_active := false
var _action := ActionState.READY
var _action_kind := ""
var _action_timer := 0.0
var _dodge_timer := 0.0
var _dodge_has_iframes := false
var _dodge_direction := Vector3.ZERO
var _block_timer := 0.0
var _is_block_held := false
var _has_hit_this_swing := false
@onready var _player: CharacterBody3D = get_parent() as CharacterBody3D
@onready var _mesh: Node3D = _player.get_node("MeshInstance3D") as Node3D
@onready var _camera_pivot: Node3D = _player.get_node("CameraPivot") as Node3D
## Übernimmt die Kampfwerte aus dem Tuning und startet inaktiv.
func _ready() -> void:
var player_data := tuning_section("player")
max_health = int(player_data.get("max_health", 100))
max_stamina = float(player_data.get("max_stamina", 100.0))
reset_combat_values()
set_physics_process(false)
## Schaltet den Kampf-Modus einer Encounter-Zone scharf oder ab.
func set_encounter_active(is_active: bool) -> void:
is_encounter_active = is_active
set_physics_process(is_active)
if is_active:
reset_combat_values()
return
_action = ActionState.READY
_is_block_held = false
_block_timer = 0.0
## Liest im Encounter die Kampf-Eingaben und treibt Aktions- und
## Dodge-Timer voran; ohne Encounter passiert nichts.
func _physics_process(delta: float) -> void:
tick_combat(delta)
if not is_alive() or _player == null:
return
if _player.is_control_locked() or DialogueSystem.is_dialogue_active:
return
_tick_action(delta)
_tick_block(delta)
if is_staggered():
return
if Input.is_action_just_pressed("attack"):
try_light_attack()
elif Input.is_action_just_pressed("heavy_attack"):
try_heavy_attack()
elif Input.is_action_just_pressed("dodge"):
try_dodge(Input.get_vector("move_left", "move_right", "move_forward", "move_back"))
if Input.is_action_just_pressed("block"):
start_block()
elif Input.is_action_just_released("block"):
end_block()
## Startet einen leichten Angriff; liefert false, wenn blockiert,
## gestaggert, in einer anderen Aktion oder ohne Ausdauer.
func try_light_attack() -> bool:
return _start_attack("light_attack")
## Startet einen schweren Angriff (langer Windup, bricht Blocks).
func try_heavy_attack() -> bool:
return _start_attack("heavy_attack")
## Startet Seitenschritt oder Rolle: Eine überwiegend seitliche
## Eingaberichtung ergibt den billigen Seitenschritt OHNE i-Frames,
## alles andere die teurere Rolle MIT Unverwundbarkeits-Fenster.
func try_dodge(input_dir := Vector2.ZERO) -> bool:
if _action == ActionState.DODGING or is_staggered():
return false
var is_sidestep: bool = input_dir.length() > 0.4 and absf(input_dir.x) > absf(input_dir.y)
var section := "sidestep" if is_sidestep else "dodge_roll"
var data := tuning_section(section)
if not spend_stamina(float(data.get("stamina_cost", 15.0))):
return false
_action = ActionState.DODGING
_action_kind = section
_dodge_timer = 0.0
_dodge_has_iframes = not is_sidestep
_dodge_direction = _direction_from_input(input_dir)
_is_block_held = false
_block_timer = 0.0
dodge_started.emit(_dodge_has_iframes)
return true
## Beginnt zu blocken und öffnet das Parry-Fenster.
func start_block() -> void:
if _action != ActionState.READY or is_staggered():
return
_is_block_held = true
_block_timer = 0.0
## Beendet den Block.
func end_block() -> void:
_is_block_held = false
_block_timer = 0.0
## Unverwundbar während des i-Fensters der Rolle (Schnelligkeit
## verlängert es leicht).
func is_invulnerable() -> bool:
if _action != ActionState.DODGING or not _dodge_has_iframes:
return false
var data := tuning_section("dodge_roll")
var scale := _agility_scale()
return _dodge_timer >= float(data.get("iframe_start", 0.05)) and _dodge_timer <= float(data.get("iframe_end", 0.3)) * scale
## Block zählt, solange die Taste gehalten wird und keine Aktion läuft.
func is_blocking() -> bool:
return _is_block_held and _action == ActionState.READY
## Parry-Fenster: die ersten Augenblicke des Blocks (Verstand weitet es).
func is_parrying() -> bool:
if not is_blocking():
return false
var data := tuning_section("block")
var stats := tuning_section("stats")
var window := float(data.get("parry_window_seconds", 0.2))
window += minf(GameState.intellect * float(stats.get("intellect_parry_per_point", 0.004)), float(stats.get("intellect_parry_max_bonus", 0.12)))
return _block_timer <= window
## Liefert den Namen der laufenden Aktion (für Tests und Debug).
func get_action_name() -> String:
return ActionState.keys()[_action]
## Startet einen Angriff aus dem Tuning-Abschnitt; Schnelligkeit
## verkürzt Windup und Recovery.
func _start_attack(section: String) -> bool:
if _action != ActionState.READY or is_staggered():
return false
var data := tuning_section(section)
if not spend_stamina(float(data.get("stamina_cost", 10.0))):
return false
_action = ActionState.WINDUP
_action_kind = section
_action_timer = 0.0
_has_hit_this_swing = false
_is_block_held = false
attack_started.emit(section)
return true
## Treibt Windup → Active → Recovery voran und schlägt in der aktiven
## Phase genau einmal zu.
func _tick_action(delta: float) -> void:
if _action == ActionState.READY:
return
if _action == ActionState.DODGING:
_tick_dodge(delta)
return
var data := tuning_section(_action_kind)
var scale := 1.0 / _agility_scale()
_action_timer += delta
match _action:
ActionState.WINDUP:
if _action_timer >= float(data.get("windup_seconds", 0.15)) * scale:
_action = ActionState.ACTIVE
_action_timer = 0.0
ActionState.ACTIVE:
if not _has_hit_this_swing:
_resolve_swing(data)
if _action_timer >= float(data.get("active_seconds", 0.15)):
_action = ActionState.RECOVERY
_action_timer = 0.0
ActionState.RECOVERY:
if _action_timer >= float(data.get("recovery_seconds", 0.25)) * scale:
_action = ActionState.READY
_action_timer = 0.0
## Sucht Ziele vor dem Spieler und teilt den Treffer aus; Kraft hebt den
## Schaden.
func _resolve_swing(data: Dictionary) -> void:
_has_hit_this_swing = true
var stats := tuning_section("stats")
var damage := int(round(float(data.get("base_damage", 10)) * (1.0 + GameState.strength * float(stats.get("strength_damage_per_point", 0.1)))))
var is_heavy: bool = bool(data.get("breaks_block", false))
var origin: Vector3 = _player.global_position + Vector3(0, 1.0, 0)
var forward: Vector3 = -_mesh.global_transform.basis.z
forward.y = 0.0
var center: Vector3 = origin + forward.normalized() * HITBOX_RANGE
for target in get_tree().get_nodes_in_group("combat_actor"):
if target == self or not (target is CombatActor):
continue
var body := target.get_parent() as Node3D
if body == null or body == _player:
continue
if body.global_position.distance_to(center) > HITBOX_RADIUS + 0.6:
continue
var result: String = target.take_hit(damage, is_heavy, self)
attack_landed.emit(result, damage)
return
attack_landed.emit("miss", damage)
## Bewegt den Spieler während Seitenschritt/Rolle und beendet sie.
func _tick_dodge(delta: float) -> void:
var data := tuning_section(_action_kind)
_dodge_timer += delta
var duration := float(data.get("duration_seconds", 0.4)) / _agility_scale()
_player.velocity.x = _dodge_direction.x * float(data.get("speed", 8.0))
_player.velocity.z = _dodge_direction.z * float(data.get("speed", 8.0))
if _dodge_timer >= duration:
_action = ActionState.READY
_dodge_timer = 0.0
## Zählt die Blockdauer für das Parry-Fenster hoch.
func _tick_block(delta: float) -> void:
if _is_block_held:
_block_timer += delta
## Wandelt die Eingaberichtung in eine Weltrichtung; ohne Eingabe rollt
## Tyrveil nach vorn.
func _direction_from_input(input_dir: Vector2) -> Vector3:
if input_dir.length() < 0.2:
var forward: Vector3 = -_mesh.global_transform.basis.z
forward.y = 0.0
return forward.normalized()
var direction: Vector3 = _camera_pivot.global_transform.basis * Vector3(input_dir.x, 0.0, input_dir.y)
direction.y = 0.0
return direction.normalized()
## Tempo-Faktor aus Schnelligkeit (>1 = schneller, gedeckelt).
func _agility_scale() -> float:
var stats := tuning_section("stats")
return 1.0 + minf(GameState.agility * float(stats.get("agility_speed_per_point", 0.006)), float(stats.get("agility_speed_max_bonus", 0.4)))

View file

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

View file

@ -0,0 +1,102 @@
extends CombatActor
## Trainings-Gegner des Kampf-Kerns (CR 8a) — Node an einem Körper.
##
## Greybox-Sparringspartner zum Verifizieren der Grammatik: Er steht,
## nimmt Treffer entgegen (Trefferpunkte über der Kapsel als Label) und
## fährt in festem Rhythmus telegrafierte Angriffe, an denen sich
## Ausweichen, Rollen, Blocken und Parieren üben lassen. Das Telegraph-
## Fenster ist bewusst lang und sichtbar (Farbwechsel des Meshes) —
## Lesbarkeit vor Härte. Reagiert auf Stagger (nach einem Parry steht er
## offen) und meldet seinen Tod über das Basis-Signal.
const TELEGRAPH_SECONDS := 1.0
const STRIKE_RANGE := 2.6
const STRIKE_DAMAGE := 12
const STRIKE_COOLDOWN := 2.2
var is_auto_attacking := true
var _cooldown := STRIKE_COOLDOWN
var _telegraph_remaining := 0.0
@onready var _body: Node3D = get_parent() as Node3D
@onready var _mesh: MeshInstance3D = _body.get_node_or_null("MeshInstance3D")
@onready var _label: Label3D = _body.get_node_or_null("HealthLabel")
## Setzt die Kampfwerte und meldet den Dummy als Ziel an.
func _ready() -> void:
add_to_group("combat_actor")
max_health = 120
max_stamina = 100.0
poise = 40
reset_combat_values()
health_changed.connect(_on_health_changed)
_update_label()
## Treibt Telegraph und Schlagrhythmus voran.
func _physics_process(delta: float) -> void:
tick_combat(delta)
if not is_alive() or not is_auto_attacking or is_staggered():
_set_telegraph(false)
return
if _telegraph_remaining > 0.0:
_telegraph_remaining -= delta
if _telegraph_remaining <= 0.0:
_resolve_strike()
return
_cooldown -= delta
if _cooldown <= 0.0:
_begin_telegraph()
## Startet einen sichtbar angekündigten Schlag.
func _begin_telegraph() -> void:
_telegraph_remaining = TELEGRAPH_SECONDS
_set_telegraph(true)
## Führt den Schlag aus, wenn der Spieler in Reichweite steht.
func _resolve_strike() -> void:
_set_telegraph(false)
_cooldown = STRIKE_COOLDOWN
var player := get_tree().get_first_node_in_group("player") as Node3D
if player == null or _body == null:
return
if player.global_position.distance_to(_body.global_position) > STRIKE_RANGE:
return
var combat := player.get_node_or_null("PlayerCombat") as CombatActor
if combat != null:
combat.take_hit(STRIKE_DAMAGE, false, self)
## Erzwingt einen sofortigen Schlag (für Sonden und gescriptete Beats).
func force_strike() -> void:
_telegraph_remaining = 0.0
_resolve_strike()
## Meldet, ob der Dummy gerade einen Schlag ankündigt.
func is_telegraphing() -> bool:
return _telegraph_remaining > 0.0
## Färbt das Mesh während des Telegraphs auffällig ein.
func _set_telegraph(is_active: bool) -> void:
if _mesh == null:
return
var material := StandardMaterial3D.new()
material.albedo_color = Color(0.85, 0.35, 0.3) if is_active else Color(0.45, 0.45, 0.5)
_mesh.material_override = material
## Hält das Trefferpunkte-Label aktuell.
func _on_health_changed(_current: int, _maximum: int) -> void:
_update_label()
## Schreibt die Trefferpunkte über die Kapsel.
func _update_label() -> void:
if _label != null:
_label.text = "Dummy %d/%d" % [health, max_health]

View file

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