Configuration

Debug Settings

Enable detailed logging for troubleshooting:

Config.debug = {
    enabled = false,        -- Master switch for all debug logs
    categories = {
        tablet = true,      -- Tablet opening/closing
        permissions = true, -- Permission checks
        flags = true,       -- Flag spawning/deletion
        markers = true,     -- Marker interactions
        notifications = true, -- Notification sending
        server = true,      -- Server-side events
        cleanup = true,     -- Resource cleanup
        lights = true       -- Starting lights
    }
}

Set enabled = true during setup, then false in production.

Permission System

Configure who can access the race control tablet:

Config.permissions = {
    requireAdmin = true,    -- Enable permission checks
    permissionType = 'esx_job',  -- Options: 'esx_job', 'esx_group', 'ace'
    allowedJob = 'circuit',      -- ESX job name
    allowedGrades = {0, 1, 2, 3, 4},  -- Job grades (empty {} = all grades)
    adminGroups = { 'admin', 'moderator', 'steward' },  -- ESX groups
    ace = 'formula1tablet.access'  -- ACE permission name
}

Permission Type Options:

1. ESX Job-Based (Default)

permissionType = 'esx_job',
allowedJob = 'circuit',
allowedGrades = {0, 1, 2, 3, 4}

• Only players with the specified job can use tablet

• Can restrict by job grades

• Example: Circuit marshals, race directors

2. ESX Group-Based

permissionType = 'esx_group',
adminGroups = { 'admin', 'moderator', 'steward' }

• Based on ESX user groups

• Useful for admin-only access

• Multiple groups supported

3. ACE Permission

permissionType = 'ace',
ace = 'formula1tablet.access'

• Uses FiveM ACE system

• Add to server.cfg:

  add_ace group.admin formula1tablet.access allow

4. Disable Permissions

requireAdmin = false

• Anyone can access tablet (not recommended for public servers)

Notification Messages & Translation

Complete translation support - Customize all notification text:

Config.notifications = {
    -- Permission messages
    accessDenied = "~r~Access Denied~s~~n~You don't have permission to use this tablet.",
    jobRequired = "~r~Access Denied~s~~n~Job Required: ~b~Circuit",
    
    -- Error messages
    flagModelError = "~r~F1 Flags Error~s~~n~Missing model '%s'. Check resource files.",
    playerNotFound = "~r~F1 Tablet~s~~n~Player '%s' not found or offline.",
    
    -- Flag notifications (fully customizable)
    flags = {
        green = {
            type = 'drapeau_vert',
            title = 'GREEN FLAG',
            message = 'Race is active! Go go go!',
            penalty = '',
            duration = 6000,
            esxNotif = "~g~🏁 GREEN FLAG~s~~n~Track clear, racing resumed"
        },
        yellow = {
            type = 'drapeau_jaune',
            title = 'YELLOW FLAG',
            message = 'Caution! Slow down and maintain position',
            penalty = 'No overtaking allowed',
            duration = 8000,
            esxNotif = "~y~🏁 YELLOW FLAG~s~~n~Caution on track"
        },
        red = {
            type = 'drapeau_rouge',
            title = 'RED FLAG',
            message = 'Session stopped! Return to pits immediately',
            penalty = 'All cars must stop',
            duration = 10000,
            esxNotif = "~r~🏁 RED FLAG~s~~n~Session stopped"
        },
        yellowSector1 = { /* ... */ },
        yellowSector2 = { /* ... */ },
        yellowSector3 = { /* ... */ },
        safetyCar = { /* ... */ }
    }
}

Translation Example - French:

flags = {
    green = {
        type = 'drapeau_vert',
        title = 'DRAPEAU VERT',
        message = 'La course est active! Allez-y!',
        penalty = '',
        duration = 6000,
        esxNotif = "~g~🏁 DRAPEAU VERT~s~~n~Piste dégagée"
    },
    yellow = {
        type = 'drapeau_jaune',
        title = 'DRAPEAU JAUNE',
        message = 'Attention! Ralentir et maintenir la position',
        penalty = 'Dépassement interdit',
        duration = 8000,
        esxNotif = "~y~🏁 DRAPEAU JAUNE~s~~n~Prudence sur la piste"
    }
    // ... more flags
}

Notification Field Descriptions:

