Race Announcements Setup Guide

The iRacing Reports bot can automatically post race results for your tracked drivers to Discord channels. This guide explains how to configure announcements, route specific series to dedicated channels, and customize what gets announced.

---

What Are Race Announcements?

When race announcements are enabled, the bot posts a summary for every official race completed by drivers you’re tracking. These announcements include:

• Driver name and finishing position
• iRating change (gain or loss)
• Incidents and safety rating changes
• Series and car information
• Link to full results on the official iRacing.com site

---

Quick Start

1. Enable Race Announcements

Run this command in the channel where you want announcements to appear:

/setup results_announcer announcer_enabled:True

The bot will ask if you want to use the current channel. Click “Use this channel” to confirm.

That’s it! Race results for your tracked drivers will now appear in that channel.

---

Advanced Configuration

Route Different Series to Different Channels

If you race multiple series, you can send each series’ announcements to its own dedicated channel:

Map a series to a channel:

/setup add_series_channel series:[select from autocomplete] channel:#gt3-results

• Leave channel blank to use the current channel
• Series autocomplete searches all official iRacing series

View current mappings:

/setup view_series_channels

Shows all series-to-channel mappings configured for your server.

Remove a series mapping:

/setup remove_series_channel series:[select from autocomplete]

That series will revert to using the default announcement channel.

---

How Channel Routing Works

The bot uses a fallback system to determine where to post each race announcement:

1. Series-specific channel (if configured): If the race’s series has been mapped to a channel via /setup add_series_channel, it announces there.
2. Default announcement channel (fallback): All other series use the guild-wide default channel set with /setup results_announcer or /setup default_results_channel.

Example Configuration

Default channel: #general-results
Series mappings:
  - GT3 Fixed → #gt3-fixed-results
  - GT3 VRS Sprint → #gt3-vrs-results
  - Formula Vee → #formula-vee-results

Result: GT3 Fixed races appear in #gt3-fixed-results, Formula Vee races in #formula-vee-results, and all other series (e.g., Skip Barber, MX-5) appear in #general-results.

---

Change the Default Channel

To change where unmapped series announce:

/setup default_results_channel channel:#new-default-channel

This updates the guild-wide fallback without affecting series-specific mappings.

---

Filter Announcements

You can limit announcements to specific race outcomes:

Only announce iRating gains:

/setup results_announcer announcer_enabled:True announce_ir_gain_only:True

Skips races where the driver lost iRating.

Only announce podium finishes:

/setup results_announcer announcer_enabled:True announce_podium_only:True

Only posts when a driver finishes 1st, 2nd, or 3rd.

Note: These filters apply guild-wide to all announcements, not per-series.

---

Command Reference

/setup results_announcer

Purpose: Enable/disable announcements and set the default channel
Options:

• announcer_enabled (required): True to enable, False to disable
• announcer_channel (optional): Channel for announcements (defaults to current channel)
• series (optional): If provided, maps this series only to the specified channel (does not change guild-wide default)
• announce_ir_gain_only (optional): Only announce positive iRating changes
• announce_podium_only (optional): Only announce top-3 finishes

Behavior:

• Without series: Updates guild-wide announcement settings (enable/disable, default channel, filters)
• With series: Maps that series to the specified channel only (does not affect default channel or filters)

---

/setup add_series_channel

Purpose: Map a specific series to a dedicated channel
Options:

• series (required): Series name (autocomplete)
• channel (optional): Target channel (defaults to current channel)

Example: Send all GT3 Fixed announcements to #gt3-results:

/setup add_series_channel series:GT3 Fixed channel:#gt3-results

---

/setup remove_series_channel

Purpose: Remove a series-to-channel mapping
Options:

• series (required): Series name (autocomplete)

Result: That series will revert to using the default announcement channel.

---

/setup default_results_channel

Purpose: Set the guild-wide default channel for unmapped series
Options:

• channel (required): New default channel

Use this when: You want to change the fallback channel without affecting series-specific mappings.

---

/setup view_series_channels

Purpose: Display all current series-to-channel mappings
Options: None

Output: An embed showing which series are routed to which channels, plus a reminder about the fallback behavior.

---

Troubleshooting

Problem: All announcements go to the wrong channel

Cause: The guild-wide default channel was accidentally changed when setting up a series-specific mapping.

Fix: Use /setup default_results_channel to reset the fallback channel:

/setup default_results_channel channel:#correct-default-channel

---

Problem: A specific series isn’t announcing where expected

Check current mappings:

/setup view_series_channels

If the series is listed, it will announce to that channel.
If the series is not listed, it uses the guild-wide default channel.

To change it:

/setup add_series_channel series:[series name] channel:#desired-channel

---

Problem: Not receiving any announcements

Verify announcements are enabled:

/setup results_announcer announcer_enabled:True

Ensure you have tracked drivers:
The bot only announces races for drivers tracked via /subscribe add.
Check your tracked drivers with /subscribe list.

Verify channel permissions:
The bot needs permission to send messages and embed links in the announcement channels.

---

Example Workflows

Scenario 1: Multi-Series Team

Goal: GT3 races in #gt3-results, Formula races in #formula-results, everything else in #general-results.

Setup:

1. /setup results_announcer announcer_enabled:True announcer_channel:#general-results
2. /setup add_series_channel series:GT3 Fixed channel:#gt3-results
3. /setup add_series_channel series:GT3 VRS Sprint channel:#gt3-results
4. /setup add_series_channel series:Formula Vee channel:#formula-results
5. /setup add_series_channel series:Formula B - Super Formula channel:#formula-results

Result: GT3 races → #gt3-results, Formula series → #formula-results, all other series → #general-results.

---

Scenario 2: Single-Series Team

Goal: Only announce iRating gains for Radical Racing Challenge in #results.

Setup:

/setup results_announcer announcer_enabled:True announcer_channel:#results announce_ir_gain_only:True

Result: Only races with positive iRating changes appear in #results.

---

Scenario 3: Clean Up Old Configuration

Goal: Remove all series mappings and consolidate to one channel.

Setup:

1. /setup view_series_channels  (see what's mapped)
2. /setup remove_series_channel series:[each mapped series]
3. /setup default_results_channel channel:#all-results

Result: All announcements go to #all-results, no series-specific routing.

---

Additional Settings

Mention Discord Users in Announcements

When enabled, the bot will @mention Discord users whose iRacing accounts are linked when they appear in race announcements.

/setup mention_race_announcements

Choose “Enable Mentions” or “Disable Mentions” when prompted.

---

Related Commands

• /subscribe add: Track a driver for announcements
• /subscribe list: View tracked drivers
• /setup admin_role: Grant announcement configuration rights to a Discord role

---

Need Help?

• Join the public Discord server for support
• Check the full command reference
• Visit iracingreports.com for web-based stats