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

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.

See Also

  • ExpressionParser Reference - Related reference
  • Groups Reference - Related reference
  • IO Reference - Related reference
  • Common Libraries Overview - Guide

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