JTW Studio - JTW Root Motion Source Plus

JTW Root Motion Source Plus

:rocket: Procedural, curve-driven, and animation-warped Root Motion for any ACharacter—without component bloat.

JTW Root Motion Source Plus is a lightweight, network-safe motion scheduler built on Unreal Engine’s native FRootMotionSource and UCharacterMovementComponent. Instead of maintaining dozens of custom FRootMotionSource subclasses, UGameplayTask objects, or custom CharacterMovementComponent base classes, you drive every kind of character displacement through a single unified source and a pure-data request struct.

Works immediately on any standard ACharacter—no actor components to attach, no DataAssets to maintain, and no GAS dependency required.

[Doc]

:sparkles: Key Features
  • Zero Intrusion, Instant Setup Call PlayMotion(Character, Request) from C++ or Blueprints, or use the cancellable async node Play Motion And Wait (OnCompleted, OnInterrupted, OnFailed).

  • Guaranteed vs. Incremental Reach Modes (ERMSReachMode)

    • Guaranteed: Automatically compensates for blocked frames so your character reaches the exact target location when the duration ends.

    • Incremental: Advances strictly by each frame’s expected step—if blocked by a wall, blocked displacement is discarded naturally instead of dragging the character along obstacles.

  • 4 Path Shapes + Local Offset Curves

    • Straight: Point-to-point linear movement with optional sine ArcHeight.

    • Polyline & Catmull-Rom Spline: Multi-point trajectories (up to 64 points) parameterized by arc length for uniform speed across uneven waypoints.

    • Analytic Parabola: Exact parabolic jump trajectories with configurable ArcHeight, landing accurately even when start and end elevations differ.

    • Custom Curves: Built-in easing (Linear, EaseIn, EaseOut, EaseInOut), optional CustomProgressCurve (UCurveFloat), and heading-space 3D OffsetCurve (UCurveVector).

  • Animation Root Motion & Multi-Window Warping Replay root motion from any UAnimSequence or UAnimMontage, and align specific time windows to world targets using FRMSWarpSegment or the non-intrusive RMS Warp Window (URMSAnimNotifyState_Warp) notify state.

  • Rotational Warping with Timing Curves (ERMSRotationMode) Turn the character independently of how it moves, and decide when the turn happens.

    • FaceMotion: face the direction of travel.

    • FaceTarget: rotate to a specific absolute yaw — glide sideways while still facing the enemy, for example.

    • Per-segment rotation for animations: locked-rotation attack animations can still end up facing the target.

    • RotationCurve: shape the turn across the motion (e.g. hold still for the first 60%, then snap around on the impact frame). The final orientation always lands exactly on target regardless of the curve.

    • Rotation is emitted as a delta and converged by proportional approach, so it self-corrects if something else nudges the character mid-motion — no start rotation needs to be supplied or replicated.

  • Explicit Capsule-Center Coordinates + Foot/Center Helpers Every world coordinate is the capsule center (GetActorLocation), documented as such. Four RMS|Location helpers (Get Center Location, Get Foot Location, Foot To Center, Center To Foot) convert to and from foot-level points, so raycast ground hits never land half a capsule off.

  • Dynamic Actor Following Track moving TargetActor targets with world-space offsets and configurable lost-target policies (GoToLastKnown or End).

  • Frame-Rate Independent Forces (Finite or Infinite) Apply Constant directional velocity or Pull (attraction toward a target Actor with StopDistance, horizontal bIgnoreZ, and distance-over-strength curves). Supports infinite duration (Duration < 0) with one-call cleanup via StopMotion / StopAllMotions.

  • One-Node Blueprint Presets Includes MakeDashRequest, MakeKnockbackRequest, MakeJumpRequest, and MakeDirectionalRequest—ready to play as-is or tweak any field before execution.

  • Multiplayer Prediction & Server Correction Ready Complete NetSerialize, Matches, and UpdateStateFrom implementation across all parameters, paths, warp segments, follow targets, and forces.

  • Built-in 3D Trajectory & HUD Debugger (Zero Shipping Overhead) Toggle RMS.Debug 1-3 in the console to visualize expected trajectories, start/end spheres, numbered waypoints, 25%/50%/75% time ticks, warp windows, pull stop-distance rings, and an on-screen active motion HUD. Completely compiled out in Shipping builds (#if !UE_BUILD_SHIPPING).

:hammer_and_wrench: Quick Start
  1. Enable JTW Root Motion Source Plus in Edit → Plugins.

  2. In any Blueprint, add Get Center Location (pass your character) → Make Dash Request (or Make Jump Request / Make Knockback Request) → Play Motion And Wait.

    All Make* nodes take an explicit StartLocation instead of a character pointer. This is deliberate: if the node read the character’s position internally, the server and the predicting client would each sample their own local value, Matches would reject the pair, and server correction would silently stop working. Pass the center once and both sides stay identical.

  3. Open the console during PIE and run RMS.Debug 2 to inspect the live 3D trajectory and active motion state.

:clipboard: Technical Details
  • Modules: RootMotionSourcePlus (Runtime)

  • Number of C++ Classes / Structs: 18 public types (URMSMotionLibrary, URMSWarpLibrary, URMSAsyncAction_PlayMotion, URMSMotionSubsystem, URMSAnimNotifyState_Warp, URMSSettings, FRMSMotionSource, FRMSMotionRequest, FRMSMotionParams, etc.)

  • Network Replicated: Yes (via UCharacterMovementComponent FRootMotionSourceGroup prediction & correction; both server and predicting client call PlayMotion with matching parameters)

  • Engine Compatibility: Unreal Engine 5.8

  • Supported Development & Target Platforms: Windows (Win64)

  • Documentation: Included in the plugin (README.md and Docs/ directory)

Developed by JTW Studio.