A comprehensive list of Track Data for Sim Racing games.
File Format v1.0.0 Beta
Fetch the data by retrieving the url:
/data/{simId}/{trackId}.json
{simId}is the lowercase Simhub game idDataCorePlugin.CurrentGame{trackId}is the lowercase Simhub track idDataCorePlugin.TrackId
Every file is formatted as follows:
# name (String) - The full human readable track name
# country (String) - (OPTIONAL) The track's country code (ISO 3166 Alpha 2)
# year (Int) - (OPTIONAL) The track's active year
# length (Int) - (OPTIONAL) Length of the track in meters
# pitentry (Int) - (OPTIONAL) The percentage point of the pit entry
# pitexit (Int) - (OPTIONAL) The percentage point of the pit exit
# turn - An array of all the Turn data
# name (String) - Turn Name
# marker (Int) - The percentage point of the Apex
# scale (Int) - (OPTIONAL) 1-6: Turn (Hairpin > Wide)
# direction (Int) - (OPTIONAL) 0: Left, 1: Right
# start (Int) - (OPTIONAL) The percentage point of turn start
# end (Int) - (OPTIONAL) The percentage point of turn end
# extra - (OPTIONAL) An array of properties
# keys (Mixed) - Key:Value
# straight - (OPTIONAL) An array of all the Straight data
# name (String) - Straight Name
# start (Int) - The percentage point of straight start
# end (Int) - The percentage point of straight end
# extra - (OPTIONAL) An array of properties
# keys (Mixed) - Key:Value
# sector - An array of all the Sector data
# name (String) - Sector Name
# marker (Int) - The percentage point of the Sector
# extra - (OPTIONAL) An array of properties
# keys (Mixed) - Key:Value
# time - (OPTIONAL) An array of estimated time delays
# class (String) - The car class (sim dependant)
# name (String) - Name of the time delay
# time (Int) - Time delay in seconds
# companion - (OPTIONAL) Optimal display of the Track Map on the Lovely Dashboard Companion
# top (Int) - Distance to top
# left (Int) - Distance to left
# rotation (Int) - Rotation
# scale (Int) - Auto Size Scale
# extra - (OPTIONAL) An array of properties
# keys (Mixed) - Key:Value
{
"name": "Silverstone",
"turn": [
{ "name": "T1", "marker": 0.042 },
{ "name": "T2", "marker": 0.133 },
{ "name": "T3", "marker": 0.151 },
{ "name": "T4", "marker": 0.176 },
{ "name": "T5", "marker": 0.201 },
{ "name": "T6", "marker": 0.229 },
{ "name": "T7", "marker": 0.377 },
{ "name": "T8", "marker": 0.432 },
{ "name": "T9", "marker": 0.469 },
{ "name": "T10", "marker": 0.499 },
{ "name": "T11", "marker": 0.594 },
{ "name": "T12", "marker": 0.628 },
{ "name": "T13", "marker": 0.672 },
{ "name": "T14", "marker": 0.696 },
{ "name": "T15", "marker": 0.731 },
{ "name": "T16", "marker": 0.858 },
{ "name": "T17", "marker": 0.887 },
{ "name": "T18", "marker": 0.949}
],
"sector": [
{ "name": "1", "marker": 0.32 },
{ "name": "2", "marker": 0.709 },
{ "name": "3", "marker": 1 }
],
"time": [{
"gt3": [
{ "name": "sg30", "time": 72 },
{ "name": "dt", "time": 37 }
]}
]
}
{
"name": "Silverstone",
"country": "GB",
"length": 5890,
"year": 2022,
"pitentry": 0.970,
"pitexit": 0.029,
"turn": [
{ "name": "Copse", "marker": 0.042, "scale": 4, "direction": 1, "start": 0.024, "end": 0.045 },
{ "name": "Maggots", "marker": 0.133, "scale": 5, "direction": 0, "start": 0.115, "end": 0.145 },
{ "name": "Maggots", "marker": 0.151, "scale": 3, "direction": 1, "start": 0.145, "end": 0.161 },
{ "name": "Becketts", "marker": 0.176, "scale": 3, "direction": 0, "start": 0.161, "end": 0.185 },
{ "name": "Becketts", "marker": 0.201, "scale": 3, "direction": 1, "start": 0.185, "end": 0.210 },
{ "name": "Chapel", "marker": 0.229, "scale": 5, "direction": 0, "start": 0.210, "end": 0.238 },
{ "name": "Stowe", "marker": 0.377, "scale": 4, "direction": 1, "start": 0.350, "end": 0.385 },
{ "name": "Vale", "marker": 0.432, "scale": 1, "direction": 0, "start": 0.400, "end": 0.440 },
{ "name": "Club", "marker": 0.469, "scale": 3, "direction": 1, "start": 0.445, "end": 0.500 },
{ "name": "T10", "marker": 0.499, "scale": 5, "direction": 1 },
{ "name": "Abbey", "marker": 0.594, "scale": 4, "direction": 1, "start": 0.570, "end": 0.595 },
{ "name": "Farm", "marker": 0.628, "scale": 6, "direction": 0, "start": 0.610, "end": 0.635 },
{ "name": "Village", "marker": 0.672, "scale": 1, "direction": 1, "start": 0.650, "end": 0.680 },
{ "name": "Loop", "marker": 0.696, "scale": 1, "direction": 0, "start": 0.680, "end": 0.705 },
{ "name": "Aintree", "marker": 0.731, "scale": 2, "direction": 0, "start": 0.717, "end": 0.738 },
{ "name": "Brooklands", "marker": 0.858, "scale": 2, "direction": 0, "start": 0.825, "end": 0.865 },
{ "name": "Luffield", "marker": 0.887, "scale": 1, "direction": 1, "start": 0.870, "end": 0.910 },
{ "name": "Woodcote", "marker": 0.949, "scale": 6, "direction": 1, "start": 0.930, "end": 0.960 }
],
"straight": [
{ "name": "Hangar Straight","start": 0.235, "end": 0.355 },
{ "name": "Hamilton Straight", "start": 0.515, "end": 0.560},
{ "name": "Wellington Straight", "start": 0.760, "end": 0.810}
],
"sector": [
{ "name": "1", "marker": 0.320 },
{ "name": "2", "marker": 0.709 },
{ "name": "3", "marker": 1 }
],
"time": [{
"gt3": [
{ "name": "sg30", "time": 72 },
{ "name": "dt", "time": 37 }
]}
],
"companion": [{
"top": -140,
"left": -270,
"rotation": -95,
"scale": 1.7
}]
}
{
"name": "Silverstone",
"country": "GB",
"length": 5890,
"year": 2022,
"turn": [
{ "name": "Copse", "marker": 0.042, "scale": 4, "direction": 1, "start": 0.024, "end": 0.045 },
{ "name": "Maggots", "marker": 0.133, "scale": 5, "direction": 0, "start": 0.115, "end": 0.145 },
{ "name": "Maggots", "marker": 0.151, "scale": 3, "direction": 1, "start": 0.145, "end": 0.161 },
{ "name": "Becketts", "marker": 0.176, "scale": 3, "direction": 0, "start": 0.161, "end": 0.185 },
{ "name": "Becketts", "marker": 0.201, "scale": 3, "direction": 1, "start": 0.185, "end": 0.210 },
{ "name": "Chapel", "marker": 0.229, "scale": 5, "direction": 0, "start": 0.210, "end": 0.238 },
{ "name": "Stowe", "marker": 0.377, "scale": 4, "direction": 1, "start": 0.350, "end": 0.385 },
{ "name": "Vale", "marker": 0.432, "scale": 1, "direction": 0, "start": 0.400, "end": 0.440 },
{ "name": "Club", "marker": 0.469, "scale": 3, "direction": 1, "start": 0.445, "end": 0.500 },
{ "name": "T10", "marker": 0.499, "scale": 5, "direction": 1 },
{ "name": "Abbey", "marker": 0.594, "scale": 4, "direction": 1, "start": 0.570, "end": 0.595 },
{ "name": "Farm", "marker": 0.628, "scale": 6, "direction": 0, "start": 0.610, "end": 0.635 },
{ "name": "Village", "marker": 0.672, "scale": 1, "direction": 1, "start": 0.650, "end": 0.680 },
{ "name": "Loop", "marker": 0.696, "scale": 1, "direction": 0, "start": 0.680, "end": 0.705 },
{ "name": "Aintree", "marker": 0.731, "scale": 2, "direction": 0, "start": 0.717, "end": 0.738 },
{ "name": "Brooklands", "marker": 0.858, "scale": 2, "direction": 0, "start": 0.825, "end": 0.865 },
{ "name": "Luffield", "marker": 0.887, "scale": 1, "direction": 1, "start": 0.870, "end": 0.910 },
{ "name": "Woodcote", "marker": 0.949, "scale": 6, "direction": 1, "start": 0.930, "end": 0.960 }
],
"straight": [
{ "name": "Hangar Straight", "start": 0.235, "end": 0.355 },
{ "name": "Hamilton Straight", "start": 0.515, "end": 0.560},
{ "name": "Wellington Straight", "start": 0.760, "end": 0.810}
],
"sector": [
{ "name": "1", "marker": 0.320 },
{ "name": "2", "marker": 0.709 },
{ "name": "3", "marker": 1 }
],
"time": [{
"gt3": [
{ "name": "sg30", "time": 72 },
{ "name": "dt", "time": 37 }
]}
],
"extra": {
"israinpossible": 1,
"reversetrackid": -1,
"coordinatebox_x": 330.51,
"coordinatebox_y": -27.919,
"coordinatebox_z": 313.279,
"coordinateboxexit_x": 115.89,
"coordinateboxexit_y": -11.299,
"coordinateboxexit_z": 351.091,
"startlineunitvector_x": -0.9652885098,
"startlineunitvector_y": -0.2611859353
}
}
To maintain properly formatted files, I've implemented - and require - a pre-commit script, that will prettify the JSON files and thus properly track changes to them.
Before you can run hooks, you need to have the pre-commit package manager installed. You can do so by following the instructions on the official pre-commit website, or just install it using the following command:
brew install pre-commit
Homebrew not your thing? Read more on the official pre-commit website.
Once installed, run pre-commit install to set up the git hook scripts
pre-commit install
You're all set as far as tooling is concerned. Every time you make a commit, the pre-commit script will make sure the files are properly formatted and are prettified.
It's usually a good idea to run the hooks against all of the files when adding new hooks (usually pre-commit will only run on the changed files during git hooks). Running pre-commit run --all-files will have a pass at everythig, and if all is well, you should see somthing like the below.
$ pre-commit run --all-files
check json...............................................................Passed
pretty format json.......................................................Passed
Corner and Straights names are from Racing Circuits. Big thanks to Nicolas of Simhub and Joerg Behrens for sharing feedback on the File Format.