JBeam file sections

Jbeam files are divided into multiple sections which each represent one type of element in a vehicle’s structure.

Basic structural elements

These are the main elements of any jbeam, and handle the shape and collisions of a vehicle.

For more information you can read the intro to jbeam

  • Nodes : The first element in a node/beam structure. They are point masses and handle most of a jbeam’s colisions along with the weight of the structure.
  • Beams : Conectors between nodes. Beams allow for flexibility and deformation in a jbeam structure, and define how the different elements are connected to each other.
  • Triangles : Surfaces defined between nodes. Triangles are used for aero calculations, and for colisions between vehicles.

Advanced structural elements

These elements allow for more advanced structural elements, and can be very useful in specific applications

  • Hydros : Beams whose length can be changed on command.
  • Rails and slidenodes : Allows the definition of nodes that slide along a rail. Used for things like steering racks, rigidifying some structures, etc
  • Thrusters : Allows to propel structures directly. Used for testing purposes, jato and others.
  • Torsion bars : Creates a torsion resistance between two lever arms. Used for sway bars and to rigidify some structures.
  • Torsion hydros : Similar to hydros, but insteads changes the angle between 2 lever arms. Used for some steering systems, and other types of actuators.

Part slot system

These elements are mostly used within the part/slot system , either to define some additional information related to the part, or the slots within a part.

  • Information : Defines a few basic parameters associated to the component, like it’s display name in the part selector.
  • Slots : Defines the list of slots within a component, along with the default selection.

Graphical and sound elements

These elements handle the various

  • Flexbodies : Defines the models that will be used to graphically represent your vehicle, and how they are tied to the nodes for deformation.
  • Glowmaps : Allows the definition of materials that can switch on demand. Mostly used to switch the material of lights to an emmissive material when the lights are turned on.
  • Soundscape : Defines sound effects to be played when certain conditions are met, along with the node used as an emitter.
  • Cameras : Defines the position and angle of the various cameras in the vehicle, including exterior and interior cameras.
  • Props : Animated 3d elements that do not deform with the jbeam structure. Used for things like gauges, pedals, steering wheels, etc.

Powertrain

The last section is the elements related to powertrain components, like powertrain definitions and wheels.

  • Powertrain : Used to define the different powertrain elements within a vehicle’s powertrain.
  • Pressure Wheels : Allows to define wheels with a pressured tire model.
  • Rotators : Alternative to pressure wheels in specialised applications, where power needs to be sent to something other than a wheel like a propeller.

Others

  • Variables : Allows the definition of adjustable parameters for a vehicle, usually adjustable suspension and drivetrain components.
  • Triggers : Defines set triggers that the player can activate with the mouse to control different functions of a vehicle.
  • Refnodes : Set of nodes which define the central coordinate system of a vehicle
  • Controller : Used to add special functions to a vehicle, like police lightbars, electronics assists, etc.

Section use

Here is how often the various sections show up in the jbeam of all vanilla content.

Keep in mind that some of those sections, like “mainEngine”, do not really correspond to a jbeam section, but are instead part of an other section that got defined separately for clarity. Those mostly happen with controllers and more complex powertrain elements.

