Quads

Quads are a way of placing two triangles at the same time. They share all of the triangle properties. A quad with nodes n1, n2, n3, n4 will create 2 triangles with the nodes n1, n2, n3 and n3, n4, n1 respectively, effectively creating a quadrangle. As with triangles, the nodes forming a quad should be chosen in a counter-clockwise order.

Quads are rarely used, mostly for surfaces that are perfectly rectangular. Even though there is no technical disadvantage of using them, they make it somewhat harder to understand the Jbeam files, especially when used together with triangles.

Required arguments

"quads": [
        ["id1:","id2:","id3:","id4:"],
        ["a", "b", "c", "d"],
],
string
type
The id of the first node of the first triangle and the last node of the second triangle
string
type
The id of the second node of the first triangle
string
type
The id of the last node of the first triangle and the first node of the second triangle
string
type
The id of the second node of the second triangle

Optional arguments

number
type
100
default
Drag coefficient of the triangles as a percentage of a flat plate of the same size.
Typical values are around 10 for most exposed body panels.
float
type
0
default
Skin drag coefficient of the triangles as a percentage of a flat plate of the same size.
Additional drag coefficient defined along the triangle surface rather than across. Used to simulate paddle-like treads in mud tires. Usually not used otherwise.
number
type
dragCoef
default
Lift coefficient of the triangles as a percentage of a flat plate of the same size.
Values between 80 and 120 are commonly used for spoilers.
number
type
0.58
default
Angle of attack in radian at which the triangles will start to stall and produce less lift.
string
type
NORMALTYPE
default

The available triangle types are :

“NORMALTYPE” : Used for most applications

“NONCOLLIDABLE” : Have no collisions or aero. Used to keep the anticlip system working with nodes that have collisions but no triangles like suspension and exhaust.

string
type
Defines a group of triangles as being a pressure volume. Used for flotation and pressure simulation.
number
type
Sets the pressureGroup pressure in PSI
number
type
Sets the pressureGroup pressure in Pascal
string
type
Used to allow triangles to break when triggered by beams in the same break group.
boolean
type
false
default
Deactivates errors when some of the nodes forming the quad are missing.
This is used for cases where some of the nodes that make up the quad are located in an optional component.
string
type
asphalt
default
Ground model of the triangles. Determines friction behavior.
As of version 0.33.2.0 the following physics materials are available:
METAL, PLASTIC, RUBBER, GLASS, WOOD, FOLIAGE, CLOTH, WATER, ASPHALT, ASPHALT_WET, SLIPPERY, ROCK, DIRT_DUSTY, DIRT, SAND, SANDY_ROAD, MUD, GRAVEL, GRASS, ICE, SNOW, FIRESMALL, FIREMEDIUM, FIRELARGE, SMOKESMALLBLACK, SMOKEMEDIUMBLACK, STEAM, RUMBLE_STRIP, COBBLESTONE, FOLIAGE_THIN, SPIKE_STRIP
string
type
Biases one side of the collision detection system.

The allowed values are “in” and “out”, leaving the argument empty will result in no bias. On the biased side, collision triangles will be physically ’thicker’ than on the other, with the collision being detected earlier. Thicker collision means less chance of clipping through on high speed impacts, thinner means the structures can be positioned closer to each other on spawn.

This is useful for very small objects that will typically only collide with things from one side.

Simple Example

"quads": [
        ["id1:","id2:","id3:", "id4:"],
        {"dragCoef":15},
        ["er_l1l","er_l3l","er_l4l", "er_l2l"],
        ["er_l1r","er_l2r","er_l4r", "er_l3r"],
        {"dragCoef":0},
        {"group":""},
],
Last modified: April 29, 2024

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.