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 General

Core delivery system module - manages delivery mode lifecycle, game time, save/load, vehicle cargo containers, weight updates, POI generation, and permission checks.

Core delivery system module - manages delivery mode lifecycle, game time, save/load, vehicle cargo containers, weight updates, POI generation, and permission checks.


Dependencies

M.dependencies = {"core_vehicleBridge"}

Module Info

FieldValue
Pathextensions/career/modules/delivery/general.lua
Globalcareer_modules_delivery_general
Dependenciescore_vehicleBridge

Public API

FunctionSignatureDescription
time()Returns current delivery game time (sim-time based)
isDeliveryModeActive()Returns true if delivery mode is currently active
startDeliveryMode()Activates delivery mode, clears POIs, triggers hook
exitDeliveryMode()Ends delivery mode, abandons cargo with penalties, clears state
checkExitDeliveryMode()Auto-exits delivery mode if no cargo/tasks remain
getDeliveryAbandonPenaltyFactor()Returns penalty multiplier for abandoning cargo (0.1)
getDeliveryModePenalty(onlyVehIdsAsKeys)Calculates total monetary penalty for abandoning all cargo
getVehicleName(vehId)Returns nice vehicle name from inventory, or fallback
getNearbyVehicleCargoContainers(callback)Async - queries nearby vehicles for cargo container data
getMostRecentCargoContainerData()Returns cached container data from last query
requestUpdateContainerWeights()Schedules a weight update for next frame
updateContainerWeights(delayCallback)Applies cargo weights to vehicle containers with freeze/delay
setDeliveryTimePaused(paused)Pauses/unpauses delivery game time
onCareerActivated()Inline function; initializes delivery module references
loadSaveData()Loads delivery save data from career save system
onPartShoppingStarted()Exits delivery mode when part shopping starts
onCareerPaintingStarted()Exits delivery mode when painting starts
onCareerTuningStarted()Exits delivery mode when tuning starts
onTeleportedToGarage(garageId, veh)Exits delivery mode when towed to garage
onAnyMissionChanged(change)Exits delivery mode when a mission starts
onRepairInGarage(invVehId)Cleans up cargo and checks exit delivery mode for repaired vehicle
onInventoryPreRemoveVehicleObject(inventoryId, vehId)Cleans up cargo before vehicle object removal
isAutomaticRouteEnabled()Returns whether automatic route is enabled
setAutomaticRoute(enabled)Enables/disables automatic route, triggers UI event
setDetailedDropOff(enabled)Enables/disables detailed drop-off view
setSetting(key, value)Sets a delivery setting
getSettings()Returns all delivery settings

Hooks

HookDescription
onSaveCurrentSaveSlotSaves all cargo, offers, facilities, settings to logisticsDatabase.json
onCareerModulesActivatedLoads save data and sets up generator
onClientStartMissionReloads data on level load
onGetRawPoiListForLevelGenerates delivery POIs for map markers
onActivityAcceptGatherDataBuilds activity accept data for parking spots
onCheckPermissionChecks delivery mode restrictions on actions
onUpdateTicks game time, container polling, weight updates
onSetBigmapNavFocusDeactivates automatic route on manual waypoint
onPartShoppingStarted / onCareerPaintingStarted / onCareerTuningStartedExit delivery mode
onTeleportedToGarage / onAnyMissionChangedExit delivery mode
onRepairInGarage / onInventoryPreRemoveVehicleObjectHandle vehicle-specific cargo cleanup

Delivery Mode Permissions

TagPermissionDescription
vehicleModificationwarningEnds delivery mode
vehicleSellingwarningEnds delivery mode
vehicleStoragewarningEnds delivery mode
vehicleRepairwarningEnds delivery mode
vehicleShoppingforbiddenBlocked during delivery
interactMissionwarningEnds delivery mode
recoveryTowToGaragewarningEnds delivery mode

Usage Example

-- Start delivery mode
career_modules_delivery_general.startDeliveryMode()

-- Check game time
local t = career_modules_delivery_general.time()

-- Get nearby containers
career_modules_delivery_general.getNearbyVehicleCargoContainers(function(containers)
  for _, c in ipairs(containers) do
    print(c.name, c.freeCargoSlots)
  end
end)

See Also

  • career_modules_delivery_parcelManager - Cargo management
  • career_modules_delivery_generator - Facility and cargo generation
  • career_modules_delivery_vehicleTasks - Vehicle delivery tasks

Additional Exports

Functions

FunctionDescription
M.getDeliveryAbandonPenaltyFactor()Career general systems interaction (save/load, level setup)
M.getDeliveryModePenalty(onlyVehIdsAsKeys)No description available
M.getMostRecentCargoContainerData()No description available
M.isDeliveryModeActive()No description available
M.onAnyMissionChanged(change)No description available
M.onCareerActivated()No description available
M.onCareerPaintingStarted()No description available
M.onCareerTuningStarted()No description available
M.onInventoryPreRemoveVehicleObject(inventoryId, vehId)No description available
M.onPartShoppingStarted()No description available
M.onRepairInGarage(invVehId)No description available
M.onTeleportedToGarage(garageId, veh)No description available
M.onUpdate(dtReal, dtSim, dtRaw)No description available
M.requestUpdateContainerWeights()No description available
M.setDeliveryTimePaused(paused)No description available
M.time()vehicle management

Values/Properties

ExportDescription
M.checkExitDeliveryModeValue: checkExitDeliveryMode
M.exitDeliveryModeValue: exitDeliveryMode
M.getNearbyVehicleCargoContainersValue: getNearbyVehicleCargoContainers
M.getSettingsValue: getSettings
M.getVehicleNameValue: getVehicleName
M.isAutomaticRouteEnabledValue: isAutomaticRouteEnabled
M.loadSaveDataValue: loadSaveData
M.onActivityAcceptGatherDataValue: onActivityAcceptGatherData
M.onCareerModulesActivatedValue: onCareerModulesActivated
M.onCheckPermissionValue: onCheckPermission
M.onClientStartMissionValue: onClientStartMission
M.onGetRawPoiListForLevelValue: onGetRawPoiListForLevel
M.onSaveCurrentSaveSlotValue: onSaveCurrentSaveSlot
M.onSetBigmapNavFocusValue: onSetBigmapNavFocus
M.setAutomaticRouteValue: setAutomaticRoute
M.setDetailedDropOffValue: setDetailedDropOff
M.setSettingValue: setSetting
M.startDeliveryModeValue: startDeliveryMode
M.updateContainerWeightsValue: updateContainerWeights

Delivery Cargo Screen

M.dependencies = {"core_vehicleBridge"}

Delivery Generator

M.dependencies = {"freeroam_facilities", "gameplay_sites_sitesManager", "util_configListGenerator"}

On this page

DependenciesModule InfoPublic APIHooksDelivery Mode PermissionsUsage ExampleSee AlsoAdditional ExportsFunctionsValues/Properties