API ReferenceGE ExtensionseditorvehicleEditorliveEditor
JBeam Picker
Live editor app for interactively picking, inspecting, and monitoring nodes and beams in the 3D viewport - displays static JBeam data, live telemetry graphs, and supports text-based search.
Live editor app for interactively picking, inspecting, and monitoring nodes and beams in the 3D viewport - displays static JBeam data, live telemetry graphs, and supports text-based search.
Module: M (extensions.editor.vehicleEditor.liveEditor.veJBeamPicker)
| Function | Description |
|---|---|
M.open() | Opens the JBeam Picker window |
M.onUpdate(dt) | Draws UI: menu bar, node/beam selection, picked items tree with live data |
M.onVehicleEditorRenderJBeams(dtReal, dtSim, dtRaw) | Renders picked nodes/beams in viewport; handles click-to-pick |
M.onEditorInitialized() | Populates beam type rendering toggle table |
M.requestDrawnNodesCallback(nodes, scale) | Receives drawn node list from vehicle Lua bdebug |
M.requestDrawnBeamsCallback(beams, scale) | Receives drawn beam list from vehicle Lua bdebug |
M.onSerialize() / M.onDeserialized(data) | Persists window open state |
| Property | Value |
|---|---|
M.menuEntry | "JBeam Picker" |
M.nodeDataFromVELua | Table receiving node live data from vehicle Lua |
M.beamDataFromVELua | Table receiving beam live data from vehicle Lua |
Node Live Data Series
| Series | Units | Source |
|---|---|---|
| Displacement | m | Node position length from ref |
| Speed | m/s | Node velocity magnitude |
| Relative Speed | m/s | Node velocity minus vehicle velocity |
| Force | N | obj:getNodeForceVector(id):length() |
Beam Live Data Series
| Series | Units | Source |
|---|---|---|
| Length | m | Distance between beam endpoints |
| Speed | m/s | obj:getBeamVelocity(id) |
| Force | N | obj:getBeamForce(id) |
| Stress | N | obj:getBeamStressDamp(id) select 1 |
| Damping | N | obj:getBeamStressDamp(id) select 2 |
Beam Types
| Constant | Name |
|---|---|
| 0 | NORMALTYPE |
| 1 | BEAM_ANISOTROPIC |
| 2 | BEAM_BOUNDED |
| 3 | BEAM_PRESSURED |
| 4 | BEAM_LBEAM |
| 5 | BEAM_BROKEN |
| 6 | BEAM_HYDRO |
| 7 | BEAM_SUPPORT |
Usage Example
-- Open via Vehicle Editor > Live Editor > JBeam Picker
extensions.editor_vehicleEditor_liveEditor_veJBeamPicker.open()
-- Requires Node/Beam Debug Modes active (Ctrl+M / Ctrl+B)
-- Picking nodes:
-- 1. Click "Pick Nodes" button (or type name to search)
-- 2. Hover nodes in viewport - closest to camera highlighted orange
-- 3. Left-click to pick/unpick (toggle)
-- 4. Picked nodes shown as red spheres with labels
-- Picking beams:
-- 1. Click "Pick Beams" button (or type name to search)
-- 2. Hover beams - closest to cursor highlighted magenta
-- 3. Left-click to pick/unpick
-- 4. Picked beams shown as red cylinders with labels
-- Picked items tree shows:
-- * Static Data: full JBeam data as recursive tree
-- * Live Data: configurable data series with real-time graphs
-- - PlotLines showing last 1000 frames
-- - Live value + rolling average display
-- - Rainbow-colored per-series labels
-- View menu allows toggling:
-- * Which node data series to display
-- * Which beam data series to display
-- * Which beam types are pickable
-- * Graph visibility toggle
-- Node display text: "name / tag" or "cid / tag"
-- Beam display text: "node1 - node2 (name cid) / tag"See Also
- Adjustable Tech Car Tuner - Related reference
- Aero Debug - Related reference
- Crash Tester - Related reference
- World Editor Guide - Guide
General Data
Live editor app displaying real-time vehicle telemetry: position, rotation, velocity, acceleration, airspeed, ground speed, environmental conditions, and damage.
Vehicle Editor - Lights Debug
Visualizes spotlight and point light props on the active vehicle in the Vehicle Editor, drawing debug spheres, direction arrows, and labels in 3D.