Skip to content
BarryHansonPublic

About

A feature-rich Discord bot for tracking VALORANT shop data, built with account switching, customizable skin alerts, automated daily shop posts, shop appearance statistics, player match statistics, player account statistics, localization, and scalable sharding and queue systems.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

ValSkins

ValSkins is a Discord bot for tracking Valorant shop data with account switching, alerts, and automated daily posts.

Table of Contents

Features

  • View your daily shop, bundles, and night market without opening the game.
  • Set skin alerts and receive notifications when skins appear.
  • Auto-post your shop every day in a selected channel.
  • Support multiple accounts per Discord user.
  • Track shop appearance stats over time.
  • Localized skin names and responses in multiple languages.
  • Sharding and queue systems for larger deployments.

Quick Start

  1. Create a Discord bot application and invite it with bot and applications.commands scopes:
  2. Install Node.js 18+ (recommended).
  3. Clone this repository.
  4. Copy config.json.example to config.json.
  5. Copy .env.example to .env and fill at least VALSKINS_TOKEN.
  6. Install dependencies:
npm install
  1. Start the bot:
node ValSkins.js

Environment Variables

Secrets should be stored in .env, not config.json.

  • VALSKINS_TOKEN
    • Discord bot token (required).
  • VALSKINS_HDEV_TOKEN
    • Optional token for profile API-backed features.
  • VALSKINS_USER_DATA_KEY
    • Encryption key for user data when encryptUserData=true.
  • VALSKINS_HDEV_TOKEN_ALERT
    • Optional true/false override for startup alert behavior.

config.json remains for non-secret behavior flags and scheduling options.

Login Flow

ValSkins now uses cookie-based login.

  • Primary command: /login
  • /login help:true shows step-by-step cookie instructions.
  • /cookies is a legacy alias and directs users to /login.

If a Riot challenge appears (phone approval or captcha), complete it in browser first, then provide fresh cookies.

Security Notes

  • .env is gitignored by default.
  • Runtime user/auth data is gitignored (data/users/, data/shopCache/, etc.).
  • Treat cookie headers and tokens as account credentials.
  • If a secret was ever committed or pasted in logs, rotate it immediately.

Commands

Core user commands include:

  • /login
  • /shop
  • /alerts
  • /dailyshop
  • /settings
  • /update
  • /logout
  • /forget

Admin/maintenance controls are available through text-based bot owner commands such as deploy/undeploy/config operations.

Docker

For container deployment:

  1. Configure config.json and .env.
  2. Use the included Dockerfile and docker-compose.yml.
  3. Start:
docker-compose up -d
  1. Logs:
docker-compose logs -f
  1. Stop:
docker-compose down

Troubleshooting

  • Slash commands missing:
    • Ensure applications.commands scope was granted.
    • Global command propagation can take time.
  • Missing Access errors:
    • Check bot permissions and role placement.
  • Login issues:
    • Run /login help:true and use a fresh cookie header from auth.riotgames.com.

Acknowledgements

  • Original SkinPeek contributors and community testers.
  • Valorant API providers and open-source maintainers supporting this ecosystem.

Translations

To add or improve a translation:

  1. Find your locale code:
  2. Open the languages directory.
  3. Edit an existing locale file, or copy en-GB.json to your locale code.
  4. Submit changes via pull request.

About

A feature-rich Discord bot for tracking VALORANT shop data, built with account switching, customizable skin alerts, automated daily shop posts, shop appearance statistics, player match statistics, player account statistics, localization, and scalable sharding and queue systems.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Used by

Contributors

Languages