Usage Guide

Automatic Activation

The chronometer automatically appears when:

  1. Player enters an F1 vehicle (matching Config.CarModelName)

  2. Player is in the driver's seat

The UI automatically hides when:

  1. Player exits the F1 vehicle

  2. Player switches to passenger seat

  3. All timing data is preserved between sessions

Manual Toggle

Players can manually hide/show the UI:

  • Method: Triggered via NUI callback qualificationChrono

  • Default: No keybind (can be added via custom implementation)

Reading the UI

The chronometer displays:

Current Lap Information:

  • Current Lap Time - Live timer for ongoing lap

  • Sector Times - Time for each completed sector in current lap

Best Performance:

  • Last Lap Time - Time of most recently completed lap

    • Green indicator = Valid lap

    • Red indicator = Invalid lap (missed checkpoints)

  • Best Lap Time - Fastest valid lap time achieved

  • Best Sector Times - Fastest time achieved in each sector

  • Theoretical Best - Sum of all best sector times

UI Positioning:

  • First-Person View: UI positioned in upper area

  • Third-Person View: UI repositions to avoid obstruction

  • Automatically adapts when changing camera

Valid vs Invalid Laps

Valid Lap Requirements:

  1. Cross start/finish line to begin lap

  2. Pass through ALL checkpoints marked as bet or sector

  3. Complete lap in order

  4. Cross start/finish line again

  5. Lap time must exceed MIN_LAP_TIME

Invalid Lap Indicators:

  • Red marker on "Last Lap" display

  • Lap time is recorded but NOT counted for "Best Lap"

  • Sector times still recorded for best sector tracking

PreviousConfigurationNextAdvanced Configuration

Last updated