RLS Studios
ProjectsPatreonCommunityDocsAbout
Join Patreon
BeamNG Modding Docs

Guides

Reference

Server CommandsGE UtilitiesGame Engine MainNavigation GraphScreenshot CaptureServerServer ConnectionSpawnpoint ManagerSimulation TimeVehicle SpawningSuspension Frequency Tester
Gameplay AchievementGameplay CityDiscoverForce FieldGarage ModeMarker InteractionParking SystemGameplay Playmode MarkersGameplay PoliceGameplay RallyGameplay Rally LoopGameplay Raw POIsGameplay Skidpad TestSpeed Trap LeaderboardsSpeed Traps and CamerasGameplay StatisticsTaxi Ride SystemTraffic SystemVehicle PerformanceWalking
Locations DetectorMission ManagerMissionsMission Screen UIPOI TestProgressMission Start TriggerUnlocks
Career ConditionsGeneric ConditionsMission ConditionsVehicle Conditions

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 Extensionsgameplaymissionsunlocksconditions

Vehicle Conditions

Reference for vehicle-based unlock condition types used by the mission unlock system.

Reference for vehicle-based unlock condition types used by the mission unlock system.


Condition Types

vehicleDriven

Requires the player to be driving a vehicle. Currently always returns true as a placeholder.

FieldTypeDescription
(none)-No additional fields required
M.vehicleDriven = {
  info = 'The player has to be seated in a vehicle.',
  getLabel = function(c) return {txt = "Driving a vehicle"} end,
  conditionMet = function(c) return true, {} end
}

Commented-Out Conditions

busDriven (disabled)

Would require the player to be driving a bus vehicle. Currently commented out.

-- M.busDriven = {
--   info = 'The player has to be seated in a bus.',
--   conditionMet = function(c)
--     if not M.vehicleDriven.conditionMet(c) then return false end
--     local vDetails = core_vehicles.getCurrentVehicleDetails()
--     return vDetails.model['Body Style'] == 'Bus'
--   end
-- }

Key Behaviors

  • vehicleDriven is the default start condition for many procedural missions (time trials, etc.)
  • The condition always returns true - actual vehicle checks happen elsewhere in the mission start pipeline
  • busDriven is preserved as commented code showing how body style checks would work
  • The empty nested table {} is returned for consistent condition evaluation structure
  • Used primarily in startCondition fields of mission info.json files

See Also

  • unlocks/conditions/careerConditions - Career Branch & League Conditions - Related reference
  • unlocks/conditions/genericConditions - Generic Logic Conditions - Related reference
  • unlocks/conditions/missionConditions - Mission Progress Conditions - Related reference
  • Gameplay Systems Guide - Guide

Mission Conditions

Reference for mission-progress-based unlock condition types used by the mission unlock system.

Race Pacenote

Object class representing a pacenote (audio/visual cue) along a race path. Pacenotes have a position, radius, directional normal, and associated text note. Used for co-driver callouts.

On this page

Condition TypesvehicleDrivenCommented-Out ConditionsbusDriven (disabled)Key BehaviorsSee Also