# VehicleOffRoad

> Talos 0.7 · Since 0.7

Off road is slower, not a spin: with wheels on an off-road surface the vehicle is dragged back toward a lower top speed, its handling guard is calmer, and (with a road) its nose turns gently back toward the road.

Absent: none of it, and the vehicle behaves exactly as without the feature; present, a field left out takes its default.

## Fields

| Field | Type | Required | Default | Allowed values | Description |
|---|---|---|---|---|---|
| `surfaces` | `string[]` | no | `["terrain"]` |  | Entity tags that are off road for a wheel on them. Defaults to ["terrain"]. `terrain` also names terrain cells. |
| `topSpeed` | `number` | no | `0` |  | The share of its top speed it may keep with every wheel off road, 0..1. Defaults to 0.62. |
| `drag` | `number` | no | `1` |  | Extra deceleration off road in METRES PER SECOND SQUARED, 0 or more. Defaults to 1.2. Times the share of its wheels off road. |
| `overDecel` | `number` | no | `9` |  | Deceleration in METRES PER SECOND SQUARED while off road above `topSpeed`, 0 or more. Defaults to 9. |
| `guard` | `number` | no | `0` |  | Off road the `handling` guard's `maxSlip` and `maxYawRate` are times this, 0..1. Defaults to 0.7. Calmer, not spinning; no effect without a `handling` block. |
| `steerBack` | `number` | no | `3` |  | METRES beyond a road's edge past which the nose turns gently back to the road; 0 is off. Defaults to 3. Only in a scene with roads. |
