RLS Studios
ProjectsPatreonCommunityDocsAbout
Join Patreon
BeamNG Modding Docs

Guides

Reference

server/commands - Camera & Input Commandsge_utils - Game Engine Utility Functionsmain.lua - GE Lua Entry Point & Game Loopmap.lua - Navigation Graph (AI Road Map)screenshot.lua - Screenshot Systemserver/server - Level Loading & Game ServerserverConnection - Client-Server Connection Manager`setSpawnpoint` - Default Spawn Point Persistence`simTimeAuthority` - Simulation Time & Bullet Time Control`spawn` - Vehicle Spawning & Safe Placement`suspensionFrequencyTester` - Suspension Natural Frequency Analysis
Career BranchesCareer System CoreCareer Save System
Career Computer MenuCareer Fuel SystemInspect VehicleVehicle InventoryLinear TutorialLoaner VehiclesCareer LogLogbookMarketplaceMission WrapperCareer Painting ModuleCareer Part Inventory ModuleCareer Part Shopping ModuleCareer Payment ModuleCareer Permissions ModuleCareer Playbook Writer ModuleCareer Player Abstract ModuleCareer Player Attributes ModuleCareer Player Driving ModuleCareer Quick Travel ModuleCareer Rentals ModuleCareer Reputation ModuleCareer Spawn Points ModuleCareer Speed Traps ModuleCareer Test Drive ModuleCareer Tether ModuleCareer Tuning ModuleCareer UI Utils ModuleCareer Unlock Flags ModuleCareer Value Calculator ModuleVehicle Class GroupingVehicle Deletion ServiceVehicle PerformanceVehicle Shopping
Delivery Cargo CardsDelivery Cargo ScreenDelivery GeneralDelivery GeneratorDelivery Pages (Logbook)Delivery Parcel ManagerDelivery Parcel ModifiersDelivery Precision ParkingDelivery ProgressDelivery TasklistDelivery TutorialDelivery Vehicle Offer ManagerDelivery Vehicle Tasks

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 Extensionscareermodulesdelivery

Delivery Vehicle Offer Manager

M.dependencies = {"util_stepHandler"}

Dependencies

M.dependencies = {"util_stepHandler"}

Manages vehicle and trailer delivery offers - stores offers, filters by facility/expiry, handles spawning via step sequences, and provides unlock tag checks.


Module Info

FieldValue
Pathextensions/career/modules/delivery/vehicleOfferManager.lua
Globalcareer_modules_delivery_vehicleOfferManager
Dependenciesutil_stepHandler

Public API

FunctionSignatureDescription
addOffer(offer)Adds a vehicle/trailer offer to the pool
getOfferById(id)Returns an offer by its ID
getAllOfferUnexpired()Returns all unexpired, unspawned offers
getAllOfferAtFacilityUnexpired(facId, psPath)Returns unexpired offers at a facility
getAllOfferCustomFilter(filter, ...)Returns offers matching a custom filter function
getAllOfferForLocation(loc)Returns offers at a specific location
sameLocation(a, b)Compares two location tables
sameLocationOffer(offer, otherLoc)Checks if offer origin matches a location
spawnOffer(offerId, fadeToBlack, callback)Spawns a vehicle for an offer: creates vehicle, positions, sets mileage, starts task
makeTaskLabel(task)Returns human-readable label for a task
isVehicleTagUnlocked(tag)Checks if a vehicle category tag is unlocked
getVehicleTagUnlockedSimple()Returns {tag = bool} for all vehicle tags
getVehicleTagLabelSingular(tag)Returns singular label for a tag
getVehicleTagLabelPlural(tag)Returns plural label for a tag
getDefaultVehicleModifiersForUI()Returns default modifier display data (route, damage)

| M.onCareerActivated | () | - |

Commented-Out Hooks

HookDescription
onBranchTierReachedWas: adjust vehicle/trailer offer money on tier change
onGetSkillUnlockInfoForUiWas: provide unlock info for vehicle/trailer tags

Vehicle Tags

TagUnlock FlagLabel
junkerVehjunkerVehJunker Cars
smallVehsmallVehSmall Vehicles
largeVehlargeVehLarge Vehicles
fleetVehfleetVehFleet Cars
exoticVehexoticVehExotic Cars
emptySmallTrailerssmallTrailersDeliverySmall Empty Trailers
loadedSmallTrailerssmallTrailersDeliverySmall Loaded Trailers
emptyMediumTrailerssmallTrailersDeliveryMedium Empty Trailers
loadedMediumTrailerssmallTrailersDeliveryMedium Loaded Trailers
emptyLargeTrailerlargeTrailersDeliveryLarge Empty Trailers
loadedLargeTrailerslargeTrailersDeliveryLarge Loaded Trailers

Spawn Sequence

spawnOffer(offerId)
  ├─ Mark offer as spawned
  ├─ Fade to black (optional)
  ├─ Spawn vehicle with model/config
  ├─ Move to parking spot
  ├─ Set mileage and part conditions
  ├─ Turn ignition off
  ├─ Ping vehicle bridge
  ├─ Record starting odometer
  ├─ Add vehicle task
  ├─ Start delivery mode
  └─ Fade from black

Usage Example

-- Get available offers at a facility
local offers = career_modules_delivery_vehicleOfferManager.getAllOfferAtFacilityUnexpired("belasco_auto")

-- Spawn a vehicle offer
career_modules_delivery_vehicleOfferManager.spawnOffer(offerId, true, function()
  print("Vehicle spawned!")
end)

-- Check vehicle tag unlock
local unlocked, def = career_modules_delivery_vehicleOfferManager.isVehicleTagUnlocked("exoticVeh")

See Also

  • career_modules_delivery_vehicleTasks - Active task management
  • career_modules_delivery_generator - Offer generation
  • career_modules_unlockFlags - Tag unlock system

Additional Exports

Values/Properties

ExportDescription
M.addOfferValue: addOffer
M.getAllOfferAtFacilityUnexpiredValue: getAllOfferAtFacilityUnexpired
M.getAllOfferCustomFilterValue: getAllOfferCustomFilter
M.getAllOfferForLocationValue: getAllOfferForLocation
M.getAllOfferUnexpiredValue: getAllOfferUnexpired
M.getDefaultVehicleModifiersForUIValue: getDefaultVehicleModifiersForUI
M.getOfferByIdValue: getOfferById
M.getVehicleTagLabelPluralValue: getVehicleTagLabelPlural
M.getVehicleTagLabelSingularValue: getVehicleTagLabelSingular
M.getVehicleTagUnlockedSimpleValue: getVehicleTagUnlockedSimple
M.isVehicleTagUnlockedValue: isVehicleTagUnlocked
M.makeTaskLabelValue: makeTaskLabel
M.onBranchTierReachedValue: onBranchTierReached
M.onGetSkillUnlockInfoForUiValue: onGetSkillUnlockInfoForUi
M.sameLocationValue: sameLocation
M.sameLocationOfferValue: sameLocationOffer
M.spawnOfferValue: spawnOffer

Delivery Tutorial

Manages tutorial state for the three delivery types (cargo, vehicle, materials). Tracks completion via XP checks, provides step-by-step task lists for UI.

Delivery Vehicle Tasks

M.dependencies = {"util_stepHandler"}

On this page

DependenciesModule InfoPublic API| M.onCareerActivated | () | - |Commented-Out HooksVehicle TagsSpawn SequenceUsage ExampleSee AlsoAdditional ExportsValues/Properties