Features | Installation | Useful Info | Acknowledgements | Translations

Discord bot to view your Valorant daily shop, set alerts for specific skins, and much more.

Simple to setup, easy to use, and packed with useful features.

Also known as   Ministral! Invite the bot to your server.
Feel free to join the support server if you need any help!

• 🔍 See your shop, bundles and night market easily without lauching the game
• 🔔 Set skin alerts to be notified automatically when they are in your shop
• 📬 Send your shop automatically every day in a text channel of your choice
• 🔀 Account switcher to check the shop and set alerts for up to 10 different accounts
• 📊 Automatically track which skins appear the most in your shop
• 👀 Fetch and see the shop of your friends using the bot
• ✔ Automatically imports new skins from the latest Valorant updates
• ⬛ Hide your Valorant username from the message using /settings
• 🌍 Skin names are automatically translated to any language that Valorant supports
• ✨ ...and so much more!
• 🛠 For bot admins:
  • Really easy to set up
  • Optimised for performance and reliability
  • Highly configurable in config.json
  • Login queue and shop cache systems to prevent rate limiting
  • Fully supports sharding (required for 2500+ servers)

• Create a discord bot and add it to your server with the bot and applications.commands scope
• Install Node.js v16.6 or newer
• Clone/Download the repo, rename the config.json.example file to config.json and put your bot token into it.
• Open a command prompt in the same folder and type npm i to install dependencies
• Run SkinPeek.js using node SkinPeek.js in the command prompt
• And that's it! Don't forget too give the bot a role that allows it to send messages and create custom emojis.

• The bot should automatically deploy the slash commands globally. If they don't appear:

  • If you're getting DiscordAPIError: Missing Access, you probably forgot to add the applications.commands scope in step 1
  • Discord global commands can take up to 1h to update due to caching. If you don't want to wait, send @bot !deploy guild in a text channel the bot can see (@bot being you @mentionning your bot). This will deploy the commands immediately in that guild.
  • If you see every command twice, just send @bot !undeploy guild!

• By default, the bot doesn't store your username/password, it only uses them to get the cookies that can be used to generate access tokens needed to get your shop.

  • Your cookies are only stored on your hard drive, and are only ever sent to official Riot servers.
  • You can log in using your cookies using /cookies to avoid sending your password, and you can delete your account from the bot anytime using /forget.

• Once you're more or less familiar with how the bot works, you should read the Admin Guide for advanced usage and tips & tricks for hosting the bot.

• If you're bored, check out this writeup on how Riot treats third-party projects like this one.

Thanks to Gam3rBoy57 for maintaining the Replit version! For setup instructions and Replit-specific support, read the top of this readme.
Note: You will probably have to /login every day on the free version, and your alerts most likely won't work. Read more here.

For advanced users who want to deploy the bot using Docker:

• Create a discord bot and add it to your server with the bot and applications.commands scope
• Create a docker-compose file like this and a config file like this
• Put your bot token in config.json
• Use docker-compose up -d to start the bot, docker-compose logs -f to see the logs and docker-compose down to stop it.

• Hamper for the idea and the code showing how to do it
• Valorant-api for the skin names and images
• muckelba for writing the battlepass calculator
• Spirit for his API for getting previous bundle items and prices
• warriorzz for setting up the Docker
• The dev discord server, join here!

Special thanks to Mistral, Jukki and Keny for their countless bug reports, suggestions and feedback, and without whom the bot wouldn't be anywhere near as good as what it is today.

If you are fluent in another language and would like help translate the bot, either to a new language or to improve an existing translation, please do!

1. Look up the language code for your language here or here.
2. Look in this repo's languages folder.
3. If your language is already there, feel free to improve and modify it as much as you can. Otherwise if you're starting from scratch, copy the en-GB.json file and rename it to your language code.
4. Open the file and do the thing.

Once you're done translating, you can either fork the repo and open a GitHub pull request, or you can just send me the JSON on discord and I'll upload it for you (with credit, of course).

Thank you! ❤️