Elaina: Die Seite wurde neu angelegt: „Beim Wechsel vom Sprint zurück zur normalen Laufgeschwindigkeit kann ein Charakter in Kurven kurz seitlich über den Boden rutschen. Diese Anleitung zeigt, wie sich die Bewegungsrichtung während des Abbremsens korrigieren lässt, ohne Sprünge oder die Schwerkraft zu beeinflussen. == Das Problem == Im beschriebenen Blueprint wird die Laufgeschwindigkeit mit einer Timeline weich verändert: * normale Laufgeschwindigkeit: `500 cm/s` * Sprint…“

2026-09-09T23:49:49Z

Die Seite wurde neu angelegt: „Beim Wechsel vom Sprint zurück zur normalen Laufgeschwindigkeit kann ein Charakter in Kurven kurz seitlich über den Boden rutschen. Diese Anleitung zeigt, wie sich die Bewegungsrichtung während des Abbremsens korrigieren lässt, ohne Sprünge oder die Schwerkraft zu beeinflussen. == Das Problem == Im beschriebenen Blueprint wird die Laufgeschwindigkeit mit einer Timeline weich verändert: * normale Laufgeschwindigkeit: <code>500 cm/s</code> * Sprint…“

Neue Seite

Beim Wechsel vom Sprint zurück zur normalen Laufgeschwindigkeit kann ein Charakter in Kurven kurz seitlich über den Boden rutschen. Diese Anleitung zeigt, wie sich die Bewegungsrichtung während des Abbremsens korrigieren lässt, ohne Sprünge oder die Schwerkraft zu beeinflussen.

== Das Problem ==

Im beschriebenen Blueprint wird die Laufgeschwindigkeit mit einer Timeline weich verändert:

* normale Laufgeschwindigkeit: <code>500 cm/s</code>
* Sprintgeschwindigkeit: <code>820 cm/s</code>
* Abbremszeit: <code>1 Sekunde</code>

Geradeaus fällt der Fehler kaum auf. Wird die Sprinttaste jedoch während einer Kurve losgelassen, zeigt der Character bereits in die neue Richtung, während seine tatsächliche [[Vector|Velocity]] noch einen seitlichen Anteil aus der alten Bewegungsrichtung besitzt. Dadurch entsteht ein sichtbarer Drift- oder „Eislauf“-Effekt.

Die Timeline ist dabei nicht die eigentliche Ursache. Sie verlängert den Übergang lediglich und macht den Richtungsunterschied deutlicher sichtbar.

== Ursache mit Debug-Pfeilen prüfen ==

Zum Prüfen können zwei Debug-Pfeile gezeichnet werden:

* '''Rot:''' <code>Get Velocity</code> – die tatsächliche Bewegungsrichtung.
* '''Grün:''' <code>Get Actor Forward Vector</code> – die Blick- beziehungsweise Vorwärtsrichtung des Characters.

Tritt der Fehler auf, zeigt der grüne Pfeil bereits in die Kurve, während der rote Pfeil noch schräg in die vorherige Richtung weist. Damit lässt sich erkennen, dass es sich nicht nur um ein Animationsproblem handelt.

== Lösung im Blueprint ==

Die horizontale Geschwindigkeit bleibt erhalten, ihre Richtung wird während der Abbrems-Timeline jedoch auf die Vorwärtsrichtung des Characters ausgerichtet.

=== 1. Horizontale Geschwindigkeit ermitteln ===

# Eine Referenz auf den '''Character''' verwenden. Nicht die Velocity des Player Controllers abfragen.
# Am Character <code>Get Velocity</code> aufrufen.
# Das Ergebnis mit <code>Vector Length XY</code> verbinden.

<code>Vector Length XY</code> liefert die aktuelle Geschwindigkeit auf der X/Y-Ebene als Float. Die vertikale Z-Bewegung wird dabei nicht in den Geschwindigkeitsbetrag eingerechnet.

=== 2. Neue Bewegungsrichtung berechnen ===

# Am Character <code>Get Actor Forward Vector</code> aufrufen.
# Den von <code>Vector Length XY</code> ausgegebenen Speed mit <code>Make Vector</code> zu <code>(Speed, Speed, Speed)</code> zusammensetzen.
# <code>Get Actor Forward Vector</code> mit diesem Vector multiplizieren.

Der beschriebene Blueprint verwendet dafür einen als <code>Vector × Vector</code> typisierten Multiply-Node. Bei einem passend typisierten <code>Vector × Float</code>-Node kann der Float auch direkt als Faktor verwendet werden.

Die Berechnung lautet:

<pre>Neue Velocity = Actor Forward Vector × aktuelle XY-Geschwindigkeit</pre>

Beispiel:

<pre>Speed = 735 cm/s
Forward = (0.80, 0.60, 0.00)
Velocity ≈ (588, 441, 0) cm/s</pre>

Die Geschwindigkeit bleibt dadurch gleich, aber der seitliche Anteil relativ zur Charakterausrichtung verschwindet.

=== 3. Velocity nur am Boden setzen ===

# <code>Get Character Movement</code> aufrufen.
# Vom Character Movement Component <code>Is Moving on Ground</code> abfragen.
# Zwischen <code>Update</code> der Abbrems-Timeline und <code>Set Velocity</code> einen [[Boolean#Branch|Branch]] setzen.
# <code>Is Moving on Ground</code> mit der <code>Condition</code> des Branch verbinden.
# Nur den Ausgang <code>True</code> mit <code>Set Velocity</code> verbinden. <code>False</code> bleibt leer.
# Das Ergebnis der Richtungsberechnung an <code>New Velocity</code> von <code>Set Velocity</code> anschließen.

