Co-Simulation Signal Editor

Editor tool for configuring co-simulation signal coupling between BeamNG vehicles and external 3rd-party simulators via UDP. Also provides vehicle signal logging (VSL) capabilities for kinematics, driver inputs, wheel data, electrics, powertrain, and sensor data.

Public Functions

Key Features

• Vehicle Signal Browser - View available signals from selected vehicle
• UDP Configuration - Set send/receive IP addresses and ports
• Signal Categories - Kinematics, driver inputs, wheels, electrics, powertrain, sensors
• Pose Tracking - Optional vehicle pose (position/rotation) logging
• Computation Timing - Configure expected 3rd-party computation and ping times
• VSL Logging - Vehicle Signal Logger for recording vehicle data
• Co-Simulation - Real-time signal exchange with external simulators

Signal Categories

UDP Configuration

Internal Communication

Uses lpack for encoding/decoding data between GE Lua and vehicle Lua (vlua):

local function updateCollectedVehicleData(collectedData)
  cData = lpack.decode(collectedData)
  isVluaDataReturned = true
end

Functions

updateCollectedVehicleData(collectedData)

Callback from vlua when vehicle signal data has been collected. Decodes the lpack-encoded data.

• collectedData (string) - lpack-encoded vehicle data from vlua

onEditorInitialized()

Registers the co-simulation edit mode and tool windows (requires tech_license).

onEditorGui()

Main per-frame UI rendering for the signal editor and vehicle signals window.

onVehicleReplaced(vid)

Clears the signals list when a vehicle is replaced.

• vid (number) - Vehicle ID

onVehicleSpawned(vid)

Resets execution state when a vehicle spawns (e.g. on CTRL+R reset).

• vid (number) - Vehicle ID

Additional Exports

• M.onVehicleReplaced
• M.onVehicleSpawned
• M.updateCollectedVehicleData

See Also

• globals - Vehicle access and communication patterns