Version 0.36.0.0 uses the following sections:
Name
Count
Name
information
Count
19619
Name
slotType
Count
19618
Name
flexbodies
Count
15302
Name
beams
Count
10741
Name
nodes
Count
10240
Name
triangles
Count
5515
Name
slots
Count
5486
Name
pressureWheels
Count
3736
Name
variables
Count
2823
Name
props
Count
2727
Name
mainEngine
Count
1567
Name
controller
Count
1469
Name
powertrain
Count
1085
Name
sounds
Count
1059
Name
slidenodes
Count
966
Name
rails
Count
939
Name
torsionbars
Count
936
Name
slots2
Count
923
Name
glowMap
Count
741
Name
vehicleController
Count
699
Name
components
Count
665
Name
soundConfigExhaust
Count
638
Name
triggers2
Count
622
Name
triggerEventLinks2
Count
621
Name
actionsEnabled
Count
587
Name
soundConfig
Count
532
Name
globalSkin
Count
413
Name
soundscape
Count
371
Name
gauge
Count
344
Name
cameraExternal
Count
333
Name
refNodes
Count
317
Name
differential_R
Count
305
Name
skinName
Count
287
Name
n2o
Count
271
Name
mirrors
Count
242
Name
gearbox
Count
205
Name
camerasInternal
Count
192
Name
energyStorage
Count
191
Name
turbocharger
Count
179
Name
cargoStorage
Count
171
Name
hydros
Count
168
Name
clutch
Count
166
Name
cameraChase
Count
164
Name
licenseplateFormat
Count
164
Name
torsionReactorF
Count
162
Name
quads
Count
160
Name
torsionHydros
Count
134
Name
differential_F
Count
134
Name
input
Count
133
Name
torqueConverter
Count
112
Name
hoodCatchCoupler
Count
100
Name
hoodLatchCoupler
Count
98
Name
supercharger
Count
97
Name
trunkCoupler
Count
96
Name
hPattern
Count
84
Name
analogOdometer
Count
80
Name
mainTank
Count
77
Name
powertrainDamage
Count
69
Name
torsionReactorR
Count
69
Name
driveModes
Count
59
Name
mainBottle
Count
51
Name
ties
Count
51
Name
singleAxisLever
Count
49
Name
tailgateCoupler
Count
48
Name
shiftLights
Count
44
Name
scaledragCoef
Count
43
Name
triggerEventLinks
Count
42
Name
triggers
Count
42
Name
events
Count
42
Name
door_R_coupler
Count
36
Name
door_L_coupler
Count
36
Name
skinType
Count
31
Name
door_RR_coupler
Count
31
Name
door_RL_coupler
Count
31
Name
scalenodeWeight
Count
30
Name
door_FL_coupler
Count
29
Name
door_FR_coupler
Count
29
Name
brakeControl
Count
25
Name
motorTorqueControl
Count
23
Name
electrics
Count
21
Name
sequentialLever
Count
19
Name
transfercaseControl
Count
17
Name
rotators
Count
17
Name
mainAirTank
Count
16
Name
tractionControl
Count
16
Name
dynDecalMaterials
Count
15
Name
airbagBeamData
Count
14
Name
adaptiveFrontDamper
Count
14
Name
powertrainHydros
Count
13
Name
thrusters
Count
13
Name
sliderLatch
Count
12
Name
tailgateCouplerUpper
Count
12
Name
adaptiveRearDamper
Count
11
Name
bogieSlideMovement
Count
10
Name
motor
Count
10
Name
autoAdjust
Count
10
Name
auxTank
Count
10
Name
airbagBeamSoundData
Count
10
Name
licenseplate_path
Count
10
Name
actuator1
Count
9
Name
jato
Count
9
Name
airSuspensionData
Count
9
Name
airbags
Count
9
Name
airbagCrossFlow
Count
9
Name
airSuspension
Count
9
Name
torsionReactorRR
Count
8
Name
frontBypass
Count
8
Name
differential_RR
Count
8
Name
hoodLatchCouplerR
Count
7
Name
airbrakes_F
Count
7
Name
vehicleData
Count
7
Name
trunkCouplerR
Count
7
Name
trunkCouplerL
Count
7
Name
fifthwheel
Count
7
Name
pump1
Count
7
Name
hoodLatchCouplerL
Count
7
Name
transfercase
Count
7
Name
mainBattery
Count
6
Name
tailgateCatchCoupler
Count
6
Name
kingpin
Count
6
Name
fueltank_L
Count
6
Name
differential_R_1
Count
6
Name
differential_R_0
Count
6
Name
rearBypass
Count
6
Name
fueltank_R
Count
6
Name
hoodLatchR
Count
6
Name
tailgateLatchCoupler
Count
6
Name
cargoDoorRRCoupler
Count
6
Name
differential_R_2
Count
6
Name
driveshaft_2
Count
5
Name
barndoor_R_coupler
Count
5
Name
barndoor_L_coupler
Count
5
Name
soundConfigFront
Count
4
Name
rightDoorCoupler
Count
4
Name
hoodLatchL
Count
4
Name
canopyCoupler
Count
4
Name
frontMotor
Count
4
Name
cargoDoorRLCoupler
Count
4
Name
differential_M
Count
4
Name
leftDoorCoupler
Count
4
Name
toolboxCoupler
Count
4
Name
reverseWarn
Count
4
Name
spareholderCoupler
Count
4
Name
hydraulicsControl
Count
4
Name
adaptiveFrontSwayBar
Count
4
Name
hydraulicsData
Count
4
Name
sleeperDoorLCoupler
Count
3
Name
dumplocks
Count
3
Name
doorBeamData
Count
3
Name
frontTank
Count
3
Name
cabinetDoorLCoupler
Count
3
Name
airbrakes_R
Count
3
Name
destsign
Count
3
Name
esc
Count
3
Name
splitterControl
Count
3
Name
torsionReactor_R
Count
3
Name
hPatternColumn
Count
3
Name
ram1
Count
3
Name
frontLockControl
Count
3
Name
bullbarLatch
Count
3
Name
soundConfigRear
Count
3
Name
cabLatch
Count
3
Name
adaptiveRearSwayBar
Count
3
Name
bedMovement
Count
3
Name
fifthwheelSlideMovement
Count
3
Name
mainTankR
Count
3
Name
mainTankL
Count
3
Name
airCompressor1
Count
3
Name
cabinetDoorRCoupler
Count
3
Name
sidedoor_coupler
Count
3
Name
ram2
Count
3
Name
mainTank_R
Count
3
Name
rearMotor
Count
3
Name
torsionReactor_F
Count
3
Name
torsionReactorGrbx
Count
3
Name
shiftLights_digidash
Count
3
Name
rangeboxControl
Count
2
Name
roofboxCoupler
Count
2
Name
hoodRCoupler
Count
2
Name
decklidCoupler
Count
2
Name
interaxleLockControl
Count
2
Name
dualAxisLever
Count
2
Name
torsionReactor_R_0
Count
2
Name
AVAS
Count
2
Name
lidT1Coupler
Count
2
Name
sidedoor_R_coupler
Count
2
Name
hydraulicsMotor
Count
2
Name
engine
Count
2
Name
sidedoor_F_coupler
Count
2
Name
scalebeamSpring
Count
2
Name
sleeperDoorRCoupler
Count
2
Name
torsionReactor_R_2
Count
2
Name
hoodLCoupler
Count
2
Name
gauges
Count
2
Name
lidT2Coupler
Count
2
Name
tiltLocks
Count
2
Name
centerDiffModes
Count
2
Name
rearDoorCoupler
Count
2
Name
hatchCoupler
Count
2
Name
tirePressureControl
Count
2
Name
door_FL_movement
Count
2
Name
wheelhubR
Count
2
Name
lidBCoupler
Count
2
Name
scalebeamDamp
Count
2
Name
antiLag
Count
2
Name
door_FR_movement
Count
2
Name
doorCrossFlow
Count
2
Name
rollupdoor_movement
Count
2
Name
torsionReactor_R_1
Count
2
Name
hoodCatchL
Count
2
Name
rearLockControl
Count
2
Name
cabTank
Count
2
Name
rearDiffLockControl
Count
2
Name
airbrakes_La
Count
2
Name
absControl
Count
2
Name
doorDisconnectL
Count
1
Name
absLegacy
Count
1
Name
liftAxleMainAirbags
Count
1
Name
airbrakes_F_twinsteer
Count
1
Name
retractPinML
Count
1
Name
airbagBeamData_main
Count
1
Name
googlyEyesL
Count
1
Name
remoteAccumulator
Count
1
Name
safetyBar_BeamData
Count
1
Name
transfercase1
Count
1
Name
bus
Count
1
Name
airbagCrossFlow_lift
Count
1
Name
auxAirTank
Count
1
Name
tailgateCouplerL
Count
1
Name
mixer_ladder
Count
1
Name
stopSign_movement
Count
1
Name
safetyBar_BeamSoundData
Count
1
Name
airbagBeamSoundData_liftAxle_lift
Count
1
Name
emergencyWindowRRCoupler
Count
1
Name
rearHatchOpenCoupler
Count
1
Name
doors_F_BeamSoundData
Count
1
Name
stopSign_BeamData
Count
1
Name
general
Count
1
Name
mixerMotor
Count
1
Name
doorBeamSoundData
Count
1
Name
safetyBar
Count
1
Name
liftAxleLiftAirbags
Count
1
Name
airbagBeamSoundData_liftAxle_main
Count
1
Name
compartmentDoorFCoupler
Count
1
Name
emergencyWindowFLCoupler
Count
1
Name
batteryBoxDoorCoupler
Count
1
Name
emergencyWindowFRCoupler
Count
1
Name
doorDisconnectR
Count
1
Name
retractPinFR
Count
1
Name
ram4
Count
1
Name
googlyEyesR
Count
1
Name
doorsF
Count
1
Name
doors_F_BeamData
Count
1
Name
prisonbusGateFCoupler_L
Count
1
Name
airbagCrossFlow_main
Count
1
Name
supportPinML2
Count
1
Name
prisonbusGateFCoupler_R
Count
1
Name
retractPinRL
Count
1
Name
slidingDoorMoovement_RL
Count
1
Name
door_RL_movement
Count
1
Name
airbagBeamData_lift
Count
1
Name
luggageTrunkCoupler
Count
1
Name
activeCenterDiff
Count
1
Name
storageboxDoors
Count
1
Name
slidingGateDoorMovement_L
Count
1
Name
rightDoorRCouplerR
Count
1
Name
soundConfigBottom
Count
1
Name
step_coupler
Count
1
Name
ram3
Count
1
Name
retractPinRR
Count
1
Name
door_RR_movement
Count
1
Name
supportPinMR
Count
1
Name
supportPinMR2
Count
1
Name
supportPinRL
Count
1
Name
frontHatchPopUpCoupler
Count
1
Name
tailgateCouplerR
Count
1
Name
torsionReactor_M
Count
1
Name
rampRCoupler
Count
1
Name
supportPinML
Count
1
Name
emergencyWindowRLCoupler
Count
1
Name
nextstop
Count
1
Name
motorTop
Count
1
Name
rampLCoupler
Count
1
Name
supportPinRR
Count
1
Name
supportPinRR2
Count
1
Name
airbrakes
Count
1
Name
leftDoorRCouplerR
Count
1
Name
soundConfigTop
Count
1
Name
soundConfigMixer
Count
1
Name
portaPottyDoorCoupler
Count
1
Name
slidingGateDoorMovement_R
Count
1
Name
auxTankCrossFlow
Count
1
Name
doorFRLatchCoupler
Count
1
Name
doors
Count
1
Name
frontHatchOpenCoupler
Count
1
Name
safetyBar_movement
Count
1
Name
supportPinRL2
Count
1
Name
mainTank_L
Count
1
Name
safetyBarCrossFlow
Count
1
Name
ram5
Count
1
Name
mainMotor
Count
1
Name
stopSign
Count
1
Name
doorSLatchCoupler
Count
1
Name
doorFRLockCoupler
Count
1
Name
auxTank2
Count
1
Name
lidBCoupler_R
Count
1
Name
hoodCoupler
Count
1
Name
doorFLLockCoupler
Count
1
Name
retractPinMR
Count
1
Name
portaPottyLockCoupler
Count
1
Name
mainTankFL
Count
1
Name
liftAxleControl
Count
1
Name
retractPinFL
Count
1
Name
prisonbusGateRCoupler
Count
1
Name
mixer_chute_lock
Count
1
Name
liftCoupler
Count
1
Name
mainTankFR
Count
1
Name
doorRLLockCoupler
Count
1
Name
motorBottom
Count
1
Name
rearTank
Count
1
Name
doorRLLatchCoupler
Count
1
Name
slidingDoorMoovement_RR
Count
1
Name
doorFLLatchCoupler
Count
1
Name
doorRRLockCoupler
Count
1
Name
stopSignCrossFlow
Count
1
Name
compartmentDoorRCoupler
Count
1
Name
doorRRLatchCoupler
Count
1
Name
lidT1Coupler_R
Count
1
Name
lidT2Coupler_R
Count
1
Name
doorSLockCoupler
Count
1
Name
scalebeamDeform
Count
1
Name
rearHatchPopUpCoupler
Count
1
Last modified: December 25, 2021

Any further questions?

Join our discord
Our documentation is currently incomplete and undergoing active development. If you have any questions or feedback, please visit this forum thread.