Player Client

This page covers client-side player functionality for BJJ Racing Core v7. These functions handle player data management and notifications on the client.

Core Exports

Access the core through the main export:

local Core = exports.bjj_racingcore:getCore()

Player Data Functions

getPlayerData()

Retrieves the locally stored player data.

local playerData = Core.getPlayerData()

Returns: table - Complete player data object

charId: number - Character ID
name: string - Player name
mmr: number - Player MMR rating
money: number - Player money balance
crypto: number - Player crypto balance
groups: table - Player permission groups
racingdata: table - Racing-specific data
metadata: table - Additional player metadata

This function will print a warning if called before player data is loaded. Always check if data exists before using.

Player Events

Receiving Events

Event	Parameters	Description
`bjj_racingcore:client:setPlayerData`	`data: table`	Sets complete player data
`bjj_racingcore:client:updatePlayerData`	`data: table`	Updates specific player data fields
`bjj_racingcore:client:playerDataSet`	`data: table`	Triggered when player data is set
`bjj_racingcore:client:playerDataUpdated`	`data: table`	Triggered when player data is updated
`bjj:client:playerLoaded`	-	Player has completed loading

Event Handlers

Listen for player data changes:

-- Player data has been set
RegisterNetEvent('bjj_racingcore:client:playerDataSet', function(data)
    print('Player data loaded:', json.encode(data))
end)

-- Player data has been updated
RegisterNetEvent('bjj_racingcore:client:playerDataUpdated', function(data) 
    print('Player data updated:', json.encode(data))
end)

-- Player has fully loaded
RegisterNetEvent('bjj:client:playerLoaded', function()
    print('Player is now fully loaded and ready')
end)

Always ensure player data is loaded before accessing it. The core system handles data synchronization automatically.