DOCS / GUIDE

Documentation

Welcome to the official GridScout documentation. Here you will learn how to set up and use GridScout in your server or account.

INTRODUCTION

Overview

Getting started

This documentation walks through the process of setting up GridScout within your server, or account.

Inviting the Bot
Learn how to install and set up GridScout on your Discord server.
Commands Reference
Explore all available commands and their parameters.

Support

Use the articles linked below for additional support.

About GridScout
Learn more about how GridScout works, and what it was built with.
Troubleshoot
Find solutions to common problems and get support.
INTRODUCTION

Invite GridScout

GridScout provides two different options for installation.

Type
Best for
Guild Install
Server administrators who want to enable GridScout's full functionality for their entire community, includes race notifications.
User Install
Individual users who want to access GridScout's features across multiple servers (subject to server permissions), or in private channels.

Guild Install

Note: You must have the Administrator or Manage Server permission to install GridScout.

  1. Click the following link to open the install menu.
  2. Choose Add to Server.
  3. Select your server from the dropdown list.
  4. Click authorise to invite GridScout.

User Install

  1. Click the following link to open the install menu.
  2. Choose Add to my Apps.
  3. Click authorise to add GridScout.

Finishing up

🎉 And done! GridScout has been successfully installed. Check out the rest of this documentation for guidance on setting up the bot.

Commands Reference
Explore all available commands and their parameters.

Troubleshooting

If you encounter any issues, please refer to the troubleshooting guide for help.

COMMANDS

Command List

General Commands

/about

Provides details about the bot, including websocket latency and support links.

/about

/settings notifications INTERACTIVE

Configure which channel should receive race notifications from GridScout.

Options

channel · channel · required
The Discord channel where race notifications should be sent.

/settings notifications #race-notifications

/settings motorsportcom

Configure which channel should receive motorsport.com news from GridScout.

Options

channel · channel · required
The Discord channel where motorsport.com news should be sent.

/settings motorsportcom #motorsportcom-news

Calendar Commands

/next INTERACTIVE

Provides detailed information about the next race on the F1 calendar, including all session times.

/next

/calendar AUTOCOMPLETE

Displays all races for a given season with dates and countries. The upcoming race includes additional session time details.

Options

season · string · optional
The F1 season to view the calendar for. Defaults to the current season if not specified.

/calendar
/calendar 2023

Driver Commands

/driver AUTOCOMPLETE

Provides driver information including basic details (name, number, team, nationality, date of birth), career statistics (championships, podiums, points), and recent race results.

Options

driver · string · required
The name of the driver to look up (with autocomplete).

/driver Lewis Hamilton
/driver Max Chilton

Constructor Commands

/constructor AUTOCOMPLETE

Provides team information including team details (full name, nationality), current engine and chassis specifications, current drivers, historical statistics, and recent results.

Options

team · string · required
The name of the team to look up (with autocomplete).

/constructor Ferrari
/constructor Red Bull

Results Commands

/results AUTOCOMPLETE INTERACTIVE

Displays results for different sessions of a specified race (practice, qualifying, sprint, race) with an interactive menu to switch between sessions. Shows driver positions, times/gaps, and status.

Options

season · integer · required
The F1 season to view results from.

race · string · required
The race to view results for (with autocomplete).

/results 2023 Monaco Grand Prix
/results 1950 British Grand Prix

Standings Commands

/standings driver AUTOCOMPLETE

Displays the current or historical driver championship standings, including driver names, points, and positions.

Options

season · integer · optional
The F1 season to view standings from. Defaults to the current season if not specified.

/standings driver
/standings driver 2023

/standings constructor AUTOCOMPLETE

Displays the current or historical constructor championship standings, including team names, points, and positions.

Options

season · integer · optional
The F1 season to view standings from. Defaults to the current season if not specified.

/standings constructor
/standings constructor 2022

Command Features

Autocomplete

Almost all commands that require specific parameters (drivers, teams, circuits, seasons) support Discord's autocomplete feature. Simply start typing and GridScout will suggest matching options.

For best results, use common names or abbreviations for drivers, teams, and circuits. The autocomplete will help you find the correct option.

Interactive Navigation

