Command Usage and Examples
All commands are implemented as Discord slash commands. Once the commands have synced with your Guild, they can be accessed with /command-name.
Some commands take parameters to refine the results, such as to filter to a specific driver. All year and round parameters are optional and if not specified will default to the most recent race. Commands which include lap data will not work for seasons before 2018.
-
round: This can be the location, Grand Prix name or the round number in the season. A partial name will attempt to search for a matching event. E.g. "Silverstone", "British".🔧 Try to be specific to prevent false matches; using the shorthand name "Spa" instead of "Spa-Francorchamps" will return a match for "Spain", so it's better to use the country name "Belgium" instead.
-
driver: Can be the driver surname, 3-letter abbreviation or number. -
session: Choose an option from the Discord menu. For Sprint Weekends before 2023, "Sprint Shootout" is the equivalent of "Sprint Qualifying". -
lap: Lap number; omit this option to use fastest lap instead.
E.g.
/results - defaults to latest race results
/results 2023 Spain Qualifying - specify all parameters
/results FP1 - year and round default to latest
Data is sourced from Ergast API and official F1 timing data (through FastF1) and is typically updated within a few hours of a session.
Ergast considers the "last" round to be the last complete race weekend. Therefore, when using commands with the default round in the middle of a race weekend - e.g. to view qualifying results on a Saturday - the results will refer to the previous round. However, you can still specify the name or number of the round in question to get results for the current race weekend if they are available.
Championship and event schedule related commands.
View Driver Championship standings.
View Constructors Championship standings.
View all drivers and teams participating in the season.
Get the current season calendar from F1Calendar.
Info and countdown to the next race weekend.
Driver information and bio including total wins, poles, championships, teams driven, years active.
Driver and session data.
View results classification for the session. Defaults to latest race results with no parameters.
View pitstop data. By default this shows the fastest pitstop for each driver. Results can be refined by specifying a driver and/or filter. Data unavailable for seasons before 2018.
Filters:
- Ranked (default): Each driver's fastest stop, sorted by duration
- Best: Show only the fastest stop of the race or from the specified driver's stops
- Worst: As above, but for the slowest stop.
View the fastest lap times for each driver in the race. Based on valid PB laps for each driver. Only seasons >=2018.
Select a tyre from the available choices to get the fastest laps on a specific compound.
View the fastest sector times and speed trap for each driver. Based on valid quick laps. Optionally filter by tyre compound using the menu selection if there is data available.
Only season >= 2018.
View race tyre stints and laps driven. Optionally refine results to a specific driver.
Only seasons >=2018.
Commands in this group are prefixed by /plot <command> and will output a Discord image file.
🔧 Telemetry data may take some time to process if results have not been cached.
Show a line plot of driver position changes during the race.
Show the tyre stints for each driver as a stacked bar chart.
Compare the delta of each driver's fastest lap as a bar chart.
A circuit outline mapped to the driver speed over the lap. Driver is required.
Compare minisector times between two drivers plotted on track.
Use the lap option to filter to a specific lap, or leave omitted to use the fastest lap (default).
View telemetry graphs for Speed, Throttle, Brake, Gears, RPM and DRS for up to 2 drivers.
Use the lap option to filter to a specific lap, or leave omitted to use the fastest lap (default).
At least 1 driver is required.
Show the number of positions gained or lost per driver during the race.
View a pie chart showing distribution of tyre compounds in the session.
Plot the lap time difference between two drivers accross all laps, excluding pitstops and slow laps.
Both first and second must be provided as a driver surname, code or number.
Plot the driver1 delta to driver2 over a single lap in the session.
Use the lap option to filter to a specific lap, or leave omitted to use the fastest lap (default).
View lap time difference for each driver to the overall session average time.
Plot a violin plot and swarm plot showing the distributions of lap times and tyre compound.
View a line graph comparing the average performance of each tyre compound over the life of the tyre.
Data is based on quick laps with a threshold of 105%. This means that some compounds may not appear on the graph even if they were used in the race because the times were too slow. Additionally, track conditions, incidents and weather will influence the accuracy of the tyre life metrics.
Bot status information including API connection health and latency.
Admin-restricted.
Temporarily bypass the bot cache for X minutes (default 5). This should rarely be neccessary, the cache is configured such that frequently changing data is refreshed more often. The cache will be automatically re-enabled after the timeout.
Owner-restricted. Shuts down the bot.