Discord Bot for iRacing Communities

Manage your iRacing league
directly from Discord

SimBot integrates with the iRacing API to handle driver registration, team management, race processing, standings, penalties, and more, all through Discord slash commands.

60+ Slash Commands
12 Feature Categories

What SimBot does

A complete league management platform built into your Discord server.

Driver & Team Management

Register drivers, form teams, handle car assignments, and track rosters across multiple series and seasons.

Live iRacing Data

Pull iRating, safety rating, and license data directly from the iRacing API. Cached in a queue-based system that respects rate limits.

Race Processing

Upload iRacing result files and have them processed automatically into per-driver and per-team standings with full lap data.

Championship Standings

Multi-category standings (Overall, Pro, Am) with configurable points systems (F1, NASCAR, or custom) and drop-race support.

Penalty System

Apply time or points penalties to drivers, with descriptions and reasons. Standings recalculate automatically on any change.

Visual Reports

Generate image-based reports for standings tables, driver lists, and lap charts, rendered as images and posted directly in Discord.

Voice Channel Sync

Automatically create and maintain team voice channels on Discord, organized by series and kept in sync with team rosters.

Hosted Server Tracking

Submit hosted session notifications and reimbursement requests with admin approval workflows and PayPal tracking.

Roster Auditing

Compare your Discord sign-ups against the iRacing league roster to find missing drivers, last-season returnees, or never-registered members.

Car Number Reservations

Reserve specific car numbers per series, prevent duplicates, and manage reservations across your entire league.

Practice Cup Events

Run standalone practice cup races with separate team and free agent registration, independent of the championship series.

Garage61 Lap Times

Query the Garage61 database for fastest lap times by track, car, team, or season. Filter and sort directly from Discord.

Command Reference

All commands use Discord slash command syntax. Commands labeled Admin Only require administrator permissions. Commands labeled Admin require elevated permissions. Parameters marked ? are optional.

How It Works

SimBot follows a consistent lifecycle from league setup to race-day reporting.

01

Configure a Series

An admin creates a series with /admin_series_create_ir, specifying the car class, team size limits, car change allowances, drop race count, and the dedicated Discord channels for sign-ups, team updates, and admin notifications.

02

Drivers Sign Up

Drivers register with /driver_signup_ir, providing their iRacing name, car number, and car. The bot queues a background job to fetch their iRating and safety rating from the iRacing API, with automatic rate-limit handling.

03

Teams Form

Drivers create teams with /team_create_ir and invite teammates. Admins can override team composition at any time. Optionally, voice channels are auto-created per team via /admin_series_voice_sync.

04

Set the Points System

Admins configure scoring with /admin_set_points_system using built-in F1 or NASCAR distributions, or a fully custom scoring table. Drop-race rules are set at the series level.

05

Process Race Results

After each race, admins upload the iRacing JSON result file with /admin_process_race. The bot parses it, matches drivers to registrations, calculates points, handles penalties, and posts formatted results to the designated channels.

06

View Standings & Reports

At any time, admins can pull driver or team standings filtered by category (Overall, Pro, Am) and sorting preference. The bot generates image-based standings cards, race result tables, and lap position charts posted directly in Discord.

Add SimBot to your server

Get SimBot running in your Discord server in a few steps.

1

Invite the bot

Click the link below to open the Discord authorization page. You must have the Manage Server permission on the server you want to add SimBot to.

Add SimBot to Discord
2

Select your server

Choose the server you want to add SimBot to from the dropdown, then click Authorize. SimBot requires the following permissions to function correctly: Send Messages, Embed Links, Attach Files, Manage Channels, Manage Roles, and Read Message History.

3

Create your first series

Once the bot is in your server, use /admin_series_create_ir to create a racing series. You will be prompted to provide a series name, car class, team size, and the Discord channels to use for sign-ups, team changes, and admin notifications.

4

Register your drivers

Drivers can sign up using /driver_signup_ir with their iRacing name and car details. SimBot will automatically fetch their iRating and safety rating from iRacing in the background.