RLS Studios
ProjectsPatreonCommunityDocsAbout
Join Patreon
BeamNG Modding Docs

Guides

Reference

server/commands - Camera & Input Commandsge_utils - Game Engine Utility Functionsmain.lua - GE Lua Entry Point & Game Loopmap.lua - Navigation Graph (AI Road Map)screenshot.lua - Screenshot Systemserver/server - Level Loading & Game ServerserverConnection - Client-Server Connection Manager`setSpawnpoint` - Default Spawn Point Persistence`simTimeAuthority` - Simulation Time & Bullet Time Control`spawn` - Vehicle Spawning & Safe Placement`suspensionFrequencyTester` - Suspension Natural Frequency Analysis
ui/ambientSound - Ambient Sound Stream PlayerUI Apps ManagerUI AudioBindings LegendCamera Distance AppConsole (consoleNG)Credits MusicExternal App (WebSocket UI Server)Fade ScreenGame BlurGameplay App ContainersGrid SelectorLivery EditorMessages DebuggerMessages/Tasks App ContainersMission InfoPolice InfoTop BarUI ModsUI Navigation / MapVehicle Paint EditorVehicle Vicinity AppUI Visibility
Vehicle Selector – Details InteractionVehicle Selector – GeneralVehicle Selector – Tile ClusteringVehicle Selector – Tile GroupingVehicle Selector – TilesVehicle Selector – Tile SortingVehicle Selector – Vehicle OperationsVehicle Selector – Vehicle Specifications

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 ReferenceGE ExtensionsuivehicleSelector

Vehicle Selector – Vehicle Specifications

Builds the detailed specifications panel for a selected vehicle config.

Builds the detailed specifications panel for a selected vehicle config.


Overview

ui_vehicleSelector_vehicleSpecifications assembles the specifications, icon tags, paint data, and metadata for the vehicle details panel. Handles unit conversions (metric/imperial) for all performance values based on user settings.

Extension path: lua/ge/extensions/ui/vehicleSelector/vehicleSpecifications.lua


Exports (M)

FunctionSignatureDescription
getDetails(itemDetails) → tableReturns full details for a vehicle config.
addIconTags(modelDetails, configDetails) → tag[]Returns drivetrain/transmission/induction/fuel icon tags.
makeSpec(modelDetails, configDetails, key, list)Adds a spec entry to a list.
specificationSetuptableSpecification group definitions.
valueToUnittableUnit formatting functions.
CONVERSIONStableUnit conversion constants.

Internals

Specification Groups

  1. Performance - Power, Torque, Weight, Top Speed, 0-60/0-100, braking, weight/power (metric/imperial variants)
  2. Other - Type, Config Type, Transmission, Drivetrain, Propulsion, etc.
  3. Dev Info (when enabled) - model/config keys, file paths, mod info, region

Unit Conversions (CONVERSIONS)

ConstantValueConversion
MPS_TO_KMH3.6m/s → km/h
MPS_TO_MPH2.237m/s → mph
PS_TO_BHP0.986PS → bhp
PS_TO_KW0.735PS → kW
NM_TO_LBFT0.738Nm → lb-ft
KG_TO_LB2.205kg → lb
M_TO_FT3.281m → ft

valueToUnit Functions

Format values by unit type: seconds, g, torque, power, speed, weight, weightPower, distanceMinor, money, years, value. Torque and power include peak RPM when available.

Icon Tags

addIconTags returns icons for:

  • Drivetrain: AWD/RWD/FWD/4WD or NxN format
  • Transmission: Manual/Automatic/Sequential/CVT/DCT
  • Induction: NA/Turbo/SC (with optional N2O)
  • Fuel: Battery/Gasoline/Diesel

Paint Data

getDetails collects:

  • multiPaintSetups - multi-paint configurations valid for the config
  • factoryPaints - all model paints sorted by name

Tags

Source tags: BeamNG Official, Custom, Automation, Mod (with goToMod link), Auxiliary, Missing JBeam.


How It Works

  1. getDetails({model, config}) loads model and config data from core_vehicles.
  2. Builds specification groups based on metric/imperial settings.
  3. Adds icon tags, paint data, general specs, and source tags.
  4. Special handling for settings/default.pc (legacy config).
  5. Returns a complete details object for the UI panel.

Lua Examples

local specs = require('/lua/ge/extensions/ui/vehicleSelector/vehicleSpecifications')

-- Get full details
local details = specs.getDetails({model = "pickup", config = "base"})
print(details.headerTitle)  -- "D-Series Base"

-- Format a power value
local formatted = specs.valueToUnit.power(320)  -- "320 PS" or "316 hp"

-- Get icon tags
local tags = specs.addIconTags(modelDetails, configDetails)
-- → {{icon = "RWD", label = "Drivetrain: Rear Wheel Drive"}, ...}

Additional Exports

The following exports are available but not yet documented in detail:

  • M.CONVERSIONS
  • M.addIconTags
  • M.getDetails
  • M.makeSpec
  • M.specificationSetup
  • M.valueToUnit

Vehicle Selector – Vehicle Operations

Handles vehicle spawning, replacing, cloning, and management actions in the vehicle selector.

Auto Annotation

Automatically annotates scene objects with semantic labels for AI/segmentation.

On this page

OverviewExports (M)InternalsSpecification GroupsUnit Conversions (CONVERSIONS)valueToUnit FunctionsIcon TagsPaint DataTagsHow It WorksLua ExamplesAdditional Exports