MiscClient2 outputs

getGroundZAndNormalFor3dCoord

GET_GROUND_Z_AND_NORMAL_FOR_3D_COORD0x8BDC7BFC57A81E76

The GTA V native GET_GROUND_Z_AND_NORMAL_FOR_3D_COORD of the MISC namespace, as LS:MP client scripts call it: the global function getGroundZAndNormalFor3dCoord, in JavaScript and in Lua.

SignatureJavaScript
getGroundZAndNormalFor3dCoord(x: number, y: number, z: number): [
  ok: boolean,
  groundZ: number,
  normal: { x: number, y: number, z: number }
]
SignatureLua
getGroundZAndNormalFor3dCoord(
  x: number,
  y: number,
  z: number
): boolean, number, Vector3

Usage

JavaScript
const [ok, groundZ, normal] = getGroundZAndNormalFor3dCoord(x, y, z);
Lua
local ok, groundZ, normal = getGroundZAndNormalFor3dCoord(x, y, z)

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
const [ok, groundZ, normal] = getGroundZAndNormalFor3dCoord(pos);
Lua · with vectors
local ok, groundZ, normal = getGroundZAndNormalFor3dCoord(pos)

Parameters

ParameterTypeJavaScriptLua
xfloatnumbernumber
yfloatnumbernumber
zfloatnumbernumber

Returns

3 values, in this order: an array in JavaScript, multiple return values in Lua.

#ValueTypeJavaScriptLuaDescription
1okBOOLbooleanbooleanThe native’s own return value.
2groundZfloatnumbernumberoutput
3normalVector3{ x: number, y: number, z: number }Vector3output

Reference

Namespace
Misc MISC
In the game
BOOL GET_GROUND_Z_AND_NORMAL_FOR_3D_COORD(float x, float y, float z, float* groundZ, Vector3* normal)
Hash
0x8BDC7BFC57A81E76
Formerly
_GET_GROUND_Z_COORD_WITH_OFFSETS

Open in the interactive natives reference