# 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
