ValSkins is a Discord bot for tracking Valorant shop data with account switching, alerts, and automated daily posts.
- Features
- Quick Start
- Environment Variables
- Login Flow
- Security Notes
- Commands
- Docker
- Troubleshooting
- Acknowledgements
- Translations
- 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.
- Create a Discord bot application and invite it with
botandapplications.commandsscopes: - Install Node.js 18+ (recommended).
- Clone this repository.
- Copy
config.json.exampletoconfig.json. - Copy
.env.exampleto.envand fill at leastVALSKINS_TOKEN. - Install dependencies:
npm install- Start the bot:
node ValSkins.jsSecrets 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.
- Encryption key for user data when
VALSKINS_HDEV_TOKEN_ALERT- Optional
true/falseoverride for startup alert behavior.
- Optional
config.json remains for non-secret behavior flags and scheduling options.
ValSkins now uses cookie-based login.
- Primary command:
/login /login help:trueshows step-by-step cookie instructions./cookiesis 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.
.envis 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.
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.
For container deployment:
- Configure
config.jsonand.env. - Use the included
Dockerfileanddocker-compose.yml. - Start:
docker-compose up -d- Logs:
docker-compose logs -f- Stop:
docker-compose down- Slash commands missing:
- Ensure
applications.commandsscope was granted. - Global command propagation can take time.
- Ensure
Missing Accesserrors:- Check bot permissions and role placement.
- Login issues:
- Run
/login help:trueand use a fresh cookie header fromauth.riotgames.com.
- Run
- Original SkinPeek contributors and community testers.
- Valorant API providers and open-source maintainers supporting this ecosystem.
To add or improve a translation:
- Find your locale code:
- Open the
languagesdirectory. - Edit an existing locale file, or copy
en-GB.jsonto your locale code. - Submit changes via pull request.