Race Timer

Also referred to as Lap Timer. This is a ScriptHookVDotNet script for GTA5.

Test your car's performance any way you want with Race Timer. Set your own checkpoints (in Placement Mode), and take any car through the race you created.

As you drive, Race Timer shows you at each checkpoint:

Installation

Extract LapTimer.dll, LapTimer.ini, and LapTimer folder into your scripts folder.
If you have already installed an earlier version of the script, make sure to merge the LapTimer folder to preserve your old races and timing sheets.

Requirements

Usage

The menu has all the controls you need to use all features of this script.

Placement Mode

In this mode, you will create your custom race by placing checkpoints. Enter "Placement Mode" with F5.

Race Mode

Once you've placed at least 2 checkpoints, get in a vehicle and press F6. You will be teleported to the first checkpoint, and the timer will start. Times will be displayed at each checkpoint and at the end of the race.

Circuit vs point-to-point

In v3, support for circuit races were implemented. Whereas all races in earlier versions ended when you reached the last checkpoint, if "Lap Mode" checkbox is checked, you will begin a new lap when you reach the last checkpoint. Some preset races, including Prison Loop, Grove Street, Spa Franchorchamps, Redwood Lights, and Broughy1322's famous test track have been updated to run in Lap Mode!

Similar to qualifying in motorsports like F1, when racing in Lap Mode, your first lap is an "out lap", and subsequent laps are "flying laps". As before, your timing sheet is exported when you complete a lap.

Menu > Race Controls > Lap Mode

Colors for elapsed time

Import/Export races

You can export races you've created to replay in another session (or share them with other users). Select Menu > Export Race, and give your race a descriptive name. The race will be saved as a .json file in your scripts/LapTimer directory.

To import races, select Menu > Race Import Menu in the menu. A list of importable races will show up. To import races created by other users, place their race .json file in your scripts/LapTimer directory. This script comes with a number of races already created.

Timing sheets

You can view your lap times for the current race in Menu > Lap Times

When you complete a race, your time is automatically saved and exported in a file. Times are saved on a per-vehicle basis, and are recorded for each checkpoint in the race.

Your race's timing sheet is automatically imported when you import a race, as long as you haven't modified it! If you modify the race (i.e. adding or deleting checkpoints), your previously recorded lap times will be invalidated.

Development

Change Log

3.1.1

3.1

3.0.1

3.0

2.2.1

2.2:

2.1:

2.0.2:

2.0.1:

2.0

1.2

1.1

1.0