API ReferenceGE ExtensionseditorvehicleEditorliveEditor
Flexbody Debug
Live editor app for inspecting and debugging flexbody meshes - visualises vertices, nodes, locator coordinates, and detects problematic vertices (spiking, lacking nearby nodes).
Live editor app for inspecting and debugging flexbody meshes - visualises vertices, nodes, locator coordinates, and detects problematic vertices (spiking, lacking nearby nodes).
Module: M (extensions.editor.vehicleEditor.liveEditor.veFlexbodyDebug)
| Function | Description |
|---|---|
M.open() | Opens the flexbody debug window |
M.onUpdate(dt) | Draws UI with flexmesh selection, node/vertex picking, and analysis tools |
M.onVehicleEditorRenderJBeams(dtReal, dtSim, dtRaw) | Renders flexbody debug visualisation (vertices, nodes, locator lines) |
M.onVehicleSwitched(oldVehicle, newVehicle, player) | Switches to new vehicle's flexbody data |
M.onVehicleSpawned(id) | Clears cached data for respawned vehicle |
M.onSerialize() / M.onDeserialized(data) | Persists window open state |
| Property | Value |
|---|---|
M.menuEntry | "Flexbody Debug" |
M.dependencies | {"editor_veMain"} |
Modes
| Mode | Description |
|---|---|
MODE_DEFAULT | Shows all vertices and nodes of selected flexbody |
MODE_PICKING_NODE | Click to select a node; filters vertices to those using that node |
MODE_PICKED_NODE | Shows picked node and its associated vertices |
MODE_PICKING_VERTEX | Click to select a vertex |
MODE_PICKED_VERTEX | Shows vertex locator info: ref/nx/ny/nz nodes with coordinate axes |
MODE_SHOW_VERTICES_LACKING_NODES | Highlights vertices far from their nearest nodes |
Analysis Tools
| Tool | Description |
|---|---|
| Find vertices lacking nearby nodes | IQR-based outlier detection for vertex-to-node distances |
| Find vertices with OOB coords | Locator coordinates outside ±0.5…1.5 range (potential spiking) |
Usage Example
-- Open via Vehicle Editor > Live Editor > Flexbody Debug
extensions.editor_vehicleEditor_liveEditor_veFlexbodyDebug.open()
-- Single Flexmesh tab:
-- 1. Select a flexmesh from the dropdown or type to search
-- 2. All other meshes are hidden; selected mesh shown at configurable alpha
-- 3. Vertices rendered as colour-coded spheres (position → RGB mapping)
-- 4. Lines drawn from vertices to their locator nodes (opacity = distance)
-- 5. Unused nodes shown as dim orange spheres
-- Node picking:
-- * Click "Pick Node" then click a node in the viewport
-- * Only vertices assigned to that node are shown
-- * Node name and debug sphere drawn at node position
-- Vertex picking:
-- * Click "Pick Vertex" then click a vertex
-- * Shows locator info: ref node, nx/ny/nz axis nodes
-- * Draws coloured axis lines (R=X, G=Y, B=Z)
-- * Displays locator coordinates as text overlay
-- All Flexmeshes tab:
-- * "Find vertices lacking nearby nodes" - IQR statistical outlier test
-- Identifies vertices whose nearest node is unusually far away
-- * "Find vertices with OOB coords" - checks locator coordinates
-- Flags coords outside [-0.5, 1.5] as potential spike sources
-- Per-vehicle settings (favorite meshes) saved to:
-- /settings/editor/flexbodyDebug_settings.json
-- Rendering proximity filter: only vertices within maxDistFromCursor
-- (default 2.0m) of the mouse ray are rendered for performanceSee Also
- Adjustable Tech Car Tuner - Related reference
- Aero Debug - Related reference
- Crash Tester - Related reference
- World Editor Guide - Guide
Crash Tester
Live editor app for spawning random vehicles at a picked location and launching them at a target speed for crash testing.
General Data
Live editor app displaying real-time vehicle telemetry: position, rotation, velocity, acceleration, airspeed, ground speed, environmental conditions, and damage.