Guide
From zero to a skin alert.
Add the bot, link a Riot account, open your store, set alerts, and lock down your privacy. About five minutes.
- 0130 seconds
Add BotFragg to a server
Invite the hosted bot, or use the account commands in a direct message.
Use the invite button and pick a server you manage. The invite only needs slash-command access. Administrator is not required.
If you only want to check your own shop, keep the bot in a private server or use its account commands in DMs. The store and account replies are yours either way.
- 021 minute
Link your Riot account
Sign in on Riot's website. BotFragg never asks for your password.
Run
/login. BotFragg replies privately with Log in to Riot and Paste URL buttons.1. Select Log in to Riot and sign in on Riot's website.
2. After signing in, a blank page or error may appear. This is expected. Keep the tab open.
3. Copy the full URL from your browser's address bar.
4. Select Paste URL, paste the URL into the form, and submit.
BotFragg finishes the sign-in and stores it encrypted. You never type your password into Discord.
Commands/loginOnly paste the URLNever share your Riot password, verification code, recovery code, or session token. BotFragg's login flow does not need them.
- 0320 seconds
Choose the active account
You can link several Riot accounts to one Discord account.
/accountslists every linked account and marks the active one./accountswitches it. Run/loginagain to add another account.Alerts stay with the account you were using when you created them. If a shop looks wrong, check the active account first.
Commands/accounts/account - 041 minute
Open your store
The same offers you would see in the VALORANT client, without the launcher.
/shopshows your daily weapon skins and accessories with prices./bundlesshows the featured bundle, its contents, and how long it stays./nightmarketshows the offers and discounts when Riot is running one.The rest of your account is here too:
/balancefor VP, Radianite, and Kingdom Credits;/battlepassfor progression;/missionsfor daily and weekly missions;/penaltiesfor queue restrictions./profileand/loadoutreply in the channel./profilealso lists recent competitive matches. Check your sharing settings before using them in a busy server.Commands/shop/bundles/nightmarket/balance/battlepass/missionsPublic replies/profile and /loadout reply in the channel. /missions, /penalties, and /crosshair view reply privately.
- 051 minute
Set a skin alert
Name a skin once. BotFragg checks your shop every day.
Run
/alertand start typing a skin name. Pick the exact skin from autocomplete. Repeat for every skin you want to track, then run/alertsto review or remove them./testalertssends a test DM. It needs an active alert and a linked account, so you can confirm the DM reaches you.On the hosted bot, alerts run once a day. They are not instant. Self-hosted instances can change the time with
ALERT_TIME_UTC; the default is 00:00:10 UTC.Alert me when a skin is in the Night Market is on by default; turn it off with
/settings setif you do not want Night Market offers included.Commands/alert/alerts/testalerts/settings set - 0630 seconds
Check your privacy settings
Decide who can see your profile and shop, and what the bot remembers.
/settings viewlists your current preferences./settings setchanges one: daily shop DMs, hide in-game name, Night Market alerts, profile sharing, and shop sharing.Profile sharing and shop sharing are off until you enable them. Hide in-game name replaces your Riot ID with a generic label on profile cards.
/logoutremoves your saved Riot sign-in but keeps alerts and settings./deletedata confirm:Trueremoves linked accounts, saved sign-ins, alerts, settings, and analytics. It cannot be undone.Commands/settings view/settings set/logout/deletedata - 0715 minutes
Run your own instance
You need your own Discord application, bot token, and Fernet key.
Self-hosting is covered by GPL-3.0. You need Python 3.14, uv, and PostgreSQL for production. Docker and Compose are optional. A development run can use SQLite.
Create a Discord application and bot, copy the token and client ID, then grant View Channels, Send Messages, Embed Links, and Read Message History. Administrator is not required.
Copy
.env.exampleto.env, setDISCORD_TOKENandAPP_ENV=developmentfor a local run, generate a Fernet key forTOKEN_ENCRYPTION_KEY, and start the bot. The Compose service runs migrations before it starts./profilegets recent competitive matches from Riot's match history directly. No extra service or API key is required.cp .env.example .env uv run python -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())" uv sync --all-groups --frozen uv run botfragg
Something still not working?
Read the FAQ