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

Paints Reference

Module defined in `lua/common/jbeam/sections/paints.lua`. Applies the metallic paint system to the vehicle object from configuration.

Module defined in lua/common/jbeam/sections/paints.lua. Applies the metallic paint system to the vehicle object from configuration.

Exports

Functions

M.process(vehicleObj, vehicleConfig, vehicle)

Applies paint data from vehicleConfig.paints (or converts from legacy colors). Sets vehicleObj.color, colorPalette0, colorPalette1 from the first three paint entries' baseColor, and calls vehicleObj:setMetallicPaintData(paints) for full metallic paint support.

  • Parameters:
    • vehicleObj - userdata - C++ vehicle object
    • vehicleConfig - table - Config with paints array (or legacy colors)
    • vehicle - table - Assembled vehicle data (unused)
  • Returns: self (module table, for chaining)

Internal Notes

  • Paint structure: { baseColor = {r, g, b, a}, ... } with additional metallic properties.
  • Each paint is validated via validateVehiclePaint(paint) before use.
  • Falls back to convertVehicleColorsToPaints(colors) if paints not present but colors is.
  • This is the newer paint system; colors.lua handles the legacy format.

NodeBeam Reference

Module defined in `lua/common/jbeam/sections/nodeBeam.lua`. Processes core structural sections: nodes (position calculation), hydros (hydraulic actuators), ropes, and quads (pressure volumes).

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.

On this page

ExportsFunctionsM.process(vehicleObj, vehicleConfig, vehicle)Internal Notes