ScriptRacePlayerHitCheckpoint (MISC) — FiveM Native Reference | NativeHub

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 <code>SCRIPT_RACE_INIT</code>.

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.

Recommended25963

Known Issues24

25987-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