Misc

Map Blips Configuration (Config.BlipSettings)

This section controls the visual indicators (blips) displayed on the map. You can customize the icons, colors, sizes, and visibility for every element of the job (Trucks, Trailers, Destinations, etc.).

Global Settings

useBlipCategory: Organizes the script's blips under a specific category in the map legend, in the scritp we have implemented one custom blip catagory which allows, for blips to be in the top corner of the map in one place.

• true: Blips appear under a categorized list.

• false: Blips appear individually.

Blip Properties

Every blip in the configuration uses the following standard properties. Use the reference guid provided to adjust everything to your liking.

Property	Description	Reference / Value Guide
sprite	The visual icon displayed.	View FiveM Blip ID List
color	The color of the icon.	View FiveM Color ID List
scale	The size of the icon.	1.0 = Standard Size 0.8 = Smaller 1.2 = Larger
display	Where the blip appears.	2 = Minimap Only 3 = Big Map Only 4 = Both (Standard)
useShortRange	Visibility based on distance.	Sets whether or not the specified blip should only be displayed when nearby, or on the minimap.
routeColor	Color of the GPS route.	Uses the same Color ID List linked above

Interaction & Marker Configuration

Interaction Mode (Config.MarkerType)

Defines the input system players use to interact with vehicles, menus.

• auto: The script attempts to automatically detect which interaction system you have installed. This function only works for supported scripts [ox_target/qb-target/is_interaction]

• marker: Draws a 3D marke on the ground. Players stand inside and press a button (e.g., E).

• custom: Allows you to write your own interaction logic in the code.

Config.MarkerType = 'auto'

Visual Settings (Config.MarkerSettings)

Property	Description	Reference / Value Guide
sprite	The 3D shape of the marker	FiveM Marker ID List
sizeX, Y, Z	The scale/size of the marker on each axis.	0.5 = Small 1.0 = Standard 2.0 = Large
red, green, blue	The color of the marker (0-255).	Google RGB Color Picker
alpha	The transparency/opacity of the marker.	0 = Invisible 100 = See-through 255 = Solid
rotation	Controls marker movement.	true = Rotates/Spins false = Static
interactionKey	The button required to interact when standing inside	FiveM Control List

Truck tire offset (Config.TruckOffsets)

This section defines the interaction points for vehicle maintenance, specifically for checking and inflating tires.

• How it works: Each coordinate represents a specific location around the truck where a player must stand to interact with a tire.

• Why edit this? If you add a custom truck model, the wheels will be in different positions than the default GTA trucks. You must add the new truck here for the script to recognize its tire position.

💡Pro Tip: Don't Guess!

Instead of guessing the X, Y, Z numbers, enable the Developer Tools and use the Config.PropPlacementTool command. This will allow you to see the coordinates in real-time, just use prop position as it would be the player!

Configuration Structure

• Vehicle Name (['hauler']): This must match the model name of the vehicle.

• Tire Points ([1], [2]...): A list of coordinates relative to the center of the vehicle. Each point is one tire, so if the truck has only four tires change the amount from six to four.

  • X: Left/Right distance.

  • Y: Forward/Backward distance.

  • Z: Height (usually -0.05 to target the ground/wheel level).

Default configuration

Config.TruckOffsets = {
    -- Default GTA 'Hauler' Truck
    ['hauler'] = {
        [1] = { x = -1.840, y = 2.315, z = -0.05 },  -- Front Left Wheel
        [2] = { x = -1.840, y = -1.070, z = -0.05 }, -- Middle Left Wheel
        [3] = { x = -1.840, y = -2.605, z = -0.05 }, -- Rear Left Wheel
        [4] = { x = 1.855, y = -2.610, z = -0.05 },  -- Rear Right Wheel
        [5] = { x = 1.855, y = -1.115, z = -0.05 },  -- Middle Right Wheel
        [6] = { x = 1.855, y = 2.265, z = -0.05 },   -- Front Right Wheel
    },

    -- Default GTA 'Phantom' Truck
    ['phantom'] = {
        [1] = { x = -1.730, y = 3.785, z = -0.05 },
        [2] = { x = -1.730, y = -2.350, z = -0.05 },
        [3] = { x = -1.730, y = -3.765, z = -0.05 },
        [4] = { x = 1.730, y = -3.765, z = -0.05 },
        [5] = { x = 1.730, y = -2.385, z = -0.05 },
        [6] = { x = 1.730, y = 3.780, z = -0.05 },
    }
    
    -- To add a custom truck, copy a block above and change the name:
    -- ['customtruck'] = { ... }
}

