TasksClient

taskSeekCoverToCoords

TASK_SEEK_COVER_TO_COORDS0x39246A6958EF072C

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

SignatureJavaScript
taskSeekCoverToCoords(
  ped: Ped,
  x1: number,
  y1: number,
  z1: number,
  x2: number,
  y2: number,
  z2: number,
  timeout: number,
  shortRoute: boolean
): void
SignatureLua
taskSeekCoverToCoords(
  ped: Ped,
  x1: number,
  y1: number,
  z1: number,
  x2: number,
  y2: number,
  z2: number,
  timeout: integer,
  shortRoute: boolean
)

Usage

JavaScript
taskSeekCoverToCoords(ped, x1, y1, z1, x2, y2, z2, timeout, shortRoute);
Lua
taskSeekCoverToCoords(ped, x1, y1, z1, x2, y2, z2, timeout, shortRoute)

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
taskSeekCoverToCoords(ped, pos1, pos2, timeout, shortRoute);
Lua · with vectors
taskSeekCoverToCoords(ped, pos1, pos2, timeout, shortRoute)

Parameters

ParameterTypeJavaScriptLua
pedPednumberinteger
x1floatnumbernumber
y1floatnumbernumber
z1floatnumbernumber
x2floatnumbernumber
y2floatnumbernumber
z2floatnumbernumber
timeoutintnumberinteger
shortRouteBOOLbooleanboolean

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.

p8 causes the ped to take the shortest route to the cover position. It may have something to do with navmesh or pathfinding mechanics.

from michael2:

taskSeekCoverToCoords(ped, 967.5164794921875, -2121.603515625, 30.479299545288086, 978.94677734375, -2125.84130859375, 29.4752, -1, 1);

appears to be shorter variation
from michael3:

taskSeekCoverToCoords(ped, -2231.011474609375, 263.6326599121094, 173.60195922851562, -1, 0);

Reference

Namespace
Tasks TASK
In the game
void TASK_SEEK_COVER_TO_COORDS(Ped ped, float x1, float y1, float z1, float x2, float y2, float z2, int timeout, BOOL shortRoute)
Hash
0x39246A6958EF072C

Open in the interactive natives reference