Vagudle

Vagudle Challenge

/vagudle_challenge lets anyone send a custom Vagudle puzzle to a friend. Just pick a secret word, a difficulty tier, and a guess limit, and the bot generates a shareable link that loads that exact challenge in-game.

• Word: 4–7 letters, validated against the chosen dictionary.
• Dictionary: Normal (common words), Hard (uncommon words), or Extreme (full Scrabble dictionary).
• Guesses: 9 or 11 attempts.
• Works anywhere: usable in servers, DMs, and private channels.

The word is encoded into the URL so the recipient can't spoil themselves by reading it.

---

Vagudle Duel

/vagudle_duel challenges another player to a head-to-head Vagudle duel. The bot randomly picks the secret word and both players get separate private links encoding the same word and compete to solve it.

• Difficulty: Normal (11 guesses, common words) or Hard (9 guesses, uncommon words).
• Word length: 4–7 letters.
• Works anywhere: usable in servers, DMs, and private channels. In a 1-on-1 DM the opponent is detected automatically; in a server the first person to click Accept becomes the opponent.
• Links are private: each player's link is sent as an ephemeral message only they can see.
• Winner determination: fewer guesses wins; ties go to faster completion time; identical time is a draw (both win).
• Results: when both players finish, the bot DMs each player the outcome including the word, their guesses, their time, and their opponent's result.
• Leaderboard: completed duels are recorded in Cloudflare D1 and reflected on the leaderboard.

Duel links expire after 24 hours. Results do not affect normal game stats.

---

Vagudle Daily

/vagudle_daily_channel sets the channel where a server's Vagudle Daily progress and reminders get posted. Requires the Manage Server permission and only works in servers (not DMs).

• Shared word: everyone in a group gets the same word each day. Word length and difficulty rotate by weekday.
• Live progress board: the bot posts and keeps editing a single message showing each player's masked guess rows as they play, revealing their full grid once they finish.
• Group streaks: tracked automatically and shown in the progress board footer.
• Reminders: if a recently-active group hasn't played yet, the bot posts a reminder with a live countdown to the next daily reset (08:00 UTC).
• DMs: Daily also works one-on-one in DMs without any channel setup — /vagudle_daily_channel is only needed for posting group progress to a server channel.

---

Vagudle Leaderboards

/vagudle_duel_leaderboard displays the duel leaderboard with pagination and toggles for sort mode and difficulty.

• Columns: rank, player, matches played, wins, win rate, and unique wins.
• Sort: toggle between ranking by unique wins (default) or total wins. Ties are broken by win rate.
• Difficulty: toggle between Normal and Hard mode leaderboards.
• Pages: 25 players per page with ◀ ▶ navigation.
• Lookup: optional user argument to look up any player's rank and stats directly.
• Works anywhere: usable in servers, DMs, and private channels.

Duel stat summaries are also posted to the stats channel every Monday and Friday at 14:45 UTC when new duels have been played since the last post.

/vagudle_daily_leaderboard displays the Vagudle Daily leaderboard.

• Columns: rank, player, wins, losses, current streak, and best streak.
• Sort: ranked by best streak, then total wins (fixed, no toggle).
• Pages: 25 players per page with ◀ ▶ navigation.
• Lookup: optional user argument, but only works for accounts that signed into Vagudle Daily with Discord — other players won't be found by this lookup.
• Works anywhere: usable in servers, DMs, and private channels.