---

SkinPeek

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.

Feel free to join the support server if you need any help!

---

Screenshots

See some more screenshots

Features

• 🔍 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)

Installation

• 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.

Useful Information

• Can I get banned for using SkinPeek? (spoiler: nope, it's safe to use!)

• After installing, 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.

Docker

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.

Acknowledgements

• Hamper for the inspiration and the code showing how to do it
• Valorant-api for the skin names and images
• muckelba for writing the battlepass calculator
• 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.

Translations

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! ❤️