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): Pick race_average, race, or qualify.
  • 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): Choose fastest or median table data.
/balance command table view /balance command box plot view

/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.
/championship standings table /championship standings scatter chart

/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)
/driver overview summary /driver iRating trend chart /driver corners per incident chart

/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): boxplot or scatter.
  • 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 qualifying leaderboard /laps qualifying chart

/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).
/officials heatmap

/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)
/participation heatmap

/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_ago is supplied.

  • name (required string)
  • series (optional string, autocomplete)
  • season (optional string, autocomplete)
  • week (optional integer)
  • races_ago (optional integer)
/previous_race series summary card /previous_race results table

/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)
/schedule track list

/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)
/strengthoffield heatmap

/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).
/points table

/team colors (sort_by)

Lists configured hex colours for each driver.

  • sort_by (choice): name or color.

/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) or no (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).
/week summary table

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.