State

Overview

The State sensor exposes the host vehicle’s pose and motion in world space: simulation time, position, direction, up vector, velocity, front reference point, and orientation quaternion. It is a non-positional ground-truth source with no physical hardware equivalent.

Positions and vectors are in world space (Z-up map coordinates). See Coordinate systems .

The sensor is available to use from Python API . It has no extensions.tech_sensors.create* / get*Readings Lua API.

Usage

This sensor does not use extensions.tech_sensors.create*. Request it through a tech client (BeamNGpy, ROS, or similar) with a vehicle SensorRequest containing {type = 'State'}.

{type = 'State'}

Args:

None.

Returns: response(table):

• type: 'VehicleUpdate'
• state: table with the fields below

This sensor has no extensions.tech_sensors.create* / get*Readings Lua API. For BeamNGpy usage, attributes, and poll response fields, see the Python API .