Troubleshooting

UI Not Appearing

Problem: Chronometer doesn't show when entering F1 car

Solutions:

• Verify car model name in config.lua matches exactly

• Check that you're in the driver seat (not passenger)

• Ensure resource is started: ensure f1_chrono

• Check F8 console for errors

• Verify ui/build/ folder contains all files

Invalid Laps Always

Problem: All laps marked as invalid

Solutions:

• Ensure all checkpoints are reachable on racing line

• Check checkpoint radii are large enough

• Verify you're passing through checkpoints in order

• Review checkpoint positions (might be off-track)

• Check F8 console for checkpoint detection

Lap Not Triggering

Problem: Crossing finish line doesn't register

Solutions:

• Verify start checkpoint is type "start"

• Check width, length, and heading are correct

• Increase start line width or length

• Ensure MIN_LAP_TIME isn't too high

• Test with debug prints in code

Missing Sector Times

Problem: Sector times not recording

Solutions:

• Confirm you have exactly 2 checkpoints with type = "sector"

• Verify sector checkpoints are in correct positions

• Ensure you're passing through them

• Check that sectors divide track properly

Checkpoints Not Detecting

Problem: Driving through checkpoints but not registering

Solutions:

• Increase radius values (try 20.0-25.0)

• Verify coordinates are accurate

• Check that vehicle model matches config

• Ensure you're driving, not teleporting

• Test at different speeds