Server

Track Exports

createTrack

Creates a new track in the database.

exports['rcore_formula']:createTrack(client, trackData)

Parameter	Type	Description
client	number	The player's server ID
trackData	table	Track configuration

trackData structure:

{
    name = "Track Name",  -- string: Track display name
    icon = "icon_name"    -- string (optional): Track icon identifier
}

---

editTrack

Edits an existing track's properties.

exports['rcore_formula']:editTrack(client, trackId, editData)

Parameter	Type	Description
client	number	The player's server ID
trackId	number/string	The ID of the track to edit
editData	table	Fields to update

editData structure:

{
    name = "New Name",           -- string (optional): New track name
    startingPositions = {...},   -- table (optional): Starting grid positions
    registrationFee = 1000,      -- number (optional): Race entry fee
    zone = {...},                -- table (optional): Track zone boundaries
    zoneData = {...}             -- table (optional): Additional zone data
}

---

deleteTrack

Deletes a track from the database.

exports['rcore_formula']:deleteTrack(client, trackId)

Parameter	Type	Description
client	number	The player's server ID
trackId	number/string	The ID of the track to delete

---

getTracks

Returns all loaded tracks.

local tracks = exports['rcore_formula']:getTracks()

Returns: table - Dictionary of all loaded tracks indexed by track ID.

---

Team Exports

createTeam

Creates a new racing team.

exports['rcore_formula']:createTeam(owner, teamData, base)

Parameter	Type	Description
owner	number	Player server ID who will own the team
teamData	table	Team configuration
base	boolean	(optional) Whether this is a base/template team

teamData structure:

{
    name = "Team Name",    -- string: Team display name
    icon = "icon_name",    -- string: Team icon identifier
    colors = {             -- table: Team colors
        primary = {...},
        secondary = {...}
    }
}

---

editTeam

Edits an existing team's properties.

exports['rcore_formula']:editTeam(client, teamId, editData)

Parameter	Type	Description
client	number	The player's server ID
teamId	number/string	The ID of the team to edit
editData	table	Fields to update

editData structure:

{
    name = "New Team Name",  -- string (optional): New team name
    icon = "new_icon"        -- string (optional): New icon identifier
}

---

deleteTeam

Deletes a team and removes all members.

exports['rcore_formula']:deleteTeam(client, teamId)

Parameter	Type	Description
client	number	The player's server ID
teamId	number/string	The ID of the team to delete

---

setTeamMoney

Sets a team's balance to a specific amount.

local success = exports['rcore_formula']:setTeamMoney(teamId, amount)

Parameter	Type	Description
teamId	number/string	The team ID
amount	number	The new balance amount

Returns: boolean - true if successful, false otherwise.

---

handleTeamTransaction

Processes a financial transaction for a team.

local success = exports['rcore_formula']:handleTeamTransaction(client, teamId, transactionType, amount, data)

Parameter	Type	Description
client	number	The player's server ID
teamId	number/string	The team ID
transactionType	string	Transaction type (see below)
amount	number	Transaction amount
data	table	(optional) Additional options

Transaction Types:

• DEPOSIT - Add money to team balance

• WITHDRAW - Remove money from team balance

• PAY_FEE - Pay race registration fee

• RETURN_FEE - Refund registration fee

• RECEIVE_PRIZE - Receive race winnings

• BUY_UPGRADE - Purchase team upgrade

• PENALTY - Pay penalty fee

data structure:

{
    ignorePermissions = false  -- boolean: Skip permission checks
}

Returns: boolean - true if successful, false otherwise.

---

kickTeamMember

Removes a member from a team.

exports['rcore_formula']:kickTeamMember(client, teamId, racerId, data)

Parameter	Type	Description
client	number	The player's server ID (who is kicking)
teamId	number/string	The team ID
racerId	number/string	The racer ID to kick
data	table	(optional) Additional options

data structure:

{
    fromMenu = false  -- boolean: Whether action is from UI menu
}

---

changeMemberRole

Changes a team member's role.

exports['rcore_formula']:changeMemberRole(client, teamId, racerId, role, data)

Parameter	Type	Description
client	number	The player's server ID (who is changing role)
teamId	number/string	The team ID
racerId	number/string	The racer ID
role	string	The new role name
data	table	(optional) Additional options

data structure:

{
    fromMenu = false  -- boolean: Whether action is from UI menu
}

---

buyTeamUpgrade

Purchases an upgrade for a team.

exports['rcore_formula']:buyTeamUpgrade(client, teamId, upgradeName, tier)

Parameter	Type	Description
client	number	The player's server ID
teamId	number/string	The team ID
upgradeName	string	Upgrade name (e.g., 'vehicles', 'pitstop', 'repair')
tier	number	The tier level to upgrade to

---

getActiveTeamVehicle

Gets the active vehicle configuration for a team.

local vehicle = exports['rcore_formula']:getActiveTeamVehicle(teamId)

Parameter	Type	Description
teamId	number/string	The team ID

Returns: table or nil

{
    model = "vehicle_model",  -- string: Vehicle model name
    primary = {...},          -- table: Primary color
    secondary = {...}         -- table: Secondary color
}

---

spawnTeamVehicle

Spawns a team vehicle at specified coordinates.

local vehicleEntity = exports['rcore_formula']:spawnTeamVehicle(client, teamId, coords)

Parameter	Type	Description
client	number	The player's server ID
teamId	number/string	The team ID
coords	table/vector4	Spawn position with heading

coords structure:

{
    x = 0.0,
    y = 0.0,
    z = 0.0,
    w = 0.0  -- heading
}

Returns: number or nil - Vehicle entity handle if successful.

---

getTeams

Returns all loaded teams.