Weigh Station Configuration

This section defines the locations of the weighing platforms. These are used by police or script logic to check if a truck's load is legal or overweight.

⚠️Important

When adding or editing lines in this section, you must preserve the variable names at the start of each line (PlatformScaleBlip, PlatformScaleInfoPos, Platform, ToolChest, Laptop).

• Do NOT delete these. The script uses these variables to store entity data. Removing them will break the weigh station.

• Only edit the values x, y, z, h, width, length, leftside, offSetZ, propScaleModel, propLaptopModel, propToolChestModel and truckOnly.

Configuration Properties

• x, y, z: The center coordinates of the weigh station platform.

  • Note: The - 1.15 offset in the Z value helps align the platform object flush with the ground.

• h: Heading (rotation) of the platform.

• width / length / height: The physical size of the detection zone.

• truckOnly:

  • true: Only trucks can trigger the scale.

  • false: Any vehicle (cars, vans) can trigger the scale.

• leftSide:

  • true: Tool chest and laptop will be on the left side of the scale.

  • false: Tool chest and laptop will be on the right side of the scale.

• offSetZ: The off set from z coords value for the prop to spawn,

• propScaleModel: Model of the scale used by the script,

• propLaptopModel: Model of the laptop used by the script,

• propToolChestModel: Model of the tool chest used by the script

Progress bar

This function handles the visual progress bar shown when a player is performing an action (e.g., repairing a truck, fueling, or attaching a trailer).

• Supported Defaults: mythic_progbar ,ox_lib , esx_progressbar, qb-progressbar are pre-configured.

• Customization: If you use a different progress bar script (like rprogress), add your export in the else block.

Configuration Parameters

• duration: Time in milliseconds (1000 = 1 second).

• label: The text displayed to the player.

• name: Unique id of the progress bar action

• animDict / animName: The animation played during the action.

Fuel System (fuelExport)

Sets the fuel level of the spawned truck.

• Usage: Called immediately after the vehicle spawns.

• Customization: Change 'fuel' to whatever fuel script you use.

function fuelExport(entity)
    exports['fuel']:SetFuel(entity, 100.0)
end

Vehicle Keys (KeySystem)

Gives the player keys to the spawned truck.

• Usage: Called after spawn.

• Customization: Add your key script export here.

function KeySystem(entity, plate)
    -- Example key script trigger
    TriggerEvent('g-core:addTempKeys', plate)
    
    -- Optional: Initialize vehicle state bag
    Entity(entity).state.vehData = {
        wasRestored = 0,
        points = 0,
    }
end

Police Notifications

Client

These functions handle the visual alerts sent to police officers when players transport illegal goods.

• addPoliceMessage: Sends a stylized HTML notification to the chat box. You can change this event to anything that you like!

• addPoliceBlip: Creates a temporary "Search Area" (Radius Blip) on the map, simulating a general location rather than an exact pinpoint.

function addPoliceBlip(coords)
    local offSetX = math.random(50, 70)
    local offSetY = math.random(50, 70)
    local blipRadius = AddBlipForRadius(coords.x + offSetX, coords.y + offSetY, coords.z, 300.0)
    
    SetBlipHighDetail(blipRadius, true)
    SetBlipColour(blipRadius, 12) -- Red Color
    SetBlipAlpha(blipRadius, 170) -- Transparency
    
    Citizen.Wait(240 * 1000) -- Lasts 4 minutes (240 seconds)
    
    if DoesBlipExist(blipRadius) then RemoveBlip(blipRadius) end
end

Server

Controls when the police are notified.

• Simulated Delay: It waits between 60 to 140 seconds (math.random) before alerting the police. This gives the criminal a "head start" and simulates a civilian calling 911 after seeing the truck.

function sendPoliceNoti(streetName, illegalLabel, plateTruck, plateTrailer, dCoords)
    local time = math.random((60 * 1000), (140 * 1000)) -- 1 to 2.5 minutes delay
    Citizen.Wait(time)
    
    -- Sends info to all players (The client script filters who is a cop)
    TriggerClientEvent('gg-jobs:truckerJob_c:policeInfo', -1, streetName, illegalLabel, plateTruck, plateTrailer, dCoords)
end