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

Editor Main Update

Core per-frame update loop for the editor. Drives edit mode updates, object icon rendering, preference broadcasting, gizmo rendering, GUI presentation, and collision rebuild checks.

Core per-frame update loop for the editor. Drives edit mode updates, object icon rendering, preference broadcasting, gizmo rendering, GUI presentation, and collision rebuild checks.

Module Overview

AspectDetail
Fileextensions/editor/mainUpdate.lua
ReturnsM table
RoleEditor frame update orchestration

Public Functions

FunctionSignatureDescription
M.onUpdate(dtReal, dtSim, dtRaw)Main per-frame update - only runs when editor.active is true
M.onExtensionLoaded()Extension load hook (no-op)
M.onExtensionUnloaded()Extension unload hook (no-op)

Update Pipeline (per frame)

1. editor.updateObjectIcons()          -- Update icon positions/visibility
2. preferencesRegistry:broadcastPreferenceValueChanged()
   └── editor.savePreferences()        -- Auto-save if any pref changed
3. editor.editMode.onUpdate(dt...)     -- Active edit mode update
4. drawMainEditorGizmos()              -- Object icons (if not hidden)
5. editor.guiModule.presentGui(dt...)  -- ImGui presentation
6. editor.valueInspectorCopyPasteMenu()
7. editor.valueInspectorFilenameContextMenu()
8. editor.modalDialogWindowUi()
9. editor.saveDirtyToolsUi()
10. editor.rebuildCollision()           -- If flagged

Usage Context

This module is loaded as editor_mainUpdate and its onUpdate is called by the engine's main loop. It coordinates all editor subsystems each frame.

-- The update only fires when the editor is active
if editor.active then
  -- All editor per-frame work happens here
end

Note: M.onEditorInitialized is explicitly set to nil, indicating this module has no initialization needs - it relies on editor_main for setup.

See Also

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

Editor Main Toolbar

Renders the editor's main toolbar with edit mode buttons, transform snapping controls (grid/rotation/scale), camera speed slider, time-of-day slider, terrain snap settings, and configurable edit mode

Map Sensor Editor

Editor tool for placing and configuring map-attached sensors (Camera, LiDAR, Ultrasonic, RADAR). Requires `Research` build flag. Provides full ImGui UI for sensor management, live/edit mode toggling,

On this page

Module OverviewPublic FunctionsUpdate Pipeline (per frame)Usage ContextSee Also