irstats discord bot

The bot guide.

Setup in two minutes, every command explained. This reference is generated from the bot's live command set, so it is always current.

Add to Discord What is this bot?

Setup

From install to first result

1 · Add the bot

Click Add to Discord and pick your server (you need the Manage Server permission there). The bot asks only for what it uses: viewing channels, sending messages, embeds, attachments and threads.

2 · Pick a channel

Type /setup channel #race-results (Manage Server only). That is where race digests post. Skip this and the bot stays quiet until you choose one.

3 · Members /track

Each member types /track and signs in with their iRacing account once, straight from the private link the bot replies with. From then on their official races post automatically.

Command reference

Getting started

Work in any server the moment the bot joins. No league, no website account needed up front.

/track
Link your iRacing account and get your race results posted in this server
/untrack
Stop posting your race results in this server
/community
This server's live leaderboard page on irstats
/setup
Configure the bot for this server (Manage Server only)
channel channel the announcements channel

Command reference

Stats lookups

Ask about any driver or series on iRacing, from any server. Replies link into full irstats pages.

/driver name
Any iRacing driver's career stats
name driver name or iracing customer id
/compare driver1 driver2?
Head-to-head two drivers: iRating, wins, form
driver1 first driver name or customer id driver2 second driver (leave empty to compare against yourself) (optional)
/wrapped driver?
Drop a Season Wrapped in the channel (yours, or any driver's)
driver driver name (leave empty for your own — needs /track) (optional)
/series name
An official iRacing series at a glance: track, license, schedule
name series name (or part of it)
/thisweek category?
This week's track for every official iRacing series
category discipline (sports car, formula car, oval, ...) (optional)
/pulse
The last 24 hours on iRacing, in numbers

Command reference

League commands

These need the server linked to an irstats league site (done by a league admin from their Manage page).

/standings championship? class?
Your league's current championship standings
championship which championship (when your league runs more than one) (optional) class narrow to one car class (optional)
/lastrace
Your league's most recent counting race: winners and standings impact
/nextrace
Where and when your league races next
/schedule
Your league's season calendar
/points driver
One driver's week-by-week championship points
driver driver name (or part of it)
/champions
Your league's honor roll: past season champions
/records
Your league's all-time records

How it behaves

What posts, when

Race digests

Official races only. Results arrive as one grouped digest within the hour of the checkered flag: class position, series, track, linked to the full result. Each race posts once, ever. Only races from the last two days are eligible, so a new member's history never floods the channel.

Your community page

Every digest links your server's own public page: a season leaderboard of tracked members plus their recent results. Share it anywhere; it updates itself.

Privacy

/track uses iRacing's own sign-in; the bot never sees passwords. Public posts follow irstats privacy rules: EU/EEA and UK drivers show abbreviated unless they opted into a public profile. /untrack stops your results immediately.

Limits and removal

Up to 50 tracked drivers per server, free. Removing the bot from the server stops everything, and the server's tracking list is deleted with it. Running a league? Linking your league site unlocks the league commands above.

Two minutes to set up.

Add to Discord

stuck? talk to us · more guides in the help center