{"hash":"0x7EE9F5D83DD4F90E","ns":"SHAPETEST","name":"START_SHAPE_TEST_LOS_PROBE","slug":"START_SHAPE_TEST_LOS_PROBE","official":true,"named":true,"luaName":"StartShapeTestLosProbe","game":"rdr3","apiset":"client","returnType":"ScrHandle","params":[{"name":"x1","type":"float"},{"name":"y1","type":"float"},{"name":"z1","type":"float"},{"name":"x2","type":"float"},{"name":"y2","type":"float"},{"name":"z2","type":"float"},{"name":"flags","type":"int"},{"name":"entity","type":"Entity"},{"name":"p8","type":"int"}],"summary":"Starts an asynchronous ray (line of sight) test; read it with GET_SHAPE_TEST_RESULT.","descriptions":[{"source":"alloc8or","format":"text","body":"Asynchronously starts a line-of-sight (raycast) world probe shape test.\n\nUse the handle with 0x3D87450E15D98694 or 0x65287525D951F6BE until it returns 0 or 2.\n\np8 is a bit mask with bits 1, 2 and/or 4, relating to collider types; 4 should usually be used."},{"source":"vorp","format":"text","body":"Asynchronously starts a line-of-sight (raycast) world probe shape test.\n\nUse the handle with 0x3D87450E15D98694 or 0x65287525D951F6BE until it returns 0 or 2.\n\np8 is a bit mask with bits 1, 2 and/or 4, relating to collider types; 4 should usually be used. flags used are mostly 83 and 3167"}],"examples":[],"aliases":["START_SHAPE_TEST_RAY"],"enums":[],"related":["0x377906D8A31E5586","0xEDE8AC7C5108FB1D"],"build":"1207","gtaHash":"0x7EE9F5D83DD4F90E","gtaJhash":"0xEFAF4BA6","sources":["alloc8or","vorp","overlay"],"doc":3,"overlayFile":"overlay/natives/0x7EE9F5D83DD4F90E.md","noteMeta":{"contributors":["borderline-rp"],"tags":["shapetest","raycast","target"]},"notes":"The RedM runtime exposes this native as **`StartShapeTestRay`** (the older name), with the same arguments.\n\n### Flags and animals\n\nThe usual \"world + vehicles + peds + objects\" mask (`1|2|4|8|16`) hits human peds but **not animals** — horses included. Bit 4 does not cover animal peds. Use `-1` to hit everything, then filter the entity yourself.\n\n```lua\nlocal handle = StartShapeTestRay(from.x, from.y, from.z, to.x, to.y, to.z, -1, PlayerPedId(), 0)\nlocal _, hit, endCoords, _, entity = GetShapeTestResult(handle)\n```\n\nVerified in game on the Borderline RP server (third-eye targeting on horses), September 2026.","url":"https://natives.borderlinerp.com/natives/SHAPETEST/START_SHAPE_TEST_LOS_PROBE","markdownUrl":"https://natives.borderlinerp.com/natives/SHAPETEST/START_SHAPE_TEST_LOS_PROBE.md","snippets":{"lua":"local retval = StartShapeTestLosProbe(x1, y1, z1, x2, y2, z2, flags, entity, p8)","luaInvoke":"local retval = Citizen.InvokeNative(0x7EE9F5D83DD4F90E, x1, y1, z1, x2, y2, z2, flags, entity, p8, Citizen.ResultAsInteger())","js":"const retval = StartShapeTestLosProbe(x1, y1, z1, x2, y2, z2, flags, entity, p8);","jsInvoke":"const retval = Citizen.invokeNative('0x7EE9F5D83DD4F90E', x1 + 0.0000001, y1 + 0.0000001, z1 + 0.0000001, x2 + 0.0000001, y2 + 0.0000001, z2 + 0.0000001, flags, entity, p8, Citizen.returnResultAnyway(), Citizen.resultAsInteger());","csharp":"int retval = Function.Call<int>((Hash)0x7EE9F5D83DD4F90E, x1, y1, z1, x2, y2, z2, flags, entity, p8);","notes":["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."]}}