natives.taskCarMissionPedTarget

Function Client Only Online and Offline

Available since Client 1.0.0

void natives.taskCarMissionPedTarget(Ped ped, Vehicle vehicle, Ped target, int driveFlag, float driveSpeed, int driveStyle, int stopDist, int chaseDist)

The natives.taskCarMissionPedTarget function is used to make the vehicle follow the target using internal game path data.

Parameters

1)	Ped	ped	The Ped to drive the Vehicle.
2)	Vehicle	vehicle	The Vehicle to drive with.
3)	Ped	target	The targetPed to chase after.
4)	int	driveFlag	The AI driving/chasing behavior to use. (0-13, see details below).
5)	float	driveSpeed	The speed of driving in meters per second. (default = 20).
6)	int	driveStyle	The AI driving style (behavior) to use. (0-7, see details below).
7)	int	stopDist	Special distance flag #1, depending on selected driveFlag; vehicle may stop within.
8)	int	chaseDist	Special distance flag #2, depending on selected driveFlag; direct chase mode within.

Return

void	This function doesn't return a value.

Notes

• direct chase mode = cut corners; no braking before intersections; ignore obstacles; follow target directly;.

Examples

Example 1 - JavaScript - Client-Side:

// find a random char inside a vehicle
function getPedInVehicle() {
	// array of all peds (includes localPlayer)
	let allPeds = getPeds();

	// loop thru peds array
	for (let i=0; i < allPeds.length; i++)
	{
		// filter by peds in vehicles
		if (allPeds[i] != localPlayer && allPeds[i].isInVehicle) {
			return allPeds[i];
		}
	}

	return null;
}

/* example code provided by DrFauli */
addCommandHandler("chasetarget", function(cmdName, params) {
	// find a random char inside a vehicle
	let thisPed = getPedInVehicle();
	if (thisPed == null) return false;

	let driveSpeed = 25;
	let driveFlag = 6;  // 6 = chase after target (player) and stay on throttle
	let driveStyle = 2  // ignore traffic lights; drive around peds and cars
	let stopDist = 10;  // dist behavior flag 1 (stop within)
	let chaseDist = 25; // dist behavior flag 2 (chase within)

	// prevent ped from leaving the car screaming by marking it as mission_char first
	natives.setCharAsMissionChar(thisPed, true);
	natives.setCharStayInCarWhenJacked(thisPed, true);
	natives.setCharInvincible(thisPed, true);
	natives.clearCharTasks(thisPed);

	// let ped follow player and crash into him (driveFlag: 6)
	// [syntax]: PedHandle, CarHandle, TargetCharHandle, flag, speed, style, stopDist, chaseDist
	natives.taskCarMissionPedTarget(thisPed, thisPed.vehicle, localPlayer, driveFlag, driveSpeed, driveStyle, stopDist, chaseDist);

	// add a blip to make the ped more visible to the player
	natives.addBlipForChar(thisPed);

	return true;
});

Compatibility

There isn't any compatibility information for this function.

Related

Client Related

gta.cancelMission
gta.onMission
gta.startMission

driving flag behavior

	behavior	ramming	overtaking	stopDist	chaseDist
0	follow target	from behind (+braking)	stay behind	not used	direct chase within
1	drive wander	ignore target	ignore target	not used	not used
2	follow target	from behind (+braking)	stay behind	not used	direct chase within
3	follow target	from sides	overtake then stop	not used	direct chase within
4	follow target	none	overtake then stop	stop within (forever)	direct chase within
5	do nothing	/	/	/	/
6	follow target	from behind (+full throttle)	stay behind (+full throttle)	not used	direct chase within
7	follow target	none	stay behind	stop within	direct chase within
8	drive wander	ignore target	ignore target	not used	not used
9	follow target	none	circle around then stop	distance left side	distance right side
10	follow target	none	drive parallel (left)	not used	parallel within
11	follow target	none	drive parallel (right)	not used	parallel within
12	follow target	none	drive parallel (rear)	not used	parallel within
13	follow target	none	drive parallel (front)	not used	parallel within

driving flag notes

• all flags will follow the selected driveStyle (parameter 6)
• driveStyle will be ignored within radius of chaseDist(direct chase mode)
• flag 0 and 2 seem to be identical.
• flag 1 and 8 seem to be identical.

driving style behavior

	traffic lights	other cars	pedestrians	blinkers	when stuck
0	ignore	drive around	drive around	not used	reverse
1	stop on red	stay behind	stop and honk	used on intersections	wait
2	ignore	drive around	drive around	not used	reverse
3	ignore	ignore	ignore	not used	reverse
4	ignore	stay behind	stop and honk	not used	wait
5	stop on red	drive around	drive around	not used	reverse
6	stop+reversing	drive around	drive around	not used	reverse
7	stop on red	stay behind	stop and honk	used on intersections	wait

driving style notes

• driving styles 0 and 2 seem to be identical.
• driving styles 1 and 7 seem to be identical.