> For the complete documentation index, see [llms.txt](https://documentation.rcore.cz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.rcore.cz/paid-resources/rcore_formula/api/server.md).

# Server

## Track Exports

### createTrack

Creates a new track in the database.

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

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

**trackData structure:**

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

***

### editTrack

Edits an existing track's properties.

```lua
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:**

```lua
{
    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.

```lua
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.

```lua
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.

```lua
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:**

```lua
{
    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.

```lua
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:**

```lua
{
    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.

```lua
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.

```lua
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.

```lua
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:**

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

**Returns:** `boolean` - `true` if successful, `false` otherwise.

***

### kickTeamMember

Removes a member from a team.

```lua
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:**

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

***

### changeMemberRole

Changes a team member's role.

```lua
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:**

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

***

### buyTeamUpgrade

Purchases an upgrade for a team.

```lua
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.

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

| Parameter | Type          | Description |
| --------- | ------------- | ----------- |
| `teamId`  | number/string | The team ID |

**Returns:** `table` or `nil`

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

***

### spawnTeamVehicle

Spawns a team vehicle at specified coordinates.

```lua
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:**

```lua
{
    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.

```lua
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.

```lua
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.

```lua
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.

```lua
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.

```lua
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.

```lua
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.

```lua
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.

```lua
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.

```lua
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.

```lua
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.

```lua
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:**

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

***

### leaveRace

Removes a player from a race.

```lua
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.

```lua
exports['rcore_formula']:deleteRace(trackId)
```

| Parameter | Type          | Description  |
| --------- | ------------- | ------------ |
| `trackId` | number/string | The track ID |

***

### getRaceCheckpointsCount

Gets the number of checkpoints on a track.

```lua
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.

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

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

**Returns:** `table` or `nil`

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

***

### addRacerPoints

Adds points to a racer.

```lua
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.

```lua
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.

```lua
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.

```lua
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.

```lua
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.

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

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

***

### getPractices

Returns all active practice sessions.

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

**Returns:** `table` - Dictionary of active practice sessions.