Features Multitap Cloud Pricing FAQ Roadmap DOCS Free demo call
Home/DOCS/Discord
Chapter 15 · Discord

The Discord bot.

Connect the Multitap bot to your server and it posts records, personal bests, race results and league news as they happen. Members get slash commands too.

Where to find it·Admin panel › Discord

The Multitap bot is one bot, run by Multitap, that joins your venue's Discord server. Connect it once, choose a channel, and it posts the moment something happens on your rigs: a personal best, a top-ten entry, a record, a streak, a rivalry, a new car in the library. Your members get slash commands to pull up boards and stats without leaving Discord, and league drivers can enter championships from there.

The Multitap Leaderboard Bot posting three embeds in Discord: a new traffic high score, a traffic personal best, and a new lap personal best on Long Beach 2023
Live embeds in a venue's channelMultitap Leaderboard Bot

Connecting

  1. Click Connect Discord.

    You need a Discord server where you have the Manage Server permission. The Connect Discord button sends you to Discord's own site to pick a server and approve the bot. It only asks to view channels, send messages, embed links, and add its slash commands.

  2. Choose the server and click Authorize.

    Pick the server you manage from Discord's list, then click Authorize.

  3. You're back on the Discord page.

    It names the server you just connected and moves straight to choosing a channel, below. If something went wrong instead, a banner across the top explains it.

If something goes wrong

What happenedThe banner saysWhat to do
CancelledYou cancelled in Discord. Nothing changed.Click Connect Discord and go through it again.
ExpiredDiscord's approval expired (it lasts 10 minutes). Click Connect Discord to try again.Click Connect Discord and finish within ten minutes this time.
Already connected elsewhereThis Discord server is already connected to Riverside Raceway. Disconnect it on that venue's Discord page first, or choose another server.Disconnect it from that other venue first, or pick a different Discord server for this one.
Not confirmedDiscord didn't confirm the connection. Choose a server where you have Manage Server and click Authorize.Click Connect Discord, pick a server where you have Manage Server, and click Authorize.

Choosing a channel

Back on the Discord page the status reads Connected: choose a channel. Pick a text channel from the list; it is grouped into categories the same way your Discord server groups them, and an announcement channel is marked (announcement).

A channel the bot can't post in yet is marked (needs permission). Choose it anyway and the page shows the fix: in Discord, open the channel, then Edit Channel > Permissions, add the Multitap role, and allow View Channel, Send Messages, Embed Links. Back on the Discord page, click Check again to confirm it took; Save only lights up once it does.

Clicking Save sends a short "connected" note to the channel right away, so you know it worked before you leave the page: Test post sent to #channel, or the reason it failed and how to fix it.

The status line and the dashboard

Once connected, the Discord page always shows one of six states, and your dashboard shows the same thing in miniature.

The Discord page for a connected venue: Posting to #bot-tests in Multitap Lounge with the time of the last post, a Details toggle, the Change channel, Send test post and Disconnect buttons, and What gets posted with the Highlights preset selected
A connected venuePosting to #bot-tests
StateWhat it meansWhat to do
Not connectedDiscord isn't linked to your venue.Click Connect Discord.
Choose a channelThe server is linked but no channel is picked yet.Pick a channel and click Save.
Posting to #channelRecords and leaderboard news are going out. Everything is working.Nothing.
Last post failedThe most recent post didn't go through: usually a permission the bot lost, a deleted channel, or a channel outside your server.Read the reason under the status line and follow it; it names the exact fix.
Bot removed from your serverSomeone removed the Multitap bot from Discord.Click Reconnect. Your channel choice is kept.
Multitap bot offlineMultitap's own Discord bot is down, not anything at your venue.Nothing on your side; posts resume when it's back.

Your dashboard's Discord line opens this page when you click it. Needs Attention lists the three states you can fix yourself: choose a channel, last post failed, and bot removed from your server. A bot that's offline, or a venue that hasn't connected Discord at all, doesn't need your attention.

Change channel, test post and disconnect

Once connected, a small Details toggle on the card shows the raw Server ID and Channel ID, if you ever need them for support. Three buttons sit below it:

ButtonWhat it does
Change channelReopens the channel list with your current channel already selected. Pick a different one and click Save, or click Cancel to keep what you have.
Send test postSends the same short "connected" note to your saved channel right now, and reports whether it arrived.
DisconnectStops posting to Discord, once you confirm.
Disconnecting doesn't remove the bot

The Multitap bot stays in your server until you remove it yourself in Discord: Server Settings > Integrations > Multitap > Remove. Until you reconnect, its slash commands tell your members this server isn't connected.

What gets posted

Three presets set the toggles below for you. Changing any toggle by hand switches you to Custom.

