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
Vehicle Controller
Automatic Gearbox Shift LogicCVT Gearbox Shift LogicCVT Gearbox v2 Shift LogicDCT Gearbox Shift LogicDummy Shift LogicElectric Motor Shift LogicManual Gearbox Shift LogicSequential Gearbox Shift Logic

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 ReferencevecontrollervehicleControllershiftLogic

CVT Gearbox Shift Logic

Shift logic module for Continuously Variable Transmissions (CVT). Manages the target ratio based on power demand and efficiency, providing seamless ratio changes without discrete gear steps.

Shift logic module for Continuously Variable Transmissions (CVT). Manages the target ratio based on power demand and efficiency, providing seamless ratio changes without discrete gear steps.


State Fields

FieldTypeDescription
gearboxHandling, timer, timerConstants, inputValues, shiftPreventionData, shiftBehavior, smoothedValuestableshared controller state and configuration.
currentGearIndex, maxGearIndex, minGearIndexnumberGear metadata (CVT typically treats D as 1 and R as -1).
throttle, brake, clutchRatio, shiftingAggression, throttleInputnumberInput and intent state.
isArcadeSwitched, isSportModeActivebooleanLogic status flags.
smoothedAvgAVInput, rpm, idleRPM, maxRPMnumberSpeed telemetry.
engineThrottle, engineLoad, engineTorque, flywheelTorque, gearboxTorquenumberPowertrain load telemetry.
ignition, isEngineRunningbooleanengine status.
oilTemp, waterTemp, checkEnginenumberThermal diagnostics.
energyStoragestablelinked fuel sources.

Public API

FunctionDescription
shiftUp()Manages PRND mode selection.
getGearName()returns the active mode name and visual gauge position.
getState()State persistence for transmission mode.

Hooks

HookDescription
init(jbeamData, sharedFunctionTable)Configures CVT target RPM ranges (high/low) and initializes ratio smoothers.
gearboxBehaviorChanged(behavior)Selects the appropriate update loop for the CVT.

See Also

  • Vehicle Controller — Parent controller
  • CVT Gearbox v2 — Updated CVT implementation

Automatic Gearbox Shift Logic

Shift logic module for traditional torque-converter automatic transmissions. Manages upshift/downshift points based on throttle position, vehicle speed, and driver aggression. Supports sport mode, kickdown, and manual override.

CVT Gearbox v2 Shift Logic

Updated CVT shift logic with improved ratio management and response characteristics. Second-generation implementation with better fuel efficiency optimization and sportier throttle response.

On this page

State FieldsPublic APIHooksSee Also