Several commands, such as /next and /results, include interactive buttons or select menus that allow you to:

  • Navigate through races in the season
  • Switch between different session types (practice, qualifying, sprint, race)
  • View detailed information without needing to use multiple commands

Season Selection

When specifying a season:

  • If not provided, the current season is used
  • Seasons back to 1950 are available for driver data
  • Constructor data is available from 1958 onwards
  • All seasons feature autocomplete for easy selection

Examples

Here are some example commands to get you started:

/next                        # Shows the upcoming race
/driver hamilton             # Shows Lewis Hamilton
/results 2023 monaco         # 2023 Monaco Grand Prix results
/standings driver            # Current driver standings
/standings constructor 2022  # 2022 constructor standings
/calendar                    # Current season calendar
/constructor red_bull        # Red Bull Racing

Rich Data Presentation

GridScout presents data with:

  • Country flag emojis for nationalities
  • Team logos for constructors
  • Position numbers
  • ANSI-coloured code blocks for detailed race results
  • Timestamps that adapt to your local timezone

Troubleshooting

If you encounter any issues with commands, please refer to the troubleshooting guide or join our Support Server for assistance.

SUPPORT

About

GridScout is a feature-rich Discord bot designed to bring comprehensive Formula 1 statistics and information directly to your Discord server.

Using the About command

To view information about the bot:

/about

This command displays details about the bot, including websocket latency and support links.

Technical information

GridScout is built with:

  • Discord.js: for Discord API integration
  • TypeScript: for type-safe code
  • F1DB: for accurate statistics and results

Bot permissions

When adding GridScout to your server, it requires the following permissions:

  • Read Messages / View Channels: to see messages in channels
  • Send Messages: to respond to commands
  • Embed Links: to send embeds with F1 statistics
  • Use External Emojis: for number, nationality and team emojis

Support & feedback

If you have questions, suggestions, or encounter any issues with GridScout:

Privacy & data

GridScout respects your privacy:

  • We do not collect or store personal user data
  • Usage statistics are anonymised and only used to improve the bot
  • We do not share any data with third parties

Credits

GridScout is made possible thanks to:

  • F1DB Team
  • Open source libraries and frameworks
  • Our contributors and community

Legal

GridScout is not affiliated with, endorsed by, or associated with Formula 1, FIA, or any F1 team. All trademarks belong to their respective owners.

SUPPORT

Troubleshooting

Welcome to the GridScout troubleshooting guide. Here you will find solutions for common issues, error messages, and configuration problems. Follow the steps below to get your bot working smoothly again.

Common issues

Bot not responding to commands

If GridScout isn't responding to your slash commands, check the following:

  • Check permissions: ensure GridScout has the necessary permissions (Read Messages / View Channels, Send Messages, Embed Links, Use External Emojis).
  • Bot status: check if GridScout is online. The bot may be down for maintenance or experiencing outages.
  • Command usage: make sure you're using the commands correctly. All commands start with a forward slash (/).
  • Discord service: check if Discord is experiencing any service issues that might affect bot functionality.

Incorrect or outdated data

  • Data refresh timing: GridScout updates its data as soon as our upstream provider does, normally the same day as the race event. Please wait a bit if you're checking immediately after a race.
  • Specific data concerns: if you believe there's a persistent error in the data (not just timing-related), please report it in our Support Server.
  • F1 data corrections: occasionally, official F1 results may be amended after initial publication (for example, due to penalties). We update our data to reflect these changes as soon as possible.

Error messages

"I don't have permission to do that"

GridScout needs additional permissions in your server. Ask a server administrator to check the bot's role permissions.

"This interaction failed"

This typically happens when:

  • You're trying to interact with a message that's too old (buttons expire after 15 minutes)
  • The bot underwent a routine update or maintenance while you were using it
  • There was a temporary connection issue

Try running the command again.

"Unknown driver / team / circuit"

Check your spelling or try using a more common name or abbreviation through the autocomplete feature.

Advanced troubleshooting

Server-specific issues

If GridScout works in other servers but not yours:

  • Remove and re-invite the bot using the invitation link
  • Verify your server isn't at the Discord integration limit

Getting support

  • Join our Support Server: get real-time help in our Discord Support Server
  • Check known issues: review submitted issues on our GitHub
  • Report a bug: use our GitHub Issues page to report bugs directly to our development team