PresetTurns on
Highlights (default)Records, top 10, new cars and tracks, traffic
EverythingEvery kind of post below
CustomPick below
Post typeFires whenSetting
Track recordsA driver takes P1 on one of your all-time boards.At most one post per driver per board every 1 min (0 posts every time)
Record battlesAdds a line to a record post when the old record was set only minutes before, or when two drivers keep swapping it."Minutes before" means within 60 min
Top 10A driver enters a board's top 10 or moves up it, or takes P1 on a today, this week, this month or one-day board.At most one post per driver per board every 10 min (0 posts every time)
New cars and tracksNew cars or tracks appear at your venue.
Traffic modeInclude traffic-mode scores, following the choices above.
Personal bestsA driver beats their own best time in the same car on that track.At most one post per driver per car every 5 min (0 posts every time)
Improvement streaksA driver sets several personal bests in a row.Post at 3, 5, 10, 25, 50 in a row
First lapsWelcome a driver the first time they drive at your venue.

Record battles stays greyed out while Track records is off; it only ever shows up inside a record post. Every number above is the starting default: type a new one and click Save Discord settings to change it. Only valid laps trigger the competitive posts. A tie is not a personal best. League events post as described in the Leagues chapter. Hotlap challenges post when one goes live, when it has a new leader (at most once every 10 minutes per challenge), and the final top 10 when it ends; see Challenges.

One post per lap, ranked like your TVs

Every lap gets at most one post, however much it did. The post leads with the biggest news and adds the rest as short lines underneath. The headline is picked in this order:

HeadlineTitle in Discord
Record๐Ÿ‘‘ New record on Spa-Francorchamps
Fastest in a window๐Ÿ Fastest today on Event Tonight (also this week, this month, of the day)
Top 10๐Ÿ P4 on Spa-Francorchamps, or Up to P4 when the driver was already in it
Personal bestโฑ๏ธ Personal best at Imola
Streak๐Ÿ”ฅ 5 personal bests in a row
First lap๐Ÿ‘‹ Welcome to Riverside Raceway

The lines below the time read like Took it from K. Ito by 0.212., 0.874 behind D. Lee (P1)., Up from P7. or Also P1 today on Event Tonight. Gaps are always spelled out as faster or behind.

Positions come from your own leaderboards, ranked exactly the way their TVs rank them, and the post names the board and links its title to the board's public page. A lap that counts on several boards leads with the all-time one and mentions up to three others in a line each. When no board covers the lap's track and car, the post ranks it against the same class on that track instead and says so, as in P2 in GT3 at Imola, with no link. That fallback is the one place where classifying your cars on the Cars & Tracks page matters; a car with no class is ranked against itself.

Drivers appear under the same names your boards show, such as K. Ito. If you have switched off Show unmatched laps on leaderboard on the Leaderboard page's Screen appearance tab, a lap by a driver who isn't linked on the Drivers page gets no post at all, and never shows up as the holder someone beat. Traffic scores are not affected by that switch.

Every post uses your venue's brand colour from Settings, puts the driver's name at the top, and carries your venue name and logo at the bottom. The game's name is added there only if your venue runs more than one game. Posts never ping anyone.

Recent posts

Under the post types, Recent posts lists what the bot announced lately, newest first: the time, the driver as your boards name them, what it was and where, for example K. Ito New record, Personal best on Spa-Francorchamps. One lap is one line even when the post carried several pieces of news. Before the first post it says Nothing posted yet.

Near the bottom of the page, under "Discord invite for your public pages", the Invite link field shows on your public league pages as Race from home. Paste a link that starts with https://discord.gg/, https://discord.com/invite/ or https://discordapp.com/invite/; anything else shows an inline error and blocks Save. Leave it empty to hide that card.

Make it one that never expires: in Discord, right-click your channel, then Invite People > Edit invite link > Expire After: Never > Generate a New Link.

It saves with everything else on the page: Save Discord settings at the bottom.

Slash commands

Members of a connected server can type these in any channel. Game choices are Assetto Corsa, ACC and iRacing; track and car fields autocomplete from your library.

CommandReply
/leaderboardThe top ten for a game on one track, optionally one class, ranked like your boards. Defaults to your most-driven track. Each row shows the gap to P1, and the car when the rows mix cars. Links to a matching all-time board if you have one.
/statsA driver's totals: laps, valid laps, tracks, cars, best lap and games. Takes the name the boards show, a board name or the in-game name.
/recordsThe P1 of each of your lap boards for that game, as their TVs show it, up to fifteen. With no boards set up, the fastest lap on each track.
/recentThe latest valid laps, up to 25.
/trafficThe traffic top ten for a track, with score and best combo. Defaults to the track with the most scores, and links to its traffic board if you have one.
/tracksThe track list for a game, filtered by region or search term.
/classesCar classes with counts.
/carsCars in a class, or matching a search.
/carThe fastest laps in one car, per driver and track. Suggests cars by their full names.
/league …Standings, schedule, signup, me, car and withdraw. See Leagues.