This page details the configuration options available in the configs/config.lua file for the Nexure Racing System. Below is each setting, its description, and possible values or requirements.

General Settings

• debug
  • Type: boolean
  • Default: false
  • Enables debug mode for troubleshooting.

SQL Configuration

• autoSQL
  • Type: table
  • Description: Handles automatic SQL table creation. Tracks must still be imported manually.
  • • enabled: boolean, default true - Enables automatic table and column creation.
    • forced: boolean, default false - Forces SQL import regardless of the current state.

UI Configuration

• UIPosition

  • Type: string
  • Default: "top-left"
  • Sets the UI position on the screen. Options: "top-left", "top-right", "bottom-left", "bottom-right".

• paceNotesPadding

  • Type: string
  • Default: "3.25rem"
  • Sets the gap between pace notes and the screen edge. Accepts any CSS value.

Device and Command Configuration

• fd_laptop

  • Type: boolean
  • Default: false
  • Enables the laptop app if you have fd_laptop installed.

• command

  • Type: string or boolean
  • Default: "tablet"
  • Command to open the tablet interface when no fd_laptop or inventory system is available. Set to false to disable.

Framework Configuration

• framework
  • Type: string
  • Default: "auto"
  • Specifies the framework mode. Options: "auto" (auto-detects from running resources) or specific framework names: "qbx", "qb", "ox", "nd", "esx", "standalone", or a custom framework name that follows the bridge structure.

Phasing Configuration

• phasingMode
  • Type: string
  • Default: "race"
  • Determines phasing mode. Options:
    • "global": Phases racers through all players on the server.
    • "race": Phases racers only through players in their own race.

Money Distribution

• raceMoneyDistribution
  • Type: string
  • Default: "top"
  • Defines money distribution among players. Options:
    • "top": Rewards only the top 3 players.
    • "all": Rewards all players, with larger amounts to top 3.
    • "equal": Provides the same amount to all players.

Race Generation Settings

• raceGeneration

  • Type: table
  • Contains settings for automatic race generation events based on server time.
  • • generationTime: table - Sets race generation time (hour/minute).
    • raceStartTime: table - Start time for races.
    • raceEndTime: table - End time for races.
    • raceAmount: number, default 48 - Total races to be generated within the specified time frame.

• classes

  • enabled: boolean, default true - Restricts competitive races to certain classes.
  • evenChances: boolean, default true - Sets even chance for each class selection.
  • classes: table - Defines race class settings with individual class probability for selection.

Money Prizes

• moneyPrize
  • min: number, default 1000 - Minimum prize money per race.
  • max: number, default 5000 - Maximum prize money per race.

Laps and Phasing

• laps

  • min: number, default 1 - Minimum laps per race.
  • max: number, default 3 - Maximum laps per race.

• phasing

  • enabled: boolean, default true - Enables phasing throughout the race.
  • time: number, default 30 - Phasing duration in seconds (set to 0 to disable).

Vehicle Classes

• vehicleClasses
  • Defines mode for vehicle class assignment.
  • • mode: string, default "auto" - Can be "auto" or "manual". If manual then please edit the configs/vehicleClasses.lua file aswell, Config Page
    • allowLowerClassesWithHigherClasses: boolean, default true - Enables lower-class vehicles in higher-class races.
    • classes: table - Defines vehicle class structure with class name, title, and score.

Checkpoints

• checkpointZones
  • mode: string, default "precise" - Options: "cylinder" or "precise".
  • dynamicMultiplier: number, default 2.0 - Multiplier for checkpoint zone sizing.

Sounds and Keybinds

• sounds

  • Defines sound settings with name and reference for race sounds like checkpoint missed or race start.

• keybinds

  • Configures keybinds for track creation and other race actions.

Each setting above is intended to give you control over gameplay mechanics, UI, sounds, and race generation, allowing you to tailor the experience to the server and player base needs.