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.33.3.0 uses the following sections:
Name
Count
Name
information
Count
17428
Name
slotType
Count
17427
Name
flexbodies
Count
13665
Name
beams
Count
9651
Name
nodes
Count
9066
Name
slots
Count
5492
Name
triangles
Count
4751
Name
pressureWheels
Count
3591
Name
variables
Count
2542
Name
props
Count
2332
Name
mainEngine
Count
1350
Name
controller
Count
1288
Name
powertrain
Count
1028
Name
sounds
Count
875
Name
slidenodes
Count
860
Name
rails
Count
837
Name
torsionbars
Count
818
Name
vehicleController
Count
625
Name
glowMap
Count
583
Name
soundConfigExhaust
Count
535
Name
triggers
Count
454
Name
soundConfig
Count
447
Name
triggerEventLinks
Count
413
Name
events
Count
405
Name
globalSkin
Count
330
Name
soundscape
Count
317
Name
gauge
Count
309
Name
cameraExternal
Count
297
Name
refNodes
Count
293
Name
differential_R
Count
273
Name
n2o
Count
257
Name
skinName
Count
238
Name
slots2
Count
224
Name
mirrors
Count
202
Name
gearbox
Count
192
Name
turbocharger
Count
172
Name
energyStorage
Count
171
Name
cargoStorage
Count
168
Name
hydros
Count
163
Name
torsionReactorF
Count
162
Name
clutch
Count
159
Name
cameraChase
Count
150
Name
camerasInternal
Count
149
Name
licenseplateFormat
Count
142
Name
quads
Count
129
Name
input
Count
128
Name
differential_F
Count
123
Name
torsionHydros
Count
121
Name
components
Count
106
Name
torqueConverter
Count
104
Name
actionsEnabled
Count
101
Name
hoodCatchCoupler
Count
95
Name
triggers2
Count
93
Name
triggerEventLinks2
Count
93
Name
hoodLatchCoupler
Count
92
Name
trunkCoupler
Count
89
Name
hPattern
Count
76
Name
analogOdometer
Count
71
Name
mainTank
Count
70
Name
powertrainDamage
Count
69
Name
supercharger
Count
69
Name
torsionReactorR
Count
67
Name
driveModes
Count
52
Name
mainBottle
Count
49
Name
singleAxisLever
Count
48
Name
tailgateCoupler
Count
47
Name
ties
Count
44
Name
shiftLights
Count
42
Name
scaledragCoef
Count
39
Name
doorRLCoupler
Count
29
Name
doorRRCoupler
Count
29
Name
doorFLCoupler
Count
28
Name
doorFRCoupler
Count
28
Name
scalenodeWeight
Count
25
Name
doorLCoupler
Count
25
Name
doorRCoupler
Count
25
Name
brakeControl
Count
22
Name
electrics
Count
21
Name
motorTorqueControl
Count
20
Name
sequentialLever
Count
19
Name
rotators
Count
17
Name
transfercaseControl
Count
16
Name
mainAirTank
Count
15
Name
adaptiveFrontDamper
Count
14
Name
tractionControl
Count
14
Name
dynDecalMaterials
Count
13
Name
powertrainHydros
Count
13
Name
sliderLatch
Count
12
Name
adaptiveRearDamper
Count
11
Name
thrusters
Count
11
Name
bogieSlideMovement
Count
10
Name
licenseplate_path
Count
10
Name
airbagBeamData
Count
10
Name
motor
Count
10
Name
autoAdjust
Count
10
Name
airbagBeamSoundData
Count
9
Name
actuator1
Count
9
Name
auxTank
Count
9
Name
differential_RR
Count
8
Name
frontBypass
Count
8
Name
torsionReactorRR
Count
8
Name
airSuspensionData
Count
7
Name
hoodLatchCouplerL
Count
7
Name
airSuspension
Count
7
Name
airbrakes_F
Count
7
Name
fifthwheel
Count
7
Name
transfercase
Count
7
Name
trunkCouplerL
Count
7
Name
airbags
Count
7
Name
trunkCouplerR
Count
7
Name
hoodLatchCouplerR
Count
7
Name
jato
Count
7
Name
differential_R_2
Count
6
Name
rearBypass
Count
6
Name
kingpin
Count
6
Name
fueltank_R
Count
6
Name
fueltank_L
Count
6
Name
hoodLatchR
Count
6
Name
tailgateCatch
Count
6
Name
differential_R_0
Count
6
Name
pump1
Count
6
Name
vehicleData
Count
6
Name
differential_R_1
Count
6
Name
driveshaft_2
Count
5
Name
cargoDoorRRCoupler
Count
5
Name
rearDiffLockControl
Count
5
Name
hoodLatchL
Count
4
Name
bedCoverCoupler
Count
4
Name
rightDoorCoupler
Count
4
Name
hoodCatch
Count
4
Name
camperShellLatch
Count
4
Name
rearLeftDoorCoupler
Count
4
Name
door_FL_coupler
Count
4
Name
rearRightDoorCoupler
Count
4
Name
leftDoorCoupler
Count
4
Name
adaptiveFrontSwayBar
Count
4
Name
door_FR_coupler
Count
4
Name
hoodLatchF
Count
4
Name
hydraulicsControl
Count
4
Name
canopyCoupler
Count
4
Name
differential_M
Count
4
Name
hydraulicsData
Count
4
Name
toolboxCoupler
Count
4
Name
reverseWarn
Count
4
Name
mainBattery
Count
4
Name
ram2
Count
3
Name
rearMotor
Count
3
Name
cabinetDoorLCoupler
Count
3
Name
cabLatch
Count
3
Name
adaptiveRearSwayBar
Count
3
Name
cargoDoorRLCoupler
Count
3
Name
esc
Count
3
Name
torsionReactor_F
Count
3
Name
dumplocks
Count
3
Name
sleeperDoorLCoupler
Count
3
Name
rearDoorCoupler
Count
3
Name
destsign
Count
3
Name
frontMotor
Count
3
Name
doorBeamData
Count
3
Name
shiftLights_digidash
Count
3
Name
bullbarLatch
Count
3
Name
frontLockControl
Count
3
Name
fifthwheelSlideMovement
Count
3
Name
torsionReactor_R
Count
3
Name
airCompressor1
Count
3
Name
mainTankR
Count
3
Name
splitterControl
Count
3
Name
bedMovement
Count
3
Name
airbrakes_R
Count
3
Name
hPatternColumn
Count
3
Name
soundConfigFront
Count
3
Name
mainTankL
Count
3
Name
soundConfigRear
Count
3
Name
cabinetDoorRCoupler
Count
3
Name
ram1
Count
3
Name
hydraulicsMotor
Count
2
Name
value
Count
2
Name
scalebeamSpring
Count
2
Name
torsionReactorGrbx
Count
2
Name
ambulanceSideDoorCoupler
Count
2
Name
torsionReactor_R_0
Count
2
Name
AVAS
Count
2
Name
gauges
Count
2
Name
lidT1Coupler
Count
2
Name
torsionReactor_R_2
Count
2
Name
sleeperDoorRCoupler
Count
2
Name
scalebeamDamp
Count
2
Name
absControl
Count
2
Name
tiltLocks
Count
2
Name
lidBCoupler
Count
2
Name
lidT2Coupler
Count
2
Name
rightFrontDoorCoupler
Count
2
Name
wheelhubR
Count
2
Name
engine
Count
2
Name
interaxleLockControl
Count
2
Name
rightRearDoorCoupler
Count
2
Name
doorCoupler
Count
2
Name
roofboxCoupler
Count
2
Name
hoodCoupler
Count
2
Name
rangeboxControl
Count
2
Name
tirePressureControl
Count
2
Name
hoodCatchL
Count
2
Name
airbrakes_La
Count
2
Name
rollupdoor_movement
Count
2
Name
torsionReactor_R_1
Count
2
Name
rearLockControl
Count
2
Name
tailgateLatch
Count
2
Name
spareholderCoupler
Count
2
Name
tailgateDoorCoupler
Count
1
Name
mainTankFL
Count
1
Name
mixer_ladder
Count
1
Name
supportPinRL2
Count
1
Name
auxAirTank
Count
1
Name
rightDoorRCouplerR
Count
1
Name
engineDoorCoupler
Count
1
Name
airbrakes
Count
1
Name
airbrakes_F_twinsteer
Count
1
Name
supportPinML2
Count
1
Name
lockCoupler
Count
1
Name
storageboxDoors
Count
1
Name
mixerMotor
Count
1
Name
doorBeamSoundData
Count
1
Name
liftAxleLiftAirbags
Count
1
Name
retractPinRL
Count
1
Name
general
Count
1
Name
retractPinFR
Count
1
Name
rearTank
Count
1
Name
doorDisconnectR
Count
1
Name
remoteAccumulator
Count
1
Name
airbagBeamData_lift
Count
1
Name
BoxDoorLCoupler
Count
1
Name
retractPinML
Count
1
Name
motorBottom
Count
1
Name
slidingDoorMoovement_RL
Count
1
Name
backGlassLatch
Count
1
Name
airbagBeamData_main
Count
1
Name
mixer_chute_lock
Count
1
Name
ram4
Count
1
Name
retractPinFL
Count
1
Name
liftAxleControl
Count
1
Name
absLegacy
Count
1
Name
frontTank
Count
1
Name
mainMotor
Count
1
Name
torsionReactor_M
Count
1
Name
decklidCoupler
Count
1
Name
ram5
Count
1
Name
mainTank_L
Count
1
Name
retractPinMR
Count
1
Name
supportPinMR
Count
1
Name
soundConfigTop
Count
1
Name
motorTop
Count
1
Name
supportPinMR2
Count
1
Name
auxTankCrossFlow
Count
1
Name
scalebeamDeform
Count
1
Name
supportPinRR2
Count
1
Name
nextstop
Count
1
Name
rampLCoupler
Count
1
Name
rampRCoupler
Count
1
Name
liftCoupler
Count
1
Name
transfercase1
Count
1
Name
soundConfigBottom
Count
1
Name
mainTank_R
Count
1
Name
mainTankFR
Count
1
Name
slidingDoorMoovement_RR
Count
1
Name
bus
Count
1
Name
lidBCoupler_R
Count
1
Name
liftAxleMainAirbags
Count
1
Name
BoxDoorRCoupler
Count
1
Name
doors
Count
1
Name
tailgateBoxCoupler
Count
1
Name
lidT2Coupler_R
Count
1
Name
supportPinRR
Count
1
Name
ram3
Count
1
Name
step_coupler
Count
1
Name
lidT1Coupler_R
Count
1
Name
supportPinRL
Count
1
Name
doorDisconnectL
Count
1
Name
leftDoorRCouplerR
Count
1
Name
supportPinML
Count
1
Name
retractPinRR
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.