RLS Studios
ProjectsPatreonCommunityDocsAbout
Join Patreon
BeamNG Modding Docs

Guides

Reference

Server CommandsGE UtilitiesGame Engine MainNavigation GraphScreenshot CaptureServerServer ConnectionSpawnpoint ManagerSimulation TimeVehicle SpawningSuspension Frequency Tester
Flowgraph Base ModuleFlowgraph Base NodeFlowgraph Base State NodeFlowgraph Node BuilderFlowgraph GraphFlowgraph Group HelperFlowgraph LinkFlowgraph ManagerNew Node TemplateFlowgraph PinFlowgraph States ManagerFlowgraph UtilsFlowgraph Variable Storage
ARunForLife (Flowgraph Node)Clear Lights Drag Race (Flowgraph Node)Countdown Lights Controller (Flowgraph Node)Get Custom Vehicle Data (Flowgraph Node)Get Mission Setup Data (Flowgraph Node)Check Players Position / Go To Start Line (Flowgraph Node)KnockAway Check (Flowgraph Node)Lights Controller (Flowgraph Node)Mission Post Clean (Flowgraph Node)Mission Cleanup / Pre Clean (Flowgraph Node)Prepare Vehicle (Flowgraph Node)Remove Stashed Player Vehicle (Flowgraph Node)Select Garage Vehicle (Flowgraph Node)Select Garage Sites / Zones (Flowgraph Node)Select Garage Spots (Flowgraph Node)Select Heist Spots (Flowgraph Node)Set Stage Lights (Flowgraph Node)Update Display Drag Race (Flowgraph Node)

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 ReferenceGE Extensionsflowgraphnodesmission

Get Custom Vehicle Data (Flowgraph Node)

- **Node Name:** `Get Custom Vehicle Data`

Overview

  • Node Name: Get Custom Vehicle Data
  • Category: once_instant
  • File: extensions/flowgraph/nodes/mission/getCustomVehicleData.lua

Reads dynamic fields stored on a vehicle object and outputs them through custom pins. Supports user-created output pins of various types.

Pin Schema

Input Pins

PinTypeDescription
vehIdnumberVehicle ID to read data from (fixed pin)

Output Pins

Dynamic - user can add custom output pins of types: string, number, bool, any, table, vec3, quat, color.

Internals

FieldPurpose
self.savePinsEnables pin persistence across serialization
self.allowCustomOutPinsAllows user to add custom output pins in the editor

Allowed Pin Types

string, number, bool, any, table, vec3, quat, color (flow is not allowed).

How It Works

  1. On execution, the node looks up the vehicle by vehId via scenetree.findObjectById().
  2. It iterates through all non-fixed output pins and attempts to read matching dynamic fields from the vehicle.
  3. Built-in fields checked: waypoints (table), routeSpeed (number), risk (number).
  4. The node includes a convertStringToTable() helper for parsing comma-separated strings into tables.

Note: The implementation appears incomplete - the generic pin iteration loop has an empty body, and only waypoints, routeSpeed, and risk are explicitly handled.

Lua Example

-- Set dynamic fields on a vehicle in the level editor:
-- vehicle.routeSpeed = "15"
-- vehicle.risk = "0.5"
-- vehicle.waypoints = "wp1,wp2,wp3"

-- This node reads them back:
-- routeSpeed output = 15 (number)
-- risk output = 0.5 (number)
-- waypoints output = {"wp1", "wp2", "wp3"} (table)

Key Dependencies

  • scenetree.findObjectById() - vehicle lookup
  • Dynamic fields on BeamNGVehicle objects
  • _flowgraph_createNode() - standard flowgraph node registration

Additional Methods

C:init()

Initializes the node, setting up pins and default properties.

C:workOnce()

Called once when the node is triggered (flow-once execution).


See Also

  • ARunForLife (Flowgraph Node) - Related reference
  • Update Display Drag Race (Flowgraph Node) - Related reference
  • Clear Lights Drag Race (Flowgraph Node) - Related reference
  • FlowGraph Guide - Guide

Countdown Lights Controller (Flowgraph Node)

- **Node Name:** `Countdown Lights Controller`

Get Mission Setup Data (Flowgraph Node)

- **Node Name:** `Get Mission Setup Data`

On this page

OverviewPin SchemaInput PinsOutput PinsInternalsAllowed Pin TypesHow It WorksLua ExampleKey DependenciesAdditional MethodsC:init()C:workOnce()See Also