Client Events
These are net events fired by the server to the client during the race lifecycle. You can hook into them from an external resource using AddEventHandler.
All streetrace.lobby:* events are fired only to players who are participants in the relevant lobby.
streetrace.lobby:OnAccepted
Fired when the player has been accepted into a lobby. Triggers the gather-smoke effect at the start line.
AddEventHandler('streetrace.lobby:OnAccepted', function(firstCoord)
-- firstCoord: vector3 — coordinates of the first checkpoint
print('Accepted into lobby, start is at', firstCoord)
end)| Parameter | Type | Description |
|---|---|---|
firstCoord | vector3 | World position of the first checkpoint |
streetrace.lobby:OnMobilizing
Fired when the race enters the mobilization phase (players must reach the start line).
AddEventHandler('streetrace.lobby:OnMobilizing', function(dto)
-- dto: table — full race manager data (track, participants, settings)
print('Race mobilizing')
end)| Parameter | Type | Description |
|---|---|---|
dto | table | Race manager DTO containing track, participants, and lobby settings |
streetrace.lobby:OnCountdown
Fired when all players are at the start line and the countdown begins.
AddEventHandler('streetrace.lobby:OnCountdown', function()
print('Countdown started')
end)streetrace.lobby:OnStart
Fired when the race officially starts (countdown hits zero).
AddEventHandler('streetrace.lobby:OnStart', function()
print('Race started')
end)streetrace.lobby:OnUpdateLaptime
Fired each time the player completes a lap. Sends the lap time to the UI.
AddEventHandler('streetrace.lobby:OnUpdateLaptime', function(lastLapTime)
-- lastLapTime: number — time of the last completed lap in milliseconds
print('Lap completed in', lastLapTime, 'ms')
end)| Parameter | Type | Description |
|---|---|---|
lastLapTime | number | Duration of the last lap in milliseconds |
streetrace.lobby:OnDisqualified
Fired when the local player is disqualified (DNF).
AddEventHandler('streetrace.lobby:OnDisqualified', function()
print('Player disqualified')
end)streetrace.lobby:OnForcedDisqualification
Fired when the server forces the player out of a race (e.g. admin action or integrity check).
AddEventHandler('streetrace.lobby:OnForcedDisqualification', function()
print('Player forcefully disqualified')
end)streetrace.lobby:OnDisband
Fired when the lobby is disbanded while the player is still waiting (before mobilization).
AddEventHandler('streetrace.lobby:OnDisband', function()
print('Lobby disbanded')
end)streetrace.lobby:OnRemoved
Fired when the lobby is removed after the race has finished.
AddEventHandler('streetrace.lobby:OnRemoved', function()
print('Lobby removed')
end)