RLS Studios
ProjectsPatreonCommunityDocsAbout
Join Patreon
BeamNG Modding Docs

Guides

Reference

Debug DrawingGPU Mesh StructsImGui FFIMath Structs (FFI)FFI C DefinitionsPID ControllersCSV LibraryDelay LineDequeDevelopment UtilitiesEvent ReferenceExtension SystemSignal FiltersGraph PathfindingUI BridgeInput Filter Constants2D Bilinear InterpolationIntrospectionJBeam Pretty PrinterJSON AST ParserSJSON ParserJSON Debug ParserJSON Pretty PrinterK-D Tree (2D Boxes)K-D Tree (3D)K-D Tree (3D)Lua SerializerC++/Lua BindingLua CoreLua ProfilerMath LibraryParticlesQuadtreeSettingsTCP ServerTimer SchedulerUtility Library
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.

See Also

  • Assorted Reference - Related reference
  • Camera Reference - Related reference
  • Colors Reference - Related reference
  • Common Libraries Overview - Guide

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 NotesSee Also