API ReferenceGE ExtensionseditorvehicleEditorliveEditor
Aero Debug
Live editor app for visualising vehicle aerodynamic forces, torques, and per-axle downforce distribution.
Live editor app for visualising vehicle aerodynamic forces, torques, and per-axle downforce distribution.
Module: M (extensions.editor.vehicleEditor.liveEditor.veAeroDebug)
| Function | Description |
|---|---|
M.open() | Opens the aero debug window |
M.onUpdate(dt) | Draws the aero debug UI; requests data from vehicle Lua aeroDebug extension |
M.onVehicleSwitched(oldVehicle, newVehicle, player) | Disables aeroDebug on old vehicle; resets state |
M.onEditorDeactivated() | Disables aeroDebug on current vehicle |
M.onEditorActivated() | No-op placeholder |
M.onSerialize() / M.onDeserialized(data) | Persists window open state |
| Property | Value |
|---|---|
M.menuEntry | "Aero Debug" |
M.dependencies | {"editor_veMain"} |
Displayed Data
| Section | Fields |
|---|---|
| Vehicle Aero Forces | Total aero force (N) world/vehicle, total aero torque (N) world/vehicle |
| Axle Configuration | FL/FR/RL/RR wheel name dropdowns with auto-fill |
| Axle Aero Forces | Front/rear downforce (N), front/rear downforce (%) |
Usage Example
-- Open via Vehicle Editor > Live Editor > Aero Debug
extensions.editor_vehicleEditor_liveEditor_veAeroDebug.open()
-- The extension communicates with the vehicle Lua VM:
-- 1. Enables vehicle-side aeroDebug: extensions.aeroDebug.enable()
-- 2. Polls aero data each frame via queueLuaCommand
-- 3. Receives serialised aeroData back via queueGameEngineLua
-- Data flow:
-- GE: vehicle:queueLuaCommand('extensions.aeroDebug.enable()')
-- GE: vehicle:queueLuaCommand('obj:queueGameEngineLua("vEditor.aeroData=" .. serialize(...))')
-- GE: vEditor.aeroData is populated with:
-- totalAeroForce (vec3, world)
-- totalAeroForceVehicle (vec3, vehicle-local)
-- totalAeroTorque (vec3, world)
-- totalAeroTorqueVehicle (vec3, vehicle-local)
-- frontDownForce, rearDownForce (N)
-- percentFront, percentRear (%)
-- wheelNameStrings (for combo boxes)
-- vehID (to verify data matches current vehicle)
-- Wheel names can be auto-filled (looks for FL/FR/RL/RR)
-- or manually set via combo boxes and "Set Wheels" button
-- This configures which wheels define the front/rear axlesSee Also
- Adjustable Tech Car Tuner - Related reference
- Crash Tester - Related reference
- Flexbody Debug - Related reference
- World Editor Guide - Guide
Adjustable Tech Car Tuner
Live editor app for tuning the adjustable tech car's dimensional variables (wheelbase, track width, overhang, body width, weight, CoG, yaw inertia) with a visual measurement overlay.
Crash Tester
Live editor app for spawning random vehicles at a picked location and launching them at a target speed for crash testing.