Documentation

Complete reference for all Scout commands, features, and configuration options.

Bot Commands

/subscription add

Subscribe to notifications for a League of Legends player.

/subscription add channel:[#channel] region:[region] riot-id:[name#tag] alias:[nickname] user:[@user]

Required Parameters:

  • channel: Discord channel for notifications
  • region: Player's League region
  • riot-id: Riot ID (GameName#TagLine)
  • alias: Display name for notifications

Optional Parameters:

  • user: Associated Discord user

/subscription delete

Remove a player subscription from your server.

/subscription delete alias:[nickname]

/subscription list

View all active player subscriptions in your server.

/subscription list

/competition

Manage competitions and leaderboards for your server.

/competition create

Create a new competition with custom criteria, dates, and settings. You can use fixed dates or select a League season.

/competition create title:[name] description:[desc] criteria-type:[type] channel:[#channel] season:[season]

Examples: Most Games Played, Highest Rank, Most Rank Climb, Most Wins (Player/Champion), Highest Win Rate

/competition edit NEW

Edit an existing competition. You can always change title, description, and channel. Other settings can only be changed before the competition starts.

/competition edit competition-id:[id] title:[new-title]

/competition list NEW

View all competitions in your server, with optional filters.

/competition list active-only:[true] my-competitions:[true]

/competition view

View competition details and current leaderboard standings.

/competition join

Join an open competition to compete on the leaderboard.

/competition leave

Leave a competition you've joined.

/competition cancel

Cancel a competition (competition owner only).

/competition grant-permission

Grant permission to create competitions to another user (admin only).

/competition invite

Invite a user to join your invite-only competition.

/admin NEW

Advanced player and account management commands for server administrators.

⚠️ Administrator Only

These commands require Discord Administrator permissions and should be used carefully as some actions cannot be undone.

/admin player-edit

Change a player's display alias in your server.

/admin player-edit current-alias:[old] new-alias:[new]

/admin account-delete

Remove a specific Riot account from a player. Useful when someone changes their main account or a smurf is no longer used.

/admin account-delete riot-id:[name#tag] region:[region]

/admin account-transfer

Transfer an account from one player to another. Perfect for when an account was added to the wrong player.

/admin account-transfer riot-id:[name#tag] region:[region] to-player-alias:[alias]

/admin player-merge

Merge two players into one, combining all their accounts and subscriptions. Useful for consolidating duplicate players.

/admin player-merge source-alias:[from] target-alias:[to]

/admin player-delete

Permanently delete a player and all their accounts and subscriptions. This action cannot be undone!

/admin player-delete alias:[alias] confirm:[true]

/admin player-link-discord

Link a Discord user to a player profile.

/admin player-link-discord player-alias:[alias] discord-user:[@user]

/admin player-unlink-discord

Unlink a Discord user from a player profile.

/admin player-unlink-discord player-alias:[alias]

/admin player-view

View detailed information about a player including accounts, subscriptions, and competitions.

/admin player-view alias:[alias]

Understanding Players, Accounts & Subscriptions

Scout organizes data around Players, Accounts, and Subscriptions. Understanding how these work together will help you manage your server's setup effectively.

How It Works

👤 Players

A Player represents a person in your Discord server. Players have:

  • An alias: A display name used throughout Scout (e.g., "ToxicTopLaner")
  • Multiple League accounts: Players can have multiple League accounts tracked (mains, smurfs, etc.)
  • A Discord account (optional): Link a Discord user to help identify who is who in your server

🎮 Accounts

An Account is an individual League of Legends account. Each account:

  • Has a Riot ID (GameName#TagLine) and region
  • Belongs to exactly one Player
  • Is tracked independently for matches

Example: If "ToxicTopLaner" has both a main account and a smurf, both accounts belong to the same Player and their matches appear under the same alias.

📢 Subscriptions

A Subscription links a Player to a Discord channel. Subscriptions:

  • Determine where match notifications are posted
  • Can send notifications for a Player to multiple channels
  • Trigger reports for ALL accounts belonging to that Player

Example: Subscribe "ToxicTopLaner" to #ranked-games, and all matches from all their accounts will post there.

🏷️ Aliases

An Alias is simply the Player's display name. It's used in all notifications and must be unique within your server. You can change a player's alias using /admin player-edit.

📊 Complete Example

Player: "ToxicTopLaner"

├─ Discord: @JohnDoe

├─ Account 1: TopMain#NA1 (na1)

├─ Account 2: Smurf420#NA1 (na1)

└─ Subscriptions: #ranked-games, #all-games

When either TopMain#NA1 or Smurf420#NA1 plays a game, a report will be posted to both #ranked-games and #all-games with the alias "ToxicTopLaner". The Discord link helps you identify that this player is @JohnDoe.

💡 Tips & Best Practices

  • Use consistent aliases: Keep player aliases simple and recognizable (e.g., Discord username or in-game name)
  • Link Discord accounts: Linking helps you identify which Discord user corresponds to each player in Scout
  • Multiple accounts work automatically: Once you add multiple accounts to a player, all their matches appear under the same alias
  • View before deleting: Use /admin player-view to see all accounts before making changes
  • Subscriptions are flexible: You can subscribe the same player to multiple channels for different notification setups

Advanced Features

Arena Support

Scout now fully supports League of Legends Arena mode - the fast-paced 16 player game mode! Get notifications and detailed reports for Arena matches just like any other queue.

What's Tracked in Arena:

  • Complete post-match reports with placement and stats
  • Team compositions for all 8 duos
  • Damage dealt, damage taken, and eliminations
  • Augments selected throughout the match
  • Final placement (1st through 8th place)

Note: Arena matches are automatically detected when you subscribe to a player - no special configuration needed!

Competitions & Leaderboards

Create custom competitions with configurable criteria and track your server's performance on dynamic leaderboards! Perfect for friendly tournaments, ranked grinds, or skill challenges.

Competition Features:

  • Season Support: Align competitions with League seasons (e.g., Season 2025 Split 1) or use custom dates
  • Edit Competitions: Update title, description, and channel anytime. Edit criteria and dates before competition starts.
  • Multiple Criteria: Choose from Most Games Played, Highest Rank, Most Rank Climb, Most Wins (Player/Champion), or Highest Win Rate
  • Queue Filtering: Track specific queues like Solo Queue, Flex, Arena, ARAM, or all games
  • Visibility Options: Open competitions for anyone, invite-only, or server-wide automatic enrollment
  • Leaderboards: Automatically updated after each match with daily summary posts
  • Champion-Specific Competitions: Create competitions for specific champions (e.g., "Best Yasuo Player")
  • Automatic lifecycle management with winner announcements

Quick Start Examples:

/competition create title:"Season Grind" description:"Climb the highest!" criteria-type:HIGHEST_RANK queue:SOLO season:2025-SPLIT-1 channel:#leaderboard

Create a ranked climb competition that lasts the entire split

/competition create title:"Arena Champions" criteria-type:MOST_WINS_PLAYER queue:ARENA start-date:2025-01-01 end-date:2025-01-31 channel:#arena

Track who wins the most Arena games in January

/competition list active-only:true

View all currently running competitions

/competition edit competition-id:5 title:"New Title" description:"Updated!"

Update competition details (works anytime)

💡 Pro Tip

Competitions automatically track matches for participants in your server. Use seasons to avoid manually setting dates, and edit competitions if you need to make changes!

New in this update: You can now edit competitions, list all competitions with filters, and use League seasons instead of fixed dates.

Required Permissions

Scout requires the following Discord permissions to function properly:

⚠️ Important

Only users with Administrator permissions can use the /subscription add and /subscription delete commands.

Bot Permissions

  • Send Messages: Post match notifications and reports
  • Use Slash Commands: Register and respond to slash commands
  • Embed Links: Create rich embeds for match reports
  • Attach Files: Upload post-match report images

Supported Regions

Scout supports all official League of Legends regions:

Americas

  • na1: North America
  • br1: Brazil
  • la1: Latin America North
  • la2: Latin America South

Europe

  • euw1: Europe West
  • eune1: Europe Nordic & East
  • tr1: Turkey
  • ru1: Russia

Asia Pacific

  • kr: Korea
  • jp1: Japan
  • oc1: Oceania
  • ph2: Philippines
  • sg2: Singapore
  • th2: Thailand
  • tw2: Taiwan
  • vn2: Vietnam

Middle East & Africa

  • me1: Middle East

Troubleshooting

Common Issues

Bot not responding to commands

  • Ensure Scout has the necessary permissions in your server
  • Check that you're using slash commands (/) not text commands
  • Verify Scout is online and has the green status indicator

Player not found or invalid Riot ID

  • Double-check the Riot ID format: GameName#TagLine
  • Ensure you're using the correct region for the player
  • Verify the player exists and has played recently

Missing match notifications

  • Scout checks for matches every minute
  • Custom games and practice tool matches are not tracked
  • Very short games might not generate reports

Getting Help

If you're still having issues, you can:

  • Review your server's audit log for permission issues
  • Check Scout's status on our status page (if available)

Frequently Asked Questions

How often does Scout check for new matches?

Scout uses intelligent dynamic polling that adjusts based on player activity:

  • Active players (played within the last hour): Checked every 1 minute
  • Recently active (6-12 hours): Checked every 5-10 minutes
  • Inactive players (30+ days): Checked every 60 minutes

This means you'll get notifications within 1-2 minutes for players who are actively gaming, while reducing unnecessary API calls for inactive accounts.

What types of matches are tracked?

Scout tracks all ranked and normal games on Summoner's Rift, ARAM, Arena, and other matchmade queues. Custom games, practice tool, and tutorial matches are not tracked.

How do competitions work?

Competitions allow you to create time-limited challenges for your server members. You can set custom criteria (wins, rank climb, win rate, etc.) and Scout will automatically track performance and update leaderboards. You can use League seasons or custom dates, and even edit competitions before they start. Use /competition create to get started!

Can I edit a competition after creating it?

Yes! You can always edit the title, description, and channel using /competition edit. Before a competition starts, you can also change the criteria, dates, visibility settings, and other parameters. Once a competition is active, core settings like criteria and dates are locked to ensure fairness.

What are the admin commands for?

The /admin commands help server administrators manage players and accounts. You can rename players, remove accounts, transfer accounts between players, merge duplicate players, and delete players entirely. These are advanced commands that require Administrator permissions in Discord.

Can I track players from different regions in the same server?

Yes! You can subscribe to players from any supported League of Legends region. Just make sure to specify the correct region when subscribing.

How many players can I track?

By default, each server can track up to 75 players with a maximum of 50 League accounts total. This helps ensure reliable service for all users.

If you need to track more players, you can remove existing subscriptions using /subscription delete. Contact us if your community requires a higher limit.

Why am I not getting post-match reports?

Post-match reports are generated after games end. The timing depends on when Scout detects the match is complete:

  • For active players (recently played): Reports appear within 2-3 minutes after match completion
  • For less active players: May take 5-15 minutes depending on their polling interval
  • Very short games (under 5 minutes) or remakes might not generate reports

The dynamic polling system prioritizes active players, so if someone is playing regularly, their reports will appear faster than someone who plays occasionally.

Is my data safe?

Scout only stores the minimum data necessary to provide notifications: Riot IDs, aliases, and Discord channel information. We don't store personal information or match history beyond what's needed for reports.

Need More Help?

Can't find what you're looking for? We're here to help!

Add Scout to Discord