Der vollständige Ablauf sieht vereinfacht so aus:

<pre>DATEN:
Get Velocity → Vector Length XY → Make Vector(Speed, Speed, Speed)
Get Actor Forward Vector ────────────────┐
├→ Multiply → Set Velocity (New Velocity)
Make Vector ─────────────────────────────┘

AUSFÜHRUNG:
Timeline Update → Branch → True → Set Velocity
Is Moving on Ground ─────→ Condition
False → keine Aktion</pre>

== Warum die Bodenprüfung wichtig ist ==

Der neu berechnete Forward Vector besitzt in diesem Fall einen Z-Wert von <code>0</code>. Würde <code>Set Velocity</code> auch in der Luft bei jedem Timeline-Update ausgeführt, würde die vertikale Geschwindigkeit ständig auf null gesetzt. Der Character könnte dann kurz schweben, weil Character Movement und Schwerkraft keine normale Fallgeschwindigkeit aufbauen können.

Die Abfrage <code>Is Moving on Ground</code> begrenzt den Fix deshalb auf das Laufen am Boden:

* <code>True</code>: Richtungsanpassung ausführen.
* <code>False</code>: nichts setzen; Sprung, Fallbewegung und Schwerkraft bleiben vollständig beim Character Movement Component.

== Einstellungen des getesteten Setups ==

Der Fix wurde mit folgenden Ausgangswerten getestet:

{| class="wikitable"
! Einstellung
! Wert
|-
| <code>Ground Friction</code>
| <code>8.0</code>
|-
| <code>Max Acceleration</code>
| <code>1500</code>
|-
| <code>Braking Deceleration Walking</code>
| <code>2000</code>
|-
| <code>Braking Friction Factor</code>
| <code>1.0</code>
|-
| <code>Use Separate Braking Friction</code>
| aktiviert
|-
| <code>Braking Friction</code>
| <code>0</code>
|-
| <code>Orient Rotation to Movement</code>
| aktiviert
|-
| <code>Rotation Rate Z</code>
| <code>360°/s</code>
|}

Änderungen an <code>Braking Friction</code>, <code>Braking Deceleration Walking</code> und <code>Rotation Rate</code> allein haben den Fehler im getesteten Projekt nicht beseitigt.

== Testen ==

Nach dem Umbau sollten diese Fälle einzeln geprüft werden:

# Normal laufen und enge Kurven drehen.
# Sprint starten und bereits während des Sprints lenken.
# Die Sprinttaste in einem weiten und anschließend in einem engen Bogen loslassen. Der Character darf nicht mehr seitlich rutschen.
# Den roten Velocity-Pfeil mit dem grünen Forward-Pfeil vergleichen. Während der Korrektur am Boden sollten beide nahezu dieselbe Richtung anzeigen.
# Während des Abbremsens springen oder über ein Objekt laufen. Flugbahn und Schwerkraft müssen normal bleiben.

Im dokumentierten Projekt wurden Kurvendrift und Schweben mit diesen Tests behoben.

== Grenzen und mögliche Nebenwirkungen ==

* Die Korrektur ist bewusst nur für Bodenbewegung gedacht. Sie sollte nicht ungeprüft für <code>Falling</code>, <code>Swimming</code> oder <code>Flying</code> übernommen werden.
* <code>Set Velocity</code> kann gleichzeitig aktive Effekte wie Knockback, Dash, externe Kräfte oder Root Motion überschreiben.
* Für Multiplayer und Dedicated Server müssen Replikation und Movement Prediction gesondert auf Client und Server getestet werden.
* Bei größerer Spiellogik empfiehlt es sich, die Berechnung aus dem Player Controller in eine eigene Character-Funktion auszulagern.
* Nach erfolgreichem Test können die Debug-Pfeile entfernt oder über eine Debug-Variable ein- und ausgeschaltet werden.

== Kurzfassung ==

Während die Sprint-Timeline abbremst, wird die aktuelle horizontale Geschwindigkeit auf <code>Actor Forward</code> ausgerichtet. Ein Branch mit <code>Is Moving on Ground</code> verhindert, dass <code>Set Velocity</code> in der Luft die Fallgeschwindigkeit löscht. So folgt der Character Kurven sauber, während Sprünge und Schwerkraft unverändert funktionieren.

== Quellen ==

* Projektinterne Bugfix-Dokumentation: „UE5.8 Bugfix – Seitliches Rutschen beim Abbremsen in Kurven“, Stand 09.09.2026.
* [https://dev.epicgames.com/documentation/unreal-engine/API/Runtime/Engine/UCharacterMovementComponent UCharacterMovementComponent]
* [https://dev.epicgames.com/documentation/unreal-engine/BlueprintAPI/AI/Components/NavMovement/IsMovingonGround Is Moving on Ground]
* [https://dev.epicgames.com/documentation/unreal-engine/API/Runtime/Engine/UMovementComponent UMovementComponent und Velocity]
* [https://dev.epicgames.com/documentation/unreal-engine/movement-components-in-unreal-engine Movement Components]
* [https://dev.epicgames.com/documentation/unreal-engine/understanding-networked-movement-in-the-character-movement-component-for-unreal-engine Networked Character Movement]

[[Category:Blueprint]]
[[Category:Character Movement]]
[[Category:Tutorial]]
[[Category:Bugfix]]

Seitliches Rutschen nach dem Sprint beheben - Versionsgeschichte