ScriptRacePlayerHitCheckpoint (MISC) — FiveM Native Reference | CfxNatives

ScriptRacePlayerHitCheckpoint(ped, checkpoint, lap, time)

Description

Introduced in build 323

Records that a player has successfully passed a checkpoint during a scripted race in GTA:Online. This native should be used after initializing the race with INLINE_0.

Parameters

Name	Type	Description
`ped`	`Ped`	The index of the Ped who hit the checkpoint.
`checkpoint`	`int`	The checkpoint number that the player has passed.
`lap`	`int`	The current lap that the player is on.
`time`	`int`	The time it took for the player to reach this checkpoint from the start of the race or the last checkpoint.

Quick Snippet: Get Ped Handle

ped

Use this to get the player ped handle for this native.

-- Get the player's ped handle (client-side)
local ped = PlayerPedId()
print("Ped handle: " .. ped)

-- For a specific player's ped (server-side):
-- local targetPed = GetPlayerPed(source)

Mp M Freemode 0 1

mp_m_freemode_01

Player Zero

player_zero

Ig Agatha

ig_agatha

S M Y Cop 0 1

s_m_y_cop_01

S M M Gaffer 0 1

s_m_m_gaffer_01

G M M Armboss 0 1

g_m_m_armboss_01

A C Boar

a_c_boar

A M M Bevhills 0 1

a_m_m_bevhills_01

Returns

void

This native does not return a value.

Recommended30439

Known Issues29

28626Issues with packet loss/timeouts

27783-27938SIGSEV crashes (issue #3915)

27722Yarn fails to exit cleanly on Windows

26261-27715Issues with building Yarn resources on some Linux servers

25943Failed build

25839-25988Node.js sandboxing seems to be causing issues for people - best to avoid for now

21547Multiple (unconfirmed) reports of server-sided natives throwing errors or causing crashes; best to avoid

17462Failed build, ignore

16276Multiple reports of issues loading JS within resources

14583-14716Crash when using the new onEntityBucketChange

14583-14862Timeouts due to latency units being in nanoseconds

13759-13890Mumble (voice) external connections blocked by default

13380-13458Server crashing due to integer encoding (PR#3235)

13079Failed Linux build (works OK if using Windows!)

12933-13045Still crashes (sometimes) when restarting resources due to Node.js 22

12913-12932Causes a crash when restarting Node.js 22

12767os.date() appends null terminator; can break Lua scripts

12651Failed Linux build, ignore

12509Failed build, ignore

12255Unconfirmed, but several reports of server-side issues that don't persist when downgrading; best to avoid

12160-12165Cannot use entity native calls in entityRemoved

12151Crashing if using newest title update (TU)

12092-12135SetPlayerModel may cause SIGSEGV crashes on some clients due to changes in player handling. 12031 and below works fine.

12078-12083Some clients will fail to connect with 'ReadBulk of header failed' error

10930Failed build, ignore

10268-10309sv_experimentalNetGameEventHandler enabled by default; can cause server crashing and reports of issues downgrading after upgrading

10191GetVehicleNumberPlateText server native broken, will cause issues with scripts involving vehicles

10072Crashing when players join

8509State bags not replicated to clients