Warzone Stats

Warzone Stats

Discord bot for calculating aggregate player stats for Call of Duty Warzone.

NOTICE

Self-hosting using Docker

Due to changes to the tracker.gg API, this bot has issues fetching data at scale. Feel free to host a version of this bot yourself for your personal Discord server using Docker.

1. Install Docker Engine.
2. Create a Discord bot, note down your generated token, and add the bot to your server.
3. Clone this repository and add your generated token to the Dockerfile file at line 4.
4. In a terminal window, run docker compose up --build to start the bot.

Features

• Register players for combined stats
• Scheduled stats posting using cronjob syntax
• View single player stats
• Supports [mode] parameter to show stats for different game modes.
  • Battle Royale: br
  • Warzone Rumble: rmbl
  • Plunder: plndr
  • Resurgence: rsg
• Supports PlayStation Network (psn), Xbox Live (xbl) and Battlenet (battlenet) platforms
• Supports [time] parameter to only show stats from specific times, e.g., last 8 hours (8h) or past 3 days (3d). Default value: 24h
  • Hours: h
  • Days: d
  • Weeks: w
  • Months: m
• Supports random team splits into groups

Guide

• Invite the bot to your server. Setup your own local instance by following the Docker instructions above.
• Send !wz stats <modeId> [platformId] [playerId] [time] to fetch stats for a specific player.
• Send !wz stats <mode> [time] to get stats for all registered users.
  • Register users using !wz register <platformId> <playerId>
  • Unregister users using !wz unregister <platformId> <playerId>
  • Enclose <playerId> in double-quotes (like "<playerId>") if it contains spaces.
• For scheduling stats posting, send !wz schedule "<cronjob>" 8h. For example, !wz schedule "30 19 * * *" 8h posts stats everyday at 19:30 UTC.
• For team splits, send !wz teams <teamSize> to get a random list of teams from registered users.

Example

• To fetch stats for the player botmun_ playing with a PlayStation for the past two weeks, send !wz stats br psn botmun_ 2w.
• Example response from the bot on Discord

Issues

• If you encounter issues with your profile not loading, check if you can access it on the COD Warzone Stats Tracker Site whose awesome API is used by the bot. Yours might be set to private.
• Allow the bot permission to use external emojis so it can use icons for platforms instead.
• For Battlenet, it may be necessary to suffix the hash for your profile when requesting stats (e.g., username#12345).
• Feel free to open a GitHub issue if you face any problems.

Credits

• Massive thanks to COD Warzone Stats Tracker API

Donate

We're a bunch of students who enjoy playing the game and worked on this bot in our spare time between classes and jobs. We won't ever restrict basic functionality for other players out there but if you find the bot useful, please considering buying us a coffee :)