BotFragg

FAQ

Questions, answered.

How to link your account, when alerts run, what BotFragg stores, how to delete it, and how to self-host. Short answers, with links if you want the details.

5 groups19 answersSupport server

Getting started

What the bot is, what it costs, and where it runs.

What is BotFragg?

A Discord bot for VALORANT. It reads your linked Riot account so you can check the daily shop, featured bundle, Night Market, balances, battlepass, missions, crosshairs, loadout, rank, and recent competitive matches without opening the game. It can also DM you when a skin you want appears.

Is BotFragg free?

The hosted bot is free to use. Ko-fi and GitHub Sponsors donations support development. If you self-host, you pay only for the infrastructure you run.

Is this an official Riot or Discord product?

No. BotFragg is an independent project. Riot Games and Discord do not endorse it, sponsor it, or run it. VALORANT is a Riot Games title.

Which languages are supported?

BotFragg supports 32 Discord locales: English plus 31 translations, including Spanish, French, German, Japanese, Korean, Portuguese, Russian, and Chinese. Slash command names and replies follow your Discord language.

Can I use it in DMs?

Yes. Account, store, alert, and settings commands work in direct messages with the bot. A few, like /ping, only work in a server.

Account and login

Linking Riot, switching accounts, and removing data.

Does BotFragg ask for my Riot password?

No. /login sends you to Riot's website. You sign in there, then paste the URL from your browser back into a private Discord form. Never send your password, verification code, recovery code, or session token to the bot, another user, or a support channel.

What exactly do I paste after signing in?

The full URL from your browser's address bar after you sign in. A blank page or error may appear. That is expected. Keep the tab open, copy the URL, choose Paste URL in the Discord message, and submit it.

Can I link more than one Riot account?

Yes. Run /login again for each account. /accounts lists them and /account switches the active one. Alerts stay with the account you were using when you created them.

Why did /shop say I need to log in?

Either you have not picked an account, or your saved Riot sign-in is no longer valid. Run /accounts to check, then /login again. /logout removes your saved sign-in but keeps the account record, alerts, and settings.

How do I remove my data?

/logout removes your saved Riot sign-in but keeps alerts and settings. /deletedata confirm:True deletes linked accounts, saved sign-ins, alerts, settings, and command analytics. Shared crosshair posts, messages already sent to Discord, and backups made before deletion are not covered.

Alerts

When the DM arrives, and why it might not.

When do skin alerts arrive?

On the hosted bot, alerts run once a day. They are not instant. When the run happens, BotFragg checks the shop and Night Market for the account you picked and DMs you once for each matching skin. Self-hosted instances set the time with ALERT_TIME_UTC; the default is 00:00:10 UTC.

Why did I not get an alert DM?

Check that you have an active alert, that direct messages from server members are allowed, and that the skin is in the shop for the account you picked. /testalerts sends a test DM; it needs an active alert and a linked account.

How do I stop the daily shop DM?

Run /settings set, choose Send my shop by DM every day, and set it to No. This does not remove your skin alerts. Night Market alerts are a separate setting.

Privacy and sharing

What is private, what is public, and what is encrypted.

Can other people see my profile or shop?

Profile sharing and shop sharing are opt-in. Enable them with /settings set. /profile and /loadout reply in the channel where you run them, so anyone who can read that channel can see the response. Hide in-game name replaces your Riot ID on profile cards.

Is my Riot sign-in encrypted?

Your Riot sign-in is encrypted before it is stored. BotFragg does not read ordinary Discord messages. The code and the privacy policy are public.

What does /crosshair view share?

By default the reply is private. In a server you can choose Share and confirm. BotFragg then posts the profile name, export code, and preview image to the current channel with your Discord display name.

Self-hosting

Running your own instance and reporting problems.

Can I run my own BotFragg?

Yes, under GPL-3.0. You need Python 3.14, uv, a Discord application and bot token, a Fernet key, and PostgreSQL for production. Container images are published at ghcr.io/botfragg/botfragg.

Does /profile need extra setup on my instance?

No. /profile reads recent competitive matches directly from Riot's match history using the account you linked. It needs no extra API key or separate service.

Where do I report a bug or a security issue?

Open an issue for ordinary bugs. For a suspected vulnerability, follow SECURITY.md instead of posting the details publicly. The support server is the fastest place for setup help.

HelpSupport server

Still stuck?

Setup problems and account questions are usually answered fastest in the support server. Include the command you ran and the reply you got, never your Riot password.

Ask in the server