local teams = exports['rcore_formula']:getTeams()

Returns: table - Dictionary of all loaded teams indexed by team ID.

---

Team Racer Exports

addPlayerToTeam

Adds a player to a team with a specific role.

exports['rcore_formula']:addPlayerToTeam(client, teamId, role)

Parameter	Type	Description
client	number	The player's server ID
teamId	number/string	The team ID
role	string	The role to assign

---

setPlayerTeamRoleByRacerId

Changes a racer's role by their racer ID.

local success = exports['rcore_formula']:setPlayerTeamRoleByRacerId(racerId, teamId, role)

Parameter	Type	Description
racerId	number/string	The racer ID
teamId	number/string	The team ID
role	string	The new role

Returns: boolean - true if successful, false otherwise.

---

removePlayerFromTeam

Removes a player from a team.

exports['rcore_formula']:removePlayerFromTeam(client, teamId)

Parameter	Type	Description
client	number	The player's server ID
teamId	number/string	The team ID

---

removePlayerFromTeamByRacerId

Removes a player from a team by their racer ID.

local success = exports['rcore_formula']:removePlayerFromTeamByRacerId(racerId, teamId)

Parameter	Type	Description
racerId	number/string	The racer ID
teamId	number/string	The team ID

Returns: boolean - true if successful, false otherwise.

---

removeAllPlayersFromTeam

Removes all members from a team.

local success = exports['rcore_formula']:removeAllPlayersFromTeam(teamId)

Parameter	Type	Description
teamId	number/string	The team ID

Returns: boolean - true if successful, false otherwise.

---

Race Exports

setRaceState

Updates the state of a race.

exports['rcore_formula']:setRaceState(trackId, state)

Parameter	Type	Description
trackId	number/string	The track ID
state	string	The new race state

Race States:

• JOINING - Waiting for racers to join

• STARTING - Race countdown

• RACING - Race in progress

• FINISHED - Race completed

---

canCreateRace

Checks if a player can create a race.

local canCreate = exports['rcore_formula']:canCreateRace(client)

Parameter	Type	Description
client	number	The player's server ID

Returns: boolean - true if player has permission, false otherwise.

---

createRace

Creates a new race on a track.

exports['rcore_formula']:createRace(client, trackId, racersCount, laps, joinData)

Parameter	Type	Description
client	number	The player's server ID
trackId	number/string	The track ID
racersCount	number	Required number of racers
laps	number	Number of laps
joinData	table	(optional) Additional join configuration

---

canRaceStart

Checks if a race has enough participants to start.

local canStart = exports['rcore_formula']:canRaceStart(trackId)

Parameter	Type	Description
trackId	number/string	The track ID

Returns: boolean - true if all required racers have joined, false otherwise.

---

joinRace

Adds a player to a race.

exports['rcore_formula']:joinRace(client, trackId, teamId, joinData)

Parameter	Type	Description
client	number	The player's server ID
trackId	number/string	The track ID
teamId	number/string	The team ID
joinData	table	(optional) Join preferences

joinData structure:

{
    tires = "soft"  -- string: Tire compound preference
}

---

leaveRace

Removes a player from a race.

exports['rcore_formula']:leaveRace(client, trackId, kick)

Parameter	Type	Description
client	number	The player's server ID
trackId	number/string	The track ID
kick	boolean	(optional) Whether this is a forced removal

---

deleteRace

Deletes a race from a track.

exports['rcore_formula']:deleteRace(trackId)

Parameter	Type	Description
trackId	number/string	The track ID

---

getRaceCheckpointsCount

Gets the number of checkpoints on a track.

local count = exports['rcore_formula']:getRaceCheckpointsCount(trackId)

Parameter	Type	Description
trackId	number/string	The track ID

Returns: number - Checkpoint count, or 0 if track not found.

---

getHistoricalRaceData

Retrieves data from a completed race.

local raceData = exports['rcore_formula']:getHistoricalRaceData(raceId)

Parameter	Type	Description
raceId	number/string	The race ID from database

Returns: table or nil

{
    standings = {...},  -- table: Final race standings
    timeData = {...}    -- table: Timing information
}

---

addRacerPoints

Adds points to a racer.

local success = exports['rcore_formula']:addRacerPoints(client, points, clientIdentifier)

Parameter	Type	Description
client	number	The player's server ID
points	number	Points to add
clientIdentifier	string	Player identifier (for offline players)

Returns: boolean - true if successful, false otherwise.

---

addTeamPoints

Adds points to a team.

local success = exports['rcore_formula']:addTeamPoints(teamId, points)

Parameter	Type	Description
teamId	number/string	The team ID
points	number	Points to add

Returns: boolean - true if successful, false otherwise.

---

getCachedRacerPoints

Gets cached points for a racer.

local points = exports['rcore_formula']:getCachedRacerPoints(client)

Parameter	Type	Description
client	number	The player's server ID

Returns: number - Racer's current points.

---

getCachedTeamPoints

Gets cached points for a team.

local points = exports['rcore_formula']:getCachedTeamPoints(teamId)

Parameter	Type	Description
teamId	number/string	The team ID

Returns: number - Team's current points, or 0 if not found.

---

getWatchers

Gets all players watching a race on a track.

local watchers = exports['rcore_formula']:getWatchers(trackId)

Parameter	Type	Description
trackId	number/string	The track ID

Returns: table - Dictionary of watchers {clientId = true, ...}

---

getRaces

Returns all active races.

local races = exports['rcore_formula']:getRaces()

Returns: table - Dictionary of active races indexed by track ID.

---

getPractices

Returns all active practice sessions.

local practices = exports['rcore_formula']:getPractices()

Returns: table - Dictionary of active practice sessions.