RLS Studios
ProjectsPatreonCommunityDocsAbout
Join Patreon
BeamNG Modding Docs

Guides

Reference

cdefDebugDraw ReferencecdefGpuMesh ReferencecdefImgui ReferencecdefMath Referencecdefs ReferencecontrolSystems Referencecsvlib ReferencedelayLine Referencedequeue ReferencedevUtils ReferenceEvent Referenceextensions Referencefilters Referencegraphpath Referenceguihooks ReferenceinputFilters ReferenceinterpolatedMap Referenceintrospection ReferencejbeamWriter Referencejson-ast Referencejson ReferencejsonDebug ReferencejsonPrettyEncoderCustom Referencekdtreebox2d Referencekdtreebox3d Referencekdtreepoint3d Referencelpack ReferenceluaBinding ReferenceluaCore ReferenceluaProfiler Referencemathlib Referenceparticles Referencequadtree Referencesettings ReferencetcpServer ReferencetimeEvents Referenceutils Reference
ExpressionParser ReferenceGroups ReferenceInteraction ReferenceIO ReferenceLinks ReferenceLoader ReferenceMaterials ReferenceOptimization ReferenceScaling ReferenceSectionMerger ReferenceSlotSystem ReferenceTableSchema ReferenceUtils ReferenceVariables Reference
Assorted ReferenceCamera ReferenceColors ReferenceEvents ReferenceLicensePlatesSkins ReferenceMeshs ReferenceMirror ReferenceNodeBeam ReferencePaints ReferenceVisual Ropes ReferenceWheels Reference

UI

Resources

BeamNG Game Engine Lua Cheat SheetGE Developer RecipesMCP Server Setup

// RLS.STUDIOS=true

Premium Mods for BeamNG.drive. Career systems, custom vehicles, and immersive gameplay experiences.

Index

HomeProjectsPatreon

Socials

DiscordPatreon (RLS)Patreon (Vehicles)

© 2026 RLS Studios. All rights reserved.

Modding since 2024

API Referencecommonjbeamsections

Wheels Reference

Module defined in `lua/common/jbeam/sections/wheels.lua`. Constructs wheel geometry (nodes and beams) from JBeam wheel definitions. The largest file in the jbeam subsystem (~2000 lines).

Module defined in lua/common/jbeam/sections/wheels.lua. Constructs wheel geometry (nodes and beams) from JBeam wheel definitions. The largest file in the jbeam subsystem (~2000 lines).

Exports

Functions

M.processWheels(vehicle)

Processes all wheel types defined in the vehicle data. Iterates wheel sections (wheels, monoHubWheels, hubWheelsTSV, hubWheelsTSI, hubWheels, pressureWheels, hubWheelsPressure), constructing node/beam geometry for each wheel type. Handles tire/hub separation, pressure beams, reinforcement beams, and tread patterns.

  • Parameters:
    • vehicle - table - Assembled vehicle data with wheel sections
  • Returns: boolean - true on success

M.processRotators(vehicle)

Processes the rotators section, calling jbeamUtils.addRotator for each rotator entry to set up powered wheel hubs with their associated node groups.

  • Parameters:
    • vehicle - table - Assembled vehicle data with rotators section
  • Returns: self (module table, for chaining)

Internal Notes

  • Wheel types (in order of complexity):
    • addWheel: Basic wheel - single ring of nodes around axle
    • addMonoHubWheel: Mono-hub - hub and tire share node ring
    • addHubWheelTSV: Hub wheel with tire-side vertices - separate hub and tire rings
    • addHubWheelTSI: Hub wheel with tire-side inner - more complex tire geometry
    • addHubWheel: Full hub wheel - separate hub, tire inner, tire outer rings
  • Each wheel type creates:
    • Spoke nodes around the axle axis
    • Hub beams (connecting hub nodes)
    • Side beams (connecting to axle nodes)
    • Tire beams (connecting tire nodes)
    • Reinforcement beams (structural integrity)
    • Pressure beams (for pressured tires)
    • Tread nodes (contact surface)
  • Pressure wheels: use BEAM_PRESSURED type for tire volume beams with pressurePSI / pressureGroup configuration
  • Support beams: BEAM_SUPPORT type used for certain structural beams
  • cleanupWheelOptions and cleanupBeamOptions remove wheel-specific properties from beam/node options to prevent leaking into subsequent elements
  • Wheel data stored in vehicle.wheels with properties: node1, node2, nodeArm, radius, wheelDir, numRays, plus arrays of beam/node references
  • addPressTri creates pressured triangles for tire surfaces
  • All geometry uses jbeamUtils.addNodeWithOptions / addBeamWithOptions for construction

Visual Ropes Reference

Module defined in `lua/common/jbeam/sections/vropes.lua`. Processes visual rope definitions from JBeam data, creating rendered rope objects attached between props.

jit/ - LuaJIT Compiler & Profiler Modules

Standard LuaJIT modules for JIT compiler introspection and profiling.

On this page

ExportsFunctionsM.processWheels(vehicle)M.processRotators(vehicle)Internal Notes