• type - FormulaOneNotif style (drapeau_vert, drapeau_jaune, drapeau_rouge, sanction, info)

• title - Large heading in notification

• message - Main body text (HTML supported: <br> for line breaks)

• penalty - Additional rule/penalty text

• duration - Display time in milliseconds

• esxNotif - Fallback ESX notification (if FormulaOneNotif unavailable)

Race Car Settings

Configure which vehicles receive race notifications:

Config.raceCar = {
    model = 'cw2020',      -- F1 vehicle model name
    checkVehicle = true    -- Only send notifications to players in this vehicle
}

Options:

• checkVehicle = true - Only F1 drivers get flags (realistic)

• checkVehicle = false - Everyone gets notifications (spectators included)

Tablet Settings

Customize tablet prop and animation:

Config.tablet = {
    model = 'prop_cs_tablet',
    animation = { 
        dict = 'amb@world_human_seat_wall_tablet@female@base', 
        name = 'base' 
    },
    attach = {
        bone = 28422,
        pos = { x = 0.03, y = 0.00, z = -0.03 },
        rot = { x = 10.0, y = 160.0, z = 0.0 }
    },
    blockControls = true  -- Disable movement while tablet is open
}

Customization:

• Change model to use different prop

• Adjust attach position/rotation for better hand placement

• Set blockControls = false to allow movement with tablet

Marker Positions

Configure interaction points for tablet and starting lights:

Config.markers = {
    enabled = true,
    drawText = true,  -- Show 3D text prompt
    list = {
        -- Tablet Marker
        { 
            x = 4354.377930, 
            y = 7996.259278, 
            z = 100.279174, 
            radius = 3.0, 
            draw = true, 
            type = 'tablet', 
            text = 'Press ~r~E~s~ to open the Race Control Tablet' 
        },
        -- Starting Lights Marker
        { 
            x = 4210.971192, 
            y = 8037.428710, 
            z = 96.235108, 
            radius = 3.0, 
            draw = true, 
            type = 'startlights', 
            text = 'Press ~r~E~s~ to start the race sequence' 
        }
    },
    style = {
        type = 6,
        scale = 0.5,
        color = { 255, 0, 0, 255 },  -- RGBA
        prompt = 'Press ~r~E~s~ to open Tablet'
    }
}

Adding More Markers:

{
    x = 100.0, y = 200.0, z = 30.0,
    radius = 3.0,
    draw = true,
    type = 'tablet',
    text = 'Press ~r~E~s~ to access Race Control'
}

Access Method

Choose how players interact with tablet:

Config.accessMethod = 'marker'  -- Options: 'marker', 'ox_target', 'both'

• 'marker' - Use 3D markers (default)

• 'ox_target' - Use ox_target (requires ox_target resource)

• 'both' - Enable both methods

Flag Positions

IMPORTANT: Configure physical flag spawn locations around your track.

Config.flagPositions = {
    all = {  -- Global yellow/red flags (all positions)
        {x = 4338.479, y = 7963.343, z = 93.598, h = 53.0},
        {x = 4001.04, y = 8153.288, z = 104.307, h = 53.0},
        // ... add more positions
    },
    stand = {  -- Starting line lights
        {x = 4063.389, y = 8122.787, z = 97.631, h = 61.0}, -- green
        {x = 4063.389, y = 8122.787, z = 98.291, h = 61.0}, -- red
    },
    s1 = {  -- Sector 1 yellow flags
        {x = 4338.479, y = 7963.343, z = 93.598, h = 53.0},
        {x = 4001.04, y = 8153.288, z = 104.307, h = 53.0},
        // ... sector 1 positions
    },
    s2 = {  -- Sector 2 yellow flags
        {x = 5869.807, y = 7009.258, z = 154.090, h = 214.0},
        // ... sector 2 positions
    },
    s3 = {  -- Sector 3 yellow flags
        {x = 4742.303, y = 6842.306, z = 58.573, h = 338.0},
        // ... sector 3 positions
    }
}

How to Set Flag Positions:

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

2. Walk the Track: Place markers at strategic locations

3. Coverage: Ensure flags are visible from track

4. Heading: Set h so flags face the correct direction

5. Height: Adjust z coordinate for proper elevation

Recommended Placement:

• Every major turn

• Start/finish straight

• Dangerous zones

• Every 100-200 meters for complete coverage

• 15-20 flags per sector is typical