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
Drive Path Editor - PlaybackDrive Path Editor - RecordDrive Path Editor - Spline 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 ExtensionseditordrivePathEditor

Drive Path Editor - Playback

Handles AI playback of all linked drive path splines/vehicles. Starts vehicles at their spline's starting node, waits for each spline's delay time, then commands AI driving via `ai.driveUsingPath` in

Handles AI playback of all linked drive path splines/vehicles. Starts vehicles at their spline's starting node, waits for each spline's delay time, then commands AI driving via ai.driveUsingPath in either Free Mode (script path) or NavGraph Mode (waypoint target list).


Public API

FunctionSignatureDescription
M.getPlaybackTime() → numberReturns total elapsed playback time in seconds
M.startPlayback(splines, vehicles)Initializes playback: builds playing table from linked pairs, resets vehicle poses
M.stopPlayback()Stops AI for all playing vehicles, resets to starting positions
M.handlePlayback()Per-frame update: checks delay times, issues AI commands when ready

Playback Flow

startPlayback(splines, vehicles)
  → Build playing table { [vid] = {spline, vehicle, isStarted} }
  → Reset all vehicles to starting positions
  → Reset timers

handlePlayback() (called each frame)
  → For each vehicle not yet started:
      if elapsed time >= spline.delayTime:
        → Build AI command based on mode
        → Queue vLua command
        → Mark as started
  → Update timers

stopPlayback()
  → ai.setState({mode = "stop"}) for all
  → Reset vehicle poses
  → Clear playing table

AI Command - Free Mode

ai.driveUsingPath{
  script = { {x,y,z, r=width, v=vel, vl=velLimit}, ... },
  routeSpeed = 31.3,
  routeSpeedMode = "set",  -- or "limit"
  avoidCars = "on",
  driveInLane = "on",
  aggression = 0.3,
  noOfLaps = nil  -- or number for loops
}

AI Command - NavGraph Mode

ai.driveUsingPath{
  wpTargetList = {"node1", "node2", ...},
  wpSpeeds = {node1 = vel1, node2 = vel2, ...},
  routeSpeed = 31.3,
  routeSpeedMode = "set",
  ...
}

Dependencies

ModulePurpose
editor/drivePathEditor/splineMgrresetVehiclePose(), spline data access
editor/toolUtilities/geomCatmull-Rom interpolation for Free Mode
editor/toolUtilities/rdpRDP simplification of playback nodes (tol=1.0)

See Also

  • Drive Path Editor - Record - Related reference
  • Drive Path Editor - Spline Manager - Related reference
  • World Editor Guide - Guide

Drag Race Editor - Waypoints

Manages standalone drag race waypoint data: loading, selecting, adding (spawn/stage/endLine), removing, saving, and ImGui UI for waypoint editing with transform gizmos and world-space preview.

Drive Path Editor - Record

Records a vehicle's driven path into a new drive path spline. Samples position and velocity at a fixed interval, deduplicates close nodes, applies RDP simplification, and links the result to the recor

On this page

Public APIPlayback FlowAI Command - Free ModeAI Command - NavGraph ModeDependenciesSee Also