RLS Studios
ProjectsPatreonCommunityDocsAbout
Join Patreon
BeamNG Modding Docs

Guides

Reference

Server CommandsGE UtilitiesGame Engine MainNavigation GraphScreenshot CaptureServerServer ConnectionSpawnpoint ManagerSimulation TimeVehicle SpawningSuspension Frequency Tester
Editor AI TestsEditor AI VisualizationEditor – Assembly Spline ToolAsset BrowserAsset DeduplicatorAsset Management ToolSFX Previewer (Audio Events List)Audio Ribbon EditorAutoSaveBarriers EditorBiome ToolBuilding EditorBulk RenameCamera BookmarksCamera TransformCamera Path EditorCEF HelperCo-Simulation Signal EditorCrawl Data EditorCreate Object ToolDataBlock EditorDecal EditorDecal Spline EditorDocumentation HelperDrag Race EditorDrift Data EditorDrive Path EditorDynamic Decals Tool (Vehicle Livery Creator)Engine Audio DebugExtensions DebugExtensions EditorFFI Pointer Leak TestFile DialogFlowgraph EditorForest EditorForest ViewEditor Gizmo HelperEditor Ground Model Debug HelperEditor Headless Editor TestEditor Icon OverviewEditor ImGui C DemoEditor InspectorEditor Layout ManagerEditor Level SettingsEditor Level ValidatorEditor LoggerEditor Log HelperEditor MainEditor Main MenuEditor Main ToolbarEditor Main UpdateMap Sensor EditorMaster Spline EditorMaterial EditorMeasures Inspector HeaderMesh Editor (Base)Mesh Road EditorMesh Spline EditorMission EditorMission PlaybookMission Start Position EditorMulti Spawn Manager (Vehicle Groups)Navigation Mesh EditorEditor News MessageObject Tool (Object Select Edit Mode)Object To Spline EditorParticle EditorPerformance Profiler / Camera RecorderPhysics ReloaderPrefab Instance EditorEditor PreferencesRace / Path EditorRally EditorRaycast Test Editor ToolRenderer Components Editor ToolRender Test Editor ToolResource Checker Editor ToolRiver EditorRoad Architect EditorRoad DecorationsRoad Editor (Decal Road)Road Network ExporterRoad River Cache HandlerRoad River GUIRoad Spline EditorRoad Template EditorRoad UtilitiesScene TreeScene ViewScreenshot Creator BootstrapScript AI EditorScript AI ManagerSensor Configuration EditorSensor DebuggerShape EditorShortcut LegendSidewalk Spline EditorSites EditorSlot Traffic EditorSuspension Audio DebugTech Server ManagerTerraform ToolTerrain And Road ImporterTerrain EditorTerrain Materials EditorText EditorTool ManagerTool ShortcutsTraffic DebugTraffic ManagerTraffic Signals EditorUndo History ViewerVehicle Bridge TestVehicle Detail ViewerVehicle Editor MainEditor - VisualizationEditor Viz HelperEditor Water Object HelperEditor Windows Manager

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 Extensionseditor

Vehicle Editor Main

Main entry point for the Vehicle Editor - manages static/live editor modes, headless editor activation, extension loading, menu creation, and vehicle data management.

Main entry point for the Vehicle Editor - manages static/live editor modes, headless editor activation, extension loading, menu creation, and vehicle data management.


Module: M (extensions.editor.veMain)

FunctionDescription
M.toggleActive()Toggles the vehicle editor on/off
M.saveCurrentWindowLayout()Saves the current window layout for the active editor mode
M.onPreRender(dtReal, dtSim, dtRaw)Updates vehicle position and fires onVehicleEditorRenderJBeams hook
M.onEditorHeadlessChange(enabled, toolName)Handles headless editor enable/disable; sets up or tears down editor state
M.onEditorInitialized()Registers "Vehicle Editor" menu item under Vehicles group
M.onVehicleSwitched(oldVehicle, newVehicle, player)Reinitialises vehicle data for the new vehicle
M.onVehicleDestroyed()Clears all vehicle references
M.onEditorInspectorFieldChanged(selectedIds, fieldName, fieldValue, arrayIndex)Handles color field changes on BeamNGVehicle objects
M.onEditorHeadlessMainMenuBar()Draws custom menu bar (File + FPS/GPU metrics) in headless mode
M.onSerialize() / M.onDeserialize(data)Persists/restores editor mode

Global: vEditor

Property / MethodTypeDescription
vEditor.editorActiveboolWhether the vehicle editor is currently active
vEditor.editorModeintEDITOR_MODE_STATIC (1) or EDITOR_MODE_LIVE (2)
vEditor.setEditorMode(mode)functionSwitches between static/live editor modes
vEditor.getEditorName()functionReturns current editor name string
vEditor.vehicleobjectCurrent vehicle BeamNGVehicle object
vEditor.vehiclePosvec3Current vehicle world position
vEditor.vehDatatableVehicle data from core_vehicle_manager
vEditor.vdatatableShortcut to vehData.vdata
vEditor.nodeCIDToNametable{[cid] = nodeName} lookup
vEditor.selectedNodestableCurrently selected node objects
vEditor.selectedBeamstableCurrently selected beam objects
vEditor.veluaDatatableData received from vehicle Lua
vEditor.staticMenuItemstableMenu items for static editor apps
vEditor.liveMenuItemstableMenu items for live editor apps

Usage Example

-- The vehicle editor is activated via F11 > Vehicles > Vehicle Editor
-- or programmatically:
extensions.editor_veMain.toggleActive()

-- Access vehicle data in other extensions:
if vEditor.editorActive and vEditor.vehicle then
  local veh = vEditor.vehicle
  local pos = vEditor.vehiclePos
  local nodes = vEditor.vdata.nodes

  -- Iterate nodes
  for cid = 0, tableSizeC(nodes) - 1 do
    local node = nodes[cid]
    local name = vEditor.nodeCIDToName[cid]
    local absPos = veh:getNodeAbsPosition(cid)
  end
end

-- Editor modes:
-- STATIC (1): JBeam structure editing (pushes VehicleEditor action map)
-- LIVE   (2): Runtime inspection (standard action map)

-- Live editor apps are auto-discovered from:
-- /lua/ge/extensions/editor/vehicleEditor/liveEditor/ve*.lua
-- Static editor apps from:
-- /lua/ge/extensions/editor/vehicleEditor/staticEditor/ve*.lua

-- Each app extension must expose:
-- Apps typically define menuEntry and open function patterns
-- menuEntry = "Category/App Name"  (menu path)
-- open = function()                (opens the app window)

-- The editor uses headless mode to replace the world editor menubar
-- with a custom File menu and FPS/GPU performance metrics display

Module Variables

  • dependencies (table) - Module variable.

Additional Exports

  • M.dependencies

See Also

  • Editor AI Tests - Related reference
  • Editor AI Visualization - Related reference
  • Editor – Assembly Spline Tool - Related reference
  • World Editor Guide - Guide

Vehicle Detail Viewer

Multi-view orthographic vehicle renderer - creates configurable render views (left, right, front, back, top, bottom) with zoom, pan, near-clip control, and PNG export.

Editor - Visualization

Central visualization management tool for the BeamNG editor, providing toggles for debug rendering modes, object visibility/selectability, material debug overlays with legends, and navgraph visualizat

On this page

Module: M (extensions.editor.veMain)Global: vEditorUsage ExampleModule VariablesAdditional ExportsSee Also