Delivery Vehicle Tasks

Dependencies

M.dependencies = {"util_stepHandler"}

Manages active vehicle/trailer delivery tasks - multi-step task progression (couple/enter → drive → confirm drop-off), reward calculation with damage/distance/time bonuses, and task lifecycle.

Module Info

Field	Value
Path	`extensions/career/modules/delivery/vehicleTasks.lua`
Global	`career_modules_delivery_vehicleTasks`
Dependencies	`util_stepHandler`

Internal State

Field	Type	Description
`M.debugName`	varies	Assigned as `"Delivery > Trailer Tasks"`
`M.debugOrder`	varies	Assigned as `12`

Public API

Function	Signature	Description
`addVehicleTask`	`(vehId, offer)`	Creates and starts tracking a vehicle/trailer delivery task
`getVehicleTasks`	`()`	Returns all active vehicle tasks
`getVehicleTaskForOffer`	`(offer)`	Returns the task for a specific offer
`getVehicleDataWithRewardsSummary`	`()`	Returns formatted task data with async reward breakdowns for drop-off UI
`canDropOffCargoAtPsPath`	`(psPath)`	Returns count of vehicles/trailers ready to drop off at a parking spot
`finishTasks`	`(offerIds)`	Finalizes specified tasks: gets part conditions, odometer, calculates rewards
`isVehicleDeliveryVehicle`	`(vehId)`	Checks if a vehicle is currently a delivery vehicle
`giveBackDeliveryVehicle`	`(vehId)`	Marks a vehicle task for abandonment
`getTargetDestinationsForActiveTasks`	`()`	Returns all destination locations for active tasks
`abandonAllVehicleTasks`	`()`	Deletes all delivery vehicles and clears tasks
`getFineForAbandon`	`(taskData)`	Calculates abandonment penalty for a single task
`getFineForAbandonAllVehicleTasks`	`()`	Sums abandonment penalties across all tasks
`navigateToNextTask`	`()`	Sets ground markers to the latest active task

| `M.onCareerActivated` | `()` | - | | `M.drawDebugMenu` | `()` | - |

Hooks

Hook	Description
`onUpdate`	Processes task state transitions, finishes, and give-backs
`onTrailerAttached`	Updates loaner organization tracking

Task Step Types

Step	Trigger Forward	Trigger Back
`coupleTrailer`	Player couples trailer	-
`enterVehicle`	Player enters vehicle	-
`bringToDestination`	Within 20m of destination	Uncoupled / exited vehicle
`putIntoParkingSpot`	Parked + uncoupled/exited	Too far from spot
`confirmDropOff`	Confirmed via UI	-

Reward Breakdown

Rewards are calculated from:

Damage - Broken parts percentage: no damage (+5%), slight damage (−20-80%), excessive (−100%)
Route - Distance driven vs expected: bonus if within 120% (+15%)
Time - Time taken vs expected: bonus if faster (+15%)
Loaner cut - Organization cut from loaner vehicles
Branch multiplier - Logistics level bonus
Precision parking - Score-based bonus/penalty

Usage Example

-- Get active tasks
local tasks = career_modules_delivery_vehicleTasks.getVehicleTasks()

-- Check if vehicle is a delivery vehicle
if career_modules_delivery_vehicleTasks.isVehicleDeliveryVehicle(vehId) then
  -- Can't sell/modify this vehicle
end

-- Calculate abandonment penalty
local fine = career_modules_delivery_vehicleTasks.getFineForAbandonAllVehicleTasks()

Additional Exports

Functions

Function	Description
`M.finishTasks(offerIds)`	No description available

Values/Properties

Export	Description
`M.abandonAllVehicleTasks`	Value: `abandonAllVehicleTasks`
`M.addVehicleTask`	Value: `addVehicleTask`
`M.canDropOffCargoAtPsPath`	Value: `canDropOffCargoAtPsPath`
`M.getFineForAbandon`	Value: `getFineForAbandon`
`M.getFineForAbandonAllVehicleTasks`	Value: `getFineForAbandonAllVehicleTasks`
`M.getTargetDestinationsForActiveTasks`	Value: `getTargetDestinationsForActiveTasks`
`M.getVehicleDataWithRewardsSummary`	Value: `getVehicleDataWithRewardsSummary`
`M.getVehicleTaskForOffer`	Value: `getVehicleTaskForOffer`
`M.getVehicleTasks`	Value: `getVehicleTasks`
`M.giveBackDeliveryVehicle`	Value: `giveBackDeliveryVehicle`
`M.isVehicleDeliveryVehicle`	Value: `isVehicleDeliveryVehicle`
`M.navigateToNextTask`	Value: `navigateToNextTask`
`M.onCouplerAttached`	Value: `onCouplerAttached`
`M.onCouplerDetached`	Value: `onCouplerDetached`
`M.onTrailerAttached`	Value: `onTrailerAttached`
`M.onUpdate`	Value: `onUpdate`

Dependencies

M.dependencies = {"util_stepHandler"}

Manages active vehicle/trailer delivery tasks - multi-step task progression (couple/enter → drive → confirm drop-off), reward calculation with damage/distance/time bonuses, and task lifecycle.

Module Info

