Vehicle Specifications

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)

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)

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

See Also

• Vehicle Selector – Details Interaction - Related reference
• Vehicle Selector – General - Related reference
• Vehicle Selector – Tile Clustering - Related reference
• UI System Guide - Guide