🏁 Top 10 Drag Racing Bot - Complete Guide
What is this bot?
The Top 10 Drag Racing Bot is a competitive racing management system for Discord servers. It lets racers compete for positions on a Top 10 leaderboard, challenge each other to races, and track their racing history.
Perfect for: Car communities, racing crews, street racing groups, or any competitive Discord server!
🔒 Premium Bot - Subscription Required: This bot requires an active server subscription to use all commands. When you try to use a command without a subscription, you'll see a helpful message with a button linking to Discord's subscription guide.
🎯How It Works
The Racing System
- Top 10 List: The main leaderboard showing the best 10 racers
- Queue: Everyone below position 10 waits in the queue
- High-Stakes Callouts: Two-stage acceptance system - defenders must accept within 24 hours or forfeit!
- Adjacent-Only Challenges: You can ONLY challenge the position directly above you (ladder climbing)
- Auto-Resolution: Callouts auto-resolve if deadlines are missed - no more ghost callouts!
- Defeat Cooldowns: Losers get 24-hour cooldowns (💧 emoji) preventing immediate re-challenges
- Named Lists: Admins can create multiple racing lists (e.g., "Street Racing", "Pro League")
- Auto-Updating Boards: Set persistent leaderboards that update automatically
🔥 Callout Indicators: When a racer has an active callout, they'll appear with a 🔥 emoji on the leaderboard! 💧 Defeat Cooldowns: Racers with active defeat cooldowns show the 💧 emoji!
⚔️High-Stakes Callout System (NEW!)
How the Two-Stage Challenge System Works
The bot now uses a strategic two-stage acceptance system to prevent "ghost callouts" and ensure challenges actually happen:
Stage 1: Acceptance Window (24 Hours)
When you challenge someone, the defender has 24 hours to respond with one of three options:
- ✅ Accept: Use
/acceptcallout to accept the challenge and start a 12-hour resolution window
- 🏳️ Decline: Use
/declinecallout to forfeit your position to the challenger immediately
- ⏰ Ignore: If no response in 24 hours, the challenger automatically wins your spot!
Stage 2: Resolution Window (12 Hours)
Once a callout is accepted, both racers have 12 hours to:
- Race in your game (Forza, Need for Speed, etc.)
- Resolve the result using
/resolve
- If no resolution in 12 hours, the challenger automatically wins!
Defeat Cooldown System
When you lose a race, you get a 24-hour cooldown (💧) preventing you from immediately challenging the same position again. This prevents "rage callouts" and keeps competition fair and strategic.
Canceling Callouts
Changed your mind? Use /clearcallout to cancel your own pending callout before it's accepted. You can't cancel once the defender accepts!
💎Subscription System
How Subscriptions Work
The Top 10 Drag Racing Bot uses Discord's native monetization system. Server administrators can subscribe through Discord's Server Shop or Monetization settings.
- 🔓 Automatic Unlock: Once subscribed, all bot commands are instantly unlocked for your server
- 🔄 Auto-Managed: Subscriptions are handled automatically by Discord - no manual setup needed
- 🛡️ Secure: Payment and subscription management through Discord's official platform
- 💎 Direct Subscribe Link: Use
/subscribe to get a button that links directly to the bot's Discord store page
- 📖 Help Guide: When you try locked commands without a subscription, you'll see a button linking to Discord's subscription setup guide
💡 Getting Started: Use
/subscribe in your server to:
- Check your server's subscription status
- Get a direct "Subscribe Now" button linking to the Discord store
- See step-by-step instructions for setting up your subscription
🔓Subscription Command (Free to Use)
/subscribe
Check your server's subscription status and get direct access to subscribe. This command works for everyone, even without a subscription!
Example: /subscribe
What you'll see:
- ✅ If subscribed: Shows activation date and active status
- 🔒 If not subscribed: Shows "Subscribe Now" button with direct link to Discord store
- 📋 Step-by-step instructions for server admins
👤User Commands
Commands everyone can use (requires active server subscription):
/join
Add yourself to the racing list. You'll start in the queue (below position 10).
Example: /join
/leave
Remove yourself from the racing list completely.
Example: /leave
/showlist
Display the current Top 10 list and queue. Shows 🔥 emoji for racers with active callouts.
Example: /showlist
/callout position
Challenge a racer to a race. You can only call out the position directly above you. The defender has 24 hours to accept or decline, or you automatically win!
Example: /callout position:5
Rules:
- Position 1-9: Can call out the position directly above them
- Position 10: Can call out position 9
- Queue members: Can call out position 10 (if no active callout on 10)
- Defeat cooldown: Can't challenge the same position for 24 hours after losing to them (💧)
- Defender must accept/decline within 24 hours or forfeit their position
/acceptcallout
(NEW!) Accept an incoming callout challenge. This starts a 12-hour window to race and resolve the result. Defenders only!
Example: /acceptcallout
What happens:
- Callout status changes to "Accepted"
- Both racers have 12 hours to race and resolve
- If not resolved in 12 hours, challenger automatically wins
- Challenger cannot cancel after acceptance
/declinecallout
(NEW!) Decline an incoming callout and forfeit your position to the challenger. Use this if you can't race. Defenders only!
Example: /declinecallout
What happens:
- You immediately forfeit your position to the challenger
- Positions swap automatically
- The callout is cleared
- Better than ignoring the callout and getting auto-resolved!
/clearcallout
(NEW!) Cancel your own pending callout before the defender accepts. Challengers only!
Example: /clearcallout
Rules:
- Only works on callouts you created
- Can't cancel after the defender accepts
- Use this if you change your mind or made a mistake
/resolverace winner loser
Declare the winner of a race and swap positions. Both racers must be mentioned.
Example: /resolverace winner:@John loser:@Mike
What happens:
- If top 10 vs top 10: Winner and loser swap positions
- If queue vs position 10: Winner takes position 10, loser goes to queue
- Loser gets a 24-hour defeat cooldown (💧) for that position
- The active callout is cleared
- Race result is saved to history
/activecallouts
View all active callouts with status (pending/accepted), deadlines, and time remaining.
Example: /activecallouts
What you'll see:
- Pending callouts: Who's challenging who, time until acceptance deadline
- Accepted callouts: Who's racing, time until resolution deadline
- Expired callouts: Marked as "auto-resolving soon"
/history
View the last 5 race results with timestamps.
Example: /history
🛠️Admin Commands
Commands requiring Discord server administrator permissions (all commands require active server subscription):
/addracer user
Manually add a racer to the list. They'll be added to the queue.
Example: /addracer user:@Sarah
/removeracer user
Manually remove a racer from the list.
Example: /removeracer user:@Sarah
/swappositions racer1 racer2
Manually swap the positions of two racers. Useful for fixing mistakes or adjusting the list.
Example: /swappositions racer1:@John racer2:@Mike
/clearcallouts
Clear all active callouts. Use this if callouts get stuck or need to be reset.
Example: /clearcallouts
/cleardraglist
Clear the entire racing list and queue. Warning: This removes all racers!
Example: /cleardraglist
/createlist name
Create a new named racing list (e.g., "Street Racing", "Pro League"). Maximum 10 lists per server.
Example: /createlist name:Street Racing
/renamelist current_name new_name
Rename an existing named list.
Example: /renamelist current_name:Street Racing new_name:Pro Street
/linklisttochannel name
Link a named list to the current channel. Multiple channels can share the same list.
Example: /linklisttochannel name:Street Racing
/unlinklist
Unlink this channel from a named list. Returns the channel to its default channel-specific list.
Example: /unlinklist
/showlists
View all created named lists in this server.
Example: /showlists
/setboard
Create a persistent auto-updating leaderboard in this channel. The board updates automatically whenever changes occur!
Example: /setboard
Auto-updates on: joins, leaves, races, swaps, callouts, and more!
/clearboard
Remove the persistent leaderboard from this channel.
Example: /clearboard
📋Common Workflows
🆕 Setting Up Your First Racing List
- Server admin subscribes through Discord's Server Shop/Monetization
- Admin creates a list:
/createlist name:Street Racing
- Admin links it to channel:
/linklisttochannel name:Street Racing
- Racers join:
/join
- View the list:
/showlist
- (Optional) Set auto-updating board:
/setboard
⚔️ High-Stakes Challenging (NEW Two-Stage System!)
- Check your position:
/showlist
- Stage 1 - Challenge: Call out the person above you:
/callout position:5
- Stage 2 - Defender Responds (24hr window):
- Option A: Accept with
/acceptcallout (starts 12hr race window)
- Option B: Decline with
/declinecallout (forfeit position)
- Option C: Ignore (auto-forfeit after 24 hours)
- Stage 3 - Race (12hr window): Race in real life or in-game!
- Stage 4 - Resolve: Winner declares result:
/resolverace winner:@Me loser:@Them
- Positions swap automatically! Loser gets 24hr cooldown (💧)
⏰ Auto-Resolution: If defender doesn't accept in 24hrs OR racers don't resolve in 12hrs, challenger automatically wins!
🏆 Queue Member Challenging Position 10
- Be in the queue (below position 10)
- Call out position 10:
/callout position:10
- Wait for acceptance (defender has 24 hours to
/acceptcallout or /declinecallout)
- If accepted: Race them within 12 hours!
- Resolve with
/resolverace
- If you win: You take position 10, they go to queue (+ they get 24hr cooldown)
- If you lose: You stay in queue, they keep position 10 (+ you get 24hr cooldown)
💡Tips & Tricks
- Multiple Lists: Create separate lists for different racing categories (street, track, etc.)
- Shared Lists: Link the same list to multiple channels so everyone sees the same rankings
- Auto Boards: Set persistent boards in your main channels for always-visible leaderboards
- Cooldown Strategy: The 24-hour cooldown prevents spam, so plan your callouts wisely!
- History Tracking: Use
/history to review recent races and verify results
- Active Callouts: Check
/activecallouts to see who's currently racing
- Queue Management: Only queue members can challenge position 10 if there's no active callout
❓FAQ
How do I subscribe to use the bot?
Server administrators can subscribe through Discord's Server Shop or Monetization settings. Once subscribed, all bot commands are instantly unlocked. Try any command and you'll see a helpful subscribe button with step-by-step instructions!
What happens if my subscription expires?
If your subscription expires or is cancelled, all racing commands will be locked. Your racing data is preserved, and commands will automatically unlock again when you resubscribe.
Can I call out anyone I want?
No, you can only call out the position directly above you. Queue members can only call out position 10.
What happens if I lose a race?
You swap positions with the winner. If you're position 10 and lose to a queue member, you go to the queue and they take position 10.
Why can't I call out someone?
Possible reasons: 1) You have a defeat cooldown (💧) for that position (24 hours after losing), 2) They have an active callout already, 3) You're trying to call out someone not directly above you.
What happens if I don't accept a callout?
If you don't accept or decline within 24 hours, you automatically forfeit your position to the challenger. It's better to use /declinecallout explicitly!
What's the 💧 emoji on the leaderboard?
The 💧 (droplet) emoji shows you have an active defeat cooldown. This means you lost a race and can't challenge that same position again for 24 hours. It prevents "rage callouts" and keeps competition strategic.
Can I cancel a callout after sending it?
Yes! Use /clearcallout to cancel your own pending callout before the defender accepts. Once they accept, you can't cancel anymore.
What happens if we don't race after accepting?
If you accept a callout but don't resolve the race within 12 hours, the challenger automatically wins. This prevents accepted callouts from going stale!
Can queue members race each other?
No, queue members can only challenge position 10. To race other queue members, they must first make it into the top 10.
How do I see the leaderboard without typing /showlist?
Ask an admin to use /setboard to create a persistent auto-updating leaderboard in your channel!
Can we have multiple racing lists in one server?
Yes! Admins can create up to 10 named lists using /createlist and link them to different channels.
🔗Important Links
Top 10 Drag Racing Bot - Manage your racing crew with style! 🏁
For support or questions, join our Discord server!