TasksClient

taskDriveBy

TASK_DRIVE_BY0x2F8AF0E82773A171

The GTA V native TASK_DRIVE_BY of the TASK namespace, as LS:MP client scripts call it: the global function taskDriveBy, in JavaScript and in Lua.

SignatureJavaScript
taskDriveBy(
  driverPed: Ped,
  targetPed: Ped,
  targetVehicle: Vehicle,
  targetX: number,
  targetY: number,
  targetZ: number,
  distanceToShoot: number,
  pedAccuracy: number,
  pushUnderneathDrivingTaskIfDriving: boolean,
  firingPattern: Hash
): void
SignatureLua
taskDriveBy(
  driverPed: Ped,
  targetPed: Ped,
  targetVehicle: Vehicle,
  targetX: number,
  targetY: number,
  targetZ: number,
  distanceToShoot: number,
  pedAccuracy: integer,
  pushUnderneathDrivingTaskIfDriving: boolean,
  firingPattern: Hash
)

Usage

JavaScript
taskDriveBy(
  driverPed, targetPed, targetVehicle, targetX, targetY, targetZ, distanceToShoot, pedAccuracy,
  pushUnderneathDrivingTaskIfDriving, firingPattern
);
Lua
taskDriveBy(
    driverPed, targetPed, targetVehicle, targetX, targetY, targetZ, distanceToShoot,
    pedAccuracy, pushUnderneathDrivingTaskIfDriving, firingPattern
)

Three consecutive numbers can be given as one vector: { x, y, z } (or [x, y, z]) in JavaScript, a Vector3 in Lua.

JavaScript · with vectors
taskDriveBy(
  driverPed, targetPed, targetVehicle, target, distanceToShoot, pedAccuracy,
  pushUnderneathDrivingTaskIfDriving, firingPattern
);
Lua · with vectors
taskDriveBy(
    driverPed, targetPed, targetVehicle, target, distanceToShoot, pedAccuracy,
    pushUnderneathDrivingTaskIfDriving, firingPattern
)

Parameters

ParameterTypeJavaScriptLua
driverPedPednumberinteger
targetPedPednumberinteger
targetVehicleVehiclenumberinteger
targetXfloatnumbernumber
targetYfloatnumbernumber
targetZfloatnumbernumber
distanceToShootfloatnumbernumber
pedAccuracyintnumberinteger
pushUnderneathDrivingTaskIfDrivingBOOLbooleanboolean
firingPatternHashnumberinteger

Returns

Nothing. In JavaScript the call evaluates to undefined.

Notes

From the community native database. Names are LS:MP’s; samples may be written for C++ or another framework.

Example:

taskDriveBy(l_467[1/*22*/], playerPedId(), 0, 0.0, 0.0, 2.0, 300.0, 100, 0, ${firing_pattern_burst_fire_driveby});

Needs working example. Doesn't seem to do anything.

I marked p2 as targetVehicle as all these shooting related tasks seem to have that in common.
I marked p6 as distanceToShoot as if you think of GTA's Logic with the native SET_VEHICLE_SHOOT natives, it won't shoot till it gets within a certain distance of the target.
I marked p7 as pedAccuracy as it seems it's mostly 100 (Completely Accurate), 75, 90, etc. Although this could be the ammo count within the gun, but I highly doubt it. I will change this comment once I find out if it's ammo count or not.

Reference

Namespace
Tasks TASK
In the game
void TASK_DRIVE_BY(Ped driverPed, Ped targetPed, Vehicle targetVehicle, float targetX, float targetY, float targetZ, float distanceToShoot, int pedAccuracy, BOOL pushUnderneathDrivingTaskIfDriving, Hash firingPattern)
Hash
0x2F8AF0E82773A171

Open in the interactive natives reference