BotFragg

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.

About 5 minutesNo admin permissionFree on the hosted bot
  1. 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.

  2. 0320 seconds

    Choose the active account

    You can link several Riot accounts to one Discord account.

    /accounts lists every linked account and marks the active one. /account switches it. Run /login again 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
  3. 041 minute

    Open your store

    The same offers you would see in the VALORANT client, without the launcher.

    /shop shows your daily weapon skins and accessories with prices. /bundles shows the featured bundle, its contents, and how long it stays. /nightmarket shows the offers and discounts when Riot is running one.

    The rest of your account is here too: /balance for VP, Radianite, and Kingdom Credits; /battlepass for progression; /missions for daily and weekly missions; /penalties for queue restrictions.

    /profile and /loadout reply in the channel. /profile also lists recent competitive matches. Check your sharing settings before using them in a busy server.

    Commands/shop/bundles/nightmarket/balance/battlepass/missions
    Public replies

    /profile and /loadout reply in the channel. /missions, /penalties, and /crosshair view reply privately.

  4. 051 minute

    Set a skin alert

    Name a skin once. BotFragg checks your shop every day.

    Run /alert and start typing a skin name. Pick the exact skin from autocomplete. Repeat for every skin you want to track, then run /alerts to review or remove them.

    /testalerts sends 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 set if you do not want Night Market offers included.

    Commands/alert/alerts/testalerts/settings set
  5. 0630 seconds

    Check your privacy settings

    Decide who can see your profile and shop, and what the bot remembers.

    /settings view lists your current preferences. /settings set changes 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.

    /logout removes your saved Riot sign-in but keeps alerts and settings. /deletedata confirm:True removes linked accounts, saved sign-ins, alerts, settings, and analytics. It cannot be undone.

    Commands/settings view/settings set/logout/deletedata
  6. 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.example to .env, set DISCORD_TOKEN and APP_ENV=development for a local run, generate a Fernet key for TOKEN_ENCRYPTION_KEY, and start the bot. The Compose service runs migrations before it starts.

    /profile gets recent competitive matches from Riot's match history directly. No extra service or API key is required.

    sh
    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