Base configuration

Job Locations & Spawns

This section defines the physical coordinates for every stage of the job lifecycle, from the start marker to vehicle spawning and return points.

• jobOffers: The coordinate for the job start. Position of the menu with avaible transports.

• truckSpawnPos / traierSpawnPos / vehicleSpawnPos: Lists of coordinates where vehicles will be spawned after starting a job. We recommend adding multiple spawn positions to prevent situations where vehicles or trailers spawn on top of each other. For setting up those coords we recommend using our tools included in the script.

• truckReturnPos: The location where players must drive to finish the job.

• checkUpPoses: Locations where players can perform vehicle maintenance.

• blipSettings: Controls the map icon for this specific job hub (Sprite, Color, Name).

Lobby & Camera Setup

These settings control the cinematic view when the player is browsing jobs in the menu.

• lobbyCoords: Defines where the player's character (Ped) stands during the menu screen.

  • ⚠️Important: You can setup up to 3 positions, due to script supporting only 3 players in one job at a time.

• cameraSettings: Defines the fixed camera angle looking at the players/vehicles in the lobby. To setup those coords we recommend using our tools included with the script.

Job Definitions (jobList)

This is the core configuration where you create specific jobs (e.g., Concrete Mixer, Cargo Haul, Fuel Tanker).

• label: The display name shown in the menu.

• nameID: A unique internal name (must be unique).

• maxPlayers: The maximum number of people who can do this job together.

  • ⚠️Important: The max amount of players is 3, this script does not support more players at once!

• imgLink: URL to the image displayed in the job menu card.

• reward: The base payment amount. When a job is set for more than one player the reward will be split to all of the players based on the % set before starting the job.

• truckModel / trailerModel: The model for the vehicles used.

• props: Attaches static objects to the trailer.

  • Example: In the code provided, a prop_staticmixer_01 is attached to a flatbed to make it look like a cement truck. To setup those props we recommend using our tools included with the script.

Destination (desinationCoords)

A list of all possible drop-off locations. The script will randomly pick one from this list.

Transport Types (transportType)

Inside every job, you can define different "tiers" of difficulty called transportType. This controls the legality of the cargo and the payout multiplier. You cannot add or remove load types from the existing ones in config.

Legal Load

• multi: Payment multiplier (Default value is equal to 1.0).

• convoyVehicle: Vehicle that is being used for that transport type.

• Description: Standard job, no police risk.

Overweight Load

• multi: Payment bonus (e.g., 1.1 = 10% bonus to total reward of the job).

• minWeight / maxWeight: Defines the cargo weight.

• convoyVehicle: Vehicle that is being used for that transport type.

• Risk: If the player is being stopped at by police officer they can go to weight station and be weigh in.

Illegal Load

• multi: High payment bonus (e.g., 1.2 = 20% bonus to total reward of the job).

• type: Defines specific contraband (Weed, Coke, Gold, Alcohol). You can add multiple types More examples are given with the script, you can find them in EXAMPLES.MD

• convoyVehicle: Vehicle that is being used for that transport type.

• props: Attaches visual evidence to the cargo (e.g., a weed block or weapon case).

• Risk: High risk of police checks.