MexTest1: page created; including Javascript example

2021-07-06T10:28:43Z

page created; including Javascript example

New page

{{DISPLAYTITLE:natives.taskCarMissionPedTarget}}
{{ScriptItem
|endpoint = client
|games = iv
|type = function
|name = natives.taskCarMissionPedTarget
|usage = make the vehicle follow the target using internal game path data.
|parameters = Ped ped, Vehicle vehicle, Ped target, int driveFlag, float driveSpeed, int driveStyle, int stopDist, int chaseDist
|parameter1 = Ped ped The Ped to drive the Vehicle.
|parameter2 = Vehicle vehicle The Vehicle to drive with.
|parameter3 = Ped target The targetPed to chase after.
|parameter4 = int driveFlag The AI driving/chasing behavior to use. (0-13, ''see details below'')
|parameter5 = float driveSpeed The speed of driving in meters per second. '''(default = 20)'''
|parameter6 = int driveStyle The AI driving style (behavior) to use. (0-7, ''see details below'')
|parameter7 = int stopDist Special distance flag #1, depending on selected driveFlag; vehicle may stop within
|parameter8 = int chaseDist Special distance flag #2, depending on selected driveFlag; direct chase mode within
|notes = direct chase mode = cut corners; no braking before intersections; ignore obstacles; follow target directly;
|return1 = void
|returnFail1 = void
|exampleJSCS = // 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;
});
}}

== driving flag behavior ==
{|class="wikitable"
!|
!|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==
{|class="wikitable"
!|
!|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.

Client/Natives/IV/taskCarMissionPedTarget - Revision history

MexTest1: page created; including Javascript example