Configuration

Basic Configuration

Edit config.lua to set your F1 vehicle model:

Config = {}

Config.CarModelName = "cw2020"  -- Change to your F1 car spawn name

Important: The model name must match your F1 vehicle's spawn name exactly (case-sensitive).

Checkpoint Configuration

Checkpoints are defined in client.lua starting around line 133. The system uses three types of checkpoints:

Checkpoint Types

1. Start/Finish Line (type = "start")

   • Marks lap start and finish

   • Uses rectangular detection zone

   • Only one start checkpoint allowed

2. Between Checkpoints (type = "bet")

   • Validation points along the track

   • Must pass all to achieve a valid lap

   • Uses circular detection zones

3. Sector Markers (type = "sector")

   • Divides lap into sectors (typically 3)

   • Also counts as validation checkpoint

   • Uses circular detection zones

Checkpoint Structure

local checkpoints = {
    -- Start/Finish Line (Rectangular)
    {
        pos = vector3(4215.494628, 8020.773438, 93.865234),
        width = 18.0,      -- Width of detection zone
        length = 4.0,      -- Length of detection zone
        heading = 10.0,    -- Direction/rotation
        type = "start"
    },
    
    -- Regular Checkpoint (Circular)
    {
        pos = vector3(3999.0, 8177.41, 101.4),
        radius = 15.0,     -- Detection radius
        type = "bet"       -- Between checkpoint
    },
    
    -- Sector Marker (Circular)
    {
        pos = vector3(5798.25, 7225.24, 145.32),
        radius = 15.0,
        type = "sector"    -- Marks end of Sector 1
    },
    
    -- Add more checkpoints...
}

Adding/Editing Checkpoints

1. Get Coordinates: Use a coordinate tool or in-game method

2. Add to Array: Insert new checkpoint in racing order

3. Set Type: Choose start, bet, or sector

4. Set Detection Zone:

   • Start line: width, length, heading

   • Others: radius (in game units)

5. Test: Drive through to verify detection

Example Track Layout:

-- Sector 1: Start → Checkpoint 5 → Sector Marker
-- Sector 2: Sector Marker → Checkpoint 12 → Sector Marker
-- Sector 3: Sector Marker → Checkpoint 20 → Start/Finish

Minimum Lap Time

Prevents accidental lap triggers from brief checkpoint crossings:

local MIN_LAP_TIME = 3000  -- Minimum 3 seconds (in milliseconds)

Adjust based on your track length:

• Short tracks: 5000-10000 ms (5-10 seconds)

• Medium tracks: 15000-30000 ms (15-30 seconds)

• Long tracks: 60000+ ms (1+ minute)