RLS Studios
ProjectsPatreonCommunityDocsAbout
Join Patreon
BeamNG Modding Docs

Guides

Reference

AI Module ReferenceBackwards Compatibility Module ReferenceBdebug Module ReferenceBdebugImpl Module ReferenceBeamstate Module ReferenceBullettime Module ReferenceController Module ReferenceDamageTracker Module ReferenceDrivetrain Module ReferenceElectrics Module ReferenceElectrics Custom Value ParserEnergyStorage Module ReferenceExtensions Module ReferenceFire Module ReferenceVehicle Engine True GlobalsGuihooks Module ReferenceGUI Streams Module ReferenceHTML Texture Module ReferenceHydros Module ReferenceInput Module ReferenceJBeam-Lua Integration GuideMapmgr Module ReferenceMaterial Module ReferenceBeamNG Math & Unit Conversions Referenceobj (Vehicle C++ Object)PartCondition Module ReferenceParticlefilter Module ReferenceParticles Module ReferencePowertrain Module ReferenceVehicle Property & Module TreeProps Module ReferenceProtocols Module ReferenceRecovery Module ReferenceScriptAI Module ReferenceSensors Module ReferenceSounds Module ReferenceStreams Module ReferenceThrusters Module Reference`v` (Vehicle Data & JBeam)Wheels Module Reference
4WD / Transfer Case ControllerAdvanced Coupler ControlAirplane Control SurfacesAxle Lift ControllerBeacon Spin ControllerBeam NavigatorBypass Dampers ControllerController TemplateControl ModesDrag TimerDrive ModesDummy ControllerElectronic Stability Control (ESC)ETK Gauges ControllerVehicle Controllers OverviewHydraulic Suspension ControllerInput/Output Demo ControllerJATO (Jet Assisted Take-Off)Lightbar ControllerLine LockLogger TemplateNitrous Oxide InjectionPlayer ControllerPneumatics System ControllerPower Steering ControllerPyrotechnic Charge ControllerSBR Gauges ControllerShift Lights ControllerTire Pressure ControlTrailer Landing Feet ControllerTwo-Step Launch ControlVivace Gauges ControllerWendover Gauges Controller
Control Management Unit (CMU)
Sensor HubVehicle Data ProcessorVirtual Sensors

UI

Resources

BeamNG Game Engine Lua Cheat SheetGE Developer RecipesMCP Server Setup

// RLS.STUDIOS=true

Premium Mods for BeamNG.drive. Career systems, custom vehicles, and immersive gameplay experiences.

Index

HomeProjectsPatreon

Socials

DiscordPatreon (RLS)Patreon (Vehicles)

© 2026 RLS Studios. All rights reserved.

Modding since 2024

API ReferencevecontrollerdrivingDynamicssensors

Sensor Hub

Central aggregation point for all driving dynamics sensor data. Collects and normalizes readings from wheel speed sensors, accelerometers, gyroscopes, and steering angle sensors into a unified data structure consumed by supervisors.

Central aggregation point for all driving dynamics sensor data. Collects and normalizes readings from wheel speed sensors, accelerometers, gyroscopes, and steering angle sensors into a unified data structure consumed by supervisors.


State Fields

FieldTypeDescription
roll, pitchnumberCurrent vehicle orientation in radians.
rollAV, pitchAV, yawAVnumberRaw rotational velocities (rad/s).
rollAVSmooth, pitchAVSmooth, yawAVSmoothnumberFiltered rotational velocities.
accelerationX, accelerationY, accelerationZnumberRaw accelerations at the reference node (m/s²).
accelerationXSmooth, accelerationYSmooth, accelerationZSmoothnumberFiltered accelerations.
accNoiseX, accNoiseY, accNoiseZnumberEstimated noise levels on the acceleration axes.
vX, vYnumberLocal velocities relative to the vehicle frame.
steeringInputnumberRaw steering input (-1 to 1).

Public API

FunctionDescription
registerCMU(cmu)Links to the CMU.
module.setDebugMode(debugEnabled)Sets the debug mode.
module.shutdown()Shuts down the module and cleans up resources.

Hooks

HookDescription
init(jbeamData)Resets timers and status.
update(dt)Polls FFI sensors and updates orientation, rotation, and acceleration data.
updateGFX(dt)Updates gravity vectors.
module.initLastStage()Final-stage initialization after all controllers and powertrains are ready.
module.reset()Resets the controller to its initial state.

See Also

  • Vehicle Data — Processed vehicle state calculations
  • Virtual Sensors — Software-derived sensor values
  • CMU — Parent control management unit

Electronic Split Shaft Lock

Electronically controlled split shaft (disconnect) actuator. Engages or disengages a driveshaft section to switch between 2WD and AWD modes on demand.

Vehicle Data Processor

Processes raw sensor inputs into derived vehicle state data — speed estimates, slip angles, weight transfer, and dynamic load calculations. Provides the foundation data that supervisors use for intervention decisions.

On this page

State FieldsPublic APIHooksSee Also