Field	Value
Path	`extensions/career/modules/delivery/vehicleTasks.lua`
Global	`career_modules_delivery_vehicleTasks`
Dependencies	`util_stepHandler`

Internal State

Field	Type	Description
`M.debugName`	varies	Assigned as `"Delivery > Trailer Tasks"`
`M.debugOrder`	varies	Assigned as `12`

Public API

Function	Signature	Description
`addVehicleTask`	`(vehId, offer)`	Creates and starts tracking a vehicle/trailer delivery task
`getVehicleTasks`	`()`	Returns all active vehicle tasks
`getVehicleTaskForOffer`	`(offer)`	Returns the task for a specific offer
`getVehicleDataWithRewardsSummary`	`()`	Returns formatted task data with async reward breakdowns for drop-off UI
`canDropOffCargoAtPsPath`	`(psPath)`	Returns count of vehicles/trailers ready to drop off at a parking spot
`finishTasks`	`(offerIds)`	Finalizes specified tasks: gets part conditions, odometer, calculates rewards
`isVehicleDeliveryVehicle`	`(vehId)`	Checks if a vehicle is currently a delivery vehicle
`giveBackDeliveryVehicle`	`(vehId)`	Marks a vehicle task for abandonment
`getTargetDestinationsForActiveTasks`	`()`	Returns all destination locations for active tasks
`abandonAllVehicleTasks`	`()`	Deletes all delivery vehicles and clears tasks
`getFineForAbandon`	`(taskData)`	Calculates abandonment penalty for a single task
`getFineForAbandonAllVehicleTasks`	`()`	Sums abandonment penalties across all tasks
`navigateToNextTask`	`()`	Sets ground markers to the latest active task

| `M.onCareerActivated` | `()` | - | | `M.drawDebugMenu` | `()` | - |

Hooks

Hook	Description
`onUpdate`	Processes task state transitions, finishes, and give-backs
`onTrailerAttached`	Updates loaner organization tracking

Task Step Types

Step	Trigger Forward	Trigger Back
`coupleTrailer`	Player couples trailer	-
`enterVehicle`	Player enters vehicle	-
`bringToDestination`	Within 20m of destination	Uncoupled / exited vehicle
`putIntoParkingSpot`	Parked + uncoupled/exited	Too far from spot
`confirmDropOff`	Confirmed via UI	-

Reward Breakdown

Rewards are calculated from:

Damage - Broken parts percentage: no damage (+5%), slight damage (−20-80%), excessive (−100%)
Route - Distance driven vs expected: bonus if within 120% (+15%)
Time - Time taken vs expected: bonus if faster (+15%)
Loaner cut - Organization cut from loaner vehicles
Branch multiplier - Logistics level bonus
Precision parking - Score-based bonus/penalty

Usage Example

-- Get active tasks
local tasks = career_modules_delivery_vehicleTasks.getVehicleTasks()

-- Check if vehicle is a delivery vehicle
if career_modules_delivery_vehicleTasks.isVehicleDeliveryVehicle(vehId) then
  -- Can't sell/modify this vehicle
end

-- Calculate abandonment penalty
local fine = career_modules_delivery_vehicleTasks.getFineForAbandonAllVehicleTasks()

Additional Exports

Functions

Function	Description
`M.finishTasks(offerIds)`	No description available

Values/Properties

Export	Description
`M.abandonAllVehicleTasks`	Value: `abandonAllVehicleTasks`
`M.addVehicleTask`	Value: `addVehicleTask`
`M.canDropOffCargoAtPsPath`	Value: `canDropOffCargoAtPsPath`
`M.getFineForAbandon`	Value: `getFineForAbandon`
`M.getFineForAbandonAllVehicleTasks`	Value: `getFineForAbandonAllVehicleTasks`
`M.getTargetDestinationsForActiveTasks`	Value: `getTargetDestinationsForActiveTasks`
`M.getVehicleDataWithRewardsSummary`	Value: `getVehicleDataWithRewardsSummary`
`M.getVehicleTaskForOffer`	Value: `getVehicleTaskForOffer`
`M.getVehicleTasks`	Value: `getVehicleTasks`
`M.giveBackDeliveryVehicle`	Value: `giveBackDeliveryVehicle`
`M.isVehicleDeliveryVehicle`	Value: `isVehicleDeliveryVehicle`
`M.navigateToNextTask`	Value: `navigateToNextTask`
`M.onCouplerAttached`	Value: `onCouplerAttached`
`M.onCouplerDetached`	Value: `onCouplerDetached`
`M.onTrailerAttached`	Value: `onTrailerAttached`
`M.onUpdate`	Value: `onUpdate`

Delivery Vehicle Tasks

Dependencies

Module Info

Internal State

Public API

| `M.onCareerActivated` | `()` | - | | `M.drawDebugMenu` | `()` | - |

Hooks

Task Step Types

Reward Breakdown

Usage Example

See Also

Additional Exports

Functions

Values/Properties

On this page

Delivery Vehicle Tasks

Dependencies

Module Info

Internal State

Public API

| `M.onCareerActivated` | `()` | - | | `M.drawDebugMenu` | `()` | - |

Hooks

Task Step Types

Reward Breakdown

Usage Example

See Also

Additional Exports

Functions

Values/Properties

On this page