Add a player once. After every ranked game, Ambessa Bot posts the result, LP change and a performance rating.
You set it up once. After that, the bot runs on its own.
Click Add to Discord and choose your server.
A server admin runs /add RiotID#TAG in the channel where
notifications should appear. Repeat for each player.
The bot checks the Riot Games API every 2 minutes. When a tracked player
finishes a Solo/Duo game, it posts the result, champion, KDA, LP change and rating.
Flex games get a post too if an admin enabled them with /flex.
Players from the same game share one post.
Anyone on the server can use /stats, /list,
/history or /ingame to look up a player, the server
leaderboard or who is in a game right now.
Everything happens inside Discord. Nobody needs to visit a website or create an account.
Rank evolution over the last 200 games, with tier bands and every
win and loss marked. Open it from the /stats card.
Every Friday at 6 PM: LP gained, winrate, rating trend and favourite champion for each player on the server.
Both teams, plus gold, XP and CS difference against the lane opponent at 15 minutes. One click shares it with the channel.
/ingame shows who is playing right now, with champion, role and game duration.
A score out of 100 and a grade from S+ to Z, based on the last 30 ranked games and the role played.
/list ranks every tracked player on the server by tier and LP.
/history lists the last 1 to 25 ranked games of a player.
Tracked players in the same game share one post. On opposite teams, it becomes a face-off.
Optional, enabled by an admin with /flex. Each Flex game gets one post with every tracked player in it.
Flex does not count in stats, rating or the weekly recap.
Ambessa Bot uses the official Riot Games Developer API exclusively to retrieve publicly available ranked data. We strictly respect Riot's rate limits, usage policies and developer guidelines.
| Endpoint | Purpose | Frequency |
|---|---|---|
account-v1by-riot-id |
Resolve a Riot ID (GameRiotID#TAG) to a PUUID when a player is added | Once on /add |
match-v5matchlist by puuid |
Fetch the latest Solo/Duo match IDs for each tracked player (and Flex, on servers that enabled it) | Every 2 min per player |
match-v5match by id |
Retrieve full match data (participants, stats, duration) for new games | On new game detection |
match-v5timeline by id |
Get frame-by-frame timeline for gold / XP / CS diff at 15 minutes and early objectives (used by the detailed stats and the player rating) | Once per new game (background, cached) |
league-v4entries by puuid |
Get current rank, LP, wins and losses for accurate LP tracking | On new game detection |
spectator-v5active game by puuid |
Check whether tracked players are in a game right now, with champion, role and queue | On /ingame (30 s cache) |
summoner-v4by puuid |
Retrieve summoner profile icon for display in stats embeds | On /stats (10 min cache) |
champion-mastery-v4by puuid |
Display mastery points for top played champions in stats | On /stats (30 min cache) |
lol-status-v4platform-data |
Monitor API availability and alert the bot owner if the key is down | Every 30 min |
Rate Limit Compliance: All API calls go through a centralized
retry handler that respects Retry-After headers on 429 responses
and applies exponential back-off on server errors.
Caching: Match data and timelines are cached in memory (48 hours for matches), stats for 10 minutes and mastery data for 30 minutes. A game shared by several tracked players is only fetched once, and the player rating is computed from stored data with no extra API call.
No Data Selling: Retrieved data is only used to power Discord notifications and on-demand commands. We never sell, share or monetize player data.
/add riot-id
Start tracking a League of Legends account on this server
Admin
/remove player
Stop tracking an account on this server
Admin
/list
Tracked accounts sorted by rank, with their rating
Everyone
/stats player
A player's rank, winrate, KDA, rating, top champions and leaderboard position
Everyone
/history player [count]
The last 1 to 25 ranked games of a player (default 5)
Everyone
/ingame
Tracked players currently in a Solo/Duo or Flex game
Everyone
/flex [enabled] [thumbnail]
Enable or disable Flex notifications (off by default)
Admin
/language [language]
Bot language on this server: English (default) or French
Admin
/clear [count] [channel]
Delete messages in a channel
Admin
/help
Command list and a link to the full documentation
Everyone
Game notifications also come with a Detailed stats button, and the
/stats card with Refresh, LP Graph,
Match History and Rating info buttons.
Ambessa Bot is not endorsed by Riot Games and does not reflect the views or opinions of Riot Games or anyone officially involved in producing or managing Riot Games properties. Riot Games and all associated properties are trademarks or registered trademarks of Riot Games, Inc.
For bug reports, data removal requests or general questions:
