irstats help / Discord bot

Community pages

The live leaderboard page every Discord community gets: what is on it, how members join it, and what posts back to the server.

All guides

Every Discord server using the bot gets a public community page: a live season leaderboard of its tracked members plus a feed of their recent results. It updates itself within the hour of every official race and needs zero setup: the page exists as soon as the bot is in the server.

What is on the page

  • Season leaderboard: every tracked member, ranked over the current iRacing season, with starts, wins, podiums, best class finish, incidents per race, and iRating movement where rating data exists. Names link to full driver profiles.
  • Recent results: the last two weeks of tracked members' races, each line linking to the complete race result.

Positions shown are in class. The season resets with each official iRacing season.

Finding your page

  • Type /community in your server; the bot replies with the link.
  • Every race digest and weekly recap in your channel links it.
  • Your irstats account page lists every community tracking you, with a leaderboard link for each.

The page's address uses a private slug, not your Discord server id, so community pages cannot be enumerated or guessed.

Joining the leaderboard

Type /track in the server and sign in with iRacing once (on iracing.com; the bot never sees your password). From then on your official races post in the server's results channel and count on the leaderboard. /untrack removes you immediately. Up to 50 members can be tracked per server on the free tier.

What posts back to Discord

  • Race digests: one grouped post as results land (within the hour), never per-race spam, linking each result and the community page.
  • Weekly recap: at the start of each week, the previous week in one post: members and races, the drive of the week, the biggest iRating mover, and a most-incidents award. Quiet weeks post nothing.

Names and privacy

The page and the posts are public, so names follow the same privacy rules as the rest of irstats: EU/EEA and UK drivers show abbreviated unless they opted into a public profile.

When a leaderboard wants to be a championship

A community page is a leaderboard, not a championship: no points system, no drop weeks, no admin. When your server wants real standings under its own rules, that is a league site, and the bot is included with it.

Upgrading is quicker for communities: the creation links on your community page (and in the bot's suggestions) open the league wizard pre-filled from your community: its name, and the series most of your tracked members already race. You adjust anything, and your members appear in the new league's standings automatically when they race its slot.