`vehicle`

AI & gameplay Experimental

Chaos Vehicles wheel and suspension assets.

What it's for

This namespace authors the wheel and suspension data behind Unreal's Chaos Vehicles plugin. You use it to create wheel Blueprint assets, tune their properties, attach wheel setups to a wheeled vehicle's movement component, and adjust the suspension that rides on each wheel.

A drivable Chaos vehicle is a movement component that holds a list of wheel setups, and each setup points at a wheel asset that carries the radius, brake and steering behavior, and the whole spring and damping model. These operations let your assistant build that data from a plain-language request instead of clicking through the wheel-asset editor and the component's wheel array by hand.

Reach for vehicle when the change is specific to the Chaos Vehicles wheel and suspension data shape. For general collision setup or physics-asset authoring that is not wheel-specific, use physics instead.

This area is experimental and still improving. The operations work, but names, parameters, and behavior may change between releases as the surface settles.

Examples

Create a front wheel asset

Ask for a new wheel Blueprint with the tuning knobs you care about, and it writes them before saving.

You: Make a steerable front wheel asset with a 16 cm radius and a 30 degree max steer angle.

  call("vehicle.create_wheel_asset", {path:"/Game/Vehicles/BP_FrontWheel",
        radius:16, maxSteerAngle:30, bAffectedBySteering:true})
    → {ok:true, created:true}

Done. Created BP_FrontWheel: 16 cm radius, 30° steering.

Attach the wheel to a vehicle

Point a wheel setup on the movement component at your wheel asset and bind it to a bone.

You: Bind that front wheel to the FL_Wheel bone on BP_RaceCar as the first wheel setup.

  call("vehicle.set_wheel_setup", {componentPath:"/Game/Vehicles/BP_RaceCar.VehicleMovementComp",
        wheelIndex:0, wheelClass:"/Game/Vehicles/BP_FrontWheel", boneName:"FL_Wheel", compile:true})
    → {ok:true, wheelIndex:0}

Done. Wheel setup 0 bound to FL_Wheel.

Tune the suspension

Adjust the spring and damping on the wheel assets referenced by the vehicle's setups.

You: Stiffen the suspension on all wheels of BP_RaceCar - higher spring rate and a bit more damping.

  call("vehicle.set_suspension", {componentPath:"/Game/Vehicles/BP_RaceCar.VehicleMovementComp",
        springRate:80000, dampingRatio:0.8})
    → {ok:true, wheelsTouched:4}

Done. Suspension stiffened across all 4 wheels.

← Back to all namespaces