Commands
In the examples below, square brackets indicate required options and round brackets indicate optional options.
For commands that accept a season override, the value should follow the format YYs# (for example, 24s1 for 2024 Season 1). Unless provided, the bot defaults to the current season.
Standard Commands
/balance [series] (lap_type) (season) (week) (division) (irating_min) (irating_max) (flair) (table)
Returns information regarding the balance of performance for a series/class. Defaults to average race laps.
series(required string, autocomplete): Select the series.lap_type(choice): Pickrace_average,race, orqualify.season(optional string, autocomplete): Override the season.week(optional integer): Limit output to a single race week.division(optional integer): Filter to a specific division.irating_min(optional integer): Minimum iRating filter (1000-6000).irating_max(optional integer): Maximum iRating filter (1000-6000).flair(optional string, autocomplete): Filter by driver flair/country.table(choice): Choosefastestormediantable data.
/championship [series] (season) (week) (highlight) (division) (irating_min) (irating_max) (flair)
Returns a table of the top 30 drivers for a series.
series(required string, autocomplete)season(optional string, autocomplete)week(optional integer)highlight(optional string): Provide double quoted driver names to highlight.division(optional integer)irating_min(optional integer): Minimum iRating filter (1000-6000).irating_max(optional integer): Maximum iRating filter (1000-6000).flair(optional string, autocomplete): Filter by driver flair/country.
/driver [name] (category) (series) (season) (week)
Returns driver statistics for the current season, automatically selecting the category with the most races if not provided.
name(required string)category(optional string, autocomplete)series(optional string, autocomplete)season(optional string, autocomplete)week(optional integer)
/laps qualifying [series] (season) (car_model) (week) (division) (highlight) (chart_type) (irating_min) (irating_max) (flair) (hide_team)
Shows qualifying lap statistics, table, and chart for a series/class.
series(required string, autocomplete)season(optional string, autocomplete)car_model(optional string, autocomplete): Filter multimake series by car.week(optional integer)division(optional integer)highlight(optional string): Double quoted driver names to emphasise.chart_type(choice):boxplotorscatter.irating_min(optional integer): Minimum iRating filter (1000-6000).irating_max(optional integer): Maximum iRating filter (1000-6000).flair(optional string, autocomplete): Filter by driver flair/country.hide_team(optional boolean): Exclude team drivers.
/laps race_average [series] (season) (car_model) (week) (division) (highlight) (chart_type) (irating_min) (irating_max) (flair) (hide_team)
Shows average race lap statistics for the selected series/class.
- Options match
/laps qualifying.
/laps race_fastest [series] (season) (car_model) (week) (division) (highlight) (chart_type) (irating_min) (irating_max) (flair) (hide_team)
Shows fastest race lap statistics for the selected series/class.
- Options match
/laps qualifying.
/officials [series] (season) (week) (time_offset)
Displays a heatmap showing how often official sessions ran for a series.
series(required string, autocomplete)season(optional string, autocomplete)week(optional integer)time_offset(optional integer): Time zone offset from GMT (in hours).
/participation [series] (car_class) (season) (week) (time_offset)
Provides a heatmap of race participation for a series.
series(required string, autocomplete)car_class(optional string, autocomplete): Specify a class for multiclass series.season(optional string, autocomplete)week(optional integer)time_offset(optional integer)
/popularity [category] (season) (week)
Ranks series by unique drivers for the selected category.
category(required string, autocomplete)season(optional string, autocomplete)week(optional integer)
/previous_race [name] (series) (season) (week) (races_ago)
Returns details for the driver’s most recent race, or an earlier race when
races_agois supplied.
name(required string)series(optional string, autocomplete)season(optional string, autocomplete)week(optional integer)races_ago(optional integer)
/previous_races [name] (series) (category) (season) (week)
Lists the driver’s last 10 races.
name(required string)series(optional string, autocomplete)category(optional string, autocomplete)season(optional string, autocomplete)week(optional integer)
/schedule [series] (season)
Displays the track schedule for a series.
series(required string, autocomplete)season(optional string, autocomplete)
/strengthoffield [series] (car_class) (season) (week) (time_offset)
Produces a heatmap of top split strength of field for a series.
series(required string, autocomplete)car_class(optional string, autocomplete)season(optional string, autocomplete)week(optional integer)time_offset(optional integer)
/subscribe
Link your Patreon subscription to the current server.
/awards [series] (season) (week) (division) (irating_min) (irating_max)
Returns racing awards for drivers in a series (most poles, overtakes, etc.).
series(required string, autocomplete)season(optional string, autocomplete)week(optional integer)division(optional integer)irating_min(optional integer): Minimum iRating filter (1000-6000).irating_max(optional integer): Maximum iRating filter (1000-6000).
Utility Subcommands
Each conversion is available under /convert with the following subcommands (all require a single integer input):
/convert celsius_to_fahrenheit [celsius]/convert fahrenheit_to_celsius [fahrenheit]/convert gallons_to_litres [gallons]/convert litres_to_gallons [litres]/convert kph_to_mph [kph]/convert mph_to_kph [mph]
Team Admin Commands
These commands require bot team administrator permissions on the server.
/manage_team add [name] [hex_color] (discord_user)
Add a driver to the team and optionally link their Discord username.
/manage_team remove [name]
Remove a driver from the team.
/manage_team update [name] (hex_color) (discord_user)
Update the driver’s highlight colour or linked Discord user.
/manage_team announcements_exclude
Manage announcement exclusion list for team drivers (interactive UI).
Subscriber Commands
The commands below require an active subscription (Patreon) linked to the server.
/irating_changes [series] (season) (week) (highlight) (irating_min)
Shows weekly iRating changes for team drivers in the selected series.
series(required string, autocomplete)season(optional string, autocomplete)week(optional integer)highlight(optional string): Double quoted driver names to emphasise.irating_min(optional integer): Minimum iRating filter (1000-6000).
/points [series] (season) (week) (highlight) (division) (irating_min) (irating_max)
Returns the championship points breakdown for team drivers.
series(required string, autocomplete)season(optional string, autocomplete)week(optional integer)highlight(optional string)division(optional integer)irating_min(optional integer): Minimum iRating filter (1000-6000).irating_max(optional integer): Maximum iRating filter (1000-6000).
/team colors (sort_by)
Lists configured hex colours for each driver.
sort_by(choice):nameorcolor.
/team discord_mappings
Lists the Discord usernames linked to team drivers.
/team divisions [category] (season)
Lists team driver divisions for a category.
category(required string, autocomplete)season(optional string, autocomplete)
/team inactive (series) (season) (week) (division) (irating_min)
Highlights team drivers without recent activity.
series(optional string, autocomplete)season(optional string, autocomplete)week(optional integer)division(optional integer)irating_min(optional integer): Minimum iRating filter (1000-6000).
/team quick_stats (category) (series) (season) (week) (division) (irating_min) (irating_max) (sort_by) (hide_inactive)
Provides snapshot statistics for team drivers.
category(optional string, autocomplete)series(optional string, autocomplete)season(optional string, autocomplete)week(optional integer)division(optional integer)irating_min(optional integer): Minimum iRating filter (1000-6000).irating_max(optional integer): Maximum iRating filter (1000-6000).sort_by(choice):races,name,ir_change,irating.hide_inactive(choice):yes(hide) orno(include).
/unsubscribe
Remove your Patreon subscription from the server.
/week [series] (season) (week) (highlight) (division) (irating_min)
Summarises weekly race counts and points for team drivers in the series.
series(required string, autocomplete)season(optional string, autocomplete)week(optional integer)highlight(optional string)division(optional integer)irating_min(optional integer): Minimum iRating filter (1000-6000).
League Commands
Note: All league commands require an active subscription and league tracking configured via /setup leagues.
/league driver [name] (league) (category)
Display driver statistics filtered to league races only.
name(required string, autocomplete): Driver name.league(optional string, autocomplete): League (defaults to oldest configured).category(optional choice): License category.
/league previous_race (league) (name) (category) (races_ago)
Display details from most recent league race.
league(optional string, autocomplete)name(optional string, autocomplete): Driver name (shows all if omitted).category(optional choice)races_ago(optional integer 1-50): How many races back.
/league previous_races (league)
Display recent league races (up to 10 races in batches of 5).
league(optional string, autocomplete)
/league championship (league) (car_class) (season)
Display championship standings for a league season.
league(optional string, autocomplete)car_class(optional string): Filter by car class (multi-class leagues).season(optional string): Season name.
/league compare [driver1] [driver2] (league) (season)
Compare two drivers head-to-head within a league.
driver1(required string, autocomplete): First driver name.driver2(required string, autocomplete): Second driver name.league(optional string, autocomplete)season(optional string): Defaults to all-time.
/league track_stats [track] (league) (car_class) (season)
Display performance statistics for a track within a league.
track(required string, autocomplete): Track name.league(optional string, autocomplete)car_class(optional string, autocomplete)season(optional string): Defaults to all-time.
/league info (league)
Display information and statistics about a league.
league(optional string, autocomplete)
/league seasons (league)
Set the default season for league commands (admin only).
league(optional string, autocomplete)
/league awards (league)
Display league awards and superlatives.
league(optional string, autocomplete)
Setup Commands
Note: All setup commands require admin rights and an active subscription.
/setup admin_role [discord_role]
Assign a Discord role that grants admin access to bot commands.
discord_role(required string): @mention the Discord role.
/setup results_announcer [announcer_enabled] (announcer_channel) (series) (announce_ir_gain_only) (announce_podium_only)
Enable or disable race result announcements.
announcer_enabled(required boolean): Enable announcements?announcer_channel(optional channel): Channel for announcements.series(optional string, autocomplete): Map specific series to channel.announce_ir_gain_only(optional boolean): Only positive iRating changes.announce_podium_only(optional boolean): Only podium finishes.
Note: With series specified, maps that series to the channel. Without series, updates the guild-wide default announcement channel.
/setup force_channel (channel)
Restrict bot usage to a specific channel or allow all channels.
channel(optional channel): Channel to restrict to (omit for interactive flow).
/setup leagues
Manage league tracking for this server (interactive UI).
/setup hide_flags
Hide country/region flags in driver row outputs (interactive buttons).
/setup show_license_letter
Show license letter (A/B/C/D/R) in iRating badge for colorblind accessibility (interactive buttons).
/setup mention_race_announcements
@mention Discord users in race announcements for tracked drivers (interactive buttons).
/setup view_series_channels
View which series are configured to announce in which channels.
/setup add_series_channel [series] (channel)
Map a specific series to announce in a specific channel.
series(required string, autocomplete): Series to map.channel(optional channel): Defaults to current channel.
/setup remove_series_channel [series]
Remove a series-to-channel mapping (series will use default channel).
series(required string, autocomplete): Series to remove from mapping.
/setup default_results_channel [channel]
Set the default channel for race announcements (for series without specific mappings).
channel(required channel): Default announcement channel.