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

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 Referencecommonjbeam

Interaction Reference

Module defined in `lua/common/jbeam/interaction.lua`. Loads and merges `.interaction.json` files for vehicle input action definitions.

Module defined in lua/common/jbeam/interaction.lua. Loads and merges .interaction.json files for vehicle input action definitions.


Exports

Functions

M.process(vehicle)

Discovers and loads all *.interaction.json files from the vehicle directory and /vehicles/common/. Validates file version (must be 2). Merges interactionGroups, actionCategories, and actions from all files into the vehicle data as vehicle.interactionGroups, vehicle.actionCategories, and vehicle.inputActions.

  • Parameters:
    • vehicle - table - The assembled vehicle data table (must have vehicle.vehicleDirectory set)
  • Returns: self (module table, for chaining)

Internal Notes

  • Supported file version: 2 (files with other versions are skipped with an error log).
  • Each action gets a source field set to the originating filename.
  • Vehicle-specific interaction files are loaded after common ones; tableMerge means vehicle files override common ones on conflict.
  • Used by core/input/actions.lua on the GE side.

Groups Reference

Module defined in `lua/common/jbeam/groups.lua`. Processes group arrays on JBeam rows, converting group name lists into indexed lookup tables and assigning group IDs.

IO Reference

Module defined in `lua/common/jbeam/io.lua`. Handles reading, parsing, and caching of `.jbeam` files. Provides part lookup by name and slot type.

On this page

ExportsFunctionsM.process(vehicle)Internal Notes