View source for Client/Natives/IV/taskCarDriveWander

{{DISPLAYTITLE:natives.taskCarDriveWander}}
{{ScriptItem
|endpoint = client
|games = iv
|type = function
|name = natives.taskCarDriveWander
|usage = make the vehicle randomly drive around using internal game path data.
|parameters = Ped ped, Vehicle vehicle, float driveSpeed, int driveStyle
|parameter1 = Ped ped The Ped to drive the Vehicle.
|parameter2 = Vehicle vehicle The Vehicle to drive with.
|parameter3 = float driveSpeed The speed of driving in meters per second. '''(default = 20)'''
|parameter4 = int driveStyle The AI driving style (behavior) to use. (0-7, ''see details below'')
|return1 = void
|returnFail1 = void
|exampleJSCS = /* example code provided by DrFauli */
addCommandHandler("drivewander", function(cmdName, params) {
	// current vehicle/ped handle
	let thisVeh = null;
	let thisPed = null;

	// check if player is in a car
	if (!localPlayer.vehicle) {
		natives.requestModel(-956048545) // Taxi
		natives.requestModel(8772846); // Taxi Driver
		natives.loadAllObjectsNow();

		// spawn the car
		thisVeh = createVehicle2(-956048545, localPlayer.position, true);
		thisVeh.heading = localPlayer.heading;

		// spawn the driver
		thisPed = natives.createCharInsideCar(thisVeh, 1, 8772846);

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

		// warp player into passenger seat id 0 (next to driver)
		natives.warpCharIntoCarAsPassenger(localPlayer, thisVeh, 0);
	}
	else {
		thisVeh = localPlayer.vehicle;
		thisPed = thisVeh.getOccupant(0);
	}

	// get speed and driveStyle from params
	let splitParams = params.split(" ");
	let driveSpeed = Number(splitParams[0]); // default is 20
	let driveStyle = Number(splitParams[1]);

	// let this car randomly drive around
	// [syntax]: pedHandle, carHandle, driveSpeed, driveStyle
	natives.taskCarDriveWander(thisPed, thisVeh, driveSpeed, driveStyle);

	return true;
});
}}