# VehicleChassis

> Talos next · Since 0.6

## Fields

| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `mass` | `number` | no |  |  | Kerb mass in kilograms, greater than zero. Outside 400..8,000 kg the `vehicle-value-implausible` warning fires. Occupants and cargo are not modelled separately; put them in here. |
| `centerOfMass` | `Vec3` | no |  |  | Centre of mass in metres, in the entity's LOCAL frame and BEFORE transform.scale, measured from the entity origin. Lower is more stable and it is the single strongest handling number in the component: a car that rolls over in every corner usually has this too high rather than a tyre problem. Slightly rearward of the wheelbase centre is typical. |
| `inertia` | `Vec3` | no |  |  | Principal moments of inertia about the centre of mass in kg·m², as [Ixx, Iyy, Izz] — roll, yaw and pitch resistance in that order, given the engine's axes. Absent means the solver derives them from the chassis collider, which is the right answer for a first pass; author them only when a measured vehicle is being matched. This is the ONE field that is still optional after preset resolution. |

## See also

- `Vec3`