config.lua

This reference walks through each property inside config.lua, including default values and accepted inputs.

General

debug

• Type: boolean
• Default: false
• Enables verbose logging for troubleshooting.

SQL

autoSQL

Automatically manages base tables/columns.

• enabled (boolean, default true): create missing tables on resource start.
• forced (boolean, default false): re-run SQL import regardless of state. Tracks still require manual import.

UI

UIPosition

• Type: string
• Default: "top-left"
• Accepted values: "top-left", "top-right", "bottom-left", "bottom-right".

paceNotesPadding

• Type: string
• Default: "3.25rem"
• Any valid CSS length that offsets pace notes from the screen edge.

Devices & Commands

fd_laptop

• Type: boolean
• Default: false
• Enables the laptop application when fd_laptop is installed.

command

• Type: string | boolean
• Default: "tablet"
• Command used to open the tablet when no laptop/inventory integration exists. Set to false to disable.

Framework Mode

framework

• Type: string
• Default: "auto"
• Options: "auto", "qbx", "qb", "ox", "nd", "esx", "standalone", or a custom framework identifier that follows the bridge contract.

Phasing

phasingMode

• Type: string
• Default: "race"
• "global" phases racers through every player; "race" limits it to competitors in the same race.

Money Distribution

raceMoneyDistribution

• Type: string
• Default: "top"
• Options:
  • "top": top 3 racers split the pot.
  • "all": everyone is rewarded with top-heavy scaling.
  • "equal": identical payouts for all racers.

Race Generation

raceGeneration

Controls automated race creation via scheduled windows.

• generationTime (table): hour/minute of race creation.
• raceStartTime / raceEndTime (table): defines the window for generated races.
• raceAmount (number, default 48): total generated races per window.
• classes.enabled (boolean, default true)
• classes.evenChances (boolean, default true)
• classes.classes (table): per-class weighting.
• moneyPrize.min (number, default 1000)
• moneyPrize.max (number, default 5000)
• laps.min (number, default 1)
• laps.max (number, default 3)
• phasing.enabled (boolean, default true)
• phasing.time (number, default 30 seconds; 0 disables)
• cameraOption.random (boolean, default true)
• cameraOption.fixed ("unset" | "first", default "unset")

Vehicle Classes

vehicleClasses

Defines how vehicles are sorted into race classes.

• mode ("auto" | "manual", default "auto")
• allowLowerClassesWithHigherClasses (boolean, default true)
• classes (table): list of { name, title, score } entries.

Set mode to "manual" to edit vehicleClasses.lua; see vehicle classes.

Checkpoints

checkpointZones

• mode ("cylinder" | "precise", default "precise")
• dynamicMultiplier (number, default 2.0)

Sounds & Keybinds

Use the sounds table to map cue names to audio assets, and keybinds to register creation and racing shortcuts.