/nyt-games-bot

Discord Bot that tracks users' NYT Games scores and maintains a leaderboard

Primary LanguagePython

NYT Games Discord Bot 🤖

A little Discord bot that tracks Wordle, Connections, and Strands scores and maintains a server leaderboard.

Track the daily, weekly, and all-time leaderboards for your server, plus get some additional stats on how well you've played. Just copy & paste your game results into Discord chat and the bot will track it.

🟩 🟨 ⬜ • 🟨 🟩 🟦 🟪 • 🔵 💡 🟡

Commands

  • ?ranks (today|week|all-time|<puzzle #>)
    • View ranked leaderboard for today, this week, all-time, or for a specific puzzle. Defaults to this week.
  • ?missing (today|<puzzle #>)
    • View users that are missing today's puzzle or missing the specified puzzle. Defaults to today.
  • ?entries [<user>]
    • View recorded entries in the database for <user>. Defaults to requester.
  • ?stats [<user1> <user2> ...]
    • View game stats for one or more users. Defaults to requester.
  • ?view [<user>] <puzzle #1> [<puzzle #2> ...]
    • View entries for a user and one or more puzzles. Defaults to requester.

Admin Commands

  • ?add [<user>] <puzzle output>
    • Manually add puzzle entry for a user. Defaults to requester.
  • ?remove [<user>] <puzzle #>
    • Manually remove puzzle entry for a user. Defaults to requester.

NOTE: ?add is NOT needed to record entries. Just paste the output from the game right into the the channel and the bot will record it. The bot will react to your message with a ✅ to let you know it has been counted.

Example Usage

  1. Adding a score normally (without ?add):
image image image

  1. Viewing the leaderboard with ?ranks:
Today's Puzzle Last 7 Days All-time
image image image
  1. Viewing missing players for today's puzzle with ?missing:

image

  1. Viewing a user's past entries with ?entries:

image

  1. Viewing stats for one or more players with ?stats:
One player Two or more players
image image

Notes

To create your own bot and deploy this yourself, I highly suggest taking a look at this guide.