ngkien1530/SkinPeek

Advanced Valorant Discord bot to see your daily shop, night market, battlepass progression, and much more

SkinPeek

Discord bot to view your Valorant daily shop, set alerts for specific skins, and much more.
Simple to setup, easy to use, and has many useful features and commands.

See some more screenshots

Feel free to join the support server for any help with the bot, or if you want to use a public instance without hosting it yourself.

Features

• 🔍 See your shop, bundles and night market easily and without lauching the game
• 🔔 Set skin alerts to be notified automatically when they are in your shop
• 🔀 Account switcher to check the shop and set alerts for multiple 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
• 🛠 For bot admins:
  • Really easy to set up
  • Optimised for performance and reliability
  • Highly configurable in config.json
  • Toggleable login and shop queues to prevent rate limiting
  • Shop cache to prevent fetching the same user's shop twice
  • Used by large shop bots, highly scalable
  • 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
• Give the bot a role that allows it to send messages and create custom emojis

Useful Information

• 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 auth.riotgames.com cookies using /cookies to avoid sending your password, and you can delete your account from the bot using /forget.
  • Obviously, only log in if you trust whoever is hosting the bot, as they can theoretically do anything with your account.

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

Replit

Thanks to Gam3rBoy57 for maintaining the Replit version!
Note: You will probably have to /login every day, and your alerts most likely won't work. Read more here.

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.
• Send !deploy guild to deploy in the current guild or !deploy global to deploy the commands globally.

Future Improvements

• Auto check for new Valorant version
• View balance
• Auto fetch skin data on startup
• Skin notifier/reminder
• Show weapon rarity
• See current bundles
• See battlepass progress (thanks muckelba!)
• Localization support
• Shop statistics
• Settings menu
• View other people's shops
• Show off your skin collection
• Option to send shop automatically every day
• Inspect weapon skin (all 4 levels + videos + radianite upgrade price)
• Admin commands (delete user, see/edit everyone's alerts, etc.)

Acknowledgements

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

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 the bot's languages folder
3. 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.

Thank you! :)