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
Allow WalkingBlacklist WalkingCan Enter From WalkingCareer ActiveComplete ScenarioCountdownDecal CircleDecal LineDecal PathDecal SingleIs Walking BlacklistedGroundmarker Remaining DistanceGroundmarkersIs WalkingIs Walking EnabledMission DefaultsMultiseatDetect Acceleration At StartPointsBar PointsPointsBar ThresholdsRemove Other VehiclesToggle WalkingIn Zone
File PathFile RaceImGui Race TimesMove Veh to Start PositionRace Start TransformRace End TransformRace AI ParametersRace CP/Lap ChangeRace DataRace DisqualifyRace End ScreenRace HighscoresRace HighscoresRace MarkersRace Pathnode ReachedRace Pacenote ReachedRace Recovery AvailableRace Recovery UsedRace Request RecoveryRace Suspend

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 Extensionsflowgraphnodesgameplayrace

File Race

**File:** `flowgraph/nodes/gameplay/race/fileRace.lua`

File: flowgraph/nodes/gameplay/race/fileRace.lua

Description: Manages a Race from a given path.

Category: repeat_instant Tags: scenario

Data Fields

FieldDefault
self.data.useDebugDrawfalse
self.data.useHotlappingApptrue
self.data.useWaypointAudiotrue

Input Pins

NameTypeDescription
flowflowInflow for this node.
idleflowIf this pin has flow, the race will not count the timer and not count as active.
resetflowResets this node.
lapCountnumberNumber of laps (min 1).
pathDatatablePath data, from the File Path node.
rollingboolIf the path should be with a rolling start, if possible.
autoStartAIboolIf true, vehicles that have their id linked to this node and are not player controlled will start racing.
hasSecVehboolIf the player have a secondary vehicle to swap to.
changeVehboolSwitch to the secondary vehicle.
primVehIdnumberPrimary ID for the player vehicle.
secVehIdnumberSecondary ID for the player vehicle.

Output Pins

NameTypeDescription
flowflowOutflow from this node.
activeflowOutflow when race is active.
completeflowOutflow when race is complete.
vehicleChangedflowTrue if the vehicle got changed.
raceDatatableData from the race for other nodes to process.
aiPathtableAI navgraph path; can be used with the Follow Waypoints node.
timenumberTotal time when race is completed.

Methods

  • C:init(mgr, ...)
  • C:postInit()
  • C:drawCustomProperties()
  • C:updatePins(old, new)
  • C:_onSerialize(res)
  • C:_onDeserialized(res)
  • C:_executionStarted()
  • C:_executionStopped()
  • C:drawMiddle(builder, style)
  • C:work(args)

See Also

  • File Path - Related reference
  • im Race Times - Related reference
  • Move Veh to Start Position - Related reference
  • FlowGraph Guide - Guide

File Path

**File:** `flowgraph/nodes/gameplay/race/filePath.lua`

ImGui Race Times

**File:** `flowgraph/nodes/gameplay/race/imRaceTimes.lua`

On this page

Data FieldsInput PinsOutput PinsMethodsSee Also