Vehicles, cloth and ragdolls

Wheeled and tracked vehicles, cloth and soft bodies, ragdolls, physics assets and physical animation for hit reactions.

Last updated Nov 3, 2026Edit this pageVersion 1.0.0

These features sit on top of the core physics setup. Each is a reflected component you add from the Add Component picker and tune in the Details panel.

Vehicles

A Vehicle component turns a dynamic rigid body into a Jolt wheeled vehicle. VehicleComponent

GroupFields
EnginemaxEngineTorque, minRPM, maxRPM, torqueCurve (RPM fraction to torque fraction; empty uses Jolt's curve)
TransmissiongearRatios, first gear first; empty uses a default automatic box
Steering and drivemaxSteerDegrees, rearWheelDrive
TireslongitudinalFrictionCurve, lateralFrictionCurve
StabilityantiRollStiffness: the spring constant in N/m of a bar joining the left and right wheel of each axle; 0 is off
Wheelswheels, one entry per wheel

Each wheel entry sets its chassis-local position, radius and width, whether it steering, is driven or takes the handbrake, its own maxSteerDegrees, suspension length, frequency and damping, brake torques and a friction scale. A six-wheel truck and a trike are the same component with a different table. When the table is empty, the four-wheel layout comes from wheelRadius, axleOffset and trackHalfWidth.

An anti-roll bar presses the outside wheel down and lifts the inside one in a corner. It is read every frame, so you can raise it while driving; a narrow, high car that rolls over in a hard turn stays on its wheels with a bar of a few tens of thousands. With p.Debug 1 and p.DebugVehicles 1 each wheel draws its suspension travel, green while it touches the ground and red while it hangs, and its contact normal.

Drive it by writing the runtime inputs throttle, steer, brake and handbrake each frame. currentRPM and currentGear are written back for engine audio and dashboards.

Set tracked to make it a tank: wheelsPerTrack road wheels per side inside two driven tracks, and steer becomes skid steering, up to a pivot turn at full deflection.

Cloth and soft bodies

A Cloth component builds a Jolt soft body. Its source picks what is simulated: ClothComponent

SourceWhat it simulates
GridA flat segmentsX by segmentsY grid of width by length meters. pinFirstEdge holds the first row, for flags, capes and curtains.
Skinned MeshOne submesh (submeshIndex) of the entity's skinned mesh. Each vertex may drift up to maxDistance from its skinned position; 0 keeps it skinned. A mask painted in the Skeletal Mesh editor's Cloth Paint section, or the red vertex color with maskFromVertexColor, scales that distance per vertex.
Soft Body (Mesh)The entity's static mesh as a free soft body, such as a cushion or jelly. pressure keeps a closed mesh's volume; 0 lets it slump.

stretchCompliance and bendCompliance set the stiffness (0 is rigid), iterations the solver budget, plus mass, linearDamping and gravityFactor. Cloth collides with the world like any dynamic body.

Ragdolls

A Ragdoll component simulates a skeleton with one rigid body per bone. The bodies come from a physics asset when the entity has a PhysicsAsset component, otherwise from an automatic rig built from the skeleton. RagdollComponent

FieldEffect
modeRagdoll (fully simulated), Animated or Hybrid
hybridWeightHow much physics shows through in Hybrid mode
blendInTime, blendOutTimeSeconds to blend from animation to physics and back
pelvisFollowsRootMoves the entity with the simulated pelvis
massMultiplierScales every body's mass
boneOverridesPer-bone mass, radius and joint limits

A physics asset (.physasset) stores the bodies and joints authored for one skeletal mesh in the physics asset editor. Set simulateOnBegin on the PhysicsAsset component to have the character fall as a ragdoll as soon as play begins. PhysicsAssetComponent

Ragdolls and physical animation also run in the editor's Simulate mode, so you can check a setup without entering play.

Physical animation

A PhysicalAnimation component blends physics onto an animated skeleton over a chain of bones, for hit reactions that recover. Motors drive the chain's bodies toward the animated pose while the rest of the skeleton follows the animation. PhysicalAnimationComponent

FieldEffect
boneChainRoot, includeChildrenWhich bones react; an empty root means the whole skeleton
strength, damping, maxTorqueThe motor profile; higher strength tracks the animation tighter
profileOverridesPer-bone profiles, applied in order, so a stiff spine and soft fingers can share a chain
blendWeightThe maximum physics contribution
continuousAlways physically driven, for a limp arm or loose gear
recoverTimeSeconds for a hit to fade back to animation

Hit it from gameplay with ApplyImpulse(boneIndex, impulse) or ApplyImpulseAtPoint(boneIndex, impulse, worldPoint); a bone index of -1 targets the chain root.

HitReact.cpp
#include "ECS/World.h"
#include "Physics/Components/PhysicalAnimationComponent.h"

Mowo::World* world = nullptr;
Mowo::EntityID victim = 0;
Mowo::Vec3 hitDirection(1.0f, 0.0f, 0.0f);
Mowo::Vec3 hitPoint(0.0f, 1.4f, 0.0f);

if (Mowo::PhysicalAnimationComponent* reaction = world->GetComponent<Mowo::PhysicalAnimationComponent>(victim)) {
	reaction->ApplyImpulseAtPoint(-1, hitDirection * 3.0f, hitPoint);
}

Engine sources

This page describes behavior implemented in these files of the engine repository, checked against commit 57ea8e727.

  • Engine/Source/Runtime/Physics/Public/Physics/Components/VehicleComponent.h
  • Engine/Source/Runtime/Physics/Public/Physics/VehicleSystem.h
  • Engine/Source/Runtime/Physics/Public/Physics/Components/ClothComponent.h
  • Engine/Source/Runtime/Physics/Public/Physics/ClothSystem.h
  • Engine/Source/Runtime/Physics/Public/Physics/Components/RagdollComponent.h
  • Engine/Source/Runtime/Physics/Public/Physics/RagdollSystem.h
  • Engine/Source/Runtime/Physics/Public/Physics/Components/PhysicsAssetComponent.h
  • Engine/Source/Runtime/Physics/Public/Physics/PhysicsAsset.h
  • Engine/Source/Runtime/Physics/Public/Physics/Components/PhysicalAnimationComponent.h
  • Engine/Source/Runtime/Physics/Public/Physics/PhysicalAnimationSystem.h

Page feedback

Was this page helpful?