GET_SAFE_COORD_FOR_PED

Hash0xB61C8E878A4199CA

Runtime nameGetSafeCoordForPed

NamespacePATH

SideClient

NameOfficial

Docs

Since build1207

GTA V hash0xB61C8E878A4199CA

Signature

BOOL GET_SAFE_COORD_FOR_PED(float x, float y, float z, BOOL onGround, Vector3* outPosition, int flags);

Parameters

Name	Type	Description
`x`	`float`	—
`y`	`float`	—
`z`	`float`	—
`onGround`	`BOOL`	—
`outPosition`	`Vector3*`	—
`flags`	`int`	—

Returns BOOL

Usage

Lua

local retval, outPosition = GetSafeCoordForPed(x, y, z, onGround, flags)

-- always works, by hash
local retval, outPosition = Citizen.InvokeNative(0xB61C8E878A4199CA, x, y, z, onGround, Citizen.PointerValueVector(), flags, Citizen.ReturnResultAnyway())

JavaScript and C#

JavaScript

const [retval, outPosition] = GetSafeCoordForPed(x, y, z, onGround, flags);

// by hash
const [retval, outPosition] = Citizen.invokeNative('0xB61C8E878A4199CA', x + 0.0000001, y + 0.0000001, z + 0.0000001, onGround, Citizen.pointerValueVector(), flags, Citizen.returnResultAnyway());

var outPosition = new OutputArgument();
bool retval = Function.Call<bool>((Hash)0xB61C8E878A4199CA, x, y, z, onGround, outPosition, flags);
// outPosition.GetResult<Vector3>()

Float parameters: Lua integers (10, or whole numbers decoded from NUI/JSON) are sent as ints and read as garbage. Write 10.0 or value + 0.0. The generated JS wrappers add 0.0000001 to non-zero floats for the same reason.
Pointer (out) arguments are not passed in Lua/JS: their values are returned after the result, in order.

Sources

alloc8or RDR3 NativeDB

Something wrong or missing? Contribute a verified note — corrections ship through pull requests.