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.24.1.1 uses the following sections:
Name
Count
Name
information
Count
10278
Name
slotType
Count
10277
Name
flexbodies
Count
8143
Name
beams
Count
5710
Name
nodes
Count
5378
Name
slots
Count
3390
Name
triangles
Count
2541
Name
pressureWheels
Count
2408
Name
variables
Count
1576
Name
props
Count
1220
Name
mainEngine
Count
884
Name
powertrain
Count
698
Name
vehicleController
Count
414
Name
torsionbars
Count
366
Name
controller
Count
365
Name
slidenodes
Count
319
Name
rails
Count
315
Name
soundConfig
Count
274
Name
glowMap
Count
242
Name
n2o
Count
213
Name
soundConfigExhaust
Count
208
Name
differential_R
Count
202
Name
globalSkin
Count
190
Name
soundscape
Count
187
Name
skinName
Count
159
Name
hydros
Count
148
Name
torsionReactorF
Count
130
Name
cameraExternal
Count
129
Name
gearbox
Count
129
Name
refNodes
Count
129
Name
clutch
Count
119
Name
licenseplateFormat
Count
106
Name
input
Count
101
Name
energyStorage
Count
93
Name
camerasInternal
Count
88
Name
turbocharger
Count
86
Name
differential_F
Count
79
Name
cameraChase
Count
76
Name
torqueConverter
Count
73
Name
quads
Count
67
Name
torsionReactorR
Count
55
Name
supercharger
Count
45
Name
mainTank
Count
44
Name
mainBottle
Count
38
Name
driveModes
Count
37
Name
shiftLights
Count
34
Name
torsionHydros
Count
34
Name
triggers
Count
34
Name
events
Count
32
Name
scaledragCoef
Count
32
Name
triggerEventLinks
Count
31
Name
ties
Count
30
Name
powertrainDamage
Count
29
Name
engine
Count
19
Name
brakeControl
Count
17
Name
motorTorqueControl
Count
17
Name
interiorSounds
Count
14
Name
rotators
Count
12
Name
tractionControl
Count
12
Name
gauge
Count
11
Name
licenseplate_path
Count
10
Name
autoAdjust
Count
10
Name
adaptiveFrontDamper
Count
9
Name
thrusters
Count
8
Name
adaptiveRearDamper
Count
7
Name
etkGauges
Count
6
Name
vehicleData
Count
6
Name
airbagBeamData
Count
6
Name
scalenodeWeight
Count
5
Name
mainBattery
Count
4
Name
differential_R_2
Count
4
Name
esc
Count
4
Name
differential_R_1
Count
4
Name
hydraulicsData
Count
4
Name
reverseWarn
Count
3
Name
rearMotor
Count
3
Name
auxTank
Count
3
Name
soundConfigRear
Count
3
Name
destsign
Count
3
Name
frontMotor
Count
3
Name
soundConfigFront
Count
3
Name
airbagBeamSoundData
Count
2
Name
airbags
Count
2
Name
value
Count
2
Name
doorBeamData
Count
2
Name
adaptiveRearSwayBar
Count
2
Name
airbrakes
Count
2
Name
adaptiveFrontSwayBar
Count
2
Name
gauges
Count
2
Name
scalebeamDamp
Count
2
Name
scalebeamSpring
Count
2
Name
transfercase
Count
2
Name
general
Count
1
Name
motorTop
Count
1
Name
mainTankR
Count
1
Name
mainTankL
Count
1
Name
mainMotor
Count
1
Name
jato
Count
1
Name
bus
Count
1
Name
scalebeamDeform
Count
1
Name
scalebeamStrength
Count
1
Name
nextstop
Count
1
Name
doors
Count
1
Name
fueltank_R
Count
1
Name
soundConfigBottom
Count
1
Name
motorBottom
Count
1
Name
mirrors
Count
1
Name
soundConfigTop
Count
1
Name
motor
Count
1
Name
fueltank_L
Count
1
Name
doorBeamSoundData
Count
1
Last modified: 25 December 2021, at 14:53

Any further questions